pub struct Wallet {
pub account_id: Option<String>,
pub address: Option<String>,
pub agent: Option<String>,
pub chain: Option<String>,
pub created_at: Option<i32>,
pub custody: Option<String>,
pub finance_account: Option<String>,
pub id: Option<String>,
pub name: Option<String>,
pub org: Option<String>,
pub project: Option<String>,
pub tier: Option<String>,
}Fields§
§account_id: Option<String>§address: Option<String>Address is the on-chain address. For kms/mpc/treasury it is the EOA a signature from this wallet recovers to; for safe it is the CREATE2 address of the Safe CONTRACT, which holds no key — its approvals recover to the MPC owner instead. Rotating a kms wallet mints a new key and therefore a NEW address, and funds and approvals at the old one do not follow; mpc, treasury and safe addresses are invariant under rotation.
agent: Option<String>§chain: Option<String>Chain is the EVM chain the wallet is bound to, CAIP-2 "eip155:
created_at: Option<i32>CreatedAt is when the wallet was provisioned, Unix seconds. Listings order by it, newest first.
custody: Option<String>Custody is the backend holding the signing material, fixed at creation: "kms" (a secp256k1 key sealed under KMS and opened in-process), "mpc" or "treasury" (an m-of-n threshold key on the deployed ring, which differ by governance and not by signing mechanics), or "safe" (a Safe contract owned by an MPC key). A kind the deployment has not wired refuses with 503 rather than fabricating a signature.
finance_account: Option<String>FinanceAccount is the finance ledger account bound to this wallet — the lookup that turns a ledger account back into an on-chain signer. Absent is the normal state and means unbound; the column is NULL until something binds it.
id: Option<String>ID is the wallet id, minted by the server as "wal_" + 24 hex. It is the last segment of the key ref, and it is the LEDGER SUBJECT an x402 payment into this wallet credits — so it names money as well as key material.
name: Option<String>Name is the display label given at creation. It addresses nothing: the key ref is derived from the scope and the id, so renaming moves no material.
org: Option<String>§project: Option<String>§tier: Option<String>Tier is the wallet tier the ring keys its TierPolicy on: hot, warm, cold, gas, bridge, contract_admin, validator, quarantine or disaster_recovery. It defaults to hot and is refused at the boundary if it is none of the nine.