@sei-js/registry

@sei-js/registry exports typed chain IDs, endpoints, token metadata, and wallet information for Sei Mainnet and Sei Testnet. Network and wallet data comes from the official sei-protocol/chain-registry. Token metadata comes from the community-maintained Seitrace asset list.

The package is ESM-only. Sei Mainnet and Sei Testnet are the only supported networks. The package no longer exports CHAIN_IDS.devnet, GAS_INFO, or IBC_INFO.

Installation

npm install @sei-js/registry

CHAIN_IDS

CHAIN_IDS has the canonical chain ID for each Sei network:

import { CHAIN_IDS } from '@sei-js/registry';

CHAIN_IDS.mainnet  // 'pacific-1'
CHAIN_IDS.testnet  // 'atlantic-2'

To avoid hardcoded strings, use these constants wherever you reference a Sei network by chain ID.

NETWORKS

NETWORKS has the RPC, REST, gRPC, EVM RPC, WebSocket, and explorer endpoints for each network:

import { NETWORKS, type Network } from '@sei-js/registry';

// Network is the 'pacific-1' | 'atlantic-2' chain ID union
const mainnet = NETWORKS['pacific-1'];

// Pick the first available EVM RPC endpoint
const evmRpc = mainnet.evm_rpc?.[0].url;

// Pick the first available WebSocket endpoint
const evmWs = mainnet.evm_ws?.[0].url;

// Pick a Cosmos REST endpoint
const rest = mainnet.rest[0].url;

Each endpoint has provider and url fields. To implement fallback logic, you can iterate through the available providers:

async function getWorkingRpc(network: Network) {
  const endpoints = NETWORKS[network].evm_rpc ?? [];
  for (const endpoint of endpoints) {
    try {
      const res = await fetch(endpoint.url, {
        method: 'POST',
        headers: { 'content-type': 'application/json' },
        body: JSON.stringify({ jsonrpc: '2.0', method: 'eth_blockNumber', params: [], id: 1 }),
      });
      if (res.ok) return endpoint.url;
    } catch {}
  }
  throw new Error(`No working EVM RPC found for ${network}`);
}

@sei-js/registry no longer exports gas metadata. For EVM transactions, use eth_gasPrice and eth_estimateGas. See Gas and fees.

TOKEN_LIST

The token metadata for each network includes names, symbols, base denominations, decimal exponents, images, and CoinGecko IDs:

Do not treat legacy tokenfactory entries as supported integration targets. Tokenfactory is not supported for new development. TOKEN_LIST filters assets whose base or denomination starts with ibc/, along with assets marked as ICS-20. The community asset list may still contain legacy tokenfactory entries for display or compatibility.

import { TOKEN_LIST } from '@sei-js/registry';

// Registry metadata on mainnet
const tokens = TOKEN_LIST['pacific-1'];

// Find SEI
const sei = tokens.find(token => token.base === 'usei');

console.log(sei?.display); // 'sei'
console.log(sei?.denom_units);
console.log(sei?.type_asset);
console.log(sei?.pointer_contract);

Exported entries use the RegistryToken type, so type_asset is required. images.png, images.svg, and coingecko_id are optional. NFT entries can have an empty denom_units array. Some assets also include optional pointer_contract metadata (address plus cw20 or erc20). Identify an asset by network and base denomination, not by pointer data alone.

CHAIN_INFO

CHAIN_INFO contains Sei Mainnet metadata such as the seid binary name, Bech32 prefix, fee token, SLIP-44 coin type, and supported native wallets:

import { CHAIN_INFO } from '@sei-js/registry';

CHAIN_INFO.bech32_prefix     // 'sei'
CHAIN_INFO.slip44            // 118  (HD wallet coin type)
CHAIN_INFO.fee_token         // 'usei'
CHAIN_INFO.supported_wallets // ['keplr', 'coin98']

// Validate a Cosmos-side Sei address format
function isSeiAddress(address: string): boolean {
  return address.startsWith(CHAIN_INFO.bech32_prefix + '1');
}

// Derive the HD path for key generation
const path = `m/44'/${CHAIN_INFO.slip44}'/0'/0/0`;

supported_wallets reflects the upstream chain registry. It is not an exhaustive list of wallets that can connect to Sei.

WALLETS

Wallet metadata includes icons, URLs, and EVM or native capability flags:

import { WALLETS } from '@sei-js/registry';

// All wallets that support EVM
const evmWallets = WALLETS.filter(w => w.capabilities.includes('evm'));

// Find a specific wallet for displaying its icon
const keplr = WALLETS.find(w => w.identifier === 'keplr');
// { name: 'Keplr Wallet', identifier: 'keplr', icon: 'https://raw.githubusercontent.com/.../keplr-logo.png',
//   url: 'https://www.keplr.app', capabilities: ['native', 'evm'] }

The current list is MetaMask (evm), Keplr (native and evm), and Coin98 (native). This list is separate from CHAIN_INFO.supported_wallets, which is the upstream native-wallet list (keplr, coin98).

Supported networks

Value	Sei Mainnet	Sei Testnet
Cosmos chain ID	`pacific-1`	`atlantic-2`
EVM chain ID	1329	1328
EVM RPC	`NETWORKS['pacific-1'].evm_rpc`	`NETWORKS['atlantic-2'].evm_rpc`
EVM WebSocket	`NETWORKS['pacific-1'].evm_ws`	`NETWORKS['atlantic-2'].evm_ws`
Faucets	None	`NETWORKS['atlantic-2'].faucets`

Overview

Essentials

seid CLI

Frontend Development

Smart Contracts

sei-js Library

Videos

Ecosystem Tutorials

Reference

Hardware Wallets

Installation

CHAIN_IDS

NETWORKS

TOKEN_LIST

CHAIN_INFO

WALLETS

Supported networks

​Installation

​CHAIN_IDS

​NETWORKS

​TOKEN_LIST

​CHAIN_INFO

​WALLETS

​Supported networks

Installation

CHAIN_IDS

NETWORKS

TOKEN_LIST

CHAIN_INFO

WALLETS

Supported networks