mirror of
https://github.com/hanzoai/skills.git
synced 2026-11-19 00:47:36 +00:00
hanzoskills.com/llms.txt now opens with the install line, the API reference index and the company index, so an agent that lands on any one of the three can find the rest. robots.txt claimed 537 documents while llms.txt counts 920. The number is gone from robots.txt; llms.txt derives it. public/ is regenerated from scripts/site.py, which it had fallen behind: the copy-prompt menu and agent bar were in the generator and not in the committed pages. tests/site.mjs passes against the result. Co-authored-by: Hanzo Dev <[email protected]>
331 lines
22 KiB
HTML
331 lines
22 KiB
HTML
<!doctype html>
|
|
<html lang="en"><head>
|
|
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
|
|
<title>hip-0079</title>
|
|
<meta name="color-scheme" content="dark">
|
|
<style>
|
|
/* Committed to one visual world: a dark instrument panel. No light variant —
|
|
the dot field and the hairline rules only read on black, and a naive
|
|
inversion would wash both out. Every colour is painted explicitly so the page
|
|
never borrows a host background. */
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
|
|
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
|
|
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
|
|
|
|
:root{
|
|
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
|
|
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
|
|
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
|
|
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
|
|
--font-zen-pixel-square:'Zen Pixel Square',monospace;
|
|
--mono:var(--font-zen-mono);
|
|
--sans:var(--font-zen-sans);
|
|
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
|
|
--r:999px; --r-soft:14px;
|
|
}
|
|
*{box-sizing:border-box}
|
|
html{-webkit-text-size-adjust:100%}
|
|
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
|
|
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
|
|
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
|
|
|
|
/* The dot field. A halftone made of one repeating radial-gradient, faded out
|
|
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
|
|
/* No overflow clip here: the dot field is inset to the box already, and a clip
|
|
would cut off the copy-prompt menu. */
|
|
.hero{position:relative;border-bottom:1px solid var(--line)}
|
|
.hero::before{content:"";position:absolute;inset:0;
|
|
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
|
|
background-size:7px 7px;
|
|
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
|
|
pointer-events:none}
|
|
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
|
|
|
|
nav{border-bottom:1px solid var(--line)}
|
|
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
|
|
justify-content:space-between;align-items:center;gap:1rem}
|
|
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--ink);text-decoration:none;
|
|
display:inline-flex;align-items:center;gap:.6rem}
|
|
.brand i{font-style:normal;color:var(--faint)}
|
|
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
|
|
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
|
|
text-transform:uppercase;color:var(--soft);text-decoration:none}
|
|
nav a.up:hover{color:var(--ink)}
|
|
|
|
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
|
|
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
|
|
h1 em{font-style:normal;color:var(--faint)}
|
|
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
|
|
|
|
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
|
|
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
|
|
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
|
|
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
|
|
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
|
|
line-height:1.2;font-weight:400}
|
|
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
|
|
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
|
|
.btn.solid:hover{background:#d8d8d4}
|
|
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
|
|
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
|
|
|
|
/* Copy-prompt selector. Each row copies the prompt for its own target. */
|
|
.copy{position:relative;display:inline-flex}
|
|
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
|
|
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
|
|
padding:.4rem;display:flex;flex-direction:column;
|
|
box-shadow:0 12px 32px rgba(0,0,0,.75)}
|
|
.menu[hidden]{display:none}
|
|
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
|
|
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
|
|
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
|
|
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
|
|
white-space:nowrap}
|
|
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
|
|
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
|
|
.mi:hover .mark{color:var(--ink)}
|
|
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
|
|
letter-spacing:.1em;text-transform:uppercase}
|
|
|
|
/* Works-with bar: one scrolling row, name and mark per agent. */
|
|
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
|
|
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
|
|
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
|
|
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
|
|
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
|
|
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
|
|
display:flex;align-items:center}
|
|
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
|
|
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
|
|
-webkit-overflow-scrolling:touch;
|
|
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
|
|
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
|
|
.bar::-webkit-scrollbar{display:none}
|
|
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
|
|
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
|
|
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
|
|
text-decoration:none;background:var(--ground)}
|
|
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
|
|
.agent .mark{width:.95rem;height:.95rem}
|
|
|
|
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
|
|
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
|
|
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
|
|
p{margin:0 0 1rem;max-width:70ch}
|
|
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
|
|
li{margin:.22rem 0}
|
|
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
|
|
text-decoration-color:var(--line-hi)}
|
|
a:hover{text-decoration-color:var(--ink)}
|
|
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
|
|
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
|
|
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
|
|
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
|
|
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
|
|
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
|
|
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
|
|
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
|
|
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
|
|
display:block;overflow-x:auto}
|
|
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
|
|
|
|
.curl{display:block;background:var(--panel);border:1px solid var(--line);
|
|
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
|
|
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
|
|
white-space:pre;line-height:1.9}
|
|
.curl b{color:var(--ink);font-weight:400}
|
|
.curl i{font-style:normal;color:var(--faint)}
|
|
|
|
/* index */
|
|
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
|
|
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
|
|
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
|
|
#q:focus{outline:none;border-color:var(--soft)}
|
|
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
|
|
text-transform:uppercase;margin:0 0 2rem}
|
|
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
|
|
padding-bottom:.45rem}
|
|
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
|
|
border-radius:var(--r-soft);text-decoration:none}
|
|
.row:hover{background:#0a0a0a}
|
|
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
|
|
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
|
|
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
|
|
color:var(--faint);font-size:.85rem}
|
|
footer a{color:var(--soft)}
|
|
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
|
|
margin:0 0 2rem;font-size:.85rem}
|
|
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
|
|
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
|
|
border-bottom:1px solid var(--line);padding-bottom:.4rem}
|
|
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
|
|
.fmap a:hover{text-decoration:underline}
|
|
.fmap div{color:var(--faint);line-height:1.5}
|
|
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
|
|
|
|
@media (max-width:640px){
|
|
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
|
|
.btns{gap:.5rem}
|
|
.btn{padding:.75rem 1.15rem;font-size:.68rem}
|
|
.copy,.copy .btn{width:100%;justify-content:center}
|
|
.menu{left:0;right:0;min-width:0}
|
|
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
|
|
.strip b{border-right:0;padding-right:0}
|
|
.bar{width:100%}
|
|
}
|
|
</style>
|
|
<link rel="alternate" type="text/markdown" href="/hip-0079.md">
|
|
|
|
<link rel="icon" href="/favicon.svg">
|
|
<link rel="canonical" href="https://hanzoskills.com/hip-0079">
|
|
</head>
|
|
<!-- Reading this with a machine? Every page here is also plain markdown.
|
|
This one: https://hanzoskills.com/hip-0079.md
|
|
Index: https://hanzoskills.com/llms.txt
|
|
Corpus: https://hanzoskills.com/all.md
|
|
Append .md to any path for the markdown twin. -->
|
|
<body>
|
|
<nav><div class="in">
|
|
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
|
|
<a class="up" href="/">All skills</a>
|
|
</div></nav>
|
|
|
|
<div class="wrap">
|
|
<h1>hip-0079</h1><p class="lede">HIP-79: Q-Chain — Quasar Finality Block Standard. Status Final. Hanzo architectural specification.</p><h1>HIP-0079: Q-Chain — Quasar Finality Block Standard</h1>
|
|
<h2>Abstract</h2>
|
|
<p>Q-Chain is the <strong>compact finality-block log</strong> for the Quasar consensus engine. Each Q-Block carries the minimum information needed for finality: roots of the validator / DKG / identity state held in Z-Chain (HIP-0078) plus a single Pulsar-M-65 threshold signature (HIP-0084) that proves the current epoch's committee finalised the block. Q-Chain does <strong>not</strong> carry raw ML-DSA validator pubkeys, raw ML-DSA per-validator signatures, raw DKG transcript messages, or raw attestation blobs — those live in Z-Chain.</p>
|
|
<p>The result: a finality lane whose per-block size is bounded and small (a few hundred bytes plus one ~3.3 KB Pulsar-M-65 signature), independent of validator-set size. Adding validators makes Z-Chain heavier, not Q-Chain.</p>
|
|
<h2>Specification</h2>
|
|
<h3>Q-Block structure</h3>
|
|
<pre><code>QBlock {
|
|
version uint16
|
|
network_id uint32
|
|
chain_id uint32
|
|
height uint64
|
|
round_or_view uint32
|
|
parent_qblock_hash [32]byte
|
|
|
|
// State roots — Z-Chain anchors. Each MUST equal the latest
|
|
// accepted EpochCommitment field for the current epoch.
|
|
lux_state_root [32]byte // Lux primary state at this height
|
|
zchain_state_root [32]byte // anchors EpochCommitment.zchain_state_root
|
|
validator_set_root [32]byte // anchors EpochCommitment.validator_registry_root
|
|
committee_root [32]byte // anchors EpochCommitment.committee_root
|
|
dkg_transcript_root [32]byte // anchors EpochCommitment.dkg_transcript_root
|
|
group_public_key_hash [32]byte // anchors EpochCommitment.group_public_key_hash
|
|
|
|
// Payload anchors — block-specific data lives elsewhere.
|
|
payload_root [32]byte // application transactions
|
|
da_root [32]byte // data-availability commitment
|
|
|
|
// Cert envelope.
|
|
proof_system_id ProofSystemID // = 0x10 STARK_FRI_SHA3_PQ canonical (0x80/0x81 refused)
|
|
hash_suite_id HashSuiteID // = 0x01 SHA3_NIST canonical
|
|
sig_scheme_id SigSchemeID // = 0x52 Pulsar-M-65 default; 0x53 for high-value roots
|
|
|
|
// Signature.
|
|
signer_bitmap_or_weight_commitment []byte // who attested (committee bitmap or weight Merkle root)
|
|
pulsar_m_threshold_signature []byte // single threshold sig over the canonical transcript
|
|
}</code></pre>
|
|
<h3>What Q-Chain MUST NOT carry</h3>
|
|
<p>Hard exclusions:</p>
|
|
<ul><li>Full validator ML-DSA-65 public keys (live in Z-Chain <code>identity_root</code>).</li><li>Per-validator ML-DSA-65 identity signatures (live in Z-Chain validator-registration proofs).</li><li>Full DKG ceremony messages (live in Z-Chain <code>dkg_transcript_root</code>).</li><li>Per-validator attestation blobs (live in Z-Chain).</li><li>Z-Chain proof bytes for non-epoch-boundary blocks (the cert</li></ul>
|
|
<p> references <code>zchain_state_root</code> by hash; the proof itself only ships at epoch boundaries).</p>
|
|
<p>A Q-Block that carries any of these violates the spec and MUST be rejected. The wire format does not have fields to hold them; this is an enforcement-by-construction guarantee.</p>
|
|
<h3>Canonical transcript binding</h3>
|
|
<p>The transcript Pulsar-M signs over for a Q-Block is computed as:</p>
|
|
<pre><code>TranscriptHash = TupleHash256(
|
|
[ "Q-Chain/v1",
|
|
version, // 2 bytes BE
|
|
network_id, // 4
|
|
chain_id, // 4
|
|
height, // 8
|
|
round_or_view, // 4
|
|
parent_qblock_hash,
|
|
lux_state_root,
|
|
zchain_state_root,
|
|
validator_set_root,
|
|
committee_root,
|
|
dkg_transcript_root,
|
|
group_public_key_hash,
|
|
payload_root,
|
|
da_root,
|
|
[proof_system_id], // 1
|
|
[hash_suite_id], // 1
|
|
[sig_scheme_id], // 1
|
|
signer_bitmap_or_weight_commitment ],
|
|
customization = "PULSAR-M-Q-BLOCK-V1")</code></pre>
|
|
<p><code>TupleHash256</code> per NIST SP 800-185 is used for unambiguous length-prefixed tuple hashing. Customisation tags pin the protocol version; bumping "v1" → "v2" is the only way to reuse the same transcript bytes for a breaking change. Hash family is <code>HashSuiteID = 0x01 SHA3_NIST</code> only — HashSuite-mismatched Q-Blocks are not produceable on Lux primary network.</p>
|
|
<h3>Acceptance rule</h3>
|
|
<p>A full node accepts a Q-Block at height H iff <strong>every</strong> of the following holds:</p>
|
|
<ol><li><code>parent_qblock_hash</code> matches the chain tip.</li><li><code>zchain_state_root</code> matches the latest accepted Z-Chain epoch root.</li><li><code>validator_set_root</code> matches the latest accepted Z-Chain</li></ol>
|
|
<p> <code>validator_registry_root</code> (per EpochCommitment).</p>
|
|
<ol><li><code>committee_root</code> matches the latest accepted Z-Chain</li></ol>
|
|
<p> <code>committee_root</code>.</p>
|
|
<ol><li><code>dkg_transcript_root</code> matches the latest accepted Z-Chain</li></ol>
|
|
<p> <code>dkg_transcript_root</code>.</p>
|
|
<ol><li><code>group_public_key_hash</code> matches the latest accepted Z-Chain</li></ol>
|
|
<p> <code>group_public_key_hash</code>.</p>
|
|
<ol><li><code>proof_system_id</code> is NOT in the forbidden set</li></ol>
|
|
<p> (<code>IsForbiddenInPQMode() == false</code>); strict-PQ networks require <code>0x10 STARK_FRI_SHA3_PQ</code>.</p>
|
|
<ol><li><code>hash_suite_id == 0x01 SHA3_NIST</code>.</li><li><code>sig_scheme_id</code> ∈ {<code>0x52 Pulsar-M-65</code>, <code>0x53 Pulsar-M-87</code>} for</li></ol>
|
|
<p> mainnet; testnet may also accept <code>0x51 Pulsar-M-44</code>.</p>
|
|
<ol><li><code>signer_bitmap_or_weight_commitment</code> satisfies the configured</li></ol>
|
|
<p> threshold (43-of-64 default per HIP-0084).</p>
|
|
<ol><li><code>pulsar_m_threshold_signature</code> verifies under unmodified</li></ol>
|
|
<p> FIPS 204 ML-DSA.Verify against the canonical transcript hash and the group public key derived from <code>group_public_key_hash</code>.</p>
|
|
<p>If any check fails, the block is rejected and a slashing-evidence record is produced per HIP-0084 §"Identifiable abort".</p>
|
|
<h3>Production defaults</h3>
|
|
<p>| parameter | value | |----------------------|--------------------------------| | <code>version</code> | <code>0x0001</code> | | <code>proof_system_id</code> | <code>0x10</code> (STARK_FRI_SHA3_PQ) | | <code>hash_suite_id</code> | <code>0x01</code> (SHA3_NIST) | | <code>sig_scheme_id</code> | <code>0x52</code> (Pulsar-M-65) | | committee size | 64 | | BFT fault bound | f = 21 | | threshold | 43-of-64 | | epoch length | network-configurable; start 1 hour | | DKG cadence | once per epoch (HIP-0084) | | online signing | preprocessing-enabled | | abort handling | identifiable abort required |</p>
|
|
<p>High-value roots (governance, bridges, slashing, archival) MAY upgrade <code>sig_scheme_id</code> to <code>0x53 Pulsar-M-87</code> for the duration of the operation. Block consumers MUST accept either.</p>
|
|
<h3>What changes for Quasar mode</h3>
|
|
<p><code>PQModeQuasar</code> (consensus/config/pq_mode.go) maps to:</p>
|
|
<ul><li><code>proof_system_id = 0x10 STARK_FRI_SHA3_PQ</code></li><li><code>hash_suite_id = 0x01 SHA3_NIST</code></li><li><code>sig_scheme_id = 0x52 Pulsar-M-65</code> (default) or <code>0x53 Pulsar-M-87</code> (high-value)</li></ul>
|
|
<p>The legacy "Pulsar.R + Groth16/BN254 Z-Chain rollup" wire shape from the prior HIP-0077 is retired with the migration to Z-Chain v1 (HIP-0078 Phase 3 flag day).</p>
|
|
<h2>Security considerations</h2>
|
|
<ul><li><strong>No silent downgrade.</strong> A Q-Block that carries</li></ul>
|
|
<p> <code>proof_system_id = 0x80</code> or <code>0x81</code> is refused before signature verification. The forbidden markers exist on the wire so a misconfigured operator's block is named, not silently accepted.</p>
|
|
<ul><li><strong>Single threshold sig per block.</strong> Multi-sig fallback paths</li></ul>
|
|
<p> (per-validator BLS + ML-DSA, classical/PQ hybrid) are NOT in this HIP. A future variant MAY add hybrid-cert support but it lives in a follow-up HIP, not here.</p>
|
|
<ul><li><strong>Root tampering.</strong> All root fields are bound into the transcript;</li></ul>
|
|
<p> flipping any one breaks signature verification.</p>
|
|
<ul><li><strong>Signer-bitmap forgery.</strong> Bitmap is bound into the transcript and</li></ul>
|
|
<p> validated against <code>committee_root</code>; an attacker who flips a bit must produce a valid Pulsar-M sig over the modified transcript, which reduces to forging Pulsar-M.</p>
|
|
<ul><li><strong>Replay across networks.</strong> <code>network_id</code> and <code>chain_id</code> are bound</li></ul>
|
|
<p> into the transcript; a Q-Block valid on Lux mainnet is not valid on a tenant network.</p>
|
|
<h2>Adoption order</h2>
|
|
<ol><li>Wire format frozen (this HIP).</li><li><code>consensus/pkg/wire/qblock.go</code> reference encoder/decoder.</li><li>Test vectors at <code>~/work/lux/consensus/qblock-vectors/</code> covering</li></ol>
|
|
<p> acceptance, refusal-on-forbidden-proof-system, transcript binding.</p>
|
|
<ol><li>Quasar driver (<code>consensus/protocol/quasar/</code>) consumes Q-Blocks</li></ol>
|
|
<p> from <code>WitnessSet.Run</code> outputs.</p>
|
|
<ol><li>Q-Chain VM at <code>chains/quasarvm</code> (planned location) implements</li></ol>
|
|
<p> acceptance rule.</p>
|
|
<ol><li>Phase 2 of HIP-0078 ships, gating the <code>proof_system_id = 0x10</code></li></ol>
|
|
<p> requirement on Lux primary network.</p>
|
|
<h2>References</h2>
|
|
<ul><li>HIP-0077 — Mesh Identity, Gossip & Payments (parent).</li><li>HIP-0078 — Z-Chain PQ Identity Rollup (root source).</li><li>HIP-0084 — Pulsar-M DKG (signing primitive).</li><li>FIPS 204 — ML-DSA verification target.</li><li>FIPS 202 + NIST SP 800-185 — TupleHash256 transcript family.</li></ul>
|
|
<footer>
|
|
<div class="fmap">
|
|
<div><b>Build</b>
|
|
<a href="https://hanzo.app">hanzo.app</a> app builder
|
|
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
|
|
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
|
|
<div><b>Run</b>
|
|
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
|
|
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
|
|
<div><b>Account</b>
|
|
<a href="https://hanzo.id">hanzo.id</a> sign in
|
|
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
|
|
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
|
|
<div><b>Company</b>
|
|
<a href="https://hanzo.ai">hanzo.ai</a> canonical
|
|
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
|
|
</div>
|
|
<div class="fend"><a href="/hip-0079.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
|
|
</footer>
|
|
</div></body></html> |