Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
K

keplr-chain-registry

> 编程语言
Open source

Protocol for Integrating Non-Native Chains to Keplr

397 stars0 likes3 views
WebsiteGitHub

About

Protocol for Integrating Non-Native Chains to Keplr

Warning

PLEASE RUN THE COMMANDS BELOW TO VERIFY CONFIGURATION IN YOUR LOCAL ENVIRONMENT BEFORE SUBMITTING PULL REQUESTS.

bash
# install node modules
yarn install

# validate your json file (for Cosmos-SDK-based chains, EVM chains, or SVM chains)
yarn validate cosmos/{your file.json}
yarn validate evm/{your file.json}
yarn validate svm/{your file.json}

READ THE GUIDELINES BELLOW CAREFULLY, PAYING PARTICULAR ATTENTION TO THE "features" IN THE [REQUIREMENT DETAILS for Cosmos-based chains] and [REQUIREMENT DETAILS for EVM-based chains].

Guidelines for Community-Driven Non-Native Chain Integration

Keplr team has always been at the leading edge of building secure and interoperable wallet infrastructure for the blooming cross-chain networks. While Keplr initially focused its core efforts on the Cosmos ecosystem (collectively known as the "interchain ecosystem"), it has since expanded to support EVM-compatible chains and Starknet, with plans to further extend into other ecosystems, leveraging thoughtfully designed UI/UX for enhanced compatibility across technologies.

To help the builders easily plug into Keplr’s wide userbase and the ever-growing crypto ecosystems, Keplr has been offering an option of permissionless integration, the so-called “Suggest (Non-Native) Chain Integration”. The feature has enabled front-ends to request adding new blockchains that aren’t natively integrated into the Keplr extension.

Keplr team is now introducing a Community-Driven Integration, which enables our users to easily make a request for adding new chains and updating their information. It's an expanded version of the previous suggest chain integration, providing a public API to our users for creating and updating a set integration standard for each chain.

To make a pull request, please carefully read and follow the guidelines below. Any contribution is more than welcome!

Table of Contents

  • Requirements and Preparation
  • Cosmos-SDK-based Chains
  • EVM-based Chains
  • SVM-based Chains
  • Notes

Requirements and Preparation

This guildline outlines the basic information that is required for registering a chain to Keplr wallet. Please note that your request does not always guarantee integrations and updates; upon your submission, Keplr team will go through a minimal verification process to see if there is any security issue or any missing information.

Once approved, the Keplr browser extension will show the tag “Community-Driven” on the chain connection page, to let the users be aware that the integration was requested and implemented by the community and the Keplr team has gone through the verification process.

Cosmos-SDK-based Chains

Cosmos-SDK-based Chain Registration Directory Structure

chainID is consisted of ({identifier}-{version}). chain-identifier therefore refers to a text identifier of a chain that comes before its version number. For example:

  The chain-identifier of `cosmoshub-4` is `cosmoshub`.
  The chain-identifier of `crypto-org-chain-mainnet-1` is `crypto-org-chain-mainnet`.
  The chain-identifier of `evmos_9001-2` is `evmos_9001`.
  The chain-identifier of 'shentu-2.2' is 'shentu-2.2'.

Here’s an overview of the structure of the directory. Please provide the information and files complying with the requirements.

.
├── cosmos                       # Mainnet
│     ├── cosmoshub.json         # Chains (Each file should be named `{chain-identifier}.json')
│     ├── osmosis.json
│     └── ...
└── images                       # Collection of image assets
      ├── cosmoshub              # Image assets of Comos Hub (Each directory should be named `{chain-identifier}`.)
      │     └── chain.png        # Cosmos Hub Logo(png, 256x256px)
      ├── osmosis                # Image assets of Osmosis
      └── ...

Cosmos-SDK-based Chain Registration Form

…

Cosmos-SDK-based Chain Registration Form Requirement Details

  • chainId: chainId in a form of {identifier}-{version} (ex. cosmoshub-4)
  • chainName: the name of the chain that will be displayed on the wallet
  • chainSymbolImageUrl: Image URL of the chain.
    • https://raw.githubusercontent.com/chainapsis/keplr-chain-registry/main/images/{chain-identifier}/{file-name}.png
    • Please modify the chain-identifier and file-name from the link above and upload it.
  • rpc: URL of RPC endpoint of the chain
  • rest: URL of REST/API endpoint of the chain
  • nodeProvider: provide the details of the RPC/REST node providers
    • name: name of the node provider
    • email: email address of the node provider (To help other users reach out when there is an issue with the nodes’ status)
    • website(optional): website address of the node provider
  • walletUrlForStaking(optional): the URL where the users are directed when they click on Staking button of the Keplr Wallet
  • bip44: BIP-44 coin type (118 highly recommended)
  • bech32Config: prefix used at the beginning of the address
  • currencies: the list of the supported currencies. If your chain uses replicated security, please place your main native token at the top of the currencies list. Note that IBC tokens are not accepted here.
  • feeCurrencies: the list of the tokens that are accepted by the validators for fees
  • stakeCurrency: the staking token of the chain. Remove this item if your chain does not support native staking (e.g. your chain uses replicated security) or does not have a staking token.
  • coinGeckoId(optional): the active API ID for Keplr to get the price from CoinGecko. For a testnet chain, this field is not accepted.
  • features: any other features that are additionally supported by the chain
    • cosmwasm: supports CosmWasm smart contracts
    • secretwasm: supports WASM smart contracts of Secret Network
    • eth-address-gen: supports EVM account generation
    • eth-key-sign: supports EVM signatures
    • eth-secp256k1-cosmos: Required for chains built with github.com/cosmos/evm
    • axelar-evm-bridge: supports EVM bridge provided by Axelar Network
    • osmosis-txfees: supports paying fees in other currencies on Osmosis
  • isTestnet: set it to true when your chain is a testnet or devnet
  • explorers(optional): block explorer configuration for transaction lookup
    • txPage: URL template for transaction pages. Available placeholders:
      • {txHash} - transaction hash in uppercase hex
      • {txHash:lowercase} - transaction hash in lowercase hex
      • {txHash:uppercase} - transaction hash in uppercase hex (same as {txHash})
      • Example: "https://www.mintscan.io/osmosis/tx/{txHash}"

EVM-based Chains

EVM-based Chain Registration Directory Structure

EVM-based chain identifier is consisted of eip155:{eip155-chain-id} which follows CAIP-2

  The chain identifier of `Ethereum` is `eip155:1`.
  The chain identifier of `Optimism` is `eip155:10`.
  The chain identifier of `Polygon` is `eip155:137`.

Here’s an overview of the structure of the directory. Please provide the information and files complying with the requirements.

…

EVM-based Chain Registration Form

…

EVM-based Chain Registration Form Requirement Details

  • rpc: URL of RPC endpoint of the chain
  • websocket: URL of WebSocket endpoint of the chain
  • nodeProvider: provide the details of the RPC/WebSocket node providers
    • name: name of the node provider
    • email: email address of the node provider (To help other users reach out when there is an issue with the nodes’ status)
    • website(optional): website address of the node provider
  • chainId: chain identifier in a form of eip155:{evm-chain-id} (ex. eip155:1)
  • chainName: the name of the chain that will be displayed on the wallet
  • chainSymbolImageUrl: Image URL of the chain.
    • https://raw.githubusercontent.com/chainapsis/keplr-chain-registry/main/images/{chain-identifier}/{file-name}.png
    • Please modify the chain-identifier and file-name from the link above and upload it.
  • bip44: BIP-44 coin type (60 highly recommended)
  • currencies: the list of the supported currencies. If your chain uses replicated security, please place your main native token at the top of the currencies list.
  • feeCurrencies: the list of the tokens that are accepted for fees
  • coinGeckoId(optional): the active API ID for Keplr to get the price from CoinGecko. For a testnet chain, this field is not accepted.
  • features: any other features that are additionally supported by the chain
    • op-stack-l1-data-fee: supports paying L1 data fee for OP stack based chain
  • explorers(optional): block explorer configuration for transaction lookup
    • txPage: URL template for transaction pages. Available placeholders:
      • {txHash} - transaction hash in uppercase hex
      • {txHash:lowercase} - transaction hash in lowercase hex
      • {txHash:uppercase} - transaction hash in uppercase hex (same as {txHash})
      • Example: "https://etherscan.io/tx/0x{txHash}"
      • Example: "https://lineascan.build/tx/0x{txHash:lowercase}"

SVM-based Chains

SVM-based Chain Registration Directory Structure

SVM-based chain identifier follows CAIP-2 format with {namespace}:{reference} structure, where reference is a base58 encoded hash.

  The chain identifier of `Solana Mainnet` is `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`.
  The chain identifier of `Solana Devnet` is `solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1`.

Here's an overview of the structure of the directory. Please provide the information and files complying with the requirements.

…

SVM-based Chain Registration Form

…

SVM-based Chain Registration Form Requirement Details

  • rpc: URL of RPC endpoint of the chain
  • websocket: URL of WebSocket endpoint of the chain
  • chainId: chain identifier in a form of {namespace}:{base58-hash} (ex. solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)
  • chainName: the name of the chain that will be displayed on the wallet
  • chainSymbolImageUrl: Image URL of the chain.
    • https://raw.githubusercontent.com/chainapsis/keplr-chain-registry/main/images/{chain-identifier}/{file-name}.png
    • Please modify the chain-identifier and file-name from the link above and upload it.
  • bip44: BIP-44 coin type (501 for Solana)
  • currencies: the list of the supported currencies
  • feeCurrencies: the list of the tokens that are accepted for fees
  • coinGeckoId(optional): the active API ID for Keplr to get the price from CoinGecko. For a testnet chain, this field is not accepted.
  • isTestnet: set it to true when your chain is a testnet or devnet
  • explorers(optional): block explorer configuration for transaction lookup
    • txPage: URL template for transaction pages. Available placeholders:
      • {txHash} - transaction hash in uppercase hex
      • {txHash:lowercase} - transaction hash in lowercase hex
      • {txHash:uppercase} - transaction hash in uppercase hex (same as {txHash})
      • Example: "https://explorer.solana.com/tx/{txHash}"

NOTE:

  • Please check if the chain information file is in JSON format.
  • Chain logos should be in PNG format in 256x256px resolution. Please also note that the images will be automatically cropped into a circle to be displayed on the wallet (See the sample image above.)
  • If coinImageUrl is not provided in currencies, Keplr doesn't show the token image on the wallet.
  • RPC / WebSocket
    • Please check if the RPC node is not currently experiencing any issues/errors.
    • Please double-check if your chainId matches the RPC node’s chainId.
    • Check if websocket connection is open.
  • REST
    • Please check if the REST node is not currently experiencing any issues/err

Issues· 6 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

TypeScript

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言