algokit_utils.assets.asset_manager

algokit_utils.assets.asset_manager

Classes

AccountAssetInformation	Information about an account’s holding of a particular asset.
AssetInformation	Information about an Algorand Standard Asset (ASA).
BulkAssetOptInOutResult	Result from performing a bulk opt-in or bulk opt-out for an account against a series of assets.
AssetManager	A manager for Algorand Standard Assets (ASAs).

Module Contents

class AccountAssetInformation

Information about an account’s holding of a particular asset.

asset_id : int

The ID of the asset

balance : int

The amount of the asset held by the account

frozen : bool

Whether the asset is frozen for this account

round : int

The round this information was retrieved at

class AssetInformation

Information about an Algorand Standard Asset (ASA).

asset_id : int

The ID of the asset

creator : str

The address of the account that created the asset

total : int

The total amount of the smallest divisible units that were created of the asset

decimals : int

The amount of decimal places the asset was created with

default_frozen : bool | None = None

Whether the asset was frozen by default for all accounts, defaults to None

manager : str | None = None

The address of the optional account that can manage the configuration of the asset and destroy it, defaults to None

reserve : str | None = None

The address of the optional account that holds the reserve (uncirculated supply) units of the asset, defaults to None

freeze : str | None = None

The address of the optional account that can be used to freeze or unfreeze holdings of this asset, defaults to None

clawback : str | None = None

The address of the optional account that can clawback holdings of this asset from any account, defaults to None

unit_name : str | None = None

The optional name of the unit of this asset (e.g. ticker name), defaults to None

unit_name_b64 : bytes | None = None

The optional name of the unit of this asset as bytes, defaults to None

asset_name : str | None = None

The optional name of the asset, defaults to None

asset_name_b64 : bytes | None = None

The optional name of the asset as bytes, defaults to None

url : str | None = None

The optional URL where more information about the asset can be retrieved, defaults to None

url_b64 : bytes | None = None

The optional URL where more information about the asset can be retrieved as bytes, defaults to None

metadata_hash : bytes | None = None

The 32-byte hash of some metadata that is relevant to the asset and/or asset holders, defaults to None

class BulkAssetOptInOutResult

Result from performing a bulk opt-in or bulk opt-out for an account against a series of assets.

• Variables:
  • asset_id – The ID of the asset opted into / out of
  • transaction_id – The transaction ID of the resulting opt in / out

asset_id : int

The ID of the asset opted into / out of

transaction_id : str

The transaction ID of the resulting opt in / out

class AssetManager(algod_client: AlgodClient, new_group: Callable[[], TransactionComposer])

A manager for Algorand Standard Assets (ASAs).

• Parameters:
  • algod_client – An AlgodClient instance
  • new_group – A function that creates a new TransactionComposer transaction group
• Example:

  asset_manager = AssetManager(algod_client)

get_by_id(asset_id: int) → AssetInformation

Returns the current asset information for the asset with the given ID.

Uses typed algod client get_asset_by_id and maps asset.params.* fields into an AssetInformation dataclass. All values are sourced from typed model attributes (e.g. asset.params.total, asset.params.manager, asset.params.unit_name) rather than dictionary keys (legacy: asset_info[“params”][“total”], etc.).

• Parameters: asset_id – The asset identifier
• Returns: AssetInformation with strongly typed fields
• Example:

  asset_manager = AssetManager(algod_client)
  info = asset_manager.get_by_id(1234567890)
  print(info.total, info.creator, info.unit_name)

get_account_information(sender: str | AddressWithTransactionSigner, asset_id: int) → AccountAssetInformation

Returns the given sender account’s asset holding for a given asset.

• Parameters:
  • sender – The address of the sender/account to look up
  • asset_id – The ID of the asset to return a holding for
• Returns: The account asset holding information
• Raises: ValueError – If the account has no holding for the specified asset
• Example:

  asset_manager = AssetManager(algod_client)
  account_asset_info = asset_manager.get_account_information(sender, asset_id)

bulk_opt_in(account: str, asset_ids: list[int], signer: TransactionSigner | None = None, rekey_to: str | None = None, note: bytes | None = None, lease: bytes | None = None, static_fee: AlgoAmount | None = None, extra_fee: AlgoAmount | None = None, max_fee: AlgoAmount | None = None, validity_window: int | None = None, first_valid_round: int | None = None, last_valid_round: int | None = None, send_params: SendParams | None = None) → list[BulkAssetOptInOutResult]

Opt an account in to a list of Algorand Standard Assets.

• Parameters:
  • account – The account to opt-in
  • asset_ids – The list of asset IDs to opt-in to
  • signer – The signer to use for the transaction, defaults to None
  • rekey_to – The address to rekey the account to, defaults to None
  • note – The note to include in the transaction, defaults to None
  • lease – The lease to include in the transaction, defaults to None
  • static_fee – The static fee to include in the transaction, defaults to None
  • extra_fee – The extra fee to include in the transaction, defaults to None
  • max_fee – The maximum fee to include in the transaction, defaults to None
  • validity_window – The validity window to include in the transaction, defaults to None
  • first_valid_round – The first valid round to include in the transaction, defaults to None
  • last_valid_round – The last valid round to include in the transaction, defaults to None
  • send_params – The send parameters to use for the transaction, defaults to None
• Returns: An array of records matching asset ID to transaction ID of the opt in
• Example:

  asset_manager = AssetManager(algod_client)
  results = asset_manager.bulk_opt_in(account, asset_ids)

bulk_opt_out(*, account: str, asset_ids: list[int], ensure_zero_balance: bool = True, signer: TransactionSigner | None = None, rekey_to: str | None = None, note: bytes | None = None, lease: bytes | None = None, static_fee: AlgoAmount | None = None, extra_fee: AlgoAmount | None = None, max_fee: AlgoAmount | None = None, validity_window: int | None = None, first_valid_round: int | None = None, last_valid_round: int | None = None, send_params: SendParams | None = None) → list[BulkAssetOptInOutResult]

Opt an account out of a list of Algorand Standard Assets.

• Parameters:
  • account – The account to opt-out
  • asset_ids – The list of asset IDs to opt-out of
  • ensure_zero_balance – Whether to check if the account has a zero balance first, defaults to True
  • signer – The signer to use for the transaction, defaults to None
  • rekey_to – The address to rekey the account to, defaults to None
  • note – The note to include in the transaction, defaults to None
  • lease – The lease to include in the transaction, defaults to None
  • static_fee – The static fee to include in the transaction, defaults to None
  • extra_fee – The extra fee to include in the transaction, defaults to None
  • max_fee – The maximum fee to include in the transaction, defaults to None
  • validity_window – The validity window to include in the transaction, defaults to None
  • first_valid_round – The first valid round to include in the transaction, defaults to None
  • last_valid_round – The last valid round to include in the transaction, defaults to None
  • send_params – The send parameters to use for the transaction, defaults to None
• Raises: ValueError – If ensure_zero_balance is True and account has non-zero balance or is not opted in
• Returns: An array of records matching asset ID to transaction ID of the opt out
• Example:

  asset_manager = AssetManager(algod_client)
  results = asset_manager.bulk_opt_out(account, asset_ids)