Assets

The Algorand Standard Asset (ASA) management functions include creating, opting in and transferring assets, which are fundamental to asset interaction in a blockchain environment.

AssetManager

The AssetManager class provides functionality for managing Algorand Standard Assets (ASAs). It can be accessed through the AlgorandClient via algorand.asset or instantiated directly:

from algokit_utils import AssetManager, TransactionComposer
from algosdk.v2client import algod

asset_manager = AssetManager(
    algod_client=algod_client,
    new_group=lambda: TransactionComposer()
)

Asset Information

The AssetManager provides two key data classes for asset information:

AssetInformation

Contains details about an Algorand Standard Asset (ASA):

@dataclass
class AssetInformation:
    asset_id: int  # The ID of the asset
    creator: str   # Address of the creator account
    total: int     # Total units created
    decimals: int  # Number of decimal places
    default_frozen: bool | None = None  # Whether asset is frozen by default
    manager: str | None = None    # Optional manager address
    reserve: str | None = None    # Optional reserve address
    freeze: str | None = None     # Optional freeze address
    clawback: str | None = None   # Optional clawback address
    unit_name: str | None = None  # Optional unit name (e.g. ticker)
    asset_name: str | None = None # Optional asset name
    url: str | None = None        # Optional URL for more info
    metadata_hash: bytes | None = None # Optional 32-byte metadata hash

AccountAssetInformation

Contains information about an account’s holding of a particular asset:

@dataclass
class AccountAssetInformation:
    asset_id: int   # The ID of the asset
    balance: int    # Amount held by the account
    frozen: bool    # Whether frozen for this account
    round: int      # Round this info was retrieved at

Bulk Operations

The AssetManager provides methods for bulk opt-in/opt-out operations:

Bulk Opt-In

# Basic example
result = asset_manager.bulk_opt_in(
    account="ACCOUNT_ADDRESS",
    asset_ids=[12345, 67890]
)

# Advanced example with optional parameters
result = asset_manager.bulk_opt_in(
    account="ACCOUNT_ADDRESS",
    asset_ids=[12345, 67890],
    signer=transaction_signer,
    note=b"opt-in note",
    lease=b"lease",
    static_fee=AlgoAmount(1000),
    extra_fee=AlgoAmount(500),
    max_fee=AlgoAmount(2000),
    validity_window=10,
    send_params=SendParams(...)
)

Bulk Opt-Out

# Basic example
result = asset_manager.bulk_opt_out(
    account="ACCOUNT_ADDRESS",
    asset_ids=[12345, 67890]
)

# Advanced example with optional parameters
result = asset_manager.bulk_opt_out(
    account="ACCOUNT_ADDRESS",
    asset_ids=[12345, 67890],
    ensure_zero_balance=True,
    signer=transaction_signer,
    note=b"opt-out note",
    lease=b"lease",
    static_fee=AlgoAmount(1000),
    extra_fee=AlgoAmount(500),
    max_fee=AlgoAmount(2000),
    validity_window=10,
    send_params=SendParams(...)
)

The bulk operations return a list of BulkAssetOptInOutResult objects containing:

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

Get Asset Information

Getting Asset Parameters

You can get the current parameters of an asset from algod using get_by_id():

asset_info = asset_manager.get_by_id(12345)

Getting Account Holdings

You can get an account’s current holdings of an asset using get_account_information():

address = "XBYLS2E6YI6XXL5BWCAMOA4GTWHXWENZMX5UHXMRNWWUQ7BXCY5WC5TEPA"
asset_id = 12345
account_info = asset_manager.get_account_information(address, asset_id)