Using the Hyperlane CLI
After deploying your Hyperlane Warp Route (HWR), you may want to extend it to a new chain. Extending a HWR involves deploying a new token contract on the target chain and enrolling existing tokens with it.
You can extend an existing HWR using the Hyperlane CLI.
Gnosis Safe Users: The EOA that owns the HWR must either be a Safe signer or
delegate
to be able to propose update transactions.
If you already have the warp config, skip to Step 1.
To generate the HWR config using the Hyperlane CLI, locate your token symbol on the chain on which it is deployed:
You can then choose the HWR to extend.
After running hyperlane warp read
, the CLI will display a config similar to the following:
basesepolia:
mailbox: "0x6966b0E55883d49BFB24539356a2f8A673E02039"
owner: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
name: "Ether"
symbol: "ETH"
decimals: 18
totalSupply: "1"
remoteRouters:
"11155111": "0x8A73F6E36735d8C4b9A00Af910746173050B754E"
type: "synthetic"
sepolia:
mailbox: "0xfFAEF09B3cd11D9b20d1a19bECca54EEC2884766"
owner: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
name: "Ether"
symbol: "ETH"
decimals: 18
totalSupply: 0
remoteRouters:
"84532": "0x26243aaD2d03AAbafaCE785808Ae64fc32aFB8A1"
type: "native"
This particular config has 2 chains: basesepolia and sepolia. This means messages can be relayed between both chains.
By default, warp read
will save the output to CURRENT_DIR/configs/warp-route-deployment.yaml
. Follow these steps to add a chain to the existing HWR.
Step 1: Configuration
Update the warp-route-deployment.yaml
by adding a config for the new chain.
warp-route-deployment.yaml
sepolia:
mailbox: "0xfFAEF09B3cd11D9b20d1a19bECca54EEC2884766"
owner: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
name: "Ether"
symbol: "ETH"
decimals: 18
totalSupply: 0
remoteRouters:
"84532": "0x26243aaD2d03AAbafaCE785808Ae64fc32aFB8A1"
type: "native"
basesepolia:
mailbox: "0x6966b0E55883d49BFB24539356a2f8A673E02039"
owner: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
name: "Ether"
symbol: "ETH"
decimals: 18
totalSupply: "1"
remoteRouters:
"11155111": "0x8A73F6E36735d8C4b9A00Af910746173050B754E"
type: "synthetic"
+ holesky:
+ mailbox: "0x46f7C5D896bbeC89bE1B19e4485e59b4Be49e9Cc"
+ owner: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
+ name: "Ether"
+ symbol: "ETH"
+ decimals: 18
+ totalSupply: "1"
+ type: "synthetic"
EOA Users: The extended config owner
must match the EOA address from the
prerequisites step to avoid deployment failure.
Step 2: Apply
Using the CLI, execute the command applicable to your HWR owner setup:
After executing, you should see a batch of transactions executed on chain, and a final message indicating that the warp config has been updated.
Step 3: Confirm
To confirm that the HWR was successfully extended using the Hyperlane CLI, run the following command with your token symbol on the chain it is deployed on:
After running warp read
, confirm that the HWR has been extended:
basesepolia:
mailbox: "0x6966b0E55883d49BFB24539356a2f8A673E02039"
owner: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
name: "Ether"
symbol: "ETH"
decimals: 18
totalSupply: 0
remoteRouters:
"17000": "0x9B18AfD7aB869C6B011F44638ff71786447B785B"
"11155111": "0x4e63147e72d029Eb8b37F375B3837B2644622686"
type: native
sepolia:
mailbox: "0xfFAEF09B3cd11D9b20d1a19bECca54EEC2884766"
owner: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
name: "Ether"
symbol: "ETH"
decimals: 18
totalSupply: "0"
remoteRouters:
"17000": "0x9B18AfD7aB869C6B011F44638ff71786447B785B"
"84532": "0xB38cc797Ccc6D8763439a07CEa052AF253281de6"
type: "synthetic"
holesky:
mailbox: "0x46f7C5D896bbeC89bE1B19e4485e59b4Be49e9Cc"
owner: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"
name: "Ether"
symbol: "ETH"
decimals: 18
totalSupply: "0"
remoteRouters:
"84532": "0xB38cc797Ccc6D8763439a07CEa052AF253281de6"
"11155111": "0x4e63147e72d029Eb8b37F375B3837B2644622686"
type: "synthetic"