@stellarshift/chain-metadata

Static, curated EVM chain registry for multi-chain dashboards, wallet network pickers, and interview take-home tasks.

Includes mainnet + Sepolia testnet entries with:

• chainId, human-readable name, short slug
• Native currency (name / symbol / decimals)
• Primary block explorer base URL
• Public RPC hints (not a live health checker)

Install

npm install @stellarshift/chain-metadata

Usage

const {
  getChain,
  listChains,
  getNativeCurrency,
  explorerAddressUrl,
  isKnownChain,
} = require('@stellarshift/chain-metadata');

getChain(42161);
// { chainId: 42161, name: 'Arbitrum One', shortName: 'arb1', ... }

listChains({ testnet: false });
// mainnets only

getNativeCurrency(56);
// { name: 'BNB', symbol: 'BNB', decimals: 18 }

explorerAddressUrl(1, '0xAb5801a7D398351b0bE27eB21Eb8E514E0C2cB8');
// https://etherscan.io/address/0xAb5801...

isKnownChain(99999); // false

Supported chains (v1.0)

| chainId | Network | |--------:|---------| | 1 | Ethereum | | 137 | Polygon | | 42161 | Arbitrum One | | 8453 | Base | | 56 | BNB Chain | | 11155111 | Sepolia (testnet) |

PRs welcome for additional L2s — we intentionally keep the list small and auditable.

Design notes

• Zero runtime dependencies — JSON bundle ships with the package
• No network calls — safe for CI and air-gapped builds
• RPC URLs are hints only; production apps should use your own provider config

License

MIT © StellarShift Labs