Tokenfactory
This page gives examples of basic
tokenfactory module cli commands to mint sdk.Coins on Sei.
The tokenfactory module allows any account to create a new token with the name
factory/${CREATOR_ADDRESS}/${SUBDENOM} in a permissionless fashion.See the tutorial at the end of this page for an example
sdk.Coin creation using the tokenfactory module.For more details on how to interact with tokenfactory module via
wasm please reference the sei-cosmwasm package and its associated Tokenfactory bindings.seid tx tokenfactory create-denom $SUBDENOM --from $ACCOUNT --chain-id $CHAIN_ID
This will create a new coin of the form
factory/${CREATOR_ADDRESS}/${SUBDENOM}NOTE: Minting is only possible from the creator address account
seid tx tokenfactory mint $AMOUNT --from $ACCOUNT --chain-id $CHAIN_ID
$AMOUNT for example includes 100sei Once minted, consider a
bank send to send the tokens to another addressNOTE: Burning is only possible from the creator address account
seid tx tokenfactory burn $AMOUNT --from $ACCOUNT --chain-id $CHAIN_ID
In this Tutorial we will create a new
sdk.Coin on atlantic-2 testnet. We employ a test creator address
sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g and walk through each step of the process- 1.Create the denom.
Here we specify a subdenom
solid seid tx tokenfactory create-denom solid --from sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g --chain-id atlantic-2 -b block -y
2. Query module to verify creation.
seid q tokenfactory denoms-from-creator sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g
denoms:
- factory/sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g/solid
We use the tokenfactory query
denoms-from-creator to query all the tokenfactory created sdk.Coins associated with address. Notice how the the full denomination is
factory/sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g/solid . This verifies our address sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g as the creator who can mint and burn. When interacting with this
sdk.Coin , we must specify the full denomination factory/sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g/solidnot just the subdenom solid .
3. Mint 1000
factory/sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g/solidseid tx tokenfactory mint 1000factory/sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g/solid --from sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g --chain-id atlantic-2 -b block -y
This will mint 1000
factory/sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g/solid to the creator address.NOTE: Consider a bank send after minting to distribute to other addresses.
4. Query bank balance of creator address to verify mint
seid q bank balances sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g
balances:
- amount: "1000"
denom: factory/sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g/solid
You can see how the 1000
factory/sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g/solid shows up in the creator address' bank balance.
5. Burn 500
factory/sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g/solidseid tx tokenfactory burn 500factory/sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g/solid --from sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g --chain-id atlantic-2 -b block -y
6. Query Bank balances of creator to verify burn
seid q bank balances sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g
balances:
- amount: "500"
denom: factory/sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g/solid
You can see now how there is only 500
factory/sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g/solid left in the creator address.
7. Bank send 100
factory/sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g/solidto another address sei1fsjz3adpv3v4zlu6dwn4qm8n98r8ard2jma7euseid tx bank send sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g sei1fsjz3adpv3v4zlu6dwn4qm8n98r8ard2jma7eu 100factory/sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g/solid --chain-id=atlantic-2 -b block -y
8. Query bank balance of receiver address to verify bank send
seid q bank balances sei1fsjz3adpv3v4zlu6dwn4qm8n98r8ard2jma7eu
balances:
- amount: "100"
denom: factory/sei1cux78sqj8nk8g0j4e39wwrntzqye2fcpmwvr8g/solid
Last modified 1mo ago