HIPsHanzo Proposals
Back to HIPs
HIP-195FinalMetaGovernance

Hanzo adopts LP-0010: Brand Sovereignty and Federation Discovery

Zach Kelling ([email protected])
Created: 2026-05-29
brandwhite-labelfederationgovernancepointer
Requires: HIP-HIP-0014, HIP-0018

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/[email protected] (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)

RepoCommitAction
hanzoai/market29a77cb + da7008eBot Hub → Hanzo Market rebrand (145 files); only Hanzo + generic presets remain
hanzoai/exchange56ae5c8@hanzoai/brand (404) → @hanzo/[email protected]; Zoo→Hanzo cleanup (had been forked from Zoo)
hanzoai/iam9a1fd61bCross-brand refs removed; added /.well-known/iam.json
hanzoai/base-studioc38131aAdded /.well-known/base.json
@hanzo/brand1.3.0Canonical published Hanzo brand package

See also

  • LP-0010 — canonical spec
  • ZIP-0031 — Zoo's adoption pointer
  • HIP-0304 — onchain registry sibling (adopts LP-0011)
  • 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
Edit on GitHubView Raw