Connect an EVM Chain

Connecting a new CosmWasm chain is easy and can be done in four simple steps documented here:

1. Upload ibc-core and light-client contracts.
2. Configure the Voyager relayer.
3. Open the connection.
4. Send assets and data.

Upload IBC Core and Light Clients

Deployment of the Union EVM stack is fully automated. You can add a chain definition, and Union will generate deployment scripts for you.

1. Clone unionlabs/union:

   git clone [email protected]:unionlabs/union

2. Add your chains configuration to evm/evm.nix. For example:

   {
     network = "holesky";
     rpc-url = "https://1rpc.io/holesky";
     private-key = ''"$1"'';
     extra-args = ''--verify --verifier etherscan --etherscan-api-key "$2"'';
   }

3. Use the gernated reproducible deployment script.

   nix run github:unionlabs/union#eth-deploy-$NETWORK-full

   for example, if your network is "holesky" above, it will be:

   nix run github:unionlabs/union#eth-deploy-holesky-full $EVM_PRIVKEY $ETHERSCAN_API_KEY

   Providing an Etherscan API key is optional, but highly recommended as it will verify the uploaded contracts for you.

Configure Voyager

TODO

Open the Connection

TODO