Hanzo AI
OpenapiWallet

Create keys

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 wallet keys <id>

Wallet API · All Hanzo APIs · Interactive reference

How is this guide?

On this page