Developer token proposal and bridge setup
Developers and project teams can propose new FT4 tokens and optional bridges on the Token Chain. The process includes fee payment, parameter configuration, and (optionally) bridge deployment.
1. Proposing a new token
Anyone can submit a token proposal. A listing fee is required upfront and refunded if the proposal is rejected. By default, the fee distribution is:
- 25% burned to reduce overall supply and help maintain token value over time.
- 25% to Chromia Foundation to support ecosystem development.
- 50% directed to the project's resource pool for ongoing ecosystem incentives.
Your proposal should include:
- Token name: This is the name of the token.
- Token symbol: This is the symbol of the token.
- Token decimals: The number of decimal places to use for the token.
- Token icon: A URL pointing to an image file.
- Minting policies: Policies governing who can mint new tokens, how many and how often. Full format of policy can be found in the reference documentation.
- Account creation blockchains: Blockchains RIDs allowed to create accounts.
Steps:
-
(Optional) Check current constants to verify the listing fee and other parameters:
Terminalchr query --blockchain-rid ${TOKEN_CHAIN_RID} get_token_chain_constants -
Submit proposal (replace placeholders):
Terminalchr tx --evm-auth ${EVM_WALLET_ADDRESS} --blockchain-rid ${TOKEN_CHAIN_RID} \ propose_token ${NAME} ${SYMBOL} ${DECIMALS} ${ICON_URL} \ ${MINTING_POLICY} ${ACCOUNT_CREATION_BRIDS} -
Verify proposal status:
Terminalchr query --blockchain-rid ${TOKEN_CHAIN_RID} get_proposals_by_proposer proposer=${YOUR_ACCOUNT_ID} -
After approval, fetch your asset ID:
Terminalchr query --blockchain-rid ${TOKEN_CHAIN_RID} \ ft4.get_assets_by_name name=${YOUR_TOKEN_NAME} page_size=null page_cursor=null
2. Proposing a bridge
If you don't have the EVM_TRANSACTION_SUBMITTER_CHAIN_RID, retrieve it with:
chr query --blockchain-rid ${DIRECTORY_CHAIN_RID} get_evm_transaction_submitter_chain_rid-
Retrieve existing bridges:
Terminalchr query --blockchain-rid ${EVM_TRANSACTION_SUBMITTER_CHAIN_RID} get_all_bridges -
Identify the Token Chain's validator contract in the response.
-
Define your
bridge_configurationin RELL format:Rellstruct bridge_configuration { network_id: integer; bridge_contract: byte_array; token_contract: byte_array; eif.hbridge.bridge_mode; use_snapshots: boolean; skip_to_height: integer; } -
Submit bridge proposal using the Chromia CLI (see the Deploy the bridge guide):
Terminalchr tx --evm-auth ${EVM_WALLET_ADDRESS} --blockchain-rid ${TOKEN_CHAIN_RID} \ propose_token_bridge ${ASSET_ID} ${BRIDGE_CONFIGURATIONS}
Token minting
To mint tokens (if authorized):
chr tx --evm-auth ${EVM_WALLET_ADDRESS} --blockchain-rid ${TOKEN_CHAIN_RID} \
mint_token ${ASSET_ID} ${AMOUNT}For full reference on on-chain functions and ICCF operations, see the
ras_token_iccf
documentation.