goal asset
goal asset
Create and manage Algorand Standard Assets.
Synopsis
Collection of commands to support the creation and management of assets.
goal asset [flags]
Options
-h, --help help for asset
-w, --wallet string Set the wallet to be used for the selected operationOptions inherited from parent commands
-d, --datadir stringArray Data directory for the node
-k, --kmddir string Data directory for kmd
Commands
- goal asset config - Configure an assets privileges and management credentials
- goal asset create - Create an asset
- goal asset destroy - Destroy an asset
- goal asset freeze - Freeze an asset
- goal asset info - Output asset metadata
- goal asset send - Transfer asset holdings
goal account config
Asset configuration
Synopsis
Configure several addresses for the asset that each affect specific functionality for the asset
goal asset config [flags]
Options
--asset string Unit name of asset to configure
--assetid uint Asset ID to configure
--creator string Account address for asset to configure
--manager string Manager account to issue the config transaction (defaults to creator)
--new-clawback string New clawback address
--new-freezer string New freeze address
--new-manager string New manager address
--new-reserve string New reserve address
Options inherited from parent commands
-d, --datadir stringArray Data directory for the node
-k, --kmddir string Data directory for kmd
-w, --wallet string Set the wallet to be used for the selected operation
goal asset create
Create an asset
Synopsis
Creating an asset is done through a transaction on the Algorand network. At minimum, the creator of the asset, the name and the total units of the asset need to be defined. The transaction to create the asset must be signed by the asset creator. When first creating an asset, all addresses (clawback, freezer, manager or reserve address) are set to the creator of the asset.
The defaultfrozen flag specifies whether the asset is initially frozen, meaning transactions in this asset are currently not allowed for any account. The total flag specifies the maximum amount of this specific asset type. This number can not be changed once the asset is created. These assets are currently not issued and are considered non-minted at this point. The assetmetadatab64 field allows you to specify up to 32 bytes of data about the entire asset. You could use it to specify specific asset details like title, deed location, court record etc. The asseturl gives you an option to reference a link that includes more details of the asset off-chain. The unitname flag is used to give a specific name to the asset. This is an up to eight character name for the asset. It is important to note that goal will allow you to create multiple assets with the same name for a specific creator, however those assets will have different asset indices. So the safest way to reference an asset is by its index --assetid, not its name --asset. The decimals flag specifies the divisibility of an asset. A value of 0 represents an asset that is not divisible, while a value of 1 represents an asset that is divisible into tenths and so on, i.e, the number of digits to display after the decimal place when displaying the asset. This value must be between 0 and 19
goal asset create [flags]
Options
--assetmetadatab64 string base-64 encoded 32-byte commitment to asset metadata
--asseturl string URL where user can access more information about the asset (max 32 bytes)
--creator string Account address for creating an asset
--decimals uint32 The number of digits to use after the decimal point when displaying this asset.
If set to 0, the asset is not divisible beyond its base unit. If set to 1, the base asset unit is tenths.
If 2, the base asset unit is hundredths, and so on.
--defaultfrozen Freeze or not freeze holdings by default
--total uint Total amount of tokens for created asset
--unitname string Name for the unit of asset
Options inherited from parent commands
-d, --datadir stringArray Data directory for the node
-k, --kmddir string Data directory for kmd
-w, --wallet string Set the wallet to be used for the selected operation
goal asset destroy
Destroy an asset family
Synopsis
You can destroy a created asset family as long as all units of the asset are the in the creator account asset holdings. The manager account is responsible for signing this transaction. No other key can delete the asset family..
goal asset destroy [flags]
Options
--asset string Unit name of asset to destroy
--assetid uint Asset ID to destroy
--creator string Account address for asset to destroy
--manager string Manager account to issue the destroy transaction (defaults to creator)
Options inherited from parent commands
-d, --datadir stringArray Data directory for the node
-k, --kmddir string Data directory for kmd
-w, --wallet string Set the wallet to be used for the selected operation
goal asset freeze
Freeze an asset
Synopsis
Freezing an account prevents the account from sending or receiving a specific asset. This action can only be taken by the freezer account or by the creator when creating the asset
goal asset freeze [flags]Options
--account string Account address to freeze/unfreeze
--asset string Unit name of the asset being frozen
--assetid uint ID of the asset being frozen
--creator string Account address for asset creator
--freeze Freeze or unfreeze
--freezer string Address to issue a freeze transaction from
Options inherited from parent commands
-d, --datadir stringArray Data directory for the node
-k, --kmddir string Data directory for kmd
-w, --wallet string Set the wallet to be used for the selected operation
goal asset info
Output asset metadata
Synopsis
View all asset parameters using the goal asset info command.
goal asset info [flags]Options
--asset string Unit name of the asset to look up
--assetid uint ID of the asset to look up
--creator string Account address of the asset creator
Options inherited from parent commands
-d, --datadir stringArray Data directory for the node
-k, --kmddir string Data directory for kmd
-w, --wallet string Set the wallet to be used for the selected operation
goal asset send
Transfer asset holdings.
Synopsis
You can send assets to another account but before doing so, the receiver has to authorize receiving your assets by creating, signing and sending a transaction with 0 units of the asset to itself (the receiver) -- see Receiving a new Algorand Standard Asset -- before being able to accept a specific asset. The safest way to reference as asset is by its id (--assetid) versus its name (--asset). You can create mulitple assets of the same name for a specific creator, but no two asset families can have the same asset index which is what is referred to in the --assetid. If you try to send an asset by referencing it's name, and there are multiple assets with the same name for a specific creator, goal will throw a Multiple matches for asset unit name "" in creator "" error.
goal asset send [flags]
Options
-a, --amount uint The amount to be transferred (required), in microAlgos
--asset string Unit name of the asset being transferred
--assetid uint ID of the asset being transferred
--clawback string Address to issue a clawback transaction from (defaults to no clawback)
-c, --close-to string Close asset account and send remainder to this address
--creator string Account address for asset creator
Options inherited from parent commands
-d, --datadir stringArray Data directory for the node
-k, --kmddir string Data directory for kmd
-w, --wallet string Set the wallet to be used for the selected operation