hip-0303

HIP-303: Hanzo adopts LP-0010: Brand Sovereignty and Federation Discovery. Status Active. Hanzo's own standard — read this before implementing against it.

HIP-0303: Hanzo adopts LP-0010: Brand Sovereignty and Federation Discovery

Abstract

Hanzo adopts LP-0010 verbatim. The Lux Proposal is the canonical spec for the schema, the per-org sovereignty rule, the white-label-by-fork model, the /.well-known/<appId>.json discovery endpoint (IETF RFC 8615), and the ConfigMap peer overlay. Hanzo's hanzoai/* repos carry only Hanzo brand data; HTTP federation discovery for Hanzo apps happens at /.well-known/<appId>.json per the shared spec.

This document records Hanzo-specific adoption details and the commit log; the normative text lives in LP-0010.

Hanzo-specific notes

• Canonical brand package: @hanzo/brand@1.3.0 (npm, source at ~/work/hanzo/brand). Deprecated alias @hanzoai/brand 404s on npm — do not use; any remaining references MUST migrate to @hanzo/brand.
• Hanzo subnet branding: the Hanzo subnet runs on the Lux primary network (chainId 36963). Hanzo apps that surface chain identity (block explorers, bridges) MAY display the chain name "Hanzo Mainnet" — chain identity is network metadata, not brand identity, and is therefore exempt from LP-0010's cross-brand pollution rule. The inverse also holds: Lux's canonical explorer displaying "Hanzo subnet" or a Hanzo chain logo is network metadata, not cross-brand pollution.
• Hanzo source-tree scope: hanzoai/* GitHub repos host Hanzo brand data only. No Lux / Zoo / Pars brand presets, k8s manifests, or federation peer URLs in source. Cross-org image references (ghcr.io/luxfi/node pulled as an upstream OSS dep) are exempt per LP-0010 §7.
• IAM white-labeling: hanzoai/iam is white-labeled by domain at runtime (same code, brand resolved from the JWKS issuer config) rather than by fork.

Reference implementation (Hanzo)

| Repo | Commit | Action | |------|--------|--------| | hanzoai/market | 29a77cb + da7008e | Bot Hub → Hanzo Market rebrand (145 files); only Hanzo + generic presets remain | | hanzoai/exchange | 56ae5c8 | @hanzoai/brand (404) → @hanzo/brand@1.3.0; Zoo→Hanzo cleanup (had been forked from Zoo) | | hanzoai/iam | 9a1fd61b | Cross-brand refs removed; added /.well-known/iam.json | | hanzoai/base-studio | c38131a | Added /.well-known/base.json | | @hanzo/brand | 1.3.0 | Canonical published Hanzo brand package |

See also

• LP-0010 — canonical spec
• ZIP-0031 — Zoo's adoption pointer
• HIP-0005 — Post-Quantum Security for AI Infrastructure
• HIP-0010 — Model Context Protocol (MCP) Integration Standards
• HIP-0014 — Application Deployment Standard
• IETF RFC 8615 — Well-Known URIs