Docs/Environments

Assets

Model native and contract-defined assets with explicit supply, decimals, and distribution.

Assets are first-class objects in an environment. The native asset exists by default; additional assets are declared with a standard, decimals, initial supply, and a distribution across accounts.

nome.env.yamlyaml

assets:
  - symbol: USDX
    standard: erc20
    decimals: 6
    supply: 1000000
    distribute:
      treasury: 800000
      user_1: 100000
      user_2: 100000
  - symbol: WETH
    standard: erc20-wrapped
    decimals: 18

Reference assets

NOME ships reference implementations of common standards. They behave exactly as the standard specifies and are deployed to deterministic addresses within your environment. You can also deploy your own asset contracts and register them so that balances appear in the Console and the state API.

Querying balances

httphttp

GET /v1/environments/env_7f3a2c/assets/USDX/holders

responsejson

{
  "asset": "USDX",
  "holders": [
    { "account": "treasury", "balance": "800000.000000" },
    { "account": "user_1",   "balance": "100000.000000" }
  ]
}