Known assets

Retrieve an asset’s configuration information from the network using Algokit Utils or goal. Additional details are also added to the accounts that own the specific asset and can be listed with standard account information calls.

Note

The code below illustrates getting asset information without the Indexer. If you have the Indexer installed use the Indexer API to search for asset information.

TypeScript

/**
 * Get information about an Algorand Standard Asset (ASA).
 *
 * - assetId: The ID of the asset
 * - creator: The address of the account that created the asset
 * - total: The total amount of the smallest divisible units that were created of the asset
 * - decimals: The amount of decimal places the asset was created with
 * - defaultFrozen: Whether the asset was frozen by default for all accounts, defaults to undefined
 * - manager: The address of the optional account that can manage the configuration of the asset and destroy it,
 *     defaults to undefined
 * - reserve: The address of the optional account that holds the reserve (uncirculated supply) units of the asset,
 *     defaults to undefined
 * - freeze: The address of the optional account that can be used to freeze or unfreeze holdings of this asset,
 *     defaults to undefined
 * - clawback: The address of the optional account that can clawback holdings of this asset from any account,
 *     defaults to undefined
 * - unitName: The optional name of the unit of this asset (e.g. ticker name), defaults to undefined
 * - unitNameAsBytes: The optional name of the unit of this asset as bytes, defaults to undefined
 * - assetName: The optional name of the asset, defaults to undefined
 * - assetNameAsBytes: The optional name of the asset as bytes, defaults to undefined
 * - url: Optional URL where more information about the asset can be retrieved, defaults to undefined
 * - urlAsBytes: Optional URL where more information about the asset can be retrieved as bytes, defaults to undefined
 * - metadataHash: 32-byte hash of some metadata that is relevant to the asset and/or asset holders,
 *     defaults to undefined
 */
const assetInfo = await algorand.asset.getById(1234n)

console.log(assetInfo.assetName)
console.log(assetInfo.total)

Source

Python

"""Get information about an Algorand Standard Asset (ASA).

- asset_id: The ID of the asset
- creator: The address of the account that created the asset
- total: The total amount of the smallest divisible units that were created of the asset
- decimals: The amount of decimal places the asset was created with
- default_frozen: Whether the asset was frozen by default for all accounts, defaults to None
- manager: The address of the optional account that can manage the configuration of the asset and destroy it,
    defaults to None
- reserve: The address of the optional account that holds the reserve (uncirculated supply) units of the asset,
    defaults to None
- freeze: The address of the optional account that can be used to freeze or unfreeze holdings of this asset,
    defaults to None
- clawback: The address of the optional account that can clawback holdings of this asset from any account,
    defaults to None
- unit_name: The optional name of the unit of this asset (e.g. ticker name), defaults to None
- unit_name_b64: The optional name of the unit of this asset as bytes, defaults to None
- asset_name: The optional name of the asset, defaults to None
- asset_name_b64: The optional name of the asset as bytes, defaults to None
- url: Optional URL where more information about the asset can be retrieved, defaults to None
- url_b64: Optional URL where more information about the asset can be retrieved as bytes, defaults to None
- metadata_hash: 32-byte hash of some metadata that is relevant to the asset and/or asset holders,
    defaults to None
"""
asset_info = algorand_client.asset.get_by_id(1234)

print(asset_info.asset_name)
print(asset_info.total)

Source

goal

goal asset info --creator <creator-address> --asset unitname  -d ~/node/data -w testwall
Asset ID:         <created-asset-id>
Creator:          <creator-address>
Asset name:       testtoken
Unit name:        unitname
Maximum issue:    12 unitname
Reserve amount:   12 unitname
Issued:           0 unitname
Decimals:         0
Default frozen:   false
Manager address:  <creator-address>
Reserve address:  <reserve-address>
Freeze address:   <freeze-address>
Clawback address: <clawback-address>

TODO Notes

• Officila stablecoins
• RWA
• Check marketing materials
• Tooling
• [ ]Tooling for assets
  • instructions for using Lora, links to community tools (wen.tools, ASAStats, etc.)