Co-authored-by: Hanzo Dev <[email protected]>
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.mdtoHIPs/hip-<NNNN>-<slug>.md, then runpython3 scripts/lint-hips.py - View all HIPs: See the complete index below
HIP Index
status: is one word for a whole proposal, so it cannot say that Go has a thing and Rust does not. A HIP may also carry implementation-go, implementation-cpp, implementation-rust. An empty cell is not none — it means nobody has read that runtime yet, and the two are counted apart here.
| shipped | partial | none | not assessed | |
|---|---|---|---|---|
| Go | 143 | 41 | 3 | 92 |
| C++ | 1 | 2 | 0 | 276 |
| Rust | 10 | 30 | 1 | 238 |
| Number | Title | Type | Category | Status | Go | C++ | Rust |
|---|---|---|---|---|---|---|---|
| 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 — An Unbuilt Multimodal Model | Standards Track | Core | Draft | - | - | - |
| HIP-0004 | LLM Gateway - Unified AI Provider Interface | Standards Track | Interface | Final | shipped | - | - |
| HIP-0005 | Post-Quantum Security for AI Infrastructure | Standards Track | Security | Final | partial | - | partial |
| HIP-0006 | Per-User Fine-Tuning Architecture for Personalized AI | Standards Track | Core | Final | - | - | - |
| HIP-0007 | Active Inference — Local Beliefs, World Models and P... | Standards Track | Core | Final | - | - | partial |
| 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 | partial | - | - |
| HIP-0010 | Model Context Protocol (MCP) Integration Standards | Standards Track | Interface | Final | - | - | shipped |
| HIP-0014 | Application Deployment Standard | Standards Track | Infrastructure | Final | - | - | - |
| HIP-0015 | Computer Control Standard | Standards Track | Interface | Final | - | - | partial |
| HIP-0018 | Payment Processing Standard | Standards Track | Interface | Draft | - | - | - |
| HIP-0019 | Tensor Operations Standard | Standards Track | Core | Final | - | partial | partial |
| HIP-0020 | Blockchain Node Standard | Standards Track | Core | Final | - | - | partial |
| 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 | Draft | - | - | - |
| HIP-0027 | Secrets Management Standard | Standards Track | Infrastructure | Draft | partial | - | - |
| HIP-0033 | Container Registry Standard | Standards Track | Infrastructure | Final | partial | - | - |
| HIP-0036 | CI/CD Build System Standard | Standards Track | Infrastructure | Final | partial | - | - |
| HIP-0038 | Admin Console Standard | Standards Track | Interface | Draft | - | - | - |
| HIP-0039 | Zen — The Open-Weight Generative Family | Standards Track | Core | Final | - | - | - |
| HIP-0040 | Multi-Language SDK Standard | Standards Track | Interface | Final | shipped | - | partial |
| HIP-0041 | The Hanzo CLI — a Projection of the Served API | Standards Track | Interface | Final | - | - | shipped |
| HIP-0043 | Hanzo Engine — LLM Inference Engine Standard | Standards Track | Core | Final | - | shipped | shipped |
| HIP-0044 | Answer — Budget, Policy, Audit, Search, KB and Graph... | Standards Track | Interface | Draft | none | - | - |
| HIP-0045 | Documentation Framework Standard | Standards Track | Interface | Final | - | - | - |
| HIP-0049 | DNS Service Standard | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-0050 | Hanzo Edge — Edge AI Runtime Standard | Standards Track | Infrastructure | Final | - | - | partial |
| HIP-0053 | Visor Monitoring & Supervision Standard | Standards Track | Infrastructure | Draft | - | - | - |
| HIP-0054 | Zero Trust Architecture Standard | Standards Track | Security | Draft | - | - | - |
| HIP-0060 | Serverless Functions (FaaS) Standard | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-0061 | Notification & Messaging Service Standard | Standards Track | Interface | Draft | - | - | - |
| HIP-0063 | Feature Flags Standard | Standards Track | Interface | Final | shipped | - | - |
| HIP-0065 | Backup & Disaster Recovery Standard | Standards Track | Infrastructure | Final | - | - | - |
| HIP-0068 | Ingress Standard | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-0069 | ZAP Mesh — One Bus for Every Node | Standards Track | Infrastructure | Draft | - | - | partial |
| HIP-0074 | Software Bill of Materials & Git Stamp Standard | Standards Track | Infrastructure | Final | shipped | - | - |
| 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 | partial | - | - |
| HIP-0085 | Wallet PQ Account Type (ML-DSA-65 native, 48-byte Ac... | Standards Track | Cryptography | Final | shipped | - | - |
| HIP-0086 | TxAuthEnvelope (typed PQ transaction signing) | Standards Track | Cryptography | Final | shipped | - | - |
| HIP-0087 | PQ Permit (replaces EIP-2612) | Standards Track | Cryptography | Final | shipped | - | - |
| HIP-0088 | Session KEM (ML-KEM-768/1024 for P2P) | Standards Track | Cryptography | Final | shipped | - | none |
| 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 | partial | - | - |
| HIP-0105 | In-Process Extension Runtime Standard | Standards Track | Infrastructure | Final | shipped | - | partial |
| HIP-0106 | The Hanzo Plugin Contract | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-0107 | Streaming Replication over VFS | Standards Track | Infrastructure | Final | partial | - | - |
| HIP-0108 | On-Demand Subsystem Supervisor + Warm Pool | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-0109 | Hanzo ML Cloud Toolkit | Standards Track | Infrastructure | Final | - | - | - |
| HIP-0111 | Hanzo IAM Authentication Standard | Standards Track | Infrastructure | Final | - | - | partial |
| HIP-0113 | Cognitive Sidecar & Hanzo Engine Provider Runtime fo... | Standards Track | Core | Final | - | - | partial |
| HIP-0114 | ZAP — Inter-VM Cognitive Transport for Thinking Chains | Standards Track | Core | Draft | partial | - | partial |
| HIP-0115 | Hanzo Frontend Delivery | Standards Track | Infrastructure | Draft | - | - | - |
| HIP-0117 | Cloud-in-a-Box — One Binary, Three Modes | Standards Track | Infrastructure | Final | partial | - | - |
| HIP-0118 | SuperAdmin & Tenant Isolation Model | Standards Track | Security | Final | shipped | - | - |
| HIP-0119 | Hanzo Service Conventions | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-0120 | ZAP-Native Transport & gRPC Elimination | Standards Track | Core | Final | shipped | partial | shipped |
| HIP-0121 | BYO Compute Fleet & Metered Billing | Standards Track | Core | Final | - | - | - |
| HIP-0122 | zip — The ZAP-Native Application Server Core | Standards Track | Infrastructure | Final | shipped | - | - |
| 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 | partial | - | - |
| 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 | shipped | - | - |
| HIP-0129 | Eval — A Score Over Model Output | Standards Track | Infrastructure | Final | partial | - | - |
| HIP-0130 | Open-Core Split — the Tenancy Line, the Composition ... | Standards Track | Core | Final | partial | - | - |
| HIP-0132 | One Telemetry Plane — One Endpoint, One Schema, Many... | Standards Track | Infrastructure | Final | partial | - | partial |
| HIP-0133 | Entity Groups — Placement, Durability, Splitting and... | Standards Track | Core | Final | partial | - | - |
| HIP-0134 | One Process, One Socket, One Identity | Standards Track | Core | Final | shipped | - | - |
| HIP-0135 | What Is Public | Process | Governance | Living | - | - | - |
| HIP-0136 | One Secret, One Path | Standards Track | Infrastructure | Final | partial | - | - |
| HIP-0137 | One License | Process | Governance | Living | - | - | - |
| HIP-0139 | Capability | Standards Track | Infrastructure | Final | shipped | - | - |
| 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 | none | - | - |
| HIP-0143 | Egress — The Outbound Trust Boundary | Standards Track | Security | Final | shipped | - | - |
| HIP-0144 | Where State Lives | Standards Track | Infrastructure | Final | partial | - | - |
| 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 | shipped | - | partial |
| 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 | partial | - | - |
| 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 | Final | - | - | - |
| HIP-0306 | AML Transaction Monitoring, Screening and Case Manag... | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-0400 | Service CRD | Standards Track | Operator | Final | - | - | shipped |
| HIP-0401 | Datastore CRD | Standards Track | Operator | Final | - | - | shipped |
| HIP-0402 | SQL CRD | Standards Track | Operator | Final | - | - | shipped |
| HIP-0403 | KV CRD | Standards Track | Operator | Final | - | - | shipped |
| HIP-0404 | DocDB CRD | Standards Track | Operator | Final | - | - | partial |
| HIP-0405 | S3 CRD | Standards Track | Operator | Final | - | - | partial |
| HIP-0406 | DNS CRD | Standards Track | Operator | Final | - | - | partial |
| HIP-0407 | Base CRD | Standards Track | Operator | Final | - | - | partial |
| HIP-0408 | IAM CRD | Standards Track | Operator | Final | - | - | partial |
| HIP-0409 | KMS CRD | Standards Track | Operator | Final | - | - | partial |
| HIP-0410 | LLM CRD | Standards Track | Operator | Final | - | - | partial |
| HIP-0411 | Ingress CRD | Standards Track | Operator | Final | - | - | shipped |
| HIP-0412 | Gateway CRD | Standards Track | Operator | Final | partial | - | partial |
| HIP-0413 | MPC CRD | Standards Track | Operator | Final | - | - | partial |
| HIP-0414 | Network CRD | Standards Track | Operator | Final | partial | - | partial |
| HIP-0418 | Indexer CRD | Standards Track | Operator | Final | partial | - | partial |
| HIP-0419 | Explorer CRD | Standards Track | Operator | Final | partial | - | partial |
| HIP-0449 | hanzo-login | Informational | Application | 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 — The Router Family, Learned Per-Request Routin... | Standards Track | Core | Final | shipped | - | shipped |
| HIP-0511 | Model Families — Zen Generates, Enso Routes, Kai Dec... | Informational | Core | Living | - | - | - |
| HIP-0512 | Experiment — The Evidence Plane | Standards Track | Infrastructure | Final | partial | - | - |
| HIP-0516 | Translate — One Endpoint, Two Tiers, Permissive Weights | Standards Track | Core | Final | shipped | - | - |
| HIP-0517 | Branch Naming — main is the Trunk, Everywhere | Process | Meta | Living | - | - | - |
| HIP-0518 | AML — The Obligation Plane | Standards Track | Interface | Final | shipped | - | - |
| HIP-0519 | One Identity Boundary | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-0520 | Serving Topology — Three Tiers, Horizontally Scalabl... | Standards Track | Infrastructure | Final | partial | - | - |
| HIP-0521 | Org Hierarchy | Standards Track | Security | Final | - | - | - |
| HIP-0522 | The Context Graph — Edges, Decisions and Derivation ... | Standards Track | Core | Final | partial | - | - |
| HIP-0523 | Channels — One Store, Two Views, Many Bridges | Standards Track | Core | Final | partial | - | - |
| HIP-0524 | The Personal Agent — What It May Send Without You | Standards Track | Core | Final | partial | - | - |
| HIP-0525 | Rendezvous — When Every Participant Is a Machine | Standards Track | Core | Draft | - | - | - |
| HIP-0526 | Semantic Memory — The Substrate Under the Graph | Standards Track | Core | Draft | partial | - | - |
| HIP-0527 | Tenancy | Standards Track | Security | Draft | partial | - | - |
| HIP-0528 | Mods — The App SDK | Standards Track | Interface | Draft | none | - | - |
| HIP-0901 | Proof of AI (PoAI) — Native Execution Proofs, Canoni... | Standards Track | Core | Draft | - | - | partial |
| 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-0904 | Zen6 — Dense, Coder and Ternary Checkpoints | Standards Track | Core | Final | - | - | - |
| HIP-1000 | Author — A Royalty Bound to a Repository | Standards Track | Application | Final | shipped | - | - |
| HIP-1001 | Books — The Double-Entry Ledger | Standards Track | Application | Final | shipped | - | - |
| HIP-1004 | Licensing — Signed Tokens for Paid Binaries | Standards Track | Security | Final | shipped | - | - |
| HIP-1020 | Chain Registry | Standards Track | Interface | Final | shipped | - | - |
| HIP-1021 | Chain JSON-RPC Endpoint | Standards Track | Interface | Final | shipped | - | - |
| HIP-1022 | Native Balance Reads | Standards Track | Interface | Final | shipped | - | - |
| HIP-1030 | OpenAPI — The Served Contract | Standards Track | Interface | Final | shipped | - | - |
| HIP-1032 | Errors — The Fault Lens | Standards Track | Interface | Final | - | - | - |
| HIP-1040 | Appearance | Standards Track | Interface | Final | shipped | - | - |
| HIP-1041 | Authz | Standards Track | Security | Final | shipped | - | - |
| HIP-1042 | Avatar | Standards Track | Interface | Final | shipped | - | - |
| HIP-1043 | CSRF | Standards Track | Security | Final | shipped | - | - |
| HIP-1044 | Org Settings | Standards Track | Security | Final | shipped | - | - |
| HIP-1045 | Orgs | Standards Track | Security | Final | shipped | - | - |
| HIP-1046 | Risk | Standards Track | Application | Final | shipped | - | - |
| HIP-1047 | Security Scanning | Standards Track | Security | Final | shipped | - | - |
| HIP-1048 | Team | Standards Track | Application | Final | shipped | - | - |
| HIP-1049 | Validator — A Token Redeemed for a Node | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1060 | Pubsub — The Tenant Endpoint on the Bus | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1061 | MQ — Queues and Streams | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1062 | Workflow — The Durable Run | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1063 | Auto — Flows That Run Themselves | Standards Track | Interface | Final | partial | - | - |
| HIP-1064 | Flow — The Canvas Plane | Standards Track | Interface | Final | shipped | - | - |
| HIP-1065 | Connectors — A User's Own Credentials | Standards Track | Security | Final | shipped | - | - |
| HIP-1066 | Transport — One Inbox | Standards Track | Interface | Final | partial | - | - |
| HIP-1067 | Destination — An Event Translated to a Sink | Standards Track | Interface | Final | shipped | - | - |
| HIP-1069 | Tel — Numbers, Calls and Messages | Standards Track | Interface | Final | shipped | - | - |
| HIP-1100 | Ad — Paid Placement Under a Campaign | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1101 | Allowance — The Free Lane's Ceiling | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1102 | Ask — The Grounded Answer | Standards Track | Interface | Final | shipped | - | - |
| HIP-1103 | Audit — The Tamper-Evident Trail | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1104 | Base — The Hosted Backend | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1105 | Benchmark — The Measurement Arena | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1106 | Blueprint — The Priced Stack | Standards Track | Interface | Final | shipped | - | - |
| HIP-1107 | Bot — A Run on a Surface | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1110 | Campaign — One Push Across Channels | Standards Track | Interface | Final | shipped | - | - |
| HIP-1111 | Captable — Who Owns What | Standards Track | Interface | Final | shipped | - | - |
| HIP-1112 | Catalog — Cross-Org Discovery | Standards Track | Interface | Final | shipped | - | - |
| HIP-1113 | Cloudflare — The Per-Org Asset Plane | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1114 | Code — Search and Symbols | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1115 | Compliance — Verification of Record | Standards Track | Interface | Final | shipped | - | - |
| HIP-1116 | Content — The Marketing Loop | Standards Track | Interface | Final | shipped | - | - |
| HIP-1117 | Crawl — A Page as Markdown | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1120 | CRM — The Sales Pipeline | Standards Track | Interface | Final | partial | - | - |
| HIP-1121 | Dataroom — Documents Shared by Link | Standards Track | Interface | Final | shipped | - | - |
| HIP-1122 | Deploy — The GitOps Plane | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1123 | Domain — Name Registration | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1124 | Engine — The Serving Runtime Lens | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1125 | Esign — Documents Out for Signature | Standards Track | Interface | Final | shipped | - | - |
| HIP-1126 | Framework — The DocType Engine | Standards Track | Core | Final | shipped | - | - |
| HIP-1127 | Gateway — Live Edge Policy | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1130 | Guide — The Launch Journey | Standards Track | Interface | Final | shipped | - | - |
| HIP-1131 | Help — The Support Desk | Standards Track | Interface | Final | shipped | - | - |
| HIP-1132 | Index — Full-Text Search | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1133 | Ingress — The Embedded Edge | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1134 | KMS — Secret Custody | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1135 | Legal — Documents Drafted, Signed and Filed | Standards Track | Interface | Final | shipped | - | - |
| HIP-1136 | Marketing — Lifecycle Email | Standards Track | Interface | Final | shipped | - | - |
| HIP-1137 | Marketplace — Listings and Installs | Standards Track | Interface | Final | partial | - | - |
| HIP-1140 | ML — Model Serving | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1141 | Pref — One Document Per Person | Standards Track | Interface | Final | shipped | - | - |
| HIP-1142 | Prompt — A Named, Versioned Value | Standards Track | Interface | Final | shipped | - | - |
| HIP-1143 | Referral — An Edge From Referrer to Referee | Standards Track | Interface | Final | shipped | - | - |
| HIP-1144 | Registry — The Artifact Control Plane | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1145 | Research — The Experiment Record | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1146 | Sandbox — A Lease on Isolated Compute | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1147 | Search — Hybrid Retrieval | Standards Track | Interface | Final | partial | - | - |
| HIP-1150 | SEO — Search Visibility as Data | Standards Track | Interface | Final | shipped | - | - |
| HIP-1151 | Settings — Per-Product Org Configuration | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1152 | Share — A Public URL for a Local Service | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1153 | Social — Publishing to Connected Transports | Standards Track | Interface | Final | shipped | - | - |
| HIP-1154 | Sync — Two Endpoints Kept in Step | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1155 | Taxonomy — The Catalogue's Shape | Standards Track | Interface | Final | shipped | - | - |
| HIP-1156 | Template — A Deploy Cut From a Catalog | Standards Track | Interface | Final | shipped | - | - |
| HIP-1160 | Task — The Work Item Board | Standards Track | Application | Final | shipped | - | - |
| HIP-1161 | Wallet — Custody of Key Material | Standards Track | Core | Final | shipped | - | - |
| HIP-1162 | World — The News Feed | Standards Track | Application | Final | shipped | - | - |
| HIP-1163 | x402 — Pay Per Request | Standards Track | Core | Final | shipped | - | - |
| HIP-1164 | Provisioning — Stores on Demand | Standards Track | Core | Final | shipped | - | - |
| HIP-1165 | S3 — Buckets and Objects | Standards Track | Core | Final | shipped | - | - |
| HIP-1167 | Dataset — An Immutable Snapshot | Standards Track | Core | Final | shipped | - | - |
| HIP-1172 | Compute — Machines You Rent or Link | Standards Track | Infrastructure | Draft | partial | - | - |
| HIP-1173 | Network — An Org-Scoped Overlay | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1180 | Link — A Record of Provider Accounts | Standards Track | Core | Final | shipped | - | - |
| HIP-1181 | Plan — The Tier Catalog | Standards Track | Core | Final | partial | - | - |
| HIP-1189 | Web3 — Chain Access | Standards Track | Core | Final | shipped | - | - |
| HIP-1190 | Event — The Product Analytics Plane | Standards Track | Core | Final | shipped | - | - |
| HIP-1198 | Graph — The Assertion Plane | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1200 | Account — The Caller's Own Surface | Standards Track | Application | Final | shipped | - | - |
| HIP-1201 | Admission — Launch Control | Standards Track | Platform | Final | shipped | - | - |
| HIP-1202 | Entitlement — What an Org May Run | Standards Track | Platform | Final | shipped | - | - |
| HIP-1203 | Affiliate — Commission on Referred Spend | Standards Track | Application | Final | shipped | - | - |
| HIP-1210 | Agents — Define, Run, Keep the Run | Standards Track | Application | Final | shipped | - | - |
| HIP-1211 | AI — The Model API | Standards Track | Infrastructure | Draft | partial | - | - |
| HIP-1212 | Exec — The Code Interpreter | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1213 | Tools — The Tool Plane | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1214 | LSP — Live Code Intelligence | Standards Track | Application | Final | shipped | - | - |
| HIP-1220 | Commerce — The Merchant Half | Standards Track | Application | Final | partial | - | - |
| HIP-1221 | Treasury — The Reserve Fund | Standards Track | Application | Final | shipped | - | - |
| HIP-1222 | Pricing — The Price List and Who May See It | Standards Track | Platform | Final | shipped | - | - |
| HIP-1230 | Platform — The Container Plane | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1231 | Projects — The Site Store | Standards Track | Application | Final | shipped | - | - |
| HIP-1232 | Git — Repository Hosting | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1240 | O11y — The Observability Plane | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1241 | Metrics — One Native Store, Three Signals | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1242 | Leaderboard — Who Uses AI Most | Standards Track | Application | Final | shipped | - | - |
| HIP-1250 | Integrations — The Connection Registry | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1251 | Websearch — The Live Web | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1252 | Meet — The Join Decision | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1253 | Explorer — Chain Data | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1260 | Knowledge — Wiki and Agent Memory | Standards Track | Application | Final | shipped | - | - |
| HIP-1261 | Label — Ground Truth | Standards Track | Application | Final | shipped | - | - |
| HIP-1262 | Reference — Lookup Sets | Standards Track | Application | Final | shipped | - | - |
| HIP-1310 | Webhook — Delivery to an Endpoint You Own | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1311 | Experiment — Arms, Assignment, a Verdict | Standards Track | Interface | Final | shipped | - | - |
| HIP-1312 | Company — The Formation Machine | Standards Track | Application | Final | shipped | - | - |
| HIP-1313 | Usage — The Metered Record | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1320 | Admin — The Operator Console | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1321 | DNS — Zones and Records | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1322 | Skills — The Discovery Catalogue | Standards Track | Interface | Final | shipped | - | - |
| HIP-1323 | Kafka — A Wire Onto the One Bus | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1324 | KV — Buckets of Versioned Values | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1325 | Node — A Machine an Org Owns | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1326 | AMQP — Exchanges, Queues and Bindings Onto the One Bus | Standards Track | Infrastructure | Final | shipped | - | - |
| HIP-1327 | Public Channels — Finding a Channel in Another Org | Standards Track | Core | Draft | - | - | - |
| HIP-1328 | Forge — The Meta Code Host | Standards Track | Infrastructure | Draft | - | - | - |
| HIP-1330 | Dev — The Agent Loop | Standards Track | Infrastructure | Draft | partial | - | - |
| HIP-1331 | Patrol — Standing Watch Over an Estate | Standards Track | Application | Final | shipped | - | - |
| HIP-1332 | Kai — The Decision Model and the Decision Plane | Standards Track | Core | Draft | - | - | partial |
| HIP-1333 | Train — One Endpoint for Training | Standards Track | Infrastructure | Draft | partial | - | partial |
| HIP-1334 | Research — The Unified Research Runtime | Standards Track | Infrastructure | Draft | partial | - | partial |
HIP Process
- Have an idea — check first whether the thing already has a HIP.
- Draft it — copy
docs/templates/hip-template.md. It lands asDraft. - Open a pull request — to hanzoai/hips.
- Get reviewed — editors read it for completeness; the lint reads it for structure. Both must pass.
- Build it. This is the step that moves the status, and the only one.
- 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:
Activemeant two different things at once. On the fourMetaandProcessHIPs it meant living, which is a real category. On the other 48 it meant shipped, which isFinal. One word doing two jobs is why the corpus disagreed with itself about 58 proposals.ReviewandLast Calldescribed a queue, not a document.SupersededandWithdrawnkept dead documents alive in the index. A superseded HIP is now DELETED and its successor carries the text;LK001refuses 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.
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 | 131 | Capability |
| HIP-0026 | 129 | Identity & Access Management Standard |
| HIP-0106 | 126 | The Hanzo Plugin Contract |
Then the invariants
| Required by | ||
|---|---|---|
| HIP-0027 | 24 | Secrets Management Standard |
| HIP-0119 | 17 | Hanzo Service Conventions |
| HIP-0005 | 15 | Post-Quantum Security for AI Infrastructure |
| HIP-0001 | 14 | AI Token - Hanzo's Native Currency |
| HIP-0111 | 14 | Hanzo IAM Authentication Standard |
| HIP-0135 | 11 | What Is Public |
| HIP-0077 | 11 | Mesh Identity, Gossip & Payments (PQ) |
| HIP-0118 | 10 | SuperAdmin & Tenant Isolation Model |
| 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 | 8 | ZAP — Inter-VM Cognitive Transport for Thinking Chains |
| HIP-0519 | 8 | One Identity Boundary |
| HIP-0010 | 6 | Model Context Protocol (MCP) Integration Standards |
| HIP-0120 | 6 | ZAP-Native Transport & gRPC Elimination |
| HIP-0036 | 6 | CI/CD Build System Standard |
| HIP-0105 | 6 | In-Process Extension Runtime Standard |
| HIP-0126 | 6 | Integrations, Connectors & the Extension Runtime — One Registry, One Way |
| HIP-0043 | 5 | Hanzo Engine — LLM Inference Engine Standard |
| 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-0085 | 5 | Wallet PQ Account Type (ML-DSA-65 native, 48-byte AccountID) |
| HIP-0201 | 5 | Model Risk Management |
The capabilities
One capability, one HIP (HIP-0139). 121 of them, grouped as capabilities.yaml groups them.
Identity & Trust — who you are · what you may touch · where secrets live
HIP-1041 authz · HIP-1046 risk · HIP-1047 security · HIP-1048 team · HIP-1049 validator · HIP-1103 audit · HIP-1115 compliance · HIP-1134 kms · HIP-1161 wallet · HIP-1167 dataset · HIP-1200 account · HIP-1202 entitlement · HIP-1261 label · HIP-1262 reference
Intelligence — models · agent · evaluation — the mind of the cloud
HIP-0129 eval · HIP-0516 translate · HIP-1102 ask · HIP-1105 benchmark · HIP-1114 code · HIP-1124 engine · HIP-1140 ml · HIP-1142 prompt · HIP-1146 sandbox · HIP-1211 ai · HIP-1212 exec · HIP-1214 lsp
Data — the stores every capability writes to and reads from
HIP-1104 base · HIP-1112 catalog · HIP-1117 crawl · HIP-1132 index · HIP-1147 search · HIP-1154 sync · HIP-1155 taxonomy · HIP-1164 provisioning · HIP-1165 s3 · HIP-1198 graph · HIP-1251 websearch · HIP-1260 knowledge · HIP-1324 kv
Streams — messaging · durable tasks · async orchestration
HIP-1060 pubsub · HIP-1061 mq · HIP-1062 workflow · HIP-1063 auto · HIP-1064 flow · HIP-1067 destination · HIP-1069 tel · HIP-1190 event · HIP-1310 webhook
Observability — see everything — telemetry · analytics · usage
HIP-1240 o11y · HIP-1241 metrics · HIP-1242 leaderboard · HIP-1313 usage
Commerce — the economy — meter · price · bill · reward
HIP-1000 author · HIP-1001 books · HIP-1004 licensing · HIP-1100 ad · HIP-1101 allowance · HIP-1110 campaign · HIP-1111 captable · HIP-1136 marketing · HIP-1137 marketplace · HIP-1143 referral · HIP-1163 x402 · HIP-1181 plan · HIP-1203 affiliate · HIP-1220 commerce · HIP-1221 treasury · HIP-1222 pricing · HIP-1311 experiment
Platform — the cloud fabric — deploy · provision · route · host
HIP-1113 cloudflare · HIP-1122 deploy · HIP-1123 domain · HIP-1127 gateway · HIP-1133 ingress · HIP-1144 registry · HIP-1172 compute · HIP-1173 network · HIP-1230 platform · HIP-1321 dns · HIP-1325 node
Applications — the user-facing surfaces built on all of the above
HIP-0074 sbom · HIP-1106 blueprint · HIP-1107 bot · HIP-1116 content · HIP-1121 dataroom · HIP-1125 esign · HIP-1126 framework · HIP-1130 guide · HIP-1131 help · HIP-1135 legal · HIP-1141 pref · HIP-1150 seo · HIP-1151 settings · HIP-1152 share · HIP-1153 social · HIP-1156 template · HIP-1160 task · HIP-1162 world · HIP-1180 link · HIP-1232 git · HIP-1252 meet · HIP-1312 company · HIP-1331 patrol
Chain — the networks the cloud speaks to — enumerate · call · read balances
HIP-1189 web3 · HIP-1253 explorer
Not yet grouped
HIP-0060 functions · HIP-0063 flags · HIP-1066 channels · HIP-1145 research · HIP-1201 admission · HIP-1210 agents · HIP-1213 tools · HIP-1231 projects · HIP-1250 integrations · HIP-1320 admin · HIP-1322 skills · HIP-1323 kafka · HIP-1326 amqp · HIP-1330 dev · HIP-1332 decisions · HIP-1333 train