Integrate a Chain

Prerequisites

• You should know how to deploy and interact with a CosmWasm contract. Refer to the Osmosis CosmWasm testnet deployment tutorial if you’d like a refresher — just replace osmosisid with axelard and use the amd64 version if building on Linux and arm64 version of the contract optimizer if you are working on a Mac with Apple silicon.

Devnet information

• Devnet RPC: http://devnet-amplifier.axelar.dev:26657
• Devnet LCD (REST API/JSON RPC): http://devnet-amplifier.axelar.dev:1317
• Devnet gRPC: devnet-amplifier.axelar.dev:9090
• Chain ID: devnet-amplifier
• Connected chains and contracts: devnet-amplifier.json

Get the axelard binary

Install the v1.0.2 axelard binary. You can either download the pre-built version or build it yourself from axelar-core.

Make sure you have a funded wallet

1. Generate an account by running:

   axelard keys add wallet --keyring-backend test
   

2. Fund your devnet account with uamplifier tokens:

   • Join the Axelar Discord.
   • Get the Developer Role.
   • Go to the #faucet channel and submit a request with your account to get 100 test tokens:

   !faucet devnet-amplifier [your axelar wallet address]
   

3. Query your account balance by running:

   axelard q bank balances [your axelar wallet address] --node http://devnet-amplifier.axelar.dev:26657
   

Onboard a chain with Amplifier

You can onboard a chain with the Amplifier by instantiating the gateway, voting verifier, and multisig prover contracts.

You can either use the existing deployed contracts and on the devnet via their code_ids (CosmWasm identifiers for stored contracts that can be instantiated), or build and store these contracts from the axelar-examples repo. You will need to instantiate the contracts no matter which option you choose.

Instantiate the contracts

Instantiate the voting verifier

1. Instantiate the voting verifier contract on the command line. See the testnet, devnet-amplifier, or devnet-verifiers configurations for the correct code_id.

   export VERIFIER_CODE_ID=626
   export MY_WALLET_ADDRESS="axelar14r0xzwz8hmkshau39dyja5kx503dx6zu52623h"
   export MY_SOURCE_CHAIN_GATEWAY_ADDRESS="0xCa85f85C72df5f8428a440887CA7c449D94e0D0c"
   

   axelard tx wasm instantiate $VERIFIER_CODE_ID \
       '{
           "governance_address": "axelar1zlr7e5qf3sz7yf890rkh9tcnu87234k6k7ytd9",
           "service_registry_address":"axelar1c9fkszt5lq34vvvlat3fxj6yv7ejtqapz04e97vtc9m5z9cwnamq8zjlhz",
           "service_name":"validators",
           "source_gateway_address":"'"$MY_SOURCE_CHAIN_GATEWAY_ADDRESS"'",
           "voting_threshold":["1","1"],
           "block_expiry":"10",
           "confirmation_height":1,
           "source_chain":"test",
           "rewards_address":"axelar1vaj9sfzc3z0gpel90wu4ljutncutv0wuhvvwfsh30rqxq422z89qnd989l",
           "msg_id_format":"hex_tx_hash_and_event_index",
           "address_format": "eip55"
       }' \
       --keyring-backend test \
       --from wallet \
       --gas auto --gas-adjustment 1.5 --gas-prices 0.00005uamplifier\
       --chain-id devnet-amplifier \
       --node http://devnet-amplifier.axelar.dev:26657 \
       --label test-voting-verifier \
       --admin $MY_WALLET_ADDRESS
   

   Valid MessageIDs and AddressFormats can be found in the Amplifier source code.

2. Search the output of this command and note the _contract_address. It will be in the in logs.events property. You’ll need to do this for each instantiation to use in future steps.

   {
   "height": "128761",
   "txhash": "B122F59D82CC52C5E69DBEDAB4D4F41DFFC125312DBA4220EDD979A568637FD6",
   "codespace": "",
   "code": 0,
   "data": "...",
   "raw_log": "[{\"events\":[{\"type\":\"instantiate\",\"attributes\":[{\"key\":\"_contract_address\",\"value\":\"axelar1x3960tw9cml6xsqtvzt4gmw3scauaxdd83rhs9dmlpjfjf9z9s7qjx8g0j\"},{\"key\":\"code_id\",\"value\":\"9\"}]},{\"type\":\"message\",\"attributes\":[{\"key\":\"action\",\"value\":\"/cosmwasm.wasm.v1.MsgInstantiateContract\"},{\"key\":\"module\",\"value\":\"wasm\"},{\"key\":\"sender\",\"value\":\"axelar1ypt7vtlj4c67ezex8nwc0vm0acf6d6evss2dau\"}]},{\"type\":\"wasm-instantiated\",\"attributes\":[{\"key\":\"_contract_address\",\"value\":\"axelar1x3960tw9cml6xsqtvzt4gmw3scauaxdd83rhs9dmlpjfjf9z9s7qjx8g0j\"},{\"key\":\"service_name\",\"value\":\"validators\"},{\"key\":\"service_registry_contract\",\"value\":\"axelar1hrpna9v7vs3stzyd4z3xf00676kf78zpe2u5ksvljswn2vnjp3ystlgl4x\"},{\"key\":\"source_gateway_address\",\"value\":\"0xCa85f85C72df5f8428a440887CA7c449D94e0D0c\"},{\"key\":\"voting_threshold\",\"value\":\"[\\\"9\\\",\\\"10\\\"]\"},{\"key\":\"block_expiry\",\"value\":\"10\"},{\"key\":\"confirmation_height\",\"value\":\"1\"}]}]}]",
   "logs": [
       {
       "msg_index": 0,
       "log": "",
       "events": [
           ...,
           {
           "type": "wasm-instantiated",
           "attributes": [
               {
               "key": "_contract_address",
               "value": "axelar1x3960tw9cml6xsqtvzt4gmw3scauaxdd83rhs9dmlpjfjf9z9s7qjx8g0j"
               },
               ...
           ]
           }
       ]
       }
   ],
   "info": "",
   "gas_wanted": "337608",
   "gas_used": "183564",
   "tx": null,
   "timestamp": "",
   "events": [...]
   }
   

Instantiate the gateway

1. Instantiate the gateway contract on the command line with the verifier address from the previous step.

   export GATEWAY_CODE_ID=616
   export MY_VERIFIER_ADDRESS="axelar1x3960tw9cml6xsqtvzt4gmw3scauaxdd83rhs9dmlpjfjf9z9s7qjx8g0j"
   

2. Instantiate the contract.

   axelard tx wasm instantiate $GATEWAY_CODE_ID \
       '{
           "verifier_address": "'"$MY_VERIFIER_ADDRESS"'",
           "router_address": "axelar14jjdxqhuxk803e9pq64w4fgf385y86xxhkpzswe9crmu6vxycezst0zq8y"
       }' \
       --keyring-backend test \
       --from wallet \
       --gas auto --gas-adjustment 1.5 --gas-prices 0.00005uamplifier\
       --chain-id devnet-amplifier \
       --node http://devnet-amplifier.axelar.dev:26657 \
       --label test-gateway \
       --admin $MY_WALLET_ADDRESS
   

3. Search the output of this command and note the _contract_address.

Instantiate the multisig prover

1. Instantiate the multisig prover contract on the command line with the gateway address from the previous step.

   export PROVER_CODE_ID=618
   export MY_GATEWAY_ADDRESS="axelar1ufs3tlq4umljk0qfe8k5ya0x6hpavn897u2cnf9k0en9jr7qarqqa9263g"
   export MY_CHAIN_ID=43113
   

2. Instantiate the contract.

   axelard tx wasm instantiate $PROVER_CODE_ID \
       '{
           "admin_address": "'"$MY_WALLET_ADDRESS"'",
           "governance_address": "axelar1zlr7e5qf3sz7yf890rkh9tcnu87234k6k7ytd9",
           "gateway_address": "'"$MY_GATEWAY_ADDRESS"'",
           "multisig_address": "axelar19jxy26z0qnnspa45y5nru0l5rmy9d637z5km2ndjxthfxf5qaswst9290r",
           "coordinator_address":"axelar1m2498n4h2tskcsmssjnzswl5e6eflmqnh487ds47yxyu6y5h4zuqr9zk4g",
           "service_registry_address":"axelar1c9fkszt5lq34vvvlat3fxj6yv7ejtqapz04e97vtc9m5z9cwnamq8zjlhz",
           "voting_verifier_address": "'"$MY_VERIFIER_ADDRESS"'",
           "signing_threshold": ["1","1"],
           "service_name": "validators",
           "chain_name":"test",
           "verifier_set_diff_threshold": 1,
           "encoder": "abi",
           "key_type": "ecdsa",
           "domain_separator": "6973c72935604464b28827141b0a463af8e3487616de69c5aa0c785392c9fb9f"
       }' \
       --keyring-backend test \
       --from wallet \
       --gas auto --gas-adjustment 1.5 --gas-prices 0.00005uamplifier\
       --chain-id devnet-amplifier \
       --node http://devnet-amplifier.axelar.dev:26657 \
       --label test-prover  \
       --admin $MY_WALLET_ADDRESS
   

The domain_separator is a hash of chain name, admin address, and code ID. Value must be a String in hex format without 0x.

1. Search the output of this command and note the _contract_address.

Whitelist your contract addresses

Send the chain’s gateway and multisig prover contract addresses to the Interop Labs team by filling out the Axelar Amplifier Integration Form. The team will register the chain and gateway with the router and authorize the prover.

Add verifiers to your chain

Every new chain will need a verifier, which requires running ampd and tofnd. See Become an Amplifier Verifier (Worker) for detailed instructions on how to do this on your machine.

Begin routing messages

Once your chain is registered with the protocol, it will need verifiers to begin routing messages. See Become an Amplifier Verifier (Worker) for instructions to onboard a verifier. Note that chain integrators will onboard on devnet-amplifier and not devnet-verifier.