Hanzo

Validator

Package validators is one-click validator onboarding: prove your Genesis NFT, get a node provisioned, queue its registration.

Package validators is one-click validator onboarding: prove your Genesis NFT, get a node provisioned, queue its registration.

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

Specification

Specification pending — no HIP in hanzoai/hips declares capability: validator 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
RESTvalidator at its own prefix4 operations
CLIhanzo validators …4 of 4
SDKno published client declares one yet — regenerating the clients is what adds them
MCPtool validators on https://api.hanzo.ai/v1/mcp4 operations, 2 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/validator, operation get_validator:

hanzo validators list

Answers 200 with object — ok.

Endpoints

EndpointWhat it does
GET /v1/validator/{tokenId}Returns one claimed validator slot, scoped to the caller's org.
GET /v1/validator/challengeIssues the single-use nonce and the exact message a wallet must sign to claim a validator slot.
GET /v1/validatorReturns the validator slots the caller's org has claimed.
POST /v1/validatorClaims a validator slot and provisions its node, after proving the caller's wallet owns the slot's NFT.

All Hanzo APIs · Interactive reference

How is this guide?

On this page