Token Registry

The registry lives in sdk/src/registry.ts and is the keeper's and app's shared answer to "what is this token, and may a desk hold it?"

#Entry shape

Each OfficialStockToken entry records: symbol, name, chainId, address (null until verified — never fabricated), Chainlink feed, issuer, decimals, optional bytecodeHash, a verification state (verified / unverified / placeholder), an enabled flag, and a note explaining the status.

An asset is trade-eligible only when it is verified and enabled and has a concrete address, decimals, and a cited feed — on that specific chain.

#Registry rows (verbatim from sdk/src/registry.ts)

The 46630 "unverified" rows have real contract addresses (confirmed against the official contracts page, symbol/decimals/bytecode) but no cited Chainlink feed, so they stay disabled. The 46630 "placeholder" rows exist to stop anyone copying 4663 addresses onto testnet.

Eligibility is enforced twice: the keeper's isTradeEligible (chain + symbol) and on-chain via RiskModule/SwapAdapter token allowlists.

#Decimals discipline

Every accounting path normalizes through these decimals — see NAV & Accounting. UI code must never mix raw and UI units; the SDK's nav.ts helpers exist for exactly that reason.

#Querying the registry

import {
  getOfficialStockToken,
  getOfficialStockTokenByAddress,
  isTradeEligible,
  listSymbols,
  listedTokenAddresses,
} from "@seat/sdk";

getOfficialStockToken("NVDA", 4663);      // verified entry
getOfficialStockToken("NVDA", 46630);     // placeholder entry (address: null)
isTradeEligible("NVDA", 4663);            // true
isTradeEligible("TSLA", 46630);           // false
listSymbols();                            // ["NVDA", "AAPL", "SPY", "TSLA", ...]
listedTokenAddresses(46630);              // concrete 46630 token addresses

See SDK: Registry for the full surface.