Skip to main content

Supported currencies metadata

ChainGate provides programmatic access to the list of all supported currencies and their associated metadata. This is useful for dynamically building interfaces, validating inputs, or retrieving consistent information across multiple chains.

You can use:

  • List of all supported currencies
  • Detailed currency metadata
  • EVM-specific properties (e.g., chain ID, EIP-1559 support)

Quick example​

import { AllCurrencies, getCurrencyInfo } from 'chaingate'

for (const currency of AllCurrencies) {
  const info = getCurrencyInfo(currency)
  console.log(`${info.name} (${info.symbol}) — decimals: ${info.decimals}`)
}

All supported currencies​

ChainGate maintains an up-to-date list of supported currency identifiers, which is exposed through the AllCurrencies constant.

ChainGate currently supports these networks (expanded regularly):

BitcoinEthereumBnbDogecoinAvalancheLitecoinBitcoin CashPolygonArbitrumFantomBaseBitcoin Testnet

Retrieve currency metadata​

Use getCurrencyInfo(currency) to obtain metadata for any supported currency.

Parameters​

  • currency — one of the values listed in All supported currencies.

Returns​

  • A metadata object describing the currency (see property reference below).
Detect if a currency is EVM-compatible

You can check whether a currency is based on an Ethereum Virtual Machine (EVM) chain using getCurrencyInfo. This is useful when applying EVM-specific logic, such as handling gas fees, signing transactions, or interacting with smart contracts.

import { getCurrencyInfo, EvmCurrencyInfo } from 'chaingate'

const info = getCurrencyInfo('polygon')
if (info instanceof EvmCurrencyInfo) {
    // Apply EVM-specific logic here
}

Property reference​

Below are the details of every property available on the metadata object returned by getCurrencyInfo.

Common to all currencies (CurrencyInfo)​

  • id (string) — Stable identifier for the currency (e.g., bitcoin, polygon).
  • name (string) — Human‑readable name of the network (e.g., Bitcoin, Polygon).
  • defaultDerivationPath (string) — Default BIP derivation path used by ChainGate for key derivation on this network.
  • svgLogoUrl (string) — URL pointing to an SVG logo suitable for UI display.
  • symbol (string) — Ticker symbol for the native asset (e.g., BTC, ETH, MATIC).
  • minimalUnitSymbol (string) — Symbol for the minimal unit (e.g., sat, gwei, or chain‑specific unit).
  • decimals (number) — Number of decimal places used by the native asset (e.g., 8 for BTC, 18 for most EVM chains).
  • commonDerivationPaths (string[]) — A curated set of commonly used derivation paths for wallets on this chain.
  • nativeTokenId (string) — Canonical identifier for the chain’s native token within ChainGate.
  • nativeTokenName (string) — Human‑readable name of the chain’s native token.

EVM‑only (EvmCurrencyInfo extends CurrencyInfo)​

  • chainId (number) — EVM chain ID per EIP‑155.
  • supportsEIP1559 (boolean) — Indicates if the chain supports the EIP‑1559 fee mechanism (base fee + priority tip).

Key points​

  • Uniform structure: Every currency exposes consistent metadata for UI and logic.
  • EVM extras: EVM chains include chainId and supportsEIP1559.
  • Type‑safe: The AllCurrencies list enables strong typing and autocompletion in TypeScript.
  • Display‑ready: Use name, symbol, svgLogoUrl, and decimals to render clean UIs.