Chain Onboarding
The WalletConnect protocol is multi-chain by design. By using the CAIP-25 standard, WalletConnect aims to provide a standardized process for onboarding new chains into our ecosystem. To get started, follow the following steps.
Register Chain with the Explorer​
Registering a chain with the Explorer does not impact or improve the ability for wallets and dapps to support your chain. It is simply a way for users to discover wallets and dapps that support your chain by:
- Browsing the Chains List
- Filtering results programmatically via the Explorer API
It is still up to wallets and dapps to provide concrete support for your chain once it is listed as part of the Explorer.
If you don't see your chain listed in this list, then you will need to create an issue in GitHub to to get the process started. You can do so by clicking here. Once your chain is added to this list, wallets & dapps will be able to indicate support for your chain via WalletConnect's Cloud.
Add RPC Methods​
Integrate RPC method support into the example wallets and dapp.
Example Wallet
Example Dapp
Promote​
For a chain to benefit users, its prominent wallets and dApps must be registered in the Explorer. Encourage them to join the API, allowing users to view the wallets as options when connecting to a dApp.
Web3Modal​
After adding the chain to the Explorer, Web3Modal can be utilized to offer users a seamless experience when connecting to their wallet.
Wagmi & Viem​
If the chain you are registering is EVM compliant, we highly recommend you to integrate it with Viem, an ethereum library used by Wagmi and Web3Modal. To accomplish this you will need to open a GitHub Pull Request in the Viem repository.
Was this helpful?