Wallet class

Constructors

Wallet({String? accountId, String? address, String? agent, String? chain, int? createdAt, String? custody, String? financeAccount, String? id, String? name, String? org, String? project, String? tier})

Returns a new Wallet instance.

Properties

accountId ↔ String?

Please note: This property should have been non-nullable! Since the specification file does not include a default value (using the "default:" property), however, the generated source code must fall back to having a nullable type. Consider adding a "default:" property in the specification file to hide this note.

getter/setter pair

address ↔ 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.

getter/setter pair

agent ↔ String?

Please note: This property should have been non-nullable! Since the specification file does not include a default value (using the "default:" property), however, the generated source code must fall back to having a nullable type. Consider adding a "default:" property in the specification file to hide this note.

getter/setter pair

chain ↔ String?

Chain is the EVM chain the wallet is bound to, CAIP-2 "eip155:

getter/setter pair

createdAt ↔ int?

CreatedAt is when the wallet was provisioned, Unix seconds. Listings order by it, newest first.

getter/setter pair

custody ↔ 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.

getter/setter pair

financeAccount ↔ 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.

getter/setter pair

hashCode → int

The hash code for this object.

no setter, override

id ↔ 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.

getter/setter pair

name ↔ 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.

getter/setter pair

org ↔ String?

Please note: This property should have been non-nullable! Since the specification file does not include a default value (using the "default:" property), however, the generated source code must fall back to having a nullable type. Consider adding a "default:" property in the specification file to hide this note.

getter/setter pair

project ↔ String?

Please note: This property should have been non-nullable! Since the specification file does not include a default value (using the "default:" property), however, the generated source code must fall back to having a nullable type. Consider adding a "default:" property in the specification file to hide this note.

getter/setter pair

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

tier ↔ 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.

getter/setter pair

Methods

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

toJson() → Map<String, dynamic>

toString() → String

A string representation of this object.

override

Operators

operator ==(Object other) → bool

The equality operator.

override

Static Methods

fromJson(dynamic value) → Wallet?

Returns a new Wallet instance and imports its values from value if it's a Map, null otherwise.

listFromJson(dynamic json, {bool growable = false}) → List<Wallet>

mapFromJson(dynamic json) → Map<String, Wallet>

mapListFromJson(dynamic json, {bool growable = false}) → Map<String, List<Wallet>>

Constants

requiredKeys → const Set<String>

The list of required keys that must be present in a JSON.