Principal

The hanzo principal commands.

Also for this capability: API · CLI · MCP · SDKs

Serves an org as an economic principal: who it is, what it may pay, and which agents answer to it.

hanzo principal clearance list

Every command takes --json for the raw response and --help for its own flags. Sign in once with hanzo auth login; the commands below use that session, and the org they act in is the one it carries.

Command What it does

hanzo principal get Returns the caller's org as an economic principal, composed from the apps that own each fact: its legal entity and founders' identity verification (company), the W-9 or W-8 it certified (tax), its wallets (wallet), the agents that answer to it — spawned ones with the agent that spawned them — (agents), its screening against the OFAC, UN, EU and UK sanctions lists and the embargoed jurisdictions, run now, and what it still lacks to pay and be paid.

hanzo principal keys Publishes the keys attestations are signed with, as a JSON Web Key Set (RFC 7517; Ed25519 keys as RFC 8037 writes them).

Command	What it does
`hanzo principal get`	Returns the caller's org as an economic principal, composed from the apps that own each fact: its legal entity and founders' identity verification (company), the W-9 or W-8 it certified (tax), its wallets (wallet), the agents that answer to it — spawned ones with the agent that spawned them — (agents), its screening against the OFAC, UN, EU and UK sanctions lists and the embargoed jurisdictions, run now, and what it still lacks to pay and be paid.
`hanzo principal keys`	Publishes the keys attestations are signed with, as a JSON Web Key Set (RFC 7517; Ed25519 keys as RFC 8037 writes them).

Agents

Command	What it does
`hanzo principal agents get <ref>`	Attests which principal one of the caller's agents answers to: the org, the chain of agents that spawned it, and the same signed with the platform's key as a JWS (EdDSA) a verifier checks offline against GET /v1/principal/keys.

Clearance

Command	What it does
`hanzo principal clearance create`	Decides whether the caller's org may pay another org, BEFORE the payment: what must happen first, what must be withheld and why, what must be reported, by whom and when, and how the payment may settle net of withholding.
`hanzo principal clearance get <id>`	Reads one of the caller org's clearances, as it was decided.
`hanzo principal clearance list`	Lists the caller org's clearances, newest first, 200 at most; a payee narrows them.

Statements

Command	What it does
`hanzo principal statements get <id>`	Reads whether one statement the platform signed about an agent still stands: live, expired, or revoked and when.

Was this page useful?

Broken link or missing step? Drop it in #docs on Discord or open a PR.

PreviousExperiment NextTax