"Hello World" example dApp

What better way to start than to lead by example? And a simple one we're all familiar with: "Hello World!"

One-time setup

Install nodejs. Run node -v to check your installation.

Version 16 is required. If needed, you can switch your node version via

sudo npm i -g n
sudo n v16.15.0

Clone this repo:

git clone https://github.com/axelarnetwork/axelar-local-gmp-examples.git

Build contracts and tests:

npm ci
npm run build

Set up deployer key

cp .env.example .env

Then update to your own private key.

Deploy and run "Hello World"

In order to run the examples against the local emulator, cd to the root directory (axelar-local-gmp-examples) in a separate terminal window and run:

node scripts/createLocal

Leave this terminal open for the duration of the example.

Run the "Call Contract" example. The application sends a message - "Hello World" - from a source to a destination chain using the callContract function.

1. Deploy locally

node scripts/deploy examples/call-contract [local|testnet]

For example:

node scripts/deploy examples/call-contract local

Output:

Deploying ExecutableSample for Moonbeam.
Deploying ExecutableSample for Avalanche.
Deploying ExecutableSample for Fantom.
Deploying ExecutableSample for Ethereum.
Deploying ExecutableSample for Polygon.
Deployed ExecutableSample for Ethereum at 0x775C53cd1F4c36ac74Cb4Aa1a3CA1508e9C4Bd24.
Deployed ExecutableSample for Moonbeam at 0xF8f92930AD2C4d627a96819E67aD3BcD95b5E063.
Deployed ExecutableSample for Polygon at 0x775C53cd1F4c36ac74Cb4Aa1a3CA1508e9C4Bd24.
Deployed ExecutableSample for Avalanche at 0x775C53cd1F4c36ac74Cb4Aa1a3CA1508e9C4Bd24.
Deployed ExecutableSample for Fantom at 0x775C53cd1F4c36ac74Cb4Aa1a3CA1508e9C4Bd24.

2. Run locally

node scripts/test examples/call-contract [local|testnet] ${"source-chain"} ${"destination-chain"} ${'message'}

For example:

node scripts/test examples/call-contract local "Moonbeam" "Avalanche" 'Hello World'

Output:

--- Initially ---
value at Avalanche is
--- After ---
value at Avalanche is Hello World

3. Run in testnet

When you're ready, you can take the actual local example above and change the local environment parameters in the deploy/run scripts to testnet.

That's it!

Summary

In the above, we sent a message - "Hello World" - from a smart contract on Moonbeam to a smart contract on Avalanche, updating the latter's "value" property to our "Hello World" message.

The full transaction flow was:

Started the local developer environment to run local EVM blockchains.
The first node script deployed this smart contract to all the EVM chains in our local developer environment.
The second node script ran this test script on local Moonbeam, which:
- Calculated the estimated gas cost of executing the method on Avalanche.
- Invoked setRemoteValue on the deployed Moonbeam smart contract. This method first pays the gas receiver on Moonbeam the estimated gas cost, then calls callContractWithToken on the Moonbeam Gateway contract.
After some time, the relay services detect the gas paid on Moonbeam and executes the smart contract on Avalanche, invoking the _execute method that updated the value to the message parameter.