Skip to content

UCS04 - Universal Chain ID

Chain IDs as reported by chains themselves are unfortunately not universally unique. For example, ID 1 is used for both Ethereum and Aptos.

To disambiguate, UCS04 defines universal_chain_id as <chain_family_name>.<chain_id>. <chain_family_name> is hard to formally define. It loosely means “The short lowercase display name of the mainnet of the network”.

These IDs are used across all Union products. In addition to disambiguation, they have the additional advantage that chains are easier to recognize in logs, chats, and config files.

Universal Chain IDs

This is a list of all universal_chain_ids currently recognized by Union. To add yours, open a PR for the universal-chain-ids.json.

aptos

  • aptos.1
  • aptos.2
  • arbitrum

  • arbitrum.421614
  • babylon

  • babylon.bbn-test-5
  • berachain

  • berachain.80084
  • ethereum

  • ethereum.11155111
  • ethereum.17000
  • ethereum.1
  • movement

  • movement.250
  • osmosis

  • osmosis.osmo-test-5
  • scroll

  • scroll.534351
  • stargaze

  • stargaze.elgafar-1
  • stride

  • stride.stride-internal-1
  • union

  • union.union-testnet-8
  • union.union-testnet-9
  • union.union-testnet-10
  • union.union-1