Skip to content
Node operator
/
Genesis sync

Genesis sync

Start your Axelar node and download the blockchain.

🔥

Important: The Axelar network is under active development. Use at your own risk with funds you're comfortable using. See Terms of use.

💡

Tip: These instructions syncronize your Axelar node using the Axelar peer-to-peer network. You can syncronize your node more quickly by downloading a recent snapshot of the blockchain as per Quick sync.

Prerequisites

  • Operating system: MacOS or Ubuntu (tested on 18.04)
  • Hardware: 4 cores, 8-16GB RAM, 512 GB drive, arm64 or amd64. Recommended 6-8 cores, 16-32 GB RAM, 1 TB+ drive.
  • Software:
    • Install jq.
    • Increase the maximum number of open files on your system. Example: ulimit -n 16384. You may wish to add this command to your shell profile so that you don't need to execute it next time you restart your machine.

Choose a keyring password

Your Axelar keyring is encrypted with a password you choose. Your password must have at least 8 characters.

In what follows you will execute a shell script to join the Axelar network. Your keyring password is supplied to the shell script via a KEYRING_PASSWORD environment variable.

⚠️

Caution: In the following instructions you must substitute your chosen keyring password for my-secret-password.

Join the Axelar network

Clone the axelerate-community repo:

git clone https://github.com/axelarnetwork/axelarate-community.git
cd axelarate-community
Launch a new Axelar mainnet node with version 0.10.7 of axelar-core:
KEYRING_PASSWORD=my-secret-password ./scripts/node.sh -a v0.10.7 -n mainnet
Your Axelar node will initialize your data folder ~/.axelar

To recover your secret keys from mnemonics, use -t path_to_tendermint_key -m path_to_validator_mnemonic -r (-r is to reset the chain). These flags work only on a completely fresh state.

Your Axelar node will launch and begin downloading the blockchain.

Backup your secret keys

BACKUP and DELETE the validator account secret mnemonic:

~/.axelar/validator.txt

BACKUP but do NOT DELETE the Tendermint consensus secret key (this is needed on node restarts):

~/.axelar/.core/config/priv_validator_key.json

View logs

View the streaming logs for your Axelar node:

In a new terminal window:

tail -f ~/.axelar/logs/axelard.log

Follow the upgrade path

Your Axelar node will download the blockchain until it reaches the first UPGRADE_HEIGHT listed below.

After your blockchain has reached UPGRADE_HEIGHT you will see a panic in the logs like

panic: UPGRADE {NAME} NEEDED at height: {UPGRADE_HEIGHT}:

Launch your Axelar node again with the CORE_VERSION listed below:

KEYRING_PASSWORD=my-secret-password ./scripts/node.sh -a {CORE_VERSION} -n mainnet

Your Axelar node will launch and resume downloading the blockchain.

Repeat this process for each entry in the table.

Test whether your blockchain is downloaded

Eventually your Axelar node will download the entire Axelar blockchain and exit catching_up mode. At that time your logs will show a new block added to the blockchain every 5 seconds.

You can test whether your Axelar node has exited catching_up mode:

curl localhost:26657/status | jq '.result.sync_info'

Look for the field catching_up:

  • true: you are still downloading the blockchain.
  • false: you have finished downloading the blockchain.

Next steps

Congratulations! You joined the Axelar network and downloaded the blockchain.

Learn what you can do with Axelar:

  • Basic node management
  • Tutorial: transfer UST or LUNA tokens from the Terra blockchain to EVM-compatible blockchains such as Avalanche, Ethereum, Fantom, Moonbeam, Polygon.
Quick sync (recommended)
Basic node management