Onboarding
Wormhole Gateway Onboarding Instructions
This page is for any Cosmos chain developer that wants to enable bridging from Gateway, a Wormhole Cosmos chain that leverages the Wormhole Guardian network for easy bridging from Ethereum to Cosmos.
See here for more details on Gateway: The Gateway to Cosmos
Step 1. Propose Adding Your Chain to the Wormhole Guardians
Open a new GitHub governance discussion under Wormhole Gateway by filling out the Cosmos Chain Governance Proposal Template - here.
Allow 96 hours for discussion and governance vote.
Step 2. Join the Wormhole Discord
Join the wormhole discord (link).
Ping the moderator, Susu (
susu.wormhole
), to get added to the#guardian-cosmos
channel.
Step 3. Establish an IBC Connection
Allowlist your IBC relayer(s) on Wormhole Gateway
The IBC relayer should generate an address via the
wormchaind
CLI - here.Fill out the IBC relayer allowlist request template.
Post the request in the
#guardian-cosmos
channel.
Establish the IBC connection.
Please ensure that the
trusting_period
andtrust_threshold
parameters are set to the safest values. E.g.trust_threshold
should be 2/3 andtrusting_period
should be 2/3 the unbonding period of your chain.See an example IBC relayer config for Wormhole Gateway below.
Please see docs here on how to set up your own Wormhole Gateway node to connect your IBC relayer to. Or, you can see available public nodes on the cosmos chain registry.
Share the IBC connection details in the
#guardian-cosmos
channel along with a request to the Wormhole Contributors to prepare governance for the IBC connection.Allow 48 hours for governance vote on accepting this IBC channel.
Step 4. [Optional] UI Integration with Wormhole Connect
Wormhole Connect is a seamless way to embed bridging directly to your app with 3 lines of code. Integrating Connect is fast, customizable, and brings all the functionality and utility of Wormhole right into your own application.
Please refer to these reference PRs to add your Cosmos chain into Wormhole Connect. Your PRs will need to be reviewed and merged by Wormhole Core Contributors.
Add your Cosmos chain ID to the Wormhole SDK: [sdk/js] Add Kujira chain id by M-Picco · Pull Request #3381 · wormhole-foundation/wormhole (github.com)
Add your Cosmos chain to Wormhole Connect: Add kujira chain by M-Picco · Pull Request #1009 · wormhole-foundation/wormhole-connect (github.com)
Step 5. Add bridged assets to the Cosmos Chain Registry and other relevant wallet and frontend registries
Permissionlessly attest the assets you would like to bridge into your chain (if not already attested) to Wormhole Gateway.
Raise relevant PRs to ensure that explorers, wallets, and other UIs recognize the Wormhole assets when they are bridged to your chain.
Example PR adding Wormhole assets to Osmosis Mintscan (example).
🎉 Congratulations! You’ve successfully connected your Cosmos chain to Gateway. If you have any questions or concerns, please reach out to Susu on the Wormhole Discord.
IBC Relayer Allowlist Request Template
Wormhole Gateway IBC Relayer Config
Last updated