Skip to content
Developer

Developer

Develop your cross-chain dapp in 2 simple steps

  1. Build. Develop and test in the Axelar local development environment
  2. Deploy. Deploy to a live network: testnet or mainnet

Example: Hello-world

axelar-local-dev-sample is a complete, working example illustrating the build-deploy process.

  1. Run the dapp in the local development environment.
  2. Run the same dapp in the live testnet, interacting with contracts already deployed on Ethereum and Avalanche testnets.

View the github README for instructions and code:

Build

The Axelar local development environment emulates multiple EVM chains and the Axelar overlay network that connects them.

  1. Create new emulated EVM chains pre-loaded with ERC-20 tokens and gateway contracts.
  2. Write your own IAxelarExecutable contracts and deploy to your emulated EVM chains.
  3. Call your IAxelarExecutable contracts from any chain via that chain's gateway contract. Use relay() to simulate the Axelar overlay network.

Learn more at the axelar-local-dev github README:

Deploy

When you're ready to go live:

  1. Deploy your IAxelarExecutable contracts to any EVM chain supported by Axelar.
  2. Remove calls to relay()---the Axelar network will handle everything for you!

See axelar-local-dev-sample for a working example:

More examples

  • Simple. Set up two EVM chains, transfer tokens from one chain to the other, send a "Hello world!" message to a contract on both chains.
  • Metamask. Set up two EVM chains and a simple web page to connect Metamask and transfer tokens from one chain to the other.
  • Remote. Set up a test environment and connect to it remotely.
  • Token linker. Use cross-chain contract calls to transfer ERC-20 tokens across EVM chains.
  • More to come

AxelarJS SDK

The AxelarJS SDK is a npm dependency that empowers developers to leverage microservices or IBC relayers provided by Axelar.

Not all dapps need the SDK. Your dapp might benefit from the SDK in the following use cases:

  1. Microservices. Example: Get a deposit address for cross-chain token transfer dapps like Satellite.
  2. Relayers. Example: Connect EVM chains to Cosmos chains such as Terra.

Learn more at the axelarjs-sdk github README: