Hanzo

Wallet

Package wallets is blockchain key custody: create wallets, rotate their keys, and sign with them.

Package wallets is blockchain key custody: create wallets, rotate their keys, and sign with them.

Base URLhttps://api.hanzo.ai
Operations8
AuthAuthorization: Bearer $HANZO_API_KEY

Specification

Specification pending — no HIP in hanzoai/hips declares capability: wallet yet. What this capability serves is below, from the API document; what it is — the store it owns, how it meters, what it publishes — is written as a HIP under HIP-0139.

Four surfaces

SurfaceReaches this capability asCoverage
RESTwallet at its own prefix8 operations
CLIhanzo wallets …8 of 8
SDKno published client declares one yet — regenerating the clients is what adds them
MCPtool wallets on https://api.hanzo.ai/v1/mcp7 operations, 1 under the document's own id — ask describe for the rest

Quickstart

export HANZO_API_KEY=sk-...   # console.hanzo.ai → API keys

Then the first call — a read that needs nothing but the key. GET /v1/wallet, operation get_wallet:

hanzo wallets list

Answers 200 with object — ok.

Endpoints

EndpointWhat it does
POST /v1/wallet/{id}/keysRolls one wallet's signing material through its own custody backend and answers the wallet with whatever address that produced.
POST /v1/wallet/{id}/signProduces a secp256k1 signature from one of the caller org's wallets over a 32-byte digest, through whichever custody backend that wallet uses.
POST /v1/wallet/{id}/transactionsComposes a Safe transaction on the MPC ring and answers its EIP-712 hash together with the owner approval the ring's threshold signature produced.
GET /v1/wallet/{id}Returns one of the caller org's wallets: its scope, custody kind, tier, chain and on-chain address.
GET /v1/wallet/accountsReturns the caller org's wallet accounts, newest first.
POST /v1/wallet/accountsOpens a named wallet account for the caller's org.
GET /v1/walletReturns the caller org's wallets, newest first, optionally NARROWED within the org by project, agent or account.
POST /v1/walletProvisions a new signing identity under one of the caller org's accounts and answers the stored wallet including its on-chain address.

All Hanzo APIs · Interactive reference

How is this guide?

On this page