Asset Registry
Standardized asset metadata and lookup helpers for @tetherto/wdk-asset-registry
Asset Registry provides in-memory registries for standardized asset metadata. Use @tetherto/wdk-asset-registry when a wallet, protocol, UI, or indexing flow needs consistent asset identifiers, symbols, decimals, chain IDs, and token contract addresses without adding an RPC dependency.
Powered by @tetherto/wdk-asset-registry.
Features
- Base asset registry: Register and look up assets by
idor by partial metadata filters. - Token asset registry: Work with token metadata including
address,symbol,name,decimals, andisNative. - Bundled asset lists: Import predefined JSON metadata from
@tetherto/wdk-asset-registry/assets/common-tokens. - Zod-backed schemas: Validate base and token asset records before registration.
- Uniswap token-list helpers: Normalize Uniswap-style token entries into WDK
TokenAssetrecords. - No RPC dependency: The package stores and searches metadata locally. It does not read balances, prices, or chain state.
Why this matters
- Share one asset identity model across WDK wallet modules, pricing flows, protocol integrations, and UI surfaces.
- Normalize token metadata before it reaches send, swap, bridge, or display logic.
- Keep static metadata lookup separate from live providers that fetch balances, prices, quotes, or contract state.
Asset Registry Configuration
Install the package, preload common tokens, and register local metadata.
Asset Registry API Reference
Review registry classes, schemas, helper functions, and result types.