Built-in Assets

Every workspace is seeded at initialization with 29 curated tokens spanning the 14 built-in networks — each network's native gas coin plus the major stablecoins and wrapped-native tokens. They are also exposed as the frozen BUILTIN_ASSETS registry so you can inspect the catalog without opening a workspace. These ids and addresses are reserved: see Assets for how imports collide with them and why they cannot be dropped.

Preloaded tokens by network

Token contract addresses

The 14 native coins all carry a placeholder address. The remaining 15 tokens each have a real contract address:

The BUILTIN_ASSETS registry

BUILTIN_ASSETS is a frozen record, keyed by network slug, of the curated token lists. Each entry is an array of AssetInit.

const BUILTIN_ASSETS: Record<string /* network slug */, ReadonlyArray<AssetInit>>

import { BUILTIN_ASSETS } from "wative-core";
import type { AssetInit } from "wative-core";

Object.keys(BUILTIN_ASSETS).length;            // 14 networks
BUILTIN_ASSETS["ethereum"].map((a) => a.symbol); // ["ETH", "USDC", "USDT", "WETH"]

const total = Object.values(BUILTIN_ASSETS)
  .reduce((n, list) => n + list.length, 0);     // 29 tokens

AssetInit

The literal shape of a built-in entry.

All fields are readonly. AssetInit differs from the constructor's AssetInitObject: it carries no network field (the network is the registry key), and its contractAddress is a required property (still nullable).

Native coins carry a placeholder address

Native gas coins have no contract, so the built-ins record a sentinel address rather than null. An Asset built from one reports native === true.

Built-in tokens cannot be dropped

Built-in ids are protected: dropAsset rejects any of them with UNSUPPORTED_OP, because removing a native token would break balance lookups deep in the wallet flow.

await ws.dropAsset(1); // ETH — rejects: WativeError { code: "UNSUPPORTED_OP" }

Imports also cannot re-use a built-in id or a built-in contract address — both collide with PARAMETER_ERROR. See Assets for the import and collision rules.

See also