Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

$$ \newcommand \Asset {\mathrm{Asa}} \newcommand \MaxAssetDecimals {\Asset_{d,\max}} \newcommand \MaxAssetNameBytes {\Asset_{n,\max}} \newcommand \MaxAssetUnitNameBytes {\Asset_{u,\max}} \newcommand \MaxAssetURLBytes {\Asset_{r,\max}} $$

Asset Configuration Transaction

Fields

An asset configuration transaction additionally has the following fields:

FIELDCODECTYPEREQUIRED
Asset IDcaiduint64Yes (except for Creation)
Asset ParametersaparstructYes (for Creation)

Asset ID

The asset ID \( \Asset_\mathrm{cfg,ID} \) identifies the asset being configured.

If the asset ID is omitted (zero), this transaction is creating an asset.

Asset Parameters

The asset parameters are the parameters for configuring the asset.

These asset parameters is structure containing:

FIELDCODECTYPEDESCRIPTION
Totaltuint64Total amount of units of the asset
Decimalsdcuint32Number of digits after the decimal place
Default FrozendfboolFlag that specifies if the asset requires whitelisting (yes if true)
Unit NameunstringAsset unit symbol (or asset short-name)
Asset NameanstringAsset name
URLaustringURL to retrieve additional asset information
Metadata Hasham[32]byteCommitment to asset metadata
ManagermaddressAccount allowed to set the asset role-based access control and destroy the asset
ReserveraddressAccount whose asset holdings should be interpreted as “not mined” (this is purely a label)
FreezefaddressAccount allowed to change the account’s frozen state for the asset holdings
ClawbackcaddressAccount allowed to transfer units of the asset from any account
  • The decimals MUST NOT exceed \( \MaxAssetDecimals \).

  • The unit name byte length MUTS NOT exceed \( \MaxAssetUnitNameBytes \).

  • The asset name byte length MUST NOT exceed \( \MaxAssetNameBytes \).

  • The URL byte length MUST NOT exceed \( \MaxAssetURLBytes \).

If the asset parameters are omitted (struct of zero values), this transaction is deleting the asset.

Semantic

TODO

Validation

TODO