USD Network

Accounts and addresses

USD Network uses Ethereum-style addresses, so every EVM key already has a USD Network account.

Addresses

A USD Network address is a 20-byte Ethereum-style address, written as 0x followed by 40 hex characters. The API lowercases addresses, and the transfer message always uses the lowercase form.

Because the address is derived the same way as on Ethereum, the same private key or recovery phrase controls the same address on USD Network, Ethereum, Base, Arbitrum and BNB Chain. In the USD.NET wallet, that is the key at path m/44'/60'/0'/0/0.

Account state

Accounts are confidential. With a read pass signed by the account's key, GET /address returns its full state:

GET /address/0x… (with x-usd-read)
{
  "address": "0x…",
  "balance": "87.65",
  "nonce": 1,
  "frozen": false,
  "txs": 2,
  "firstSeen": 1793730989320,
  "transactions": [ … ]
}
FieldMeaning
balanceUSD₮ balance as a decimal string, up to 6 decimals
nonceThe nonce the next transfer from this account must use
frozenWhether the issuer has frozen the account
txsNumber of sealed transfers involving the account
firstSeenTime of the first block that touched the account, in milliseconds

An address that has never received USD₮ returns a zero balance and nonce 0. No registration is needed. Without a read pass the response is only { "address", "confidential": true, "frozen" }.

System addresses

AddressRole
0x0000000000000000000000000000000000000000Issuer. The from of mints and compliance actions.
0x00000000000000000000000000000000000fee00Fee collector. Receives every transfer fee.