Chain Integration Governance Proposals

New chains are onboarded to the Axelar Amplifier through community governance. In general, you will need to submit five governance proposals to integrate your chain:

• Proposal to instantiate the verifier contract
• Proposal to instantiate the gateway contract
• Proposal to instantiate the prover contract
• Proposal to register your chain with the router
• Proposal to authorize your prover with the Amplifier multisig contract

For example, EVM chain integrators should be using an instantiate-contract proposal to use existing code_ids, but teams with customized contract needs should use a store-instantiate proposal to both store and instantiate their custom code.

Prerequisites

• Access to the Axelar command-line interface
• 2,000 AXL for each proposal, either from your own wallet or through a community member who can fund the proposal within one hour of posting
• A running RPC endpoint or Axelar node
• Experience with the appropriate Amplifier CosmWasm contracts and interfaces for integrating a chain (i.e. completed the Integrate a Chain tutorial)

Community Forum introduction

You will need to introduce your chain to the community in order for Axelar token holders to vote for your proposals. This should be done on the governance section of the Axelar Community Forum. Make a community introduction post that precedes and can be referenced by any on-chain proposals. It should include the following information:

• Background
• Governance details
• Pre-deployed source chain gateway address
• Plan for funding rewards pools

All of your on-chain proposals will refer back to this introduction, so make sure to be thorough. You should stay present and engage with any questions or comments during the seven-day feedback period, which can include public comments as well as a security council review. When the feedback period is over, submit your on-chain governance proposals to finish the integration of your chain.

Proposal to instantiate the verifier contract

export CODE_ID=500
export CHAIN_NAME="[chain name]"
export NETWORK_GOV_ADDRESS="axelar10d07y265gmmuvt4z0w9aw880jnsr700j7v9daj"
export RPC="http://devnet-amplifier.axelar.dev:26657"

axelard tx gov submit-proposal instantiate-contract $CODE_ID \
'{
    "governance_address": "axelar10d07y265gmmuvt4z0w9aw880jnsr700j7v9daj",
    "service_registry_address": "axelar1c9fkszt5lq34vvvlat3fxj6yv7ejtqapz04e97vtc9m5z9cwnamq8zjlhz",
    "service_name":"validators",
    "source_gateway_address":"0xeE9E463Fd8bE9AF266e1B143C27F7D42648f4006",
    "voting_threshold":["1","1"],
    "block_expiry":10,
    "confirmation_height":1,
    "source_chain":"ethereum-sepolia",
"rewards_address":"axelar1vaj9sfzc3z0gpel90wu4ljutncutv0wuhvvwfsh30rqxq422z89qnd989l",
    "msg_id_format":"hex_tx_hash_and_event_index"
}' \
--title="Instantiate verifier contract for "'"$CHAIN_NAME"'" \
--description="Instantiate verifier contract for "'"$CHAIN_NAME"'" \
--run-as $NETWORK_GOV_ADDRESS \
--label "'"$CHAIN_NAME"'" \
--deposit=2000000000uamplifier \
--keyring-backend test \
--from wallet \
--gas auto --gas-adjustment 1.5 --gas-prices 0.007uamplifier \
--chain-id=devnet-amplifier \
--no-admin \
--node $RPC

Proposal to instantiate the gateway contract

export CODE_ID=493
export CHAIN_NAME="[chain name]"
export NETWORK_GOV_ADDRESS="axelar10d07y265gmmuvt4z0w9aw880jnsr700j7v9daj"
export RPC="http://devnet-amplifier.axelar.dev:26657"

axelard tx gov submit-proposal instantiate-contract $CODE_ID \
    '{
        "verifier_address": "axelar1e6jnuljng6aljk0tjct6f0hl9tye6l0n9p067pwx2374h82dmr0s9qcqy9",
        "router_address": "axelar14jjdxqhuxk803e9pq64w4fgf385y86xxhkpzswe9crmu6vxycezst0zq8y"
    }' \
    --title="Instantiate gateway contract for "'"$CHAIN_NAME"'" \
    --description="Instantiate gateway contract for "'"$CHAIN_NAME"'" \
    --run-as $NETWORK_GOV_ADDRESS \
    --label "'"$CHAIN_NAME"'" \
    --deposit=2000000000uamplifier \
    --keyring-backend test \
    --from wallet \
    --gas auto --gas-adjustment 1.5 --gas-prices 0.007uamplifier \
    --chain-id=devnet-amplifier \
    --no-admin \
    --node $RPC

Proposal to instantiate the prover contract

export CODE_ID=495
export CHAIN_NAME="[chain name]"
export NETWORK_GOV_ADDRESS="axelar10d07y265gmmuvt4z0w9aw880jnsr700j7v9daj"
export RPC="http://devnet-amplifier.axelar.dev:26657"

axelard tx gov submit-proposal instantiate-contract $CODE_ID \
    '{
"admin_address": "axelar1zlr7e5qf3sz7yf890rkh9tcnu87234k6k7ytd9", # Prover admin address
"governance_address": "axelar1zlr7e5qf3sz7yf890rkh9tcnu87234k6k7ytd9",
"gateway_address": "axelar1hdx49xndyxzrs3t5jkzart00taqysu6kmaf77waxv8regwxxpp4qcsea2w"
"multisig_address": "axelar19jxy26z0qnnspa45y5nru0l5rmy9d637z5km2ndjxthfxf5qaswst9290r",
"coordinator_address":"axelar1m2498n4h2tskcsmssjnzswl5e6eflmqnh487ds47yxyu6y5h4zuqr9zk4g",
"service_registry_address":"axelar1c9fkszt5lq34vvvlat3fxj6yv7ejtqapz04e97vtc9m5z9cwnamq8zjlhz",
"voting_verifier_address": "axelar1zlr7e5qf3sz7yf890rkh9tcnu87234k6k7ytd9", # Ethereum Sepolia voting verifier governance address
"signing_threshold": ["1","1"],
"service_name": "validators",
"chain_name": "'"$CHAIN_NAME"'",
"verifier_set_diff_threshold": 1,
"encoder": "abi",
"key_type": "ecdsa",
"domain_separator": "6973c72935604464b28827141b0a463af8e3487616de69c5aa0c785392c9fb9f" # Hash of chain name, admin address, and code ID. Value must be a String in hex format without `0x`.
    }' \
    --title="Instantiate prover contract for "'"$CHAIN_NAME"'" \
    --description="Instantiate prover contract for "'"$CHAIN_NAME"'" \
    --run-as $NETWORK_GOV_ADDRESS \
    --label "'"$CHAIN_NAME"'" \
    --deposit=2000000000uamplifier \
    --keyring-backend test \
    --from wallet \
    --gas auto --gas-adjustment 1.5 --gas-prices 0.007uamplifier \
    --chain-id=devnet-amplifier \
    --admin="axelar1zlr7e5qf3sz7yf890rkh9tcnu87234k6k7ytd9"
    --node $RPC

Register your chain with the router

export ROUTER_CONTRACT_ADDRESS="axelar14jjdxqhuxk803e9pq64w4fgf385y86xxhkpzswe9crmu6vxycezst0zq8y"
export CHAIN_NAME="[chain name]"
export ROUTER_GOV_ADDRESS="axelar1zlr7e5qf3sz7yf890rkh9tcnu87234k6k7ytd9"
export RPC="http://devnet-amplifier.axelar.dev:26657"

axelard tx gov submit-proposal execute-contract $ROUTER_CONTRACT_ADDRESS \
    '{
        "register_chain": {
            "chain":"'"$CHAIN_NAME"'",
            "gateway_address": "[chain gateway address]",
            "msg_id_format": "hex_tx_hash_and_event_index"
        }
    }' \
    --title="Register "'"$CHAIN_NAME"'" chain with the Amplifier router" \
    --description="Register "'"$CHAIN_NAME"'" chain with the Amplifier router" \
    --run-as $ROUTER_GOV_ADDRESS \
    --deposit=2000000000uamplifier \
    --keyring-backend test \
    --from wallet \
    --gas auto --gas-adjustment 1.5 --gas-prices 0.007uamplifier \
    --chain-id=devnet-amplifier \
    --node $RPC

Authorize your prover with the Amplifier multisig contract

Once the feedback period has passed, submit the proposal on the command line:

export MULTISIG_CONTRACT_ADDRESS="axelar1ufs3tlq4umljk0qfe8k5ya0x6hpavn897u2cnf9k0en9jr7qarqqa9263g"
export CHAIN_PROVER_ADDRESS="[chain prover address]"
export CHAIN_NAME="[chain name]"
export MULTISIG_GOV_ADDRESS="axelar1zlr7e5qf3sz7yf890rkh9tcnu87234k6k7ytd9"
export RPC="http://devnet-amplifier.axelar.dev:26657"

axelard tx gov submit-proposal execute-contract $MULTISIG_CONTRACT_ADDRESS \
    '{
        "authorize_caller":
            {
            "contract_address":"'"$CHAIN_PROVER_ADDRESS"'"
            }
    }' \
    --title="Authorize "'"$CHAIN_NAME"'" prover with the Amplifier multisig contract" \
    --description="Authorize "'"$CHAIN_NAME"'" prover with the Amplifier multisig contract" \
    --run-as $MULTISIG_GOV_ADDRESS \
    --deposit=2000000000uamplifier \
    --keyring-backend test \
    --from wallet \
    --gas auto --gas-adjustment 1.5 --gas-prices 0.007uamplifier \
    --chain-id=devnet-amplifier \
    --node $RPC

Track your proposal

You can track the status of your proposal with the proposal_id given in the output after a successful submission.

Costs

Each proposal requires a 2,000 AXL deposit to submit. These funds will be refunded if votes reach quorum. The Axelar Network currently requires a 33.4% quorum of staked tokens.

Voting period

There is a three-day (72-hour) voting period for all mainnet proposals.