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)