Hanzo
OpenapiWallet

Rolls one wallet's signing material through its own custody backend and answers…

Rolls one wallet's signing material through its own custody backend and answers the wallet with whatever address that produced.

POST /v1/wallet/{id}/keys

Addresshttps://api.hanzo.ai/v1/wallet/{id}/keys
MethodPOST
Operationpost_wallet_by_id_keys
AuthAuthorization: Bearer $HANZO_API_KEY

Rolls one wallet's signing material through its own custody backend and answers the wallet with whatever address that produced. For KMS custody a fresh secp256k1 key is generated and sealed, which CHANGES the address — funds and approvals at the old address do not move. For a Safe the address is counterfactual and the owner shares are ring-managed, so rotation is a no-op and the address is unchanged. A backend that is not configured fails closed with 503 rather than leaving the wallet half-rotated.

Request

1 field.

FieldInTypeRequiredDescription
idpathstringyes

Response

StatusBodyMeaning
200Walletok

200 body — 12 fields.

FieldInTypeAlwaysDescription
accountIdbodystring
addressbodystringAddress 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…
agentbodystring
chainbodystringChain is the EVM chain the wallet is bound to, CAIP-2 "eip155:<n>" or a bare decimal chain id.
createdAtbodyintegerCreatedAt is when the wallet was provisioned, Unix seconds.
custodybodystringCustody 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…
financeAccountbodystringFinanceAccount is the finance ledger account bound to this wallet — the lookup that turns a ledger account back into an on-chain signer.
idbodystringID is the wallet id, minted by the server as "wal_" + 24 hex.
namebodystringName is the display label given at creation.
orgbodystring
projectbodystring
tierbodystringTier is the wallet tier the ring keys its TierPolicy on: hot, warm, cold, gas, bridge, contract_admin, validator, quarantine or disaster_recovery.

Failure carries the platform error shape — see Errors.

Examples

hanzo wallets keys <id>

Wallet API · All Hanzo APIs · Interactive reference

How is this guide?

On this page