Hanzo Improvement Proposals (HIPs)

Hanzo Improvement Proposals (HIPs) are the primary mechanism for proposing new features, gathering community input, and documenting design decisions for the Hanzo AI ecosystem. This process ensures that changes to the Hanzo platform are transparently reviewed and achieve community consensus before implementation.

What is a HIP?

A Hanzo Improvement Proposal (HIP) is a design document that provides information to the Hanzo community about a proposed change to the system. HIPs serve as the formal pathway to introduce improvements and build agreement on their adoption. They are used for:

• Proposing new AI architectures, models, and infrastructure
• Defining standards for agent frameworks, protocols, and interfaces
• Collecting community input on platform design
• Documenting design decisions with pedagogical context (why we built what we built)

Quick Start

• New to HIPs? Begin with HIP-0000, the Hanzo AI Architecture overview
• Create a new HIP: copy docs/templates/hip-template.md to HIPs/hip-<NNNN>-<slug>.md, then run python3 scripts/lint-hips.py
• View all HIPs: See the complete index below

HIP Index

Number	Title	Type	Category	Status
HIP-0000	Hanzo AI Architecture & Framework	Meta	-	Living
HIP-0001	AI Token - Hanzo's Native Currency	Standards Track	Core	Final
HIP-0002	Hamiltonian Large Language Models (HLLMs) Specification	Standards Track	Core	Final
HIP-0003	Jin Multimodal AI Architecture	Standards Track	Core	Draft
HIP-0004	LLM Gateway - Unified AI Provider Interface	Standards Track	Interface	Final
HIP-0005	Post-Quantum Security for AI Infrastructure	Standards Track	Security	Final
HIP-0006	Per-User Fine-Tuning Architecture for Personalized AI	Standards Track	Core	Final
HIP-0007	Active Inference Integration for Hamiltonian LLMs	Standards Track	Core	Final
HIP-0008	HMM (Hanzo Market Maker) - Native DEX for AI Compute...	Standards Track	Core	Final
HIP-0009	Agent SDK - Multi-Agent Orchestration Framework	Standards Track	Core	Final
HIP-0010	Model Context Protocol (MCP) Integration Standards	Standards Track	Interface	Final
HIP-0014	Application Deployment Standard	Standards Track	Infrastructure	Final
HIP-0015	Computer Control Standard	Standards Track	Interface	Final
HIP-0018	Payment Processing Standard	Standards Track	Interface	Final
HIP-0019	Tensor Operations Standard	Standards Track	Core	Final
HIP-0020	Blockchain Node Standard	Standards Track	Core	Final
HIP-0024	Hanzo Sovereign L1 Chain Architecture	Standards Track	Core	Final
HIP-0025	Bot Agent Wallet & RPC Billing Protocol	Standards Track	Core	Final
HIP-0026	Identity & Access Management Standard	Standards Track	Infrastructure	Final
HIP-0027	Secrets Management Standard	Standards Track	Infrastructure	Draft
HIP-0033	Container Registry Standard	Standards Track	Infrastructure	Draft
HIP-0036	CI/CD Build System Standard	Standards Track	Infrastructure	Final
HIP-0039	Zen Model Architecture	Standards Track	Core	Final
HIP-0040	Multi-Language SDK Standard	Standards Track	Interface	Final
HIP-0041	The Hanzo CLI — a Projection of the Served API	Standards Track	Interface	Final
HIP-0043	Hanzo Engine — LLM Inference Engine Standard	Standards Track	Core	Final
HIP-0045	Documentation Framework Standard	Standards Track	Interface	Final
HIP-0049	DNS Service Standard	Standards Track	Infrastructure	Final
HIP-0050	Hanzo Edge — Edge AI Runtime Standard	Standards Track	Infrastructure	Final
HIP-0060	Serverless Functions (FaaS) Standard	Standards Track	Infrastructure	Final
HIP-0061	Notification & Messaging Service Standard	Standards Track	Interface	Final
HIP-0063	Feature Flags Standard	Standards Track	Interface	Final
HIP-0065	Backup & Disaster Recovery Standard	Standards Track	Infrastructure	Final
HIP-0068	Ingress Standard	Standards Track	Infrastructure	Final
HIP-0069	Service Discovery & Auto-Bridge	Standards Track	Infrastructure	Final
HIP-0074	Software Bill of Materials & Git Stamp Standard	Standards Track	Infrastructure	Final
HIP-0077	Mesh Identity, Gossip & Payments (PQ)	Standards Track	Infrastructure	Final
HIP-0078	Z-Chain — Post-Quantum Identity & Attestation Rollup	Standards Track	Infrastructure	Draft
HIP-0079	Q-Chain — Quasar Finality Block Standard	Standards Track	Infrastructure	Final
HIP-0084	Pulsar-M — Threshold ML-DSA DKG & Signing	Standards Track	Cryptography	Final
HIP-0085	Wallet PQ Account Type (ML-DSA-65 native, 48-byte Ac...	Standards Track	Cryptography	Final
HIP-0086	TxAuthEnvelope (typed PQ transaction signing)	Standards Track	Cryptography	Final
HIP-0087	PQ Permit (replaces EIP-2612)	Standards Track	Cryptography	Final
HIP-0088	Session KEM (ML-KEM-768/1024 for P2P)	Standards Track	Cryptography	Final
HIP-0089	DRBG / Randomness Beacon (SP 800-90A/B)	Standards Track	Cryptography	Final
HIP-0095	QoS Challenge System	Standards Track	Core	Draft
HIP-0096	AI Compute Contribution Rewards	Standards Track	Core	Final
HIP-0097	Node Identity and the did:hanzo: DID Method	Standards Track	Core	Final
HIP-0098	Governance / Upgrade Keys (ML-DSA-87 / SLH-DSA cold ...	Standards Track	Cryptography	Final
HIP-0101	Hanzo-Lux Bridge Protocol Integration	Standards Track	Bridge	Final
HIP-0102	Omnichain Bridge Integration	Standards Track	Bridge	Draft
HIP-0103	Bridge PQ-Only Profile	Standards Track	Infrastructure	Final
HIP-0104	Contract Auth via Z-Chain Proof	Standards Track	Infrastructure	Final
HIP-0105	In-Process Extension Runtime Standard	Standards Track	Infrastructure	Final
HIP-0106	The Hanzo Plugin Contract	Standards Track	Infrastructure	Final
HIP-0107	Streaming Replication over VFS	Standards Track	Infrastructure	Final
HIP-0108	On-Demand Subsystem Supervisor + Warm Pool	Standards Track	Infrastructure	Final
HIP-0109	Hanzo ML Cloud Toolkit	Standards Track	Infrastructure	Final
HIP-0111	Hanzo IAM Authentication Standard	Standards Track	Infrastructure	Draft
HIP-0113	Cognitive Sidecar & Hanzo Engine Provider Runtime fo...	Standards Track	Core	Final
HIP-0114	ZAP — Inter-VM Cognitive Transport for Thinking Chains	Standards Track	Core	Draft
HIP-0115	Hanzo Frontend Delivery	Standards Track	Infrastructure	Draft
HIP-0117	Cloud-in-a-Box — One Binary, Three Modes	Standards Track	Infrastructure	Final
HIP-0118	SuperAdmin & Tenant Isolation Model	Standards Track	Security	Final
HIP-0119	Hanzo Service Conventions	Standards Track	Infrastructure	Final
HIP-0120	ZAP-Native Transport & gRPC Elimination	Standards Track	Core	Final
HIP-0121	BYO Compute Fleet & Metered Billing	Standards Track	Core	Final
HIP-0122	zip — The ZAP-Native Application Server Core	Standards Track	Infrastructure	Final
HIP-0123	Visor — Fleet & Fabric Autoscaling Across Any Provider	Standards Track	Infrastructure	Final
HIP-0124	Bring-Your-Own Provider & AI — Unified Dashboard and...	Standards Track	Platform	Final
HIP-0125	Consensus-Backed Plugin-Placement Platform	Standards Track	Infrastructure	Final
HIP-0126	Integrations, Connectors & the Extension Runtime — O...	Standards Track	Interface	Final
HIP-0127	V8 · Open Edition — Architecture, Distribution & the...	Standards Track	Meta	Final
HIP-0128	Resource Surface Standard — Generated REST over ZAP	Standards Track	Core	Final
HIP-0129	Eval — A Score Over Model Output	Standards Track	Infrastructure	Final
HIP-0130	Open-Core Split — the Tenancy Line, the Composition ...	Standards Track	Core	Final
HIP-0132	One Telemetry Plane — One Endpoint, One Schema, Many...	Standards Track	Infrastructure	Final
HIP-0133	Entity Groups — Placement, Durability, Splitting and...	Standards Track	Core	Final
HIP-0134	One Process, One Socket, One Identity	Standards Track	Core	Final
HIP-0135	What Is Public	Process	Governance	Living
HIP-0136	One Secret, One Path	Standards Track	Infrastructure	Final
HIP-0137	One License	Process	Governance	Living
HIP-0139	Capability	Standards Track	Infrastructure	Final
HIP-0140	Proposing a Capability	Meta	Core	Living
HIP-0141	Substitution	Standards Track	Core	Final
HIP-0142	One Manifest, Five Kinds	Standards Track	Infrastructure	Draft
HIP-0200	Responsible AI Principles and Commitments	Meta	-	Living
HIP-0201	Model Risk Management	Meta	-	Living
HIP-0210	Safety Evaluation Framework	Meta	-	Living
HIP-0220	Bias Detection & Mitigation	Meta	-	Living
HIP-0230	AI Transparency & Explainability	Meta	-	Living
HIP-0240	AI Incident Response	Meta	-	Living
HIP-0250	Sustainability Standards Alignment Matrix	Meta	-	Living
HIP-0251	AI Compute Carbon Footprint	Meta	-	Living
HIP-0260	Efficient Model Practices	Meta	-	Living
HIP-0270	AI Supply Chain Responsibility	Meta	-	Living
HIP-0300	Unified MCP — one endpoint, and local servers that f...	Standards Track	Interface	Final
HIP-0301	Agent Runtime Protocols & Cross-Platform Parity	Standards Track	Core	Final
HIP-0302	Hanzo Replicate: Encrypted SQLite Durability for Bas...	Standards Track	Infrastructure	Final
HIP-0303	Hanzo adopts LP-0010: Brand Sovereignty and Federati...	Meta	Governance	Living
HIP-0305	esign: shared-DB tenancy via team-where, not file-pe...	Standards Track	Infrastructure	Draft
HIP-0306	AML Transaction Monitoring, Screening and Case Manag...	Standards Track	Infrastructure	Final
HIP-0400	Service CRD	Standards Track	Operator	Final
HIP-0401	Datastore CRD	Standards Track	Operator	Final
HIP-0402	SQL CRD	Standards Track	Operator	Final
HIP-0403	KV CRD	Standards Track	Operator	Final
HIP-0404	DocDB CRD	Standards Track	Operator	Final
HIP-0405	S3 CRD	Standards Track	Operator	Final
HIP-0406	DNS CRD	Standards Track	Operator	Final
HIP-0407	Base CRD	Standards Track	Operator	Final
HIP-0408	IAM CRD	Standards Track	Operator	Final
HIP-0409	KMS CRD	Standards Track	Operator	Final
HIP-0410	LLM CRD	Standards Track	Operator	Final
HIP-0411	Ingress CRD	Standards Track	Operator	Final
HIP-0412	Gateway CRD	Standards Track	Operator	Final
HIP-0413	MPC CRD	Standards Track	Operator	Final
HIP-0414	Network CRD	Standards Track	Operator	Final
HIP-0418	Indexer CRD	Standards Track	Operator	Final
HIP-0419	Explorer CRD	Standards Track	Operator	Final
HIP-0504	Unified Cross-Platform Design System	Standards Track	Interface	Final
HIP-0506	Hanzo Studio — Agentic Multi-Modal Creative Runtime	Standards Track	Application	Final
HIP-0510	Enso — Learned Per-Request Model Routing and the Rec...	Standards Track	Core	Final
HIP-0512	Experiment — The Evidence Plane	Standards Track	Infrastructure	Final
HIP-0516	Translate — One Endpoint, Two Tiers, Permissive Weights	Standards Track	Core	Final
HIP-0517	Branch Naming — main is the Trunk, Everywhere	Process	Meta	Living
HIP-0518	AML — The Obligation Plane	Standards Track	Interface	Final
HIP-0519	One Identity Boundary	Standards Track	Infrastructure	Final
HIP-0520	Serving Topology — Three Tiers, Horizontally Scalabl...	Standards Track	Infrastructure	Final
HIP-0521	Org Hierarchy	Standards Track	Security	Final
HIP-0522	The Context Graph — Edges, Decisions and Derivation ...	Standards Track	Core	Final
HIP-0523	Rooms — One Store, Two Views, Many Bridges	Standards Track	Core	Final
HIP-0524	The Personal Agent — What It May Send Without You	Standards Track	Core	Final
HIP-0525	Rendezvous — When Every Participant Is a Machine	Standards Track	Core	Draft
HIP-0901	Proof of AI (PoAI) — Native Execution Proofs, Canoni...	Standards Track	Core	Draft
HIP-0902	Proof of Code — Consensus over Git Refs	Standards Track	Core	Final
HIP-0903	The Agentic Company — Autonomous Firms on Hanzo	Informational	Meta	Final
HIP-1000	Author — A Royalty Bound to a Repository	Standards Track	Application	Final
HIP-1001	Books — The Double-Entry Ledger	Standards Track	Application	Final
HIP-1004	Licensing — Signed Tokens for Paid Binaries	Standards Track	Security	Final
HIP-1020	Chain Registry	Standards Track	Interface	Final
HIP-1021	Chain JSON-RPC Endpoint	Standards Track	Interface	Final
HIP-1022	Native Balance Reads	Standards Track	Interface	Final
HIP-1030	OpenAPI — The Served Contract	Standards Track	Interface	Final
HIP-1032	Errors — The Fault Lens	Standards Track	Interface	Final
HIP-1040	Appearance	Standards Track	Interface	Final
HIP-1041	Authz	Standards Track	Security	Final
HIP-1042	Avatar	Standards Track	Interface	Final
HIP-1043	CSRF	Standards Track	Security	Final
HIP-1044	Org Settings	Standards Track	Security	Final
HIP-1045	Orgs	Standards Track	Security	Final
HIP-1046	Risk	Standards Track	Application	Final
HIP-1047	Security Scanning	Standards Track	Security	Final
HIP-1048	Team	Standards Track	Application	Final
HIP-1049	Validator — A Token Redeemed for a Node	Standards Track	Infrastructure	Final
HIP-1060	Pubsub — The Tenant Endpoint on the Bus	Standards Track	Infrastructure	Final
HIP-1061	MQ — Queues and Streams	Standards Track	Infrastructure	Final
HIP-1062	Tasks — The Durable Run	Standards Track	Infrastructure	Final
HIP-1063	Auto — Flows That Run Themselves	Standards Track	Interface	Final
HIP-1064	Flow — The Canvas Plane	Standards Track	Interface	Final
HIP-1065	Connectors — A User's Own Credentials	Standards Track	Security	Final
HIP-1066	Channels — One Inbox	Standards Track	Interface	Final
HIP-1067	Destination — An Event Translated to a Sink	Standards Track	Interface	Final
HIP-1069	Tel — Numbers, Calls and Messages	Standards Track	Interface	Final
HIP-1100	Ad — Paid Placement Under a Campaign	Standards Track	Infrastructure	Final
HIP-1101	Allowance — The Free Lane's Ceiling	Standards Track	Infrastructure	Final
HIP-1102	Ask — The Grounded Answer	Standards Track	Interface	Final
HIP-1103	Audit — The Tamper-Evident Trail	Standards Track	Infrastructure	Final
HIP-1104	Base — The Hosted Backend	Standards Track	Infrastructure	Final
HIP-1105	Benchmark — The Measurement Arena	Standards Track	Infrastructure	Final
HIP-1106	Blueprint — The Priced Stack	Standards Track	Interface	Final
HIP-1107	Bot — A Run on a Surface	Standards Track	Infrastructure	Final
HIP-1110	Campaign — One Push Across Channels	Standards Track	Interface	Final
HIP-1111	Captable — Who Owns What	Standards Track	Interface	Final
HIP-1112	Catalog — Cross-Org Discovery	Standards Track	Interface	Final
HIP-1113	Cloudflare — The Per-Org Asset Plane	Standards Track	Infrastructure	Final
HIP-1114	Code — Search and Symbols	Standards Track	Infrastructure	Final
HIP-1115	Compliance — Verification of Record	Standards Track	Interface	Final
HIP-1116	Content — The Marketing Loop	Standards Track	Interface	Final
HIP-1117	Crawl — A Page as Markdown	Standards Track	Infrastructure	Final
HIP-1120	CRM — The Sales Pipeline	Standards Track	Interface	Final
HIP-1121	Dataroom — Documents Shared by Link	Standards Track	Interface	Final
HIP-1122	Deploy — The GitOps Plane	Standards Track	Infrastructure	Final
HIP-1123	Domain — Name Registration	Standards Track	Infrastructure	Final
HIP-1124	Engine — The Serving Runtime Lens	Standards Track	Infrastructure	Final
HIP-1125	Esign — Documents Out for Signature	Standards Track	Interface	Final
HIP-1126	Framework — The DocType Engine	Standards Track	Core	Final
HIP-1127	Gateway — Live Edge Policy	Standards Track	Infrastructure	Final
HIP-1130	Guide — The Launch Journey	Standards Track	Interface	Final
HIP-1131	Help — The Support Desk	Standards Track	Interface	Final
HIP-1132	Index — Full-Text Search	Standards Track	Infrastructure	Final
HIP-1133	Ingress — The Embedded Edge	Standards Track	Infrastructure	Final
HIP-1134	KMS — Secret Custody	Standards Track	Infrastructure	Final
HIP-1135	Legal — Documents Drafted, Signed and Filed	Standards Track	Interface	Final
HIP-1136	Marketing — Lifecycle Email	Standards Track	Interface	Final
HIP-1137	Marketplace — Listings and Installs	Standards Track	Interface	Final
HIP-1140	ML — Model Serving	Standards Track	Infrastructure	Final
HIP-1141	Pref — One Document Per Person	Standards Track	Interface	Final
HIP-1142	Prompt — A Named, Versioned Value	Standards Track	Interface	Final
HIP-1143	Referral — An Edge From Referrer to Referee	Standards Track	Interface	Final
HIP-1144	Registry — The Artifact Control Plane	Standards Track	Infrastructure	Final
HIP-1145	Research — The Experiment Record	Standards Track	Infrastructure	Final
HIP-1146	Sandbox — A Lease on Isolated Compute	Standards Track	Infrastructure	Final
HIP-1147	Search — Hybrid Retrieval	Standards Track	Interface	Final
HIP-1150	SEO — Search Visibility as Data	Standards Track	Interface	Final
HIP-1151	Settings — Per-Product Org Configuration	Standards Track	Infrastructure	Final
HIP-1152	Share — A Public URL for a Local Service	Standards Track	Infrastructure	Final
HIP-1153	Social — Publishing to Connected Channels	Standards Track	Interface	Final
HIP-1154	Sync — Two Endpoints Kept in Step	Standards Track	Infrastructure	Final
HIP-1155	Taxonomy — The Catalogue's Shape	Standards Track	Interface	Final
HIP-1156	Template — A Deploy Cut From a Catalog	Standards Track	Interface	Final
HIP-1160	Todo — The Work Item Board	Standards Track	Application	Final
HIP-1161	Wallet — Custody of Key Material	Standards Track	Core	Final
HIP-1162	World — The News Feed	Standards Track	Application	Final
HIP-1163	x402 — Pay Per Request	Standards Track	Core	Final
HIP-1164	Provisioning — Stores on Demand	Standards Track	Core	Final
HIP-1165	S3 — Buckets and Objects	Standards Track	Core	Final
HIP-1167	Dataset — An Immutable Snapshot	Standards Track	Core	Final
HIP-1172	visor — Compute You Rent	Standards Track	Infrastructure	Final
HIP-1173	Network — An Org-Scoped Overlay	Standards Track	Infrastructure	Final
HIP-1180	Link — A Record of Provider Accounts	Standards Track	Core	Final
HIP-1181	Plan — The Tier Catalog	Standards Track	Core	Final
HIP-1189	Web3 — Chain Access	Standards Track	Core	Final
HIP-1190	Event — The Product Analytics Plane	Standards Track	Core	Final
HIP-1198	Graph — The Assertion Plane	Standards Track	Infrastructure	Final
HIP-1200	Account — The Caller's Own Surface	Standards Track	Application	Final
HIP-1201	Admission — Launch Control	Standards Track	Platform	Final
HIP-1202	Entitlement — What an Org May Run	Standards Track	Platform	Final
HIP-1203	Affiliate — Commission on Referred Spend	Standards Track	Application	Final
HIP-1210	Agents — Define, Run, Keep the Run	Standards Track	Application	Final
HIP-1211	AI — The Model API	Standards Track	Infrastructure	Final
HIP-1212	Exec — The Code Interpreter	Standards Track	Infrastructure	Final
HIP-1213	Tools — The Tool Plane	Standards Track	Infrastructure	Final
HIP-1214	LSP — Live Code Intelligence	Standards Track	Application	Final
HIP-1220	Commerce — The Merchant Half	Standards Track	Application	Final
HIP-1221	Treasury — The Reserve Fund	Standards Track	Application	Final
HIP-1222	Pricing — The Price List and Who May See It	Standards Track	Platform	Final
HIP-1230	Platform — The Container Plane	Standards Track	Infrastructure	Final
HIP-1231	Projects — The Site Store	Standards Track	Application	Final
HIP-1232	Git — Repository Hosting	Standards Track	Infrastructure	Final
HIP-1240	O11y — The Observability Plane	Standards Track	Infrastructure	Final
HIP-1241	Metrics — One Native Store, Three Signals	Standards Track	Infrastructure	Final
HIP-1242	Leaderboard — Who Uses AI Most	Standards Track	Application	Final
HIP-1250	Integrations — The Connection Registry	Standards Track	Infrastructure	Final
HIP-1251	Websearch — The Live Web	Standards Track	Infrastructure	Final
HIP-1252	Meet — The Join Decision	Standards Track	Infrastructure	Final
HIP-1253	Explorer — Chain Data	Standards Track	Infrastructure	Final
HIP-1260	Knowledge — Wiki and Agent Memory	Standards Track	Application	Final
HIP-1261	Label — Ground Truth	Standards Track	Application	Final
HIP-1262	Reference — Lookup Sets	Standards Track	Application	Final
HIP-1310	Webhook — Delivery to an Endpoint You Own	Standards Track	Infrastructure	Final
HIP-1311	Experiment — Arms, Assignment, a Verdict	Standards Track	Interface	Final
HIP-1312	Company — The Formation Machine	Standards Track	Application	Final
HIP-1313	Usage — The Metered Record	Standards Track	Infrastructure	Final
HIP-1320	Admin — The Operator Console	Standards Track	Infrastructure	Final
HIP-1321	DNS — Zones and Records	Standards Track	Infrastructure	Final
HIP-1322	Skills — The Discovery Catalogue	Standards Track	Interface	Final
HIP-1323	Kafka — A Wire Onto the One Bus	Standards Track	Infrastructure	Final
HIP-1324	KV — Buckets of Versioned Values	Standards Track	Infrastructure	Final
HIP-1325	Node — A Machine an Org Owns	Standards Track	Infrastructure	Final
HIP-1326	AMQP — Exchanges, Queues and Bindings Onto the One Bus	Standards Track	Infrastructure	Final

HIP Process

1. Have an idea — check first whether the thing already has a HIP.
2. Draft it — copy docs/templates/hip-template.md. It lands as Draft.
3. Open a pull request — to hanzoai/hips.
4. Get reviewed — editors read it for completeness; the lint reads it for structure. Both must pass.
5. Build it. This is the step that moves the status, and the only one.
6. Mark it Final — once the thing it specifies exists in the code.

A status is a claim about the world, not a stage in a queue. Review and Last Call used to sit between 3 and 6 and told a reader nothing they could act on: a proposal under review is still one you cannot build against. They are gone.

Types of HIPs

scripts/lint-hips.py holds the machine copy of these three vocabularies and fails the build on any value outside them. This section and that file must agree.

• Standards Track: describes one thing we build and maintain. Exactly one public repository, and exactly one HIP for it. Requires a category.
• Process: how we work — numbering, branch names, what is public. Not 1:1 with a repository, and not expected to be.
• Meta: governance, principles, and commitments.
• Informational: guidance that normatively requires nothing.

Categories

Standards Track HIPs carry exactly one:

Core · Interface · Infrastructure · Security · Cryptography · Operator · Bridge · Governance · Meta · Application · Platform

Status

Three words. Each answers one question — can I rely on this? — and nothing else.

Status	Meaning
Draft	Proposed. Nothing implements it yet, or the document itself describes work still ahead. Argue with it; do not build against it.
Final	The thing it specifies exists in the code. The spec is settled — changing it takes a new HIP.
Living	A document that never finishes: governance and process, amended in place rather than replaced. Every Meta and Process HIP is one.

vocabulary.json is the machine copy. scripts/lint-hips.py, scripts/index.py and the doc site all read that file, so a status added there is a status they all know; a status written into a HIP that is not there fails the build.

Eight spellings came before these three, and every one of them is folded in vocabulary.json under folded. Three are worth stating here:

• Active meant two different things at once. On the four Meta and Process HIPs it meant living, which is a real category. On the other 48 it meant shipped, which is Final. One word doing two jobs is why the corpus disagreed with itself about 58 proposals.
• Review and Last Call described a queue, not a document.
• Superseded and Withdrawn kept dead documents alive in the index. A superseded HIP is now DELETED and its successor carries the text; LK001 refuses the deletion until every document that pointed at it points at the successor instead.

Resources

• Documentation: docs.hanzo.ai
• Discord: discord.gg/CJCyAsm9Vr
• GitHub: github.com/hanzoai
• Twitter: @hanzoai

License

All HIPs are released under CC0 1.0 Universal Public Domain Dedication.

---

Building the future of AI infrastructure, one proposal at a time.

Reading order

Every HIP by number is indexed below. This is the order it is learnable in, derived from the corpus rather than curated: a HIP's requires: names what a reader must already hold, so what the most HIPs require is what to read first. Regenerated by scripts/index.py.

Start here

	Required by
HIP-0000	—	Hanzo AI Architecture & Framework — the map
HIP-0139	126	Capability
HIP-0106	121	The Hanzo Plugin Contract
HIP-0026	120	Identity & Access Management Standard

Then the invariants

	Required by
HIP-0027	23	Secrets Management Standard
HIP-0001	16	AI Token - Hanzo's Native Currency
HIP-0119	15	Hanzo Service Conventions
HIP-0005	15	Post-Quantum Security for AI Infrastructure
HIP-0077	11	Mesh Identity, Gossip & Payments (PQ)
HIP-0135	10	What Is Public
HIP-0111	9	Hanzo IAM Authentication Standard
HIP-0084	9	Pulsar-M — Threshold ML-DSA DKG & Signing
HIP-0200	9	Responsible AI Principles and Commitments
HIP-0004	8	LLM Gateway - Unified AI Provider Interface
HIP-0079	8	Q-Chain — Quasar Finality Block Standard
HIP-0078	8	Z-Chain — Post-Quantum Identity & Attestation Rollup
HIP-0302	8	Hanzo Replicate: Encrypted SQLite Durability for Base Services
HIP-0114	7	ZAP — Inter-VM Cognitive Transport for Thinking Chains
HIP-0519	7	One Identity Boundary
HIP-0010	6	Model Context Protocol (MCP) Integration Standards
HIP-0036	6	CI/CD Build System Standard
HIP-0118	6	SuperAdmin & Tenant Isolation Model
HIP-0002	5	Hamiltonian Large Language Models (HLLMs) Specification
HIP-0018	5	Payment Processing Standard
HIP-0024	5	Hanzo Sovereign L1 Chain Architecture
HIP-0128	5	Resource Surface Standard — Generated REST over ZAP
HIP-0068	5	Ingress Standard
HIP-0085	5	Wallet PQ Account Type (ML-DSA-65 native, 48-byte AccountID)
HIP-0105	5	In-Process Extension Runtime Standard
HIP-0120	5	ZAP-Native Transport & gRPC Elimination
HIP-0201	5	Model Risk Management
HIP-0126	5	Integrations, Connectors & the Extension Runtime — One Registry, One Way

The capabilities

One capability, one HIP (HIP-0139). 122 of them, grouped as capabilities.yaml groups them.

Not yet grouped

HIP-0018 billing · HIP-0026 iam · HIP-0060 functions · HIP-0061 notify · HIP-0063 flags · HIP-0074 sbom · HIP-0129 eval · HIP-0516 translate · HIP-1000 author · HIP-1001 books · HIP-1004 licensing · HIP-1030 openapi · HIP-1041 authz · HIP-1046 risk · HIP-1047 security · HIP-1048 team · HIP-1049 validator · HIP-1060 pubsub · HIP-1061 mq · HIP-1062 tasks · HIP-1063 auto · HIP-1064 flow · HIP-1066 channels · HIP-1067 destination · HIP-1069 tel · HIP-1100 ad · HIP-1101 allowance · HIP-1102 ask · HIP-1103 audit · HIP-1104 base · HIP-1105 benchmark · HIP-1106 blueprint · HIP-1107 bot · HIP-1110 campaign · HIP-1111 captable · HIP-1112 catalog · HIP-1113 cloudflare · HIP-1114 code · HIP-1115 compliance · HIP-1116 content · HIP-1117 crawl · HIP-1120 crm · HIP-1121 dataroom · HIP-1122 deploy · HIP-1123 domain · HIP-1124 engine · HIP-1125 esign · HIP-1126 framework · HIP-1127 gateway · HIP-1130 guide · HIP-1131 help · HIP-1132 index · HIP-1133 ingress · HIP-1134 kms · HIP-1135 legal · HIP-1136 marketing · HIP-1137 marketplace · HIP-1140 ml · HIP-1141 pref · HIP-1142 prompt · HIP-1143 referral · HIP-1144 registry · HIP-1145 research · HIP-1146 sandbox · HIP-1147 search · HIP-1150 seo · HIP-1151 settings · HIP-1152 share · HIP-1153 social · HIP-1154 sync · HIP-1155 taxonomy · HIP-1156 template · HIP-1160 todo · HIP-1161 wallet · HIP-1162 world · HIP-1163 x402 · HIP-1164 provisioning · HIP-1165 s3 · HIP-1167 dataset · HIP-1172 visor · HIP-1173 network · HIP-1180 link · HIP-1181 plan · HIP-1189 web3 · HIP-1190 event · HIP-1198 graph · HIP-1200 account · HIP-1201 admission · HIP-1202 entitlement · HIP-1203 affiliate · HIP-1210 agents · HIP-1211 ai · HIP-1212 exec · HIP-1213 tools · HIP-1214 lsp · HIP-1220 commerce · HIP-1221 treasury · HIP-1222 pricing · HIP-1230 platform · HIP-1231 projects · HIP-1232 git · HIP-1240 o11y · HIP-1241 metrics · HIP-1242 leaderboard · HIP-1250 integrations · HIP-1251 websearch · HIP-1252 meet · HIP-1253 explorer · HIP-1260 knowledge · HIP-1261 label · HIP-1262 reference · HIP-1310 webhook · HIP-1311 experiment · HIP-1312 company · HIP-1313 usage · HIP-1320 admin · HIP-1321 dns · HIP-1322 skills · HIP-1323 kafka · HIP-1324 kv · HIP-1325 node · HIP-1326 amqp