qub Protokollýsing

qub er ein protokoll fyri kryptografiskar tíðarbundnar bindingar: eitt skipan til at innsigla orð til ein framtíðardag og at prógva, tá ið tann dagurin kemur, beint hvat varð sagt og nær.

Trý grundleggjandi eind gera tað virkandi. drand er ein desentralieraður tilvildarljósvíti — avdúkingardagurin er framfylgjandi av fysikki, ikki av góðvilja nakrar parts. Varandi alment goymslupláss er eitt manipulatiónsfrítt alment goymslupláss — eingin partur kann broyta ella strika ein qub, tá ið hann er innsiglaður. ML-DSA-65 er ein post-kvantum stafrøk undirskrift — hvør qub er bundin at einum lyklapari, hvørs loyndarmál ongantíð fer frá tóleind høvundans.

Saman gera hesi grundleggjandi eind eina frágreiðing, sum er tíðarlæst, manipulatiónsávísandi og tilskrivanlig — ein kvittan, hvørs virði veksur, alt sum heimsins evni at smíða fortíðina batnar.

Restin av hesum skjali er tann normativa fyriskipanin, sum krevst fyri samvirkandi ímótkomningar.

qub Protokoll Fyriskipan

Hetta skjalið er tann normativa protokollfyriskipanin fyri qub tíðarbundnu bindingarskipanina. Hon ásetir dátubygnaðir, raðfestingarreglur, avleiðingarformlar og verifikatiónsmannagongdir, sum krevjast fyri samvirkandi ímótkomningar.

Umfang: protokollagið er við vilja málneutralt — qub-likamið er ógjøgnumskygt reintekstur / markdown / pakt-bæti, og staðbundin framsýning er ábyrgd vísarans (qub.social vevtænasta, <qub-embed> iframe, MCP-klientar, o.s.fr.).

1. Teknleiðing og Vanir

Øll heiltøl í forímyndabygningum verða raðfest sum big-endian fastbreiddar bætibráir (i64 → 8 bæti, u8 → 1 bæti) uttan so at annað er ásett.

Øll tíðarmerki eru Unix-sekund í UTC.

2. Dátubygnaðir

2.1 ComposeQub (Skapara Innminnis-Støða)

Ikki raðfest til CBOR. Ikki skrivað til varandi goymslupláss. Staðbundið hjá høvundaappini.

ComposeQub {
    draft_id:       [u8; 16],        // Random, generated locally
    created_at:     i64,             // Unix seconds UTC
    unlock_at:      Option<i64>,     // Unix seconds UTC; None while composing
    visibility:     u8,              // 0x01 = public (only value in MVP)
    content_type:   u8,              // 0x01 = text (only value in MVP)
    plaintext:      Vec<u8>,         // UTF-8 qub body
    sender_label:   Option<String>,  // Decorative display name; not authenticated
    status:         DraftStatus,     // Composing | Sealed | Uploaded | Failed
}

2.2 QubEnvelope (Avkrypterað Nýttulast)

Raðfest við kanoniskum CBOR (§3). Krypterað innan í SealedQub. Hetta er bygnaðurin, sum prógvar innihaldsheild eftir avkryptering.

QubEnvelope {
    version:             u8,              // Protocol major version (0x01 for v1)
    qub_id:              [u8; 32],        // Derived (see §4.1)
    content_type:        u8,              // Content type registry (see §6)
    created_at:          i64,             // Unix seconds UTC
    unlock_at:           i64,             // Unix seconds UTC
    outcome_at:          Option<i64>,     // V1.1 — when reality renders judgment (verdict-uplift-plan §3.1)
    sender_label:        Option<String>,  // Decorative; not authenticated in MVP
    reply_to:            Option<[u8; 32]>,// Parent qub_id for reply chains; not in qub_id preimage; not signed (see §9.3)
    body:                Vec<u8>,         // Content payload (UTF-8 for text, CBOR for pact)
    body_hash:           [u8; 32],        // SHA3-256(body) (see §4.2)
    sig_alg:             u8,              // Signature algorithm (see §9.2)
    author_signature:    Option<Vec<u8>>, // Set when sig_alg != 0x00
    author_pubkey:       Option<Vec<u8>>, // Set when sig_alg != 0x00
    cosigner_pubkey:     Option<Vec<u8>>, // Set for cosigned pact bilateral agreements
    cosigner_signature:  Option<Vec<u8>>, // Set for cosigned pact bilateral agreements
}

Grundlinja (óundirskrivaður tekst-qub): version = 0x01, content_type = 0x01, sig_alg = 0x00, allir Option-teigar fráverandi.

Aðrar v1-uppsetingar: content_type = 0x03 (pakt-likam, sí §6.1); sig_alg = 0x01 (ML-DSA-65) við author_signature og author_pubkey til staðar (sí §9.3); cosigner_pubkey og cosigner_signature til staðar saman fyri samundirskrivaðar paktir (sí §9.7); reply_to sett til foreldur-qubsins qub_id fyri svarkeðju-qub-ar (sí §9.3 fyri avleiðingarnar fyri undirskriftarumfangið).

2.3 SealedQub (Kanoniskt Tráðasnið)

Raðfest við kanoniskum CBOR (§3). Skrivað til varandi goymslupláss. Hetta er á-keðju-artefaktið.

SealedQub {
    version:           u8,              // Protocol major version (0x01 for v1)
    qub_id:            [u8; 32],        // Same as QubEnvelope.qub_id
    visibility:        u8,              // 0x01 = public; v1 viewers reject other values
    unlock_at:         i64,             // Unix seconds UTC
    outcome_at:        Option<i64>,     // V1.1 — surfaced on the verdict-watch CTA
                                        //   before reveal; mirrors QubEnvelope.outcome_at;
                                        //   bound to qub_id via the §4.1 preimage.
    drand_chain_id:    String,          // drand chain hash (hex string)
    drand_round:       u64,             // Target drand round number
    tlock_ciphertext:  Vec<u8>,         // tlock-encrypted QubEnvelope CBOR bytes
    recipient_pubkey:  Option<[u8; 32]>,// Reserved field; accepted by canonical CBOR
                                        //   but not interpreted by the v1 reference viewer
    title:             Option<String>,  // Plaintext title surfaced on the viewer
                                        //   countdown before reveal. Bound to qub_id
                                        //   via title_hash (§4.1). 1..=100 NFC code
                                        //   points, no control characters.
}

2.4 RevealedQub (Vísara Applikatiónsstøða)

Ikki raðfest til CBOR. Staðbundið hjá vísaraappini. Bygt eftir væleydnaða avkryptering og verifikatión.

RevealedQub {
    qub_id:              [u8; 32],
    arweave_tx_id:       String,
    visibility:          u8,
    content_type:        u8,
    created_at:          i64,
    unlock_at:           i64,
    drand_chain_id:      String,
    drand_round:         u64,
    sender_label:        Option<String>,
    title:               Option<String>,    // Carried forward from SealedQub.title
    reply_to:            Option<[u8; 32]>,
    body:                Vec<u8>,
    body_hash:           [u8; 32],
    body_hash_verified:  bool,
    author_signature:    Option<Vec<u8>>,
    author_pubkey:       Option<Vec<u8>>,
    signature_verified:  Option<bool>,
    cosigner_pubkey:     Option<Vec<u8>>,
    cosigner_signature:  Option<Vec<u8>>,
    cosigner_verified:   Option<bool>,
}

3. Kanoniska CBOR-Profilið

Øll SealedQub- og QubEnvelope-raðfesting MÁ samsvara hesum profili. Tveir ímótkomningar, sum fáa sama logiska bygnaðin, MÚGVA framleiða eins bæti.

3.1 Raðfestingarreglur

3.2 Verifiseraðar Kanoniskar Lyklaraðsetingar

Hesar lyklaraðsetingar eru normativar. Ímótkomningar MÚGVA senda lyklar út í júst hesi raðseting. Avlúsingar-staðfestingar EIGA at verifisera raðsetingina í ikki-útgávubygdum.

QubEnvelope (útgáva 0x01, óundirskrivaður, allir valfríir teigar fráverandi):

"body"                (5 encoded bytes)
"qub_id"              (7 encoded bytes)
"sig_alg"             (8 encoded bytes)
"version"             (8 encoded bytes)
"reply_to"            (9 encoded bytes)   ← only if present (reply chains)
"body_hash"           (10 encoded bytes)
"unlock_at"           (10 encoded bytes)
"created_at"          (11 encoded bytes)
"outcome_at"          (11 encoded bytes)  ← only if present (V1.1 verdict mechanic)
"content_type"        (13 encoded bytes)
"sender_label"        (13 encoded bytes)  ← only if present
"author_pubkey"       (14 encoded bytes)  ← only if present
"cosigner_pubkey"     (16 encoded bytes)  ← only if present (pact cosign)
"author_signature"    (17 encoded bytes)  ← only if present
"cosigner_signature"  (19 encoded bytes)  ← only if present (pact cosign)

QubEnvelope lyklaraðsetingaravleiðing: hvør lykil er ein CBOR-tekstrein. Raðfest longd = 1 bæti høvur + reinlongd (fyri reinir undir 24 bætum). Raða eftir samlaðari raðfestari longd fyrst, so leksikografiskt fyri lyklar av sömu longd.

SealedQub (útgáva 0x01, alment, eingin móttakari):

"title"             (6 encoded bytes)   ← only if present
"qub_id"            (7 encoded bytes)
"version"           (8 encoded bytes)
"unlock_at"         (10 encoded bytes)
"outcome_at"        (11 encoded bytes)  ← only if present (V1.1 verdict mechanic)
"visibility"        (11 encoded bytes)
"drand_round"       (12 encoded bytes)
"drand_chain_id"    (15 encoded bytes)
"recipient_pubkey"  (17 encoded bytes)  ← only if present
"tlock_ciphertext"  (17 encoded bytes)

PactTerms (pakt-likam, content_type 0x03):

"notes"         (6 encoded bytes)  ← only if present
"terms"         (6 encoded bytes)
"title"         (6 encoded bytes)
"party_a"       (8 encoded bytes)
"party_b"       (8 encoded bytes)
"pact_version"  (13 encoded bytes)

PactTerm (rað í terms-bránni):

"key"    (4 encoded bytes)
"value"  (6 encoded bytes)

PartyIdentifier (party_a / party_b kort):

"label"    (6 encoded bytes)
"contact"  (8 encoded bytes)  ← only if present

3.3 Bætiraðfestingarúrtak

4. Normativar Avleiðingar

4.1 qub_id

qub_id eyðmerkir ein qub einstaknliga og bindir QubEnvelope at SealedQub. Hann verður avleiddur deterministiskt úr brævainnihaldinum.

qub_id = SHA3-256(
    "QUB_ID_V2"          ||  // domain separator: ASCII bytes [0x51 0x55 0x42 0x5F 0x49 0x44 0x5F 0x56 0x32] (9 bytes) + 0x00 padding (1 byte) = 10 bytes
    version              ||  // u8 (1 byte)
    content_type         ||  // u8 (1 byte)
    created_at           ||  // i64 big-endian (8 bytes)
    unlock_at            ||  // i64 big-endian (8 bytes)
    outcome_at_or_zero   ||  // i64 big-endian (8 bytes; 0 when outcome_at is absent)
    drand_round          ||  // u64 big-endian (8 bytes)
    body_hash            ||  // [u8; 32] (32 bytes)
    title_hash               // [u8; 32] (32 bytes; absent-sentinel = [0u8; 32])
)
// Total preimage: 108 bytes → 32-byte output

Økisskiljara-raðfesting: Reinurin "QUB_ID_V2" er 9 ASCII-bæti. Eitt einstakt 0x00 fyllibæti verður lagt aftanat at náa 10 bæti fyri samrøðing. Ímótkomningar MÚGVA brúka júst hesi 10 bæti: [0x51, 0x55, 0x42, 0x5F, 0x49, 0x44, 0x5F, 0x56, 0x32, 0x00].

outcome_at-raðfesting: V1.1 víðkaði forímyndina úr 92 til 100 bæti fyri at fella tann valfría outcome_at-teigin inn í bindingina. Fráverandi outcome_at verður raðfest sum 8 núll-bæti; protokoll-váttararnir avvísa outcome_at <= 0 allastaðni, so hetta varðveitslin kann ikki rekast saman við einum lógligum virði. Sí §3.2 (tráðasnið) og tað innantrægra tasks/verdict-uplift-plan.md fyri tann dóma-mekanismin, sum krevur hendan teig.

drand_round-raðfesting: V1.2 víðkaði forímyndina úr 100 til 108 bæti fyri at fella drand_round (tann ætlaða drand-rundu, §4.3) inn í bindingina, og økti økisskiljaran til QUB_ID_V2. Hetta bindur tíðarlás-rundina inn í qub-samleikan: ein gátt kann ikki binda dulorðstekstin aftur til eina aðra rundu (t.d. eina longu gingna) enn tað, sum vístu unlock_at ímplikerar. Avlæsingarprotokollurin (§8) váttar harumframt, at tann runda, sum er bakað inn í tlock-dulorðstekstins stanza, samsvarar unlock_round(unlock_at), so tann vístu avlæsingartíðin er prógvanliga tann runda, sum gáttar avkrypteringina.

Eginleikar:

• At broyta nakran teig í QubEnvelope (likam, tíðarmerki, innihaldsslag, útgáva) framleiðir ein annan qub_id.
• qub_id verður roknaður áðrenn krypteringina. Bæði QubEnvelope og SealedQub bera sama qub_id. Vísarin verifiserar, at teir samsvara, eftir avkryptering.
• qub_id veltur ikki á sender_label, author_signature ella author_pubkey. Hetta merkir, at sama innihald innsiglað á sama tíðspunkti framleiðir sama qub_id, óansæð hvør undirskrivar tað.
• At broyta SealedQub title (við øllum øðrum fastsettum) broytir qub_id gjøgnum title_hash. Ein gátt kann tí ikki skifta reintekst-heitið, sum verður víst á niðurteljingini, uttan at gera qub-eyðmerkingina ógilduga.
• At broyta SealedQub outcome_at (við øllum øðrum fastsettum) broytir qub_id gjøgnum forímyndina. Ein gátt kann ikki skifta tann dóma-dagin, sum verður vístur á niðurteljingini áðrenn avdúkingina, uttan at gera qub-eyðmerkingina ógilduga.
• At broyta drand_round (við øllum øðrum fastsettum) broytir qub_id gjøgnum forímyndina. Ein gátt kann ikki binda tíðarlás-dulorðstekstin aftur til eina aðra rundu uttan at gera qub-eyðmerkingina ógilduga; saman við §8 avlæsingartíðar-stanza-rundu-kanningini er tann vístu unlock_at tann runda, sum veruliga gáttar avkrypteringina.

4.2 body_hash

body_hash = SHA3-256(body)

Har body er tann ráa Vec<u8> innihaldsnýttulastin. Fyri tekst-qub-ar er hetta tann UTF-8-raðfesta qub-likamið.

4.2.1 title_hash

title_hash = SHA3-256(NFC(title).utf8_bytes)   if title is present
title_hash = [0u8; 32]                         if title is absent

Har title er tað valfría reintekst-heitið, sum verður víst á vísara-niðurteljingini áðrenn avdúkingina (sí §3.2). NFC-normalisering koyrir á styttingartíðspunkti, so styttingin er støðug yvir sjónliga-javnvirði kodupunkt-raðir. Allir-núll varðveitslin er varðveitt fyri fráverandi førið; ein tómur reinur verður avvístur á kanoniska CBOR-markinum sum ein ikki-kanonisk raðfesting av "fráverandi" (tann kanoniska raðfestingin sleppir teiginum heilt burtur).

4.3 Avlæsingarrunda-Kortlegging

drand_round = ceil((unlock_at - chain_genesis_time) / chain_period_seconds)

ceil()-atgerðin velur fyrstu drand-rundu, hvørs avdúkingartíð er ≥ unlock_at. Hetta tryggjar, at qub ikki verður avkrypteranligur, áðrenn tann valda avlæsingartíðin.

Útjaðaraføri: um (unlock_at - chain_genesis_time) er júst deilibart við chain_period_seconds, er úrslitið júst tann runda — qub avlæsist beint á avdúkingartíð teirrar rundu.

Vátting: unlock_at MÁ vera í framtíðini á innsiglingartíð. unlock_at MÁ IKKI vera meira enn 10 ár frá created_at (fyri at avmarka langtíðar drand-veltingarvanda; brúkaramótið EIGUR at vára fyri avlæsingardøgum lengri enn 2 ár burtur).

5. Tráðasniðs-Nýggjslag

Tráðasniðs-nýggjslag veita samanseting-tíðar trygd ímóti at blanda CBOR-bæti saman við JSON, rátt reintekst ella aðrar bætiraðfestingar.

5.1 Samanseting-Reglur

// Production code — only through CBOR serialisers:
let sealed = SealedQubCbor::from_encoded(cbor_bytes);

// There is deliberately NO From<Vec<u8>> implementation.
// You cannot accidentally wrap arbitrary bytes in a wire format type.

// Accessing raw bytes:
let bytes: &[u8] = sealed.as_bytes();
let bytes: Vec<u8> = sealed.into_bytes();

5.2 Vátting við Samanseting

from_encoded() EIGUR at vátta, at inntakið byrjar við einum gildugum CBOR-kort-høvri. Full bygnaðarvátting hendir á tólkingartíð, ikki samanseting-tíð, fyri at sleppa undan tvítólking.

6. Innihaldsslags-Skráseting

Vísarar MÚGVA avvísa ókend innihaldsslag við einum greiðum brúkara-sjónligum feili. Vísarar MÚGVA IKKI royna at framsýna ókend slag sum tekst.

6.1 Pakt-Likam (content_type = 0x03)

Eitt pakt-likam er tann kanoniska CBOR-raðfestingin av einum PactTerms-virði:

PactTerms {
    pact_version:  u8,                    // 0x01 for structured/v1
    title:         String,                // ≤ 200 bytes, NFC
    terms:         Vec<PactTerm>,         // ≤ 20 rows
    party_a:       PartyIdentifier,       // initiator
    party_b:       PartyIdentifier,       // counter-signer
    notes:         Option<String>,        // ≤ 5,000 bytes, NFC; absent key if none
}

PactTerm       { key: String (≤ 100), value: String (≤ 2,000) }   // NFC on both sides
PartyIdentifier{ label: String (≤ 100), contact: Option<String (≤ 320)> }

Kanoniskar CBOR-lyklaraðsetingar fyri øll trý kort eru givnar í §3.2. Samlað raðfest pakt-CBOR MÁ IKKI fara um 100 KB (samsvarar §6).

Skema-skiljari. Fyrsta raðin í terms fyri ein structured/v1-pakt MÁ vera { key: "pact_schema", value: "structured/v1" }. Raðir uttan hesa merking eru "egindefineraðir" paktir og fáa onga bygda vátting ella skema-vitandi framsýning.

Frystir váttanarpláss. structured/v1-paktir bera júst fýra váttanarraðir undir hesum lyklum:

"initiator_standard_terms"
"initiator_capacity_terms"
"counterparty_standard_terms"
"counterparty_capacity_terms"

value fyri hvønn er ein av átta frystum enskum reinum, vald av (role, kind)-parinum, har role ∈ { seller, buyer, provider, client } og kind ∈ { standard, capacity }. Sjálvir reinirnir eru normativ protokoll-dáta — báðir parta ML-DSA-65-undirskriftir binda seg at júst teimum bætum gjøgnum body_hash. Teir verða IKKI staðbundnir; tann undirskrivaða likamið er málneutralt. Onkur orðingarbroyting krevur eina nýggja skemaútgávu (structured/v2).

Teir átta reinirnir, teirra uppfletting (acknowledgement_for(role, kind)) og grundgevingin fyri hvønn eru fastsett av tilvísingar-ímótkomningini. Samsvarandi ímótkomningar MÚGVA senda út bæti-eins váttanarvirði; gulligrundar SHA3-256 likams-styttingar-roynir, sum fevna um allar fýra hlutverka-samansetingar, fanga onkra reki.

Vísara-framsýningarraðseting. Váttanarreinirnir innihalda orðingar sum "lýst omanfyri", sum áseta, at lýsingar- / umfangsraðir verða framsýndar undan váttanunum. Vísarar MÚGVA framsýna terms-bráina í CBOR-raðseting; umraðseting brýtur prosa-merkingina.

Mótpartsamband. Tá ið Parts B contact er eitt gildugt teldupost-adressu, sendir qub-upphalanartænastan sjálvvirkandi eitt eftirkanningar- / samundirskrivingar-boð á sviðstíð og bindur eventuella samundirskriving at vátting av sama adressu (§9.7). Paktir, hvørs Parts B-samband er fráverandi, kunnu framvegis verða samundirskrivaðir, men bert gjøgnum ein utanteldupost-kanal — tænastan noktar samundirskrivingar-umbønir, sum ikki kunnu framleiða eina samsvarandi 15-minuttu teldupost-váttingarmerking.

6.2 Dóma-Likam (content_type = 0x04)

Eitt dóma-likam er tann kanoniska CBOR-raðfestingin av einum VerdictBody-virði:

VerdictBody {
    verdict_version: u8,                  // 0x01 for structured/v1
    outcome:         u8,                  // 1=Right · 2=Partial · 3=Wrong · 4=Unfalsifiable
    reflection:      Option<String>,      // ≤ 2,000 bytes NFC; "hvat broyttist, hvat lærdi tú"
    evidence_url:    Option<String>,      // ≤ 2,048 bytes; bert HTTPS; lyklurin er fráverandi, tá hann er sleptur burtur
}

Kanonisk CBOR-lyklaraðseting:

"outcome"          (8 encoded bytes)
"reflection"       (11 encoded bytes)  ← bert um tað er til staðar
"evidence_url"     (13 encoded bytes)  ← bert um tað er til staðar
"verdict_version"  (16 encoded bytes)

Samlað raðfest dóma-CBOR MÁ IKKI fara um 8 KB (samsvarar skrásetingar-raðnum omanfyri).

Úrslits-enum. Tráðabætið er ætlanar-neutralt; teir fýra bólkarnir Right / Partial / Wrong / Unfalsifiable fevna um úrslits-rúmið hjá hvørjari dóma-berandi ætlan. Per-ætlanar-merkir ("Sá tað fyri" / "Helt tað" / "Sendi avstað" / "Vátta" fyri Right, o.s.fr.) eru ein vísara-sniðs-spurningur, ið verður loystur ímóti ætlanini hjá foreldra-qubinum — tráðurin verður mál- og ætlanar-neutralur. Virði uttan fyri 1..=4 MUGU verða avvíst í avkodingini.

Foreldra-samband. Eitt dóma-qub ber IKKI foreldra-tilvísingina í sínum likami. Arweave-veksil-eyðmerkin hjá foreldra-qubinum verður givin út sum Parent-Tx-Id-goymslumerki á upphaldsstundini (§7 goymslumerkislag). Hetta letur likamið vera eina sjálvberandi undirskrivaða lýsing av sjálvsdøming; eftirlitskeðjan ("rættur um hvat?") verður grundað við Arweave-merkis-uppfletting.

Trygd hjá vitnisburðar-URL (normativt). Tá ið evidence_url er til staðar, MUGU váttararnir (saman­seting-síðan, tráðasíðan, Worker-jaðarin) framfylgja:

1. Bert HTTPS. Reinurin MÁ byrja við bætirøðini https://. Onkur annar háttur — http, ftp, javascript, data, file, o.s.fr. — verður avvístur.
2. Longdarmark. ≤ 2.048 bæti (praktiska URL-mark hjá kagaranum).
3. NFC + fíggindarliga-bætis-kanning. Sama regla sum title og reflection — bidi-yvirskriving / núll-vídd / merkis-blokkur / BOM / C0 / C1-bæti verða avvíst. Skilamarkið samsvarar Rust crate::handle::contains_hostile_text_codepoint og TS workers/api/src/utils/unicode.ts::isHostileCodepoint (haldist í takt).
4. Onki millumrúm, ongi ASCII-stýristekn. Millumrúm / DEL / sub-0x20-bæti hvar sum helst í URL-num verða avvíst — letur niður tann \n/\t-inntrokings-vektorin, sum bidi-reglan ikki tekur við.
5. Ikki-tómt vert-stykki. Alt millum https:// og fyrsta /, ? ella # MÁ vera ikki-tómt.

Ongin tænara-síðis heinting. Workeren MÁ IKKI fyriumboða, heinta ella framvísa URL-ina. Protokollin goymir ein streng; framsýningin hendir á vísara-síðuni við rel="nofollow noopener noreferrer" target="_blank" og einum sjónligum verti vístan saman við leinkju-tekstinum.

Umhugsan. Valfrítt umhugsanartekst skrivað av høvundinum ("hvat broyttist, hvat lærdi tú"). Sama NFC + fíggindarliga-bætis-vátting sum title. Tómt / bert-millumrúms inntak fellur saman til fráverandi á samansetingarstundini.

Skema-útgáva. v1 stuðlar bert verdict_version = 0x01. Komandi skema-broytingar økja hetta bætið og koma saman við einari nýggjari protokoll-útgávu sambært §12.

7. Innsiglingarprotokollur

Tann fullkomna innsiglingarrøðin. Hvørt stig er normativt.

 1. User composes plaintext and metadata in ComposeQub.
 2. Validate:
    a. body is non-empty.
    b. body size ≤ max for content_type and user tier (see §6).
    c. unlock_at is in the future.
    d. unlock_at ≤ created_at + 10 years.
    e. content_type is a known, supported value.
 3. Compute body_hash = SHA3-256(body).
 4. Set created_at = current Unix seconds UTC.
 5. Select drand chain. Load chain_genesis_time and chain_period_seconds, and
    compute drand_round = ceil((unlock_at - chain_genesis_time) / chain_period_seconds).
    (Computed here, before qub_id, because drand_round is bound into the qub_id
    preimage — §4.1, V1.2.)
 6. Compute qub_id (see §4.1), folding in drand_round from step 5.
 7. Construct QubEnvelope with all fields.
 8. Serialise QubEnvelope using canonical CBOR → bytes B.
    Assert: serialised output matches canonical profile (§3).
 9. Compute C = tlock_encrypt(B, drand_round, drand_chain_public_key).
10. Construct SealedQub with tlock_ciphertext = C, and matching qub_id, version,
    unlock_at, drand_chain_id, drand_round.
12. Serialise SealedQub using canonical CBOR → SealedQubCbor.
12a. Generate K = 32 random bytes (CSPRNG) and N = 12 random bytes (CSPRNG).
     Compute W = wrap_sealed_qub(SealedQubCbor, qub_id=qub_id, key=K, nonce=N)
     per §13. The bytes uploaded to permanent storage are the OuterWrapper CBOR W,
     never the bare SealedQubCbor. K leaves the device only as the URL
     fragment in step 16.
13. Display seal-time disclosure. User confirms.
14. Validate upload eligibility via the qub upload service (bot-detection, entitlement, rate limits).
15. Submit W (the OuterWrapper bytes) to the qub upload service; the service
    signs and uploads to permanent storage. The service is byte-blind to the inner
    SealedQubCbor and never receives K.
16. Receive arweave_tx_id from the service. Construct delivery URL as
    `<origin>/c/<arweave_tx_id>#<base64url(K)>` (or `<origin>/s/<short_code>#<base64url(K)>`
    when a short code is allocated). Browsers do not transmit URL fragments
    to servers, so K is never observed by qub.social or any storage gateway.

Goymslupláss-tag-lag (utanmark). qub-upphalanartænastan leggur eitt við vilja lítið sett av goymslupláss-handilstagum afturat tann umbúgvdu nýttulastini. Content-Type=application/octet-stream er normativt kravt. Tilvísingartænastan leggur harumframt trý valfríi tag afturat, tá ið høvundurin velur at vísa tey: Intent (loyvilista-váttað samansetings-ætlan — t.d., quote, reply, commitment), Author (høvundans §9.3 alment-lyklað fingramerki sum 64-tekna lágstavur hex) og Parent-Tx-Id (foreldur-qubsins goymslupláss-handilseyðmerking fyri svarkeðjur, 43-tekna base64url).

Author-tagið er valfrítt fyri hvønn qub: tilvísingar-høvundaappin leggur tað bert afturat, tá ið brúkarin uttrýkiliga loyvir alment-tilskriving á innsiglingartíð. Tá ið skiftarin er av — sum er sjálvsett — verður einki Author-tag skrivað, og qub er ótilskrivaður á keðjuni: einki í varandi goymslupláss bindur upphalanina at einum høvundahandli, teldupost ella øðrum qub-um. Tá ið skiftarin er á, loysist Author-fingramerkið upp til høvundans valda @handil gjøgnum §9.5 váttanarkeðjuna. Svarkeðju-sambond og Intent eru ikki-eyðmerkjandi. Tann ytri umbúgvingin (§13) verjir innra likamið móti dulorðs-samanbinding — fyribyrgir, at ein høstari kennir og masseavkrypterar qub-laga upphalanir, eftir at teirra drand-runda verður útgivin.

Tilvísingartænastan leggur við vilja IKKI App-Name-, App-Version- ella Type-tag afturat: nakar slíkur einvirðis-filtur fór at skilað øllum qub-savninum aftur til eina GraphQL-fyrispurning, sum ikki samsvarar umbúgvingarinnar likams-bert loyndarumfang.

Ein samsvarandi verifiserari MÁ IKKI velta á nakað goymslupláss-tag fyri §11 triðjapartsverifikatión; likams-styttingin / qub_id / undirskriftin binda seg bert at innra CBOR, ongantíð at tag-settinum.

8. Avlæsingarprotokollur

Tann fullkomna avlæsingarrøðin. Hvørt stig er normativt.

 1. Viewer opens delivery URL. Extract arweave_tx_id from path AND
    K = base64url_decode(fragment) from the URL fragment. If the fragment
    is absent or malformed → display "this URL is missing its decryption
    key" and stop; the viewer MUST NOT contact the storage gateway
    without K, since fetching wrapped bytes the viewer cannot decrypt
    serves no purpose and only leaks the access attempt.
 2. Check denylist. If tx_id is denylisted → display block message. Stop.
 3. Fetch OuterWrapper bytes from permanent storage (with multi-gateway fallback).
 3a. Unwrap: parse the bytes as OuterWrapper (§13), verify the wrapper
    `version` byte is `0x01`, and compute SealedQubCbor =
    unwrap_sealed_qub(OuterWrapper, key=K). Any AEAD authentication
    failure (wrong K, tampered ciphertext, swapped qub_id-as-AAD,
    swapped nonce) → display "this URL's decryption key does not match
    the stored qub" and stop. Authentication failures are
    indistinguishable to the viewer per §13.5.
 4. Parse SealedQubCbor → SealedQub.
 5. Validate: SealedQub.version is known (0x01). Reject unknown versions.
 6. If current time < SealedQub.unlock_at → display countdown. Poll or wait.
 6a. Round-binding check (V1.2). Recompute expected_round =
    ceil((SealedQub.unlock_at - chain_genesis_time) / chain_period_seconds).
    Reject unless SealedQub.drand_round == expected_round AND the round baked
    into the tlock ciphertext stanza (read via the age/tlock header, no signature
    required) == expected_round. The stanza round is the one that actually gates
    decryption; without this check a malicious creator could bind the ciphertext
    to an already-past round while displaying a future countdown, so anyone
    reading the stored bytes could decrypt before unlock_at. Implementations with
    no chain identity (test mocks) skip this check.
 7. Once current time ≥ SealedQub.unlock_at:
    a. Fetch drand round signature for SealedQub.drand_round from drand network.
    b. Compute B = tlock_decrypt(SealedQub.tlock_ciphertext, round_signature).
 8. Parse B → QubEnvelope.
 9. Validate QubEnvelope.version is known.
10. Verify: SHA3-256(QubEnvelope.body) == QubEnvelope.body_hash.
    Fail → integrity error.
11. Verify: QubEnvelope.qub_id == SealedQub.qub_id.
    Fail → integrity error.
12. Verify: QubEnvelope.unlock_at == SealedQub.unlock_at.
    Fail → integrity error.
13. Verify: QubEnvelope.content_type is known and renderable.
    Known values: 0x01 (text), 0x03 (pact). Unknown → display error.
14. If QubEnvelope.sig_alg != 0x00 → verify author signature (see §9.4).
15. If cosigner_pubkey or cosigner_signature present → verify cosigner (see §9.7).
16. Render content using appropriate renderer (see §10 for text, §6 for pact).
17. Construct RevealedQub for display.

9. Høvundaundirskriving

9.1 Grundgeving

qub-ar verða goymdir í varandi goymslupláss. Høvundaundirskriftir mugu verða ófalsanligar í alla framtíð, sum er orsøkin til, at v1.0 brúkar tað post-kvantum ML-DSA-65 skemað (FIPS 204) heldur enn eitt klassiskt skema, hvørs trygd kann minka innan qubsins varandi lívskeið.

9.2 Algoritmu-Skráseting

Vísarar MÚGVA avvísa ókend sig_alg-virði.

9.3 Undirskrivað Forímynda-Bygning

Tvær forímynda-útgávur hava verið til. Allar undirskriftir MÚGVA brúka V2, og verifiserarar MÚGVA bert góðtaka V2. Tann gamla V1-forímyndin (skjalfest niðanfyri sum søgulig tilvísing) varð góðtikin sum ein loysn, ið bert varð brúkt til verifikatión, undir flytingini til V2; henda loysnin er nú avtikin, og ein undirskrift, sum bert byggir á V1, verður nú avvíst.

V2 (núverandi — framleidd av allari nýggjari høvundaundirskriving, og av báðum undirskriftum í pakt-sviðsetingar- / samundirskrivingar-gongdini):

sig_input = SHA3-256(
    "QUB_AUTHOR_SIG_V2"  ||    // domain separator (17 bytes)
    version              ||    // u8 (1 byte)
    qub_id               ||    // [u8; 32] (32 bytes)
    body_hash            ||    // [u8; 32] (32 bytes)
    unlock_at            ||    // i64 big-endian (8 bytes)
    0x00                 ||    // u8 (1 byte): MUST be 0x00 in v1.x
    sender_label_hash    ||    // [u8; 32]: SHA3-256(NFC(sender_label)),
                               //   or 32 zero bytes when absent
    reply_to_or_zero           // [u8; 32]: parent qub_id, or 32 zero
                               //   bytes when absent
)

// Total preimage: 155 bytes → 32-byte hash

signature = Sign(author_secret_key, sig_input)

sender_label_hash fylgir sömu fráverandi-sentinel-venju sum title_hash (§4.2.1): 32 null-bæti eru ikki eitt gildugt SHA3-256-úttak, so „fráverandi" kann ongantíð stoyta saman við eitt til staðar verandi heiti. Allir teigar eru fastbreiddir, so forímyndin er ótvíræð uttan longdarforskoyti.

V1 (gomul — AVTIKIN; ikki longur framleidd og ikki longur góðtikin við verifikatión):

sig_input = SHA3-256(
    "QUB_AUTHOR_SIG_V1"  ||    // domain separator (17 bytes)
    version              ||    // u8 (1 byte)
    qub_id               ||    // [u8; 32] (32 bytes)
    body_hash            ||    // [u8; 32] (32 bytes)
    unlock_at            ||    // i64 big-endian (8 bytes)
    0x00                       // u8 (1 byte): MUST be 0x00 in v1.0
)

// Total preimage: 91 bytes → 32-byte hash

V1-forímyndin vantaði sender_label og reply_to. Hon varð góðtikin sum ein loysn, ið bert varð brúkt til verifikatión, undir flytingini til V2; henda loysnin er síðani avtikin — verifiserarar MÚGVA bert góðtaka V2-forímyndina. Skilgreiningin verður varðveitt her sum søgulig tilvísing og til at greiða frá økisskiljaranum niðanfyri. Ein undirskrift, sum bert verifiserar móti V1, MÁ verða viðgjørd sum ein verifikatiónsfeilur.

Økisskiljarar: "QUB_AUTHOR_SIG_V1" / "QUB_AUTHOR_SIG_V2" eru hvør 17 ASCII-bæti ([0x51, 0x55, 0x42, 0x5F, 0x41, 0x55, 0x54, 0x48, 0x4F, 0x52, 0x5F, 0x53, 0x49, 0x47, 0x5F, 0x56, 0x31/0x32]). Eingin fylling. Tann ymiski skiljarin økisskilir báðar bygningarnar, so ein undirskrift yvir eina forímynd kann ongantíð verifisera sum hin.

org_id_present-bæti: bætið eftir unlock_at MÁ vera 0x00. Tilvísingar-ímótkomningin vísir hetta sum fastvirðið ORG_ID_PRESENT_INDIVIDUAL = 0x00 í crates/qub-core/src/signing.rs; vísarar, sum endurbyggja sig_input fyri verifikatión, MÚGVA senda út sama bæti.

Undirskriftarumfang — hvat er og er ikki fevnt. V2-sig_input bindur seg beinleiðis at version, qub_id, body_hash, unlock_at, sender_label og reply_to (umframt tann fasta økisskiljaran og org_id_present-bætið). qub_id verður sjálvur avleiddur úr version, content_type, created_at, unlock_at, outcome_at, drand_round og body_hash gjøgnum §4.1-forímyndina, so ein og hvør broyting á hesum teigum framleiðir ein annan qub_id og ger undirskriftina ógilduga transitivt. Tann beinleiðis-váttaða yvirvøddin er tí:

Hví V2 er tann einasta góðtikna forímyndin.

• Undir tí avtiknu V1-forímyndini kundi ein partur við skrivirættindum til goymdu bætini skift sender_label ("Alice" → "Mallory") ella um-foreldrað reply_to — og krypterað aftur eftir umfarið — uttan at gera høvundaundirskriftina ógilduga, tí hvørgin teigurin var í tí undirskrivaðu forímyndini. V2 fevnir um báðar, so ein og hvør broyting á øðrumhvørjum teiginum flytir verifikatiónina til "miseydnaða". Av tí at verifiserarar nú bert góðtaka V2, er hetta skiftið afturlatið fyri hvørja undirskrift: ein undirskrift, sum bindur hvørgin teigin (t.e. bert verifiserar móti V1), verður reint avvíst, ikki lækkað niður til V1.
• author_pubkey innan í brævinum verður verandi tann sanna samleikaakkerið — vísarar MÚGVA avleiða framsýningarsamleikan úr author_pubkey (gjøgnum §9.5 váttanarlagið) heldur enn at líta á sender_label.

Ímótkomningar, sum framsýna sender_label ella reply_to fyri endabrúkarum, MÚGVA vísa tann váttaða samleikan (alment-lyklað fingramerki, váttan) sum tað fremsta samleikasignalið, ikki heitið.

9.4 Verifikatiónsmannagongd

1. Read sig_alg from QubEnvelope.
2. If sig_alg == 0x00 → unsigned. No verification. Display "unsigned qub."
3. If sig_alg is unknown → reject. Display "unrecognised signature scheme."
4. Extract author_signature and author_pubkey. If either is absent → integrity error.
5. Reconstruct sig_input using fields from QubEnvelope (V2 formula, §9.3).
6. Verify(author_pubkey, sig_input, author_signature). The V2 preimage is the
   only accepted form — the legacy V1 fallback is retired (§9.3), so a
   signature that does not verify against V2 fails, full stop.
7. If verification succeeds → display "signed by [key fingerprint]."
8. If verification fails → display "signature verification failed."

Undirskriftarverifikatión er tann dýrasta atgerðin (serliga ML-DSA-65). Hon EIGUR at verða gjørd eftir, at allar bíligari kanningar (stytting, qub_id, unlock_at) eru væleydnaðar.

9.5 Samleika-Váttanir

Samleika-váttanir — kortleggingin av author_pubkey til mennisklig-kennaligar samleikakrøv sum eitt qub-handil, teldupostadressu, sosialt handil ella passlyklareingisbevís — eru ein vísara-síðu progressiv betran og verða ikki kravdar fyri undirskriftarverifikatión. Vísarar, sum loysa váttanir upp til ein framsýningarsamleika, MÚGVA brúka raðfestingina:

handle > email > social > fingerprint

Fingramerki-uppgávan er tann lágstavur hex av SHA3-256(author_pubkey); hon er altíð tøk fyri nakran undirskrivaðan qub. Vísarar KUNNU stytta hana fyri framsýning — tilvísingar-vísarin framsýnir qub: fylgt av tey fyrstu og tey síðstu fýra bætini (qub:<8 hex>…<8 hex>).

Ein samsvarandi verifiserari kann fullføra hvørja kanning í §9.4 uttan at samband við qub-API, uttan nakað net umframt varandi goymslupláss og drand, og uttan nakra ambætara-síðu uppfletting. Váttanarloysing er eitt skilt besta-royndar stig, sum bert verður gjørt eftir, at undirskriftarverifikatión hevur eydnast.

9.6 Støddaráhrørsla

Fyri ein tekst-qub av 500–2.000 bætum tríðfaldar ML-DSA-65 grovt tann goymdu støddina. Tann absoluti kostnaðurin er ómunaligur.

9.7 Samundirskrivara-Verifikatión (Pakt Tvíhliða Semjur)

Fyri tvíhliða semjur (content_type = 0x03) prógvar eitt annað undirskriftarlag, at báðir partar samtyktu somu treytir.

Brævateigar:

• cosigner_pubkey: ML-DSA-65 alment lyklað hjá mótundirskrivaranum (Partur B).
• cosigner_signature: Undirskrift yvir sama sig_input sum høvundurin (§9.3).

Báðir teigar MÚGVA vera til staðar saman ella báðir fráverandi. Um júst ein er til staðar, MÚGVA vísarar fráboða ein heildarfeil.

Verifikatiónsmannagongd:

1. If cosigner_pubkey absent and cosigner_signature absent → no cosigner. Done.
2. If exactly one is present → integrity error.
3. Verify cosigner_pubkey != author_pubkey (prevent self-cosigning).
   Fail → display "cosigner pubkey must differ from author."
4. Reconstruct sig_input using the same formula as §9.3 (V2 only — the
   legacy V1 fallback is retired; all pact clients produce V2 signatures).
5. Verify(cosigner_pubkey, sig_input, cosigner_signature).
6. Success → display "co-signed by [cosigner fingerprint]."
7. Failure → display "co-signature verification failed."

Eginleikar:

• Samundirskrivarin undirskrivar tann eins sig_input sum høvundurin — báðir partar binda seg at sama qub_id, body_hash og unlock_at (og, undir V2, sama sender_label_hash og reply_to_or_zero).
• Til at lata mótundirskrivaran endurbyggja V2-forímyndina uttan atgongd til rá brævabætini, tryggjar sviðsetingartænastan á sviðsetingartíð, at eitt pakt-brævs sender_label er líkt pact_terms.party_a.label og at reply_to er fráverandi. Bæði halda fyri hvønn tilvísingar-klient pakt; brøv, sum bróta hetta, verða avvíst við sviðseting.
• qub_id-avleiðing (§4.1) inniheldur IKKI samundirskrivara-teigar. At leggja ein samundirskrivara afturat einum tilstaðarverandi brævi broytir ikki qub_id.
• Ein paktur kann vera bert høvundaundirskrivaður (einhliða binding), bert-samundirskrivara (óvanligt), ella bæði (full tvíhliða prógv).

Teldupost-bindingar-gátt (rakstrarlig). Tá ið ein sviðsettur paktur ber ein Parts B-teldupostsamband (§6.1), MÁ qub-upphalanartænastan nokta samundirskrivingar-umbønini, uttan so at ein stuttlívd teldupost-váttingarmerking finst, sum samsvarar bæði sviðsetingareyðmerkingini og normaliseraða-teldupost-styttingini av tí sambandinum. Merkingin verður skrivað av /api/v1/auth/verify, tá ið maginlink-teknið ber eitt staging_id og tað verifiseraða adressuið samsvarar SHA-256(normalise_email(party_b.contact)) — har normalise_email(addr) varðveitir lokala-partsins stavstødd og lágstavar bert økispartin (sambært RFC 5321 §2.3.11), og SHA-256 her er NIST FIPS 180-4 styttingin (ymisk frá tí SHA3-256, sum verður brúkt í §4-avleiðingum) — og rennur út 900 sekund (15 minuttir) eftir útgávu. Hetta er ein rakstrarlig anti-eftirlíkingar-gátt, IKKI partur av tí á-keðju qub-prógvi — ein triðjaparts-verifiserari, sum endurspælir §11, tørvar bert varandi goymslupláss og drand, uttan nakra ambætara-síðu uppfletting. Merkingin finst bert ambætara-síðu og er ongantíð partur av tí undirskrivaða likami.

Støddaráhrørsla (ML-DSA-65 høvundur + samundirskrivari):

10. Markdown Framsýning og Reinsing

Hesin parturin er trygdar-avgerðandi. Vísarin framsýnir tekst-qub-ar (content_type = 0x01) við einum avmarkaðum Markdown-undirsetti.

10.1 Loyvd Eind

• Yvirskriftir: # gjøgnum #### (einki ##### ella ######)
• Áherðsla: feitt (**), skástreingur (*), gjøgnumstrikað (~~)
• Listar: raðaðir (1.) og óraðaðir (-, *)
• Sitatblokkar (>)
• Kotur: innanlínju-spennir (```) og innteknaðar blokkar (`````)
• Vatnrættar reglur (---)
• Línubrot (tvey slóðandi millanrúm ella tóm lína)
• Reglubrot

10.2 Forboðin Eind

10.3 Ímótkoming

Ímótkomningar MÚGVA brúka ein strangan loyvilista-tólkara, ikki ein avvísingarlista. Tann viðmæltu atgerðin:

1. Tólka Markdown við pulldown-cmark (ella javnvirði).
2. Gang gjøgnum AST og slepp nakran node, sum ikki er á loyvilistanum (§10.1).
3. Fyri leinkju-nodes: send út URL sum sjónligan tekst, ikki sum eitt klikkiligt <a>-element.
4. Umset tann filtreraða AST til eina slag-defineraða millumframsetting (t.d., ein MarkdownNode-enum við bert tryggum variantum). Ráur HTML er bygnaðarliga ófyriskipanligur í hesi IR.
5. Framsýn úr tí slag-defineraðu IR til mál-vísarlagið (t.d., reaktiv vísarkomponentir, DOM-nodes). Eingin HTML-rein-samanseting ella innerHTML á nøkrum tíðspunkti.

Avvísingarlista-atgerðir eru veikar, av tí at nýggj Markdown-víðkanir ella tólkara-eyðkenni kunnu innføra ófiltreraðar eindir. Tann slag-defineraða AST-atgerðin gerð XSS bygnaðarliga ómøguligt — har er eingin variantur, sum kann bera tilvildarligan HTML.

10.4 Størri- og Bygnaðarmark

• Mest framsýnd yvirskriftardýpd: #### (H4). ##### og dýpri verða framsýnd sum feitur tekstur.
• Einki mark á reglutali (likamsstødd-mørk í §6 eru avmarkingin).
• Innteknaðir kotublokkar: eingin syntaks-lýsmáting í MVP. Framsýndir sum einbreiddar fyrirsniðaður tekstur.

11. Triðjapartsverifikatión

Nakar triðjapartur kann verifisera ein almennan qub uttan qub-samstarv. Verifikatiónsmannagongdin:

1. Obtain arweave_tx_id (from delivery URL or direct knowledge).
2. Fetch SealedQubCbor from any storage gateway.
3. Confirm storage block inclusion (block height, block timestamp).
4. Parse SealedQubCbor → SealedQub.
5. Fetch drand round signature for SealedQub.drand_round.
6. tlock_decrypt(tlock_ciphertext, round_signature) → QubEnvelope CBOR bytes.
7. Parse → QubEnvelope.
8. Verify SHA3-256(body) == body_hash.
9. Verify QubEnvelope.qub_id == SealedQub.qub_id.
10. Verify QubEnvelope.unlock_at == SealedQub.unlock_at.
11. If sig_alg != 0x00: verify author_signature (see §9.4).
12. All checks pass → qub is verified.

Hvat verifikatión prógvar:

Hvat verifikatión IKKI prógvar:

12. Útgávumerking

12.1 Protokollútgáva

version-teigurin (u8) í bæði SealedQub og QubEnvelope eyðmerkir høvuðs-protokollútgávuna.

• Vísarar MÚGVA avvísa ókendar høvuðsútgávur við einum greiðum feili.
• Innan fyri eina kenda høvuðsútgávu MÚGVA avkodarar avvísa ókendar kortlyklar (§3.1) — skemamenning fer fram við at innføra eina nýggja version, ikki við at leggja lyklar afturat, sum verandi avkodarar høvdu hjáleitt. (Fyrri endurskoðanir av hesi lýsing loyvdu at tola ókendar valfríar teigar; tann ásetingin er tikin aftur — hon gjørdi encode(decode(x)) ikki-injektivt og opnaði ein vektor fyri fjalt undirskrivað innihald á pakt-likamum.)
• Innihaldsslag (content_type) og undirskriftarskemar (sig_alg) eru útgávu-gátta: nýggj virði kunnu bert verða innførd saman við eini nýggjari protokollútgávu ella uttrýkiligari skrásetingaruppdatering.

12.2 Útgávusøga

12.3 Framkompatibilitetur

Ein v1-vísari, sum møtir einum QubEnvelope við ókendum CBOR-kortlyklum (lyklar ikki í §3.2-kanonisku raðsetingini), MÁ avvísa tað við einum avkodingarfeili (§3.1). Framkompatibilitetur hvílir á version-teiginum, ikki á toli fyri ókendum lyklum: framtíðar viðbøtur — sjálvt smá metadáta — verða givnar út undir einum nýggjum version-virði, sum ein v1-vísari avvísir við einum greiðum "nýggjari protokollur"-feili, heldur enn tigandi at sleppa innihaldi burtur, sum undirskriftirnar binda seg at.

Ein v1-vísari, sum møtir sig_alg = 0x01 (ML-DSA-65) men manglar ML-DSA-65-verifikatiónsstuðul, EIGUR at framsýna qub-innihaldið við einum "undirskrift til staðar men ikki verifiserandi"-fráboðan, ikki at avvísa qub-in heilt. Tilvísingar-ímótkomningin í dag avvísir hvørt sig_alg-virði annað enn 0x00 og 0x01, av tí at v1-skrásetingin inniheldur ongan annan gildugan algoritm — strangt avvísing og bløyt-feilur eru observatiónsliga eins, fram til ein triði algoritmur verður skrásettur. Tann bløyt-feilar-atferðin omanfyri verður byrðiberandi, tá ið §9.2 sleppir inn eini nýggjari innfeti, og tilvísingar-vísarin verður dagførdur til at bløyt-feila á tí tíðspunkti.

12.4 Ytri Umbúgvingsútgáva

Tann OuterWrapper, sum er lýstur í §13, ber sína egnu version-bæti, óheft av SealedQub.version og QubEnvelope.version. Tey tvey útgávuríini menast hvør sær: ein framtíðar post-kvantum-tryggur symmetriskur avloysari lyftir umbúgvingar-bætið uttan at nerta innra protokollútgávuna, og ein framtíðar protokollag-viðbót (t.d., ein nýggjur brævateigur) lyftir innra útgávuna uttan at nerta umbúgvingar-bætið.

Vísarar MÚGVA avvísa ókendar umbúgvingsútgávur við einum greiðum feili. Protokollurin heldur við vilja umbúgvingsútgávuríið smátt, fram til ein nakanligur flytingar-fyrisláttur kemur fram (t.d., NIST-vegleiðing, sum yndir ein annan AEAD); eitt 0x02-pláss verður tillutað í somu broyting, sum innførir algoritmin.

13. Ytri Krypteringarumbúgving

13.1 Grundgeving

Protokollagini (QubEnvelope → tlock → SealedQub) gera ein innsiglaðan qub tíðarlæstan: likamið er ólesiligt fram til unlock_at og drand-runda-undirskriftin hevur verið útgivin. Eftir avlæsing er runda-undirskriftin tó alment, og tann kanoniska CBOR-lagin av SealedQub er kennilig, so ein høstari, sum skrásetti varandi-goymslupláss handlar, kundi masseavkrypterað alt qub-savnið.

Tann ytri krypteringarumbúgving stongir tann kanalin við at seta inn eitt eyka symmetriskt AEAD-lag millum tann kanoniska SealedQubCbor og tey bæti, sum verða skrivað til varandi goymslupláss. Tann 256-bita lykilin K livir bert í URL-brotinum av avgreiðslu-URL og á brúkaratóleindum; kagar senda ikki URL-brot til ambætarar, so qub.social, hvør goymslupláss-gátt og hvør CDN framman fyri annaðhvørt eru observatiónsliga blind fyri K. Hvør qub í varandi goymslupláss er tí eitt ógjøgnumskygt dulorð, hvørs reintekstur er ógjenfáanligur uttan tann URL, sum høvundurin valdi at deila.

Net-úrslit:

• Uppteljingar-ónæmi sum sjálvsett. Umbúgvd bæti í varandi goymslupláss eru bæti-óskiljanlig frá tilvildarligum dulorði. Ein høstara-strategi um at "GraphQL-fyrispyrja eftir qub-laga upphalanum, masseavkryptera við almennum drand-undirskriftum" endar ikki við reintekst.
• Krypto-smildra privatlív-støða. qub.social kann bókstavliga ikki avkryptera sítt egna savn. Rættarkøll náa dulorð, ikki reintekst.
• Tvey-stigs loyndarstigi. Sjálvsett = leinkju-stýrð atgongd (hesin parturin). Móttakara-krypteraðir privatir qub-ar (ein frátikin Fasa 2-eginleiki, enn ikki tilskilaður) leggjast oman á sum tað annað stig.

13.2 Lagaseting

plaintext body                       ← QubEnvelope.body (§2.2)
  ↓ canonical CBOR (§3)
envelope CBOR
  ↓ tlock encrypt to drand round (§7 step 10)
tlock_ciphertext (inside SealedQub) (§2.3)
  ↓ canonical CBOR (§3)
SealedQubCbor bytes                  ← inner wire artifact
  ↓ AES-256-GCM(K, nonce, AAD=qub_id) (§7 step 12a, this section)
OuterWrapper CBOR bytes              ← uploaded to permanent storage (§7 step 15)

Innsigling og avlæsing á protokollaginum (§7, §8) eru óbroyttar undir umbúgvingar-markinum; umbúgvingin festist á kallstaðnum hjá seal() og loysist á kallstaðnum hjá unlock().

13.3 OuterWrapper Dátubygnaður

struct OuterWrapper {
    version:    u8,           // 0x01, see §12.4
    qub_id:     [u8; 32],     // copied from inner SealedQub; AEAD AAD
    nonce:      [u8; 12],     // 96-bit AEAD nonce
    ciphertext: Vec<u8>,      // AES-256-GCM(K, nonce, SealedQubCbor, AAD=qub_id) || 16-byte tag
}

Teig-stødufeingi.

• version MÁ vera javnt við 0x01 fyri v1.0 umbúgvingsbæti.
• qub_id MÁ vera javnt við qub_id-teigin í tí SealedQub, sum verður endurfingin eftir avumbúgving. Avumbúgvingar-stigið framfylgir hetta ikki beinleiðis (AEAD AAD-bindingin gerð bæti-stigs manipulatión ómøguliga), men avlæsingarlagið kannar sambandið transitivt: um ein høvundur umbúgvir ein SealedQubCbor, hvørs innra qub_id ikki samsvarar umbúgvingar-qub_id, dettur §8 stig 11.
• nonce MÁ vera 96 bitar (12 bæti), nýframleitt av einum CSPRNG fyri hvørja umbúgvingaratgerð. At endurnýta eitt nonce undir sama lykli loyvir AEAD nonce-endurnýtingar-álop, sum endurfáa reintekstin; framleiðarar MÚGVA viðgera (key, nonce)-pør sum einskots.
• ciphertext er AES-256-GCM-úttakið: dulorðsbæti samanbundin við 16-bæti váttanartagi. ciphertext.len() == SealedQubCbor.len() + 16 júst.

CBOR-raðfesting. Kanoniskt CBOR sambært §3, við somu lyklaraðsetingar-regluni (raðað eftir raðfestari bætilongd vaksandi, so leksikografiskt). Teir fýra lyklarnir eru:

Tað fyrsta bæti av OuterWrapper-CBOR er tí tann ávísa-longdar kort-høvur fyri eitt 4-innfetis kort (0xA4).

13.4 AAD-Binding at qub_id

Umbúgvingin bindur qub_id sum AEAD eyka váttaða dáta. Hetta er tann byrðiberandi bygnaðarliga vørnin móti trimum sløgum av álopum:

At bera qub_id í umbúgvingar-reintekstinum veikir ikki uppteljingar-ónæmi munandi — qub_id er sjálvur ein SHA3-256-stytting av §4.1-forímyndini uttan nakra endurfáanliga forímynd úr styttingini, og ein uppteljari, sum longu hevur høstað umbúgvingar-bætini, lærir einki av tí sjónliga qub_id, sum hann ikki kundi sluttað sær til frá tilveruni av sjálvari upphalanini.

13.5 Umbúgvingar- og Avumbúgvingar-Algoritmar

wrap_sealed_qub(SealedQubCbor S, qub_id Q, key K, nonce N):
    require K.len() == 32 and N.len() == 12 and Q.len() == 32
    C := AES_256_GCM_encrypt(key=K, nonce=N, msg=S, aad=Q)
    // C includes the 16-byte authentication tag at the end
    return canonical_cbor_encode(OuterWrapper{
        version:    0x01,
        qub_id:     Q,
        nonce:      N,
        ciphertext: C,
    })

unwrap_sealed_qub(OuterWrapper bytes W, key K):
    require K.len() == 32
    O := canonical_cbor_decode(W) as OuterWrapper
    require O.version == 0x01           // §12.4
    P := AES_256_GCM_decrypt(
            key=K, nonce=O.nonce, ciphertext=O.ciphertext, aad=O.qub_id
         )
    // any AEAD failure → DECRYPT_FAILED, indistinguishable to caller
    return P                            // P is the inner SealedQubCbor

Feilstøðu-samanfall. Skeivur K, skeivt nonce, AAD-misrætt og manipulerað dulorð framleiða øll sama DECRYPT_FAILED-feil. Hetta er ein viljaður AEAD-eginleiki: at skilja feilstøðuna fór at gjørt eina síðukanal, sum ein fjar-álopsmaður kundi probað við at senda misformaðar umbúgvingar og taka tíð á svarinum. Tilvísingar-ímótkomningar MÚGVA samanfella allar AEAD-feilir til eina einasta feil-formi.

13.6 Lyklatilfar og Útbýti

Umbúgvingar-lykilin K er eitt 256-bita javnt tilvildarvirði, framleitt fyri hvønn qub av einum CSPRNG. Tilvísingar-ímótkomningarnar fáa hann frá:

• WASM-høvundur: getrandom (WebCrypto undir wasm_js-bakendanum).
• Ambætara-síðu innsiglingar-API-kallari: sín lokali CSPRNG; kallarin veitir og varðveitir K sum wrapper_key_b64url. Workeren nýtir K í minni fyri umbúgvingina, men MÁ IKKI varðveita hann. Hetta letur eina idempotenta endurroynd endurfáa eitt yvirstrikað svar við kallarans varðveitta førleika í staðin fyri at velta á eitt einskots ambætara-framleitt loyndarmál.

Útbýti: K MÁ verða raðfest sum URL-trygt base64 (RFC 4648 §5, eingin fylling) og lagt afturat avgreiðslu-URL sum brot-eindina:

delivery_url = <origin>/c/<arweave_tx_id>#<base64url(K)>

Brotið verður ongantíð sent til nakan ambætara av einum samsvarandi kaga. Endurfáanarkanalar (ambætara-síðu søguskráseting, valfríur teldupost-sjálvsending), sum varðveita tann fulla avgreiðslu-URL — íroknað brotið — út um brúkarans tóleind, eru eitt skilt skifti móti tí sjálvsettu krypto-smildru-støðuni og MÚGVA verða gátta á uttrýkiligu brúkarasamtykki.

Brot-tap. Um ein brúkari missir URL-brotið og hevur ongan endurfáanarkanal, er qub ólesiligur. Hetta er tað byrðiberandi skiftið í sniðnum og MÁ verða greitt frá fyri brúkaranum á innsiglingartíð. MVP styrkir innsiglingartíðar-frágreiðingina við uttrýkiligum "goym hendan URL"-tekst og einum verifiseraðum-teldupost endurfáanarkanali fyri brúkarar, sum velja tað.

13.7 Utanmark fyri Hendan Partin

• Høvundaundirskriving (§9) er óbroytt: undirskriftir verða roknaðar innan í tí innra QubEnvelope og verða endurfingnar eftir avumbúgving → tlock-avkryptering → CBOR-tólking.
• Móttakara-krypteraðir privatir qub-ar (ein frátikin Fasa 2-eginleiki, enn ikki tilskilaður) leggjast oman á hesa umbúgving sum eitt annað loyndarstig; bæði stigini kunnu vera virkin samstundis.
• Paktir (§6, content_type 0x03) verða umbúgvdir júst eins og tekst-qub-ar; umbúgvingin er bæti-blind fyri innra innihaldsslag.

13.8 Almennir qub-ar (umbúgvingar-burturlating)

Tann ytri umbúgvingin er valfrí á avgreiðslulaginum. Ein høvundur kann innsigla ein qub sum almennan, og í tí føri verður tann kanoniski SealedQubCbor skrivaður til varandi goymslupláss beinleiðis, uttan nakað OuterWrapper-lag og uttan nakran lykil K:

SealedQubCbor bytes  ──(public)──▶  uploaded to permanent storage as-is
SealedQubCbor bytes  ──(private)─▶  AES-256-GCM(K, …) ▶ OuterWrapper ▶ uploaded

Ein almennur qub er tíðarlæstur men ikki leinkju-stýrdur: hann verður verandi ólesiligur fram til drand-runda hansara verður útgivin (tlock-lagið er óbroytt), men eftir avlæsing kann hvør, sum hevur arweave_tx_id, avkryptera hann — eingin URL-brot-eind er kravd, tí einki K er. Hetta er tað viljaða skiftið fyri yvirbríkar, sum ambætarin má dríva: avdúkingar-fráboðanar-teldupostar, triðjamanna-embeds og ríkari eftir-avdúkingar-SEO krevja øll eina leinkju, sum riggar uttan ein loyndarleynd, sum ambætarin ongantíð heldur (§13.6).

Avleiðingar, sum ein framleiðari MÁ taka hædd fyri:

• Einki uppteljingar-ónæmi. Almennir qub-ar geva frá sær §13.1-uppteljingar-ónæmis-eginleikan við bygnaði. Tilvísingar-upphalanartænastan stemplar eitt Visibility: public varandi-goymslupláss-merki á teir (og bert teir), so teir eru viljaðir uppdagiligir; privatir qub-ar bera einki sovorðið merki og halda síni bæti-óskiljanleika.
• Reintekst-heiti útsett á innsiglingartíð. §3.2-title-teigurin er reintekstur innan í SealedQubCbor. Undir umbúgvingini er hann fjaldur, til ein lesari letur upp K; uttan umbúgvingina er hann heimslesiligur á varandi goymslupláss frá tí løtu hann verður upphalaður, áðrenn avlæsing. Samsvarandi høvunda-appar MÚGVA greiða frá hesum á innsiglingartíð.
• Uppdaging er bygnaðarlig. Ein samsvarandi lesari/embed skilir hesi tvey skapini sundur við tólking: bæti, sum tólkast sum OuterWrapper, taka avumbúgvingar-við-K-leiðina; bæti, sum tólkast sum ein berur SealedQubCbor, verða góðtikin beinleiðis. Eingin tráðarmerking er kravd, og qub_id bindur ikki sýni — tað sama innihaldið er bæti-eins á SealedQub-laginum, hvørt tað er innsiglað almennt ella privat.

Privatur (umbúgvdur) verður verandi sjálvsettur; almennur er eitt uttrýkiligt høvunda-val fyri hvønn qub.

14. Royndarvektorir

14.1 qub_id Avleiðing

Input:
  version      = 0x01
  content_type = 0x01
  created_at   = 1735689600 (2025-01-01 00:00:00 UTC)
  unlock_at    = 1736294400 (2025-01-08 00:00:00 UTC)
  outcome_at   = absent
  drand_round  = 4695445  (= (1736294400 - 1595431050) / 30, drand mainnet params §14.2)
  body         = "Hello, future."  (UTF-8, 14 bytes)
  title        = absent

Intermediate:
  body_hash  = SHA3-256("Hello, future.")
             = 76ab8b3f843c6ed4f2d0fd75b9f457b4
               ad49dd4450f9c22723ae430e3af3211d
  title_hash = [0u8; 32]   (title absent — §4.2.1 sentinel)

Domain separator (10 bytes):
  [0x51, 0x55, 0x42, 0x5F, 0x49, 0x44, 0x5F, 0x56, 0x32, 0x00]

Preimage (108 bytes — V1.2):
  domain_separator    ||  // 10 bytes
  0x01                ||  // version
  0x01                ||  // content_type
  0x0000000067748580  ||  // created_at as i64 big-endian (1735689600)
  0x00000000677DC000  ||  // unlock_at as i64 big-endian (1736294400)
  0x0000000000000000  ||  // outcome_at_or_zero (outcome_at absent)
  0x000000000047A595  ||  // drand_round as u64 big-endian (4695445)
  body_hash           ||  // 32 bytes
  title_hash              // 32 bytes (all-zeros sentinel; title absent)

Expected output:
  qub_id = SHA3-256(preimage)
         = 3a9fcb31b750d985c262fada6d4f777f
           d6a28be831d941d85c131f5a4bbaf8a4

Ímótkomningar MÚGVA framleiða eins body_hash- og qub_id-virði fyri hetta inntakið. Hesin royndarvektorin EIGUR at vera tann fyrsta eindarroyndin, sum verður skrivað. Tey kanonisku virðini omanfyri vórðu roknað av tilvísingar-ímótkomningini og MÚGVA samsvara bita fyri bita. Søguligar forímynd-skipanir (fyrr-byrjan — eingir livandi qub-ar veltu á hesum): tann 92-bæta V1.0 qub_id var 3d9fc2390eab043d38a1669ed3b71be76f9eefe872b9569ab1aaa027b88392b0; tann 100-bæta V1.1 qub_id (eftir at outcome_at_or_zero varð felt inn) var b0d032898ad629795150fdcb3f84e518f59ed05b7a2a82bc24ebdb87f52144ed. V1.2 fellir drand_round inn og økir økisskiljaran til QUB_ID_V2.

14.2 Avlæsingarrunda-Kortlegging

Input:
  unlock_at           = 1735689600
  chain_genesis_time  = 1595431050
  chain_period_seconds = 30

Calculation:
  (1735689600 - 1595431050) / 30 = 4675285.0
  ceil(4675285.0) = 4675285

drand_round = 4675285

14.3 Kanoniskt CBOR Hringferð

Ímótkomningar MÚGVA vátta, at serialize(parse(serialize(qub))) == serialize(qub) fyri øll gildug inntøk. Hetta er ein eginleikaroynd, ikki ein einstakur vektorur.

14.4 PactTerms CBOR (content_type 0x03)

Input:
  pact_version = 1
  title        = "Scooter deposit"
  terms        = [
    { key: "Item",    value: "Honda Metropolitan scooter" },
    { key: "Price",   value: "$100" },
    { key: "Deposit", value: "$10" }
  ]
  party_a      = { label: "Alice" }
  party_b      = { label: "Bob", contact: "bob@example.com" }
  notes        = absent

Canonical CBOR key order (PactTerms):
  "notes"(6) < "terms"(6) < "title"(6) < "party_a"(8) < "party_b"(8) < "pact_version"(13)

Canonical CBOR key order (PactTerm):
  "key"(4) < "value"(6)

Canonical CBOR key order (PartyIdentifier):
  "label"(6) < "contact"(8)

Tey kanonisku CBOR-bætini og SHA3-256 body_hash verða roknað av tilvísingar-ímótkomningini. Ímótkomningar MÚGVA framleiða bæti-eins CBOR fyri hetta inntakið.

Ímótkomningar MÚGVA eisini vátta, at serialize(parse(serialize(pact))) == serialize(pact) fyri øll gildug PactTerms-inntøk (eginleikaroynd).

14.5 Ytri Umbúgving Tvørmáls-Vektorir

Tann ytri umbúgvingin (§13) hevur eina sjálvstøðuga kanoniska grundgrein á crates/qub-core/tests/vectors/wrapper_v1.json. Hvørt føri fastsetur eitt (key, nonce, qub_id, sealed_cbor)-tupul sum ógjøgnumskygd hex-inntøk og áseta eitt ávíst expected_wrapper_hex-úttak. Báðar tilvísingar-ímótkomningarnar nýta sama JSON-fílu:

• Rust: crates/qub-core/tests/wrapper_vectors.rs (cargo test -p qub-core --test wrapper_vectors).
• TypeScript: workers/api/src/crypto/__tests__/wrapper.test.ts (npm test).

Grundgreinin fastsetur fyri tíðina trý føri:

Ímótkomningar MÚGVA framleiða bæti-eins expected_wrapper_hex fyri tey skrásettu inntøkini. At endurgenera grundgreinina krevur QUB_REGEN_VECTORS=1 cargo test -p qub-core --test wrapper_vectors og er varðveitt fyri skildar snið-broytingar.

15. Krypto-Profil Stýring (Framtíð)

Hesin parturin er upplýsandi fyri v1 og verður normativur fyrstu ferð, eitt annað algoritmur fer inn í nakra av qubs kryptografisku grundleggjandi eindunum.

15.1 Núverandi Støða

Protokollur v1 bindur júst ein algoritm fyri hvørt grundleggjandi eind:

• Undirskrift: ML-DSA-65 (sig_alg = 0x01; 1952-bæti alment lyklað, 3309-bæti undirskrift) og óundirskrivað (sig_alg = 0x00). Skrásetingin í §9.2 definerar onki annað virði; ein v1-verifiserari MÚGVA avvísa hvørt sig_alg uttan fyri {0x00, 0x01}. Ein framtíðar Ed25519-inngongd verður væntað (§15.3) men er ikki tillutað í v1.
• Tíðarlás: drand quicknet bert — keðju-styttingin, almenni lykilin, upprunatíðin og tíðarbilið eru fast netverksparametrar, sum tilvísingar-DrandTimelockProvider::quicknet() (crates/qub-core/src/tlock.rs) og config/drand-endpoints.json bera.
• Ytri umbúgving: AES-256-GCM v1 bert (§13).

Verifiserarar fastkoda í dag lykla- og undirskriftarlongdir fyri hvørt grundleggjandi eind. Eingin smidugleika-yvirvødd verður víst av tráðasniðnum.

15.2 Ætlaða Lag

Tá ið eitt annað algoritmur fer inn í protokollin, verður verifiserarin settur upp fyri ein nevndan CryptoProfile (t.d., ExqubV1), sum listir tað júst settið av loyvdum virðum fyri hvørt grundleggjandi eind — sig_algs, drand-keðjur, umbúgvingsútgávur, innihaldsslag. Profilið er fastsett á verifikatiónstíð, ongantíð samhandlað í-band. Hvørt virði uttanfyri tað virkna profilið verður avvíst.

Hetta tryggjar, at at leggja ML-DSA-87 afturat ella at virkja Ed25519 kann ikki afturvirkandi veikja tilstaðarverandi verifiserara-uppsetingar: ein v1-verifiserari verður verandi ein v1-verifiserari, sjálvt eftir at eitt v2-profil er útgivið.

15.3 Útloysingartreytir

Lyft §15 til normativa støðu, tá ið nakað av tí fylgjandi verður fyriskotið:

• Eitt annað sig_alg-bæti (Ed25519-virkjan, ML-DSA-87, ella nøkur nýggj innfeting í §9-skrásetingina).
• Ein onnur drand-keðja í framleiðslu-nýtslu.
• Ein onnur ytri-umbúgvingsútgáva.

Til tá er §15 ein staðhaldari, sum fastsetur flytingar-lagið, so framtíðar PRar lenda móti einum kendum máli heldur enn at endurmeta samhandlingar-yvirvøddina frá byrjan.

16. Gjøgnumskygnis-Logg og Varandi-Stig (Snið — endurskoðan liðug)

Støða. Hesin parturin er ein sniðtilskilan. Tráðasniðini, styttingin og trygdarmyndilin niðanfyri eru normativ fyri ímótkomningina, men eingin gjøgnumskygnis-logg-kotur er enn farin í verk. W5 ytri endurskoðanin er liðug: §16.15 skrásetir tær loystu avgerðirnar og tær bindandi byrjunartreytir, sum komu út úr henni. Ímótkomning kann fara fram undir hesum treytum. §16 verður verandi framsýnandi í somu meining sum §15 — hon fastsetur málið, so ímótkomningin lendir móti einum settum sniði heldur enn at endurleiða trygdarmyndilin í kotuendurskoðan. Hon er strangt viðbótarlig — hvør verandi qub heldur sína egnu Arweave-flutning, og tað er eingin broyting í SealedQub / QubEnvelope-tráðasniðnum.

16.1 Grundgeving og Varandi-Stig

Í dag hvíla bæði varandugleiki hjá einum qub og tíðar-skuldbindingin á einari einastu Arweave-flutning fyri hvønn qub (§11). Tað bindur innsiglingar-bíðanina at Arweave-endaligheit, ger upphalanina fyri hvønn qub til eitt vøru-kostnaðartak (ARWEAVE_DAILY_CEILING), og gevur onga manipulatiónsstaðfestandi raðseting tvørtur um qub-ar. Gjøgnumskygnis-loggin leggur tvey løg undir og rundan um hetta einasta stig:

T2 ger Arweave fyri hvønn qub til eitt val (T3) heldur enn tann einasta varandugleika-vegin. ARWEAVE_DAILY_CEILING verður avtikin sum vøru-tak og lækkað til ein streymbrótara bert á tí serstaka akker-veskinum (§16.7); innsiglingar hjá brúkarum verða ongantíð avvístar fyri at fara um tað.

Varandugleika-ærligheit (loyst — §16.15 Q6). Varandugleiki dálkar ikki afturábak: T1 R2-skrivingin er samstundis og skriva-einaferð, so ein ókeypis-stigs qub, sum ikki keypti T3, er fult varandi tann løtu innsiglingin kemur aftur. Tað, sum verður grovari, er tann prógvanliga yvirmark-skuldbindingartíðin: fyri ein ókeypis qub verður hon akker-blokk-tíðin heldur enn ein blokk-tíð fyri eina flutning fyri hvønn qub. Við lágum nøgd — tann veruliga tíðliga-byrjunar- og dálítla-niða-støðan — er tann fulli dagligi taktur tann vanligi grunnur, ikki ein sjáldsamur jaðari. Vøru-raðseting er tí eitt yvirmark við ongari skuldbundnari talvíri bíðan — "innsiglað og varandi nú; eitt óheft alment tíðarmerki verður lagt afturat við næsta logg-akker (vanliga dagliga)" — og nákvæmt-tíma skuldbindingar-prógv er ein goldin T3-eginleiki, framlagdur á stig-samanberingar-flatuni og í treytum (§16.11, §16.15 Q6). Hvør tíðar-mark er bert ein innvortis SLO, ongantíð ein marknaðarført SLA.

16.2 LogLeaf Bygnaður (tvey skuldbundin skap)

Ein logg-innfeting er ein LogLeaf, raðfest sum handskrivað kanoniskt CBOR undir §3.1-profilinum (ávísa longd, eingin tøgg, eingin flótitøl, stytstu-form heiltøl, NFC-tekstur, valfríir teigar útilatnir tá ið fráverandi, lyklar raðaðir eftir raðfestari bætilongd vaksandi, so bætivís). §3.1 parse → re-encode → compare-kanoniski varðin verður settur á raðfestingar-leiðina áðrenn stytting (ikki bert á tólking), so tvær ímótkomningar kunnu ikki vera ósamdar um blað-bætini gjøgnum eitt heiltal-breidd- ella lykla-raðsetingar-munur. Øll heiltøl eru u8 / u64 / i64; allar styttingar eru 32-bæti bætistrongir (bstr[32]). Eitt goymt Arweave-flutningseyðkenni er ein rá 32-bæti SHA-256-stytting borin sum bstr[32], ongantíð ein base64url-tekststrongur (samsvarar §3.3).

Blaðið hevur tvey skap vald av einum kind-bæti, tí á sjálvsettu upphalanarleiðini er Worker bæti-blindur: POST /api/v1/upload fær bert qub_id og unlock_at sum ótreysta klient-fullyrðingar — body_hash, drand_round, created_at og drand_chain_version eru øll innsiglað inni í §13 ytru umbúgvingini, hvørs lykil Worker ongantíð heldur. Bert ambætara-innsiglingar-leiðin (POST /api/v1/seal) leiðir body_hash / drand_round av reintekstinum. Eitt einasta blað-skap, sum bar body_hash + drand_round, fór tí at skuldbundið virði, sum rekstrarmaðurin ongantíð verifiseraði fyri meginpartin av veruligum qub-um. Klovningin heldur hvørt skuldbundið virði ærligt:

Eitt kind=0x02-blað skuldbindur við vilja hvørki body_hash ella drand_round: tað váttar skuldbindingina og raðsetingina av einum ógjøgnumskygdum dulorði á innihaldsadressu chash, sum fullyrðir qub_id og unlock_at — ikki reintekst tess ella rundu. Reintekst-/rundu-leggirnir fyri ein fullyrtan qub koma frá tí verandi §11 .qub-bólkar-verifikatión, ikki frá logginum (§16.11). drand_chain_version er ikki í blaðnum (tað er inni í umbúgvingini á sjálvsettu leiðini); keðju-fínkornleiki livir á akkerinum (§16.7). Raðfestar-agi: avvís eitt øll-null ref ella chash, og avvís ikki-positivt unlock_at / received_at, ímóti outcome_at > 0-sentinel-varðanum í cbor.rs.

16.2.1 Privat-qub blinding

Loggin má ikki verða tann uppteljingar-orakul, sum §13 ytra umbúgvingin er til at forða (§13.1). Fyri ein privatan (umbúgvdan) qub skuldbindur asserted-blaðið tað blindaða eyðkennið SHA3-256(qub_id ‖ log_blind_secret), har log_blind_secret er ein ambætara-hildin loynd, og letur body_hash úti. Ein triðjapartur kann ikki binda eitt sovorðið blað at einum ávísum qub_id; haldarin av qub, sum hevur avgreiðslu-URL og tí qub_id, kann endurrokna blindingina til at vátta sína egnu íroknan. Ein almennur qub (longu uppteljiligur, longu berandi Visibility: public Arweave-merkið sambært §13.8) skuldbindur tað rá qub_id. Hetta er tann eini staðurin, har sjálvstøðug verifiserbarheit við vilja víkur fyri einari byrðiberandi privatlívs-grundregli; tann sjálvstøðuga bindingin fyri privatar qub-ar er chash (§16.9).

log_blind_secret umsiting (loyst — §16.15 Q4). Blindingin verjir blað-ósamanbindiligheit, ikki reintekst-loyndarhald (§13 umbúgvingin heldur tað óheft). Við einari log_blind_secret-brot, fyri hvørt qub_id, sum mótstøðumaðurin longu heldur ella kann endurbyggja (hvør qub, hvørs bólk/URL hann hevur, umframt hvørt lágt-entropi ella alment qub_id), endurroknar hann blað-ref í einari styttingar og bindur tað — hetta er beinleiðis binding av einum kendum nøgd, ikki ein brút-kraft-leiting yvir eitt ókent rúm. Flokka log_blind_secret sum eina samanbindingar-/Sybil-stigs loynd í sama umsitingar-stigi sum aðrar ambætara-loyndir, og rotera bert frameftir (ein rotatión blindar framtíðar blað av nýggjum; hon kann ikki afturvirkandi loysa longu-akkrað).

16.3 Blað- og Knútastytting

RFC 6962 §2.1 økis-skild stytting við SHA-256 avloyst av SHA3-256:

leaf_hash      = SHA3-256(0x00 || canonical_cbor(LogLeaf))
node_hash(l,r) = SHA3-256(0x01 || l || r)
empty tree     = SHA3-256("")          // defined but never anchored

Økis-forskeyti-bætini 0x02 (innfetingar-keðja, §16.4) og 0x03 (STH-stytting, §16.6) eru varðveitt og sundurskild frá hesum. Tey eru einbæti og kunnu tí ikki samanfalla við tey verandi 10-bæti ASCII-økisskiljararnar (QUB_ID_V2, o.s.fr.). Træið er tað RFC 6962 vinstra-fulla óbalanseraða træ (hvør innri klovningur við størsta tváveldi strangt minni enn blað-talið í undirtræinum), sum letur íroknanar- og samsvars-prógv deila eina endurskoðanar-leið-algoritmu. Tilvísingar-tilskilanin ber uttrýkiligt vinstra/høgra-avleiðingar-pseudokotu og fastsetur ein ikki-tváveldis (5-blaða) royndarvektor, so høgra-eggjar-flytingar-førið — sum ein 4-blaða vektorur fjalir — verður roynt.

16.4 Stytting-Keðjing (innvortis)

LogDO heldur eina innvortis innfetingar-keðju bert til brot-samsvars. Hon verður ongantíð útgivin og ongantíð verifiserara-vend:

entry_chain[seq] = SHA3-256(0x02 || entry_chain[seq-1] || leaf_hash[seq])
entry_chain[-1]  = SHA3-256("QUB_TLOG_GENESIS_V1")

Tann útgivna bert-viðbótar-myndugleikin er tann savnaða Merkle-rótin + akker tess (§16.5–16.6), ongantíð tann rá raðseting, sum rekstrarmaðurin tilvildarliga sendir blað í: keðjan endurroknast fyri hvørja raðseting, sum verður send, so bert tann akkraða rótin festir kanoniska staðin.

16.5 Savnað Merkle-Træ og Bólking

Tað er eitt ævinliga-vaksandi RFC 6962-træ yvir øll blað í seq-raðseting — ikki einstøk per-bólk-træ. (Ein bera-blað-keðjað per-bólk-bygging varð avvíst: tað er ikki eitt veruligt forskeytis-samband, so tess "samsvars-prógv" eru ógrundað.) Tað savnaða træið gevur veruliga RFC 9162 samsvars-prógv og letur eitt einasta nýligt akker prógva íroknan fyri hvønn eldri qub.

LogDO Durable Object er tann einasti skrivari (blockConcurrencyWhile, ímóti QuotaDO / EntitlementDO) — at viðbøta til ein deildan logg er les-broyt-skriva á deildari støðu og MÁ tí fara gjøgnum eitt DO, ongantíð KV. Tað goymir træsins høgra-eggjar-fronti (O(log n) styttingar), so at lata aftur ein bólk er O(batch). Ein bólkur er settið av blaðum akkrað saman; útloysingartreytir hansara eru stillanligar, ikki protokoll-frystar: eitt tree_size-framgongd av í minsta lagi LOG_BATCH_MAX_LEAVES (sjálvsett 4096), ella aldur, sum náar akker-taktinum, ella ein noyðug skoling, tá ið ein goldin T3-innsigling lendir. root_i er tann savnaða Merkle-træstyttingin yvir blað 0 .. tree_size_i.

16.6 Undirskrivað Træhøvur gjøgnum Arweave-Akker

Arweave-akker-flutningin er Undirskrivaða Træhøvrið og avloysir eina rekstrarmaður-undirskrift fyri sjálvt træhøvrið: tað dagliga akkerið krevur ongan qub-lykil, tí Arweave-flutnings owner er undirskriftin. Verndarmúr-tesan heldur — tann óbroytiliga undirstøðan, ikki ein qub-hildin loynd, er byrðiberandi fyri akkraðu rótina.

Tað er júst ein heitur qub-undirskriftarlykil í sniðnum, og hann er festur: tann kvittanar-lykilin fyri hvørja innsigling (§16.10). Almenni lykilin hansara er skuldbundin í LogProfile (deildur við verifiseraranum) og kross-undirskrivaður av anchor_owner, so ein verifiserari váttar eina kvittan ímóti tí somu festu rótini sum akkerið. Hetta er loysnin á §16.15 Q2 — ein ófestur, rekstrarmaður-roterandi kvittanar-lykil fór at verið avvísiligur (rekstrarmaðurin kundi noktað, at lykilin var teirra), sum fór at gjørt kvittanarinnar ábyrgdar-virði fyri einki ímóti tí rekstrarmaður-stigs mótstøðumanni, sum kvittanin er til at avskekja. So: qub heldur ongan ófestan logg-undirskriftarlykil; kvittanar-lykilin er festur og anchor_owner-kross-undirskrivaður.

SignedTreeHead er kanoniskt CBOR (lyklar eftir raðfestari longd): size:u64, root:bstr[32], batch:u64, prev:bstr[32] (fyrri sth_hash; genesis = 32 null-bæti), log_id:bstr[32], first_seq:u64, anchored_at:i64. Stytting tess er sth_hash = SHA3-256(0x03 || canonical_cbor(SignedTreeHead)).

Fest trygdarrót. log_id = SHA3-256("QUB_TLOG_V1" || anchor_owner_address). Ein samsvarandi verifiserari MÁ krevja anchor_tx.owner == LogProfile.anchor_owner, har anchor_owner (og kvittanar-lykilsins almenni lykil) er bakaður inn í qub_core sum LogProfile — saman við quicknet-fastvirðunum longu í DrandTimelockProvider::quicknet() — og deildur við verifiserara-binærinum. Verifiserarin MÁ eisini vátta Arweave-flutnings dáta → tx_id-bindingina lokalt heldur enn at troysta á eitt gátt-/raw/-svar. Hetta letur aftur óvera-veskis-tvíræðnis-holið: "akkrað á Arweave" hevur onga meining, fyrr enn verifiserarin festir hvørt veskið.

Rotatión er ein §15-stýringar-víðkan, ikki ein endurnýtsla (loyst — §16.15 Q3). §15.2-profil-flatan listar í dag bert sig_algs / drand-keðjur / umbúgvingsútgávur / innihaldsslag, og §15.3-útloysingartreytirnar lista onga av hesum — LogProfile / anchor_owner er enn ikki í §15-flatuni. Rotatiónsstýring má tí verða bygd: §15.3 verður víðkað (niðanfyri) til at leggja LogProfile-útloysingartreytina afturat, og ein rotatión er eitt undirskrivað LogProfile-lyft sent í einari verifiserara-dagføring. Ein ætlað rotatión ber eina útgangandi → inngangandi kross-undirskrift; ein brots-dripin rotatión kann tað ikki (tann útgangandi lykilin er ótreystur/ótøkur júst tá) og fellur aftur til §15-stýrda lyftið, við fyrri-akker-grein-kanninum (niðanfyri) at marka skaða í millumtíðini.

Tvíræðnis-vindeygað (fyrsta-floks trygdarparametur). Eitt blað er tvíræðnis-mótstøðuført bert tá ið dekkjandi akker tess er Arweave-váttað. Vindeygað er received_at → akker-vátting (≤ taktur + Arweave-endaligheit). Innan tað eru tær einastu tryggingar tann festa innsiglingar-kvittanin (§16.10) og rekstrarliga heild hjá qub. Trý ábyrgdar-tilfar gera hetta ærligt heldur enn handveivt (vitnismyndilin er loysnin á §16.15 Q2):

1. Fest undirskrivað innsiglingar-kvittan — SCT-líkin afturlatin í upphalanar-svarinum (§16.10), undirskrivað av tí festa, anchor_owner-kross-undirskrivaða kvittanar-lyklinum. Eitt blað, sum verður sleppt áðrenn akker tess, letur offrinum eina ónoktiliga kvittan at útgeva, sum letur aftur tøgnar-burturlatingar-holið.
2. Útgivin eftirlits-aðferð + fyrri-keðju-gongd — akker-prev-keðjan verður gingin høvur→genesis; ein grein (tvey akker við einari size við ymiskum root, ella ein brotin prev) er útgevanligt prógv um misbúgving. Tvíræðnis-uppdaging er ein settur rekstrarligur loyvni, ikki ein tøgn forutanseting.
3. Tvíføld sjálvs-útgivin høvur — hvørt nýtt høvur {sth_hash, tree_size} verður sett í eitt serstakt qub-egnað alment, bert-viðbótar GitHub-goymslupláss (tann byrðiberandi manipulatiónsstaðfestandi sjálvs-útgivingar-leggur), við einum sosialum innleggi sum besta-royndar-stuðul bert. Ein miseydnað innlegging MÁ blaðsenda (ikki feila tøgut).

Ærligheits-mark (bindandi treyt). Tí qub stýrir báðum innleggingar-flatum, er hetta sjálvs-útgivið, ikki sjálvstøðugt vitnað. Eingin vøru-, marknaðar- ella rættar-flata kann fullyrða, at loggin er "sjálvstøðugt vitnaður"; tann loyvda fullyrðingin er, at tvíræðni er uppdagiligt og letur eftir eina ónoktiliga kvittan. Eitt veruligt sjálvstøðugt triðjamanns-vitni er frestað til eitt komandi §15-stýringar-lyft.

received_at er rekstrarmaður-fullyrt og eingin fullyrðing kann hvíla á tí — tað verður ongantíð víst sum prógv ella sum klagu-stuðul á nakrari vøru- / rættar- / API- / prógv-framsýningar-flatu. Arweave-akker-blokk-tíðin T er tann eina troystleysa tíðarmerkið (eitt yvirmark á "loggað við"). Hvør eftirlits-skilanskanning á received_at MÁ samanbera ímóti T, ikki ímóti tí rekstrarmaður-stýrda anchored_at-STH-teiginum; ein sovorðin kanning er ein vørn ímóti einum ærligum rekstrarmanns klokku-feili bert, ikki ein ábyrgdar-stýring ímóti einum óndskaplig rekstrarmanni (§16.15 Q5).

16.7 Akker-Flutningar-Snið og Taktur

AnchorBundle er tann kanoniska-CBOR Arweave-flutningar-likamið, skrivað gjøgnum §16.8-bólkaran: ver:u8, sth:bstr (kanonisk SignedTreeHead-bæti), prev_anchor:bstr (fyrri akker-flutnings eyðkenni rá bæti; útilatið við genesis), chain_hash:tstr (drand-keðjan í gildi — quicknet), og bólksins blað-CBOR-streymur í seq-raðseting, so akkerið er sjálvinnihaldandi: ein eftirlitsmaður endurleiðir root av likaminum við ongari qub-treytan. (Um blað-streymurin verður stórur við høgum nøgd, kann ein framtíðar endurskoðan skuldbinda bert eitt blað-bil við tilvísing; nevnt, ikki tikið upp í v1.)

Arweave-merki eru við vilja uppteljilig — loggin er ætlaður at verða funnin, ósamlíkt privatum qub-um: App-Name: qub-tlog, Anchor-Format: 1, Log-Id: <hex>, Batch: <n>, Tree-Size: <n>, Root: <hex>, Prev-Anchor: <tx>, Content-Type: application/cbor. Merki eru ótreystir hint; CBOR-likamið er einasti myndugleiki.

Taktur: dagliga sum sjálvsett, endurskoðað við nøgd (stødd-útloysingartreytin styttir av sær taktin undir álagi); ein goldin T3-innsigling noyðir eitt akker, so goldnir kundar bíða ongantíð ein dag. Akker-veskið er serstakt og lágt-ferðar, skilt frá upphalanar-veskinum — tað MÁ vera sítt egna JWK (ein ávísur lykil, ikki ein logiskur leiklutur á upphalanar-veskinum), so ein upphalanar-veskis-brot kann ikki fyrifalsa akker — við einum hørðum dagligum akker-flutningar-fíggjarætlan (tað lækkaða ARWEAVE_DAILY_CEILING). Umsitingar-støðan verður greitt frá: ein trongt-skopaður heitur lykil við einum strongum streymbrótara og lágari íðstøðu, ikki "kaldur" — eitt veski, sum sjálvs-undirskrivar dagliga, kann ikki vera kalt, og tilskilanin lætast ikki sum so.

16.8 ANS-104 Bólkari

Ein innanhýsis ANS-104 DataItem-raðfestari og djúp-stytting-undirskrivari, umleið 300 reglur, bert Web Crypto, núll npm-treytan (báðir Turbo SDKar falla á npm ci --ignore-scripts-forsýningar-keðju-gáttini). DataItem-bætilag:

signatureType (2, LE) || raw_signature || owner || target(flag+0|32) || anchor(flag+0|32) || num_tags(8, LE) || tags_len(8, LE) || avro_tags || data

Undirskriving er Arweave deepHash — ein endurkomandi SHA-384-stytting (Arweave-tráðakrav, crypto.subtle.digest("SHA-384")) yvir ["dataitem", "1", sig_type, owner, target, anchor, encoded_tags, data] — síðan RSA-PSS yvir djúpu styttingina við veskis-JWK gjøgnum crypto.subtle; id = base64url(SHA-256(signature)). SHA-384 her er avgirt sum ein Arweave-tráða-bert grundleggjandi eind, ongantíð ein qub-trygdar-grundleggjandi eind (§15 skrásetir múrin; qub-trygdar-stytting er SHA3-256 alstaðni).

Ein kotuleið tænar trimum nýtarum: goldin T3-varandugleiki fyri hvønn qub, Arweave-ótøkis-fráfallið (køa DataItem, lat R2-fyrst-váttanina aftur kortini — hetta letur aftur tann verandi ARWEAVE_UNAVAILABLE 503-deyðendan), og at skriva AnchorBundle. Undirskriftarskema (loyst — §16.15 Q8): v1 undirskrivar við RSA-PSS (undirskriftarslag 1) og endurnýtir tann verandi Arweave-veskis-JWK-háttin (núll nýggj langlívað lykla-umsiting, sum tænar "ein loynd færri"-tesuni); Ed25519 er frestað til §15 PQ-flytingar-leiðina.

Tann handveltaða djúp-styttingin er tann hægsta-vandi, lægsta-natúrliga-fevjings kotan í W5, so gáttin hennara er óforhandlanlig (§16.15 Q8):

1. Tann tvørmáls-grundgrein tlog_v1.json (Rust + TS, §14.5 wrapper_v1.json-myndilin) fevnir djúp-stytting, DataItem-bæti + id, blað-styttingar, eina 5-blaða rót + endurskoðanar-leið, eina STH-stytting, eitt íroknanar-prógv og eitt samsvars-prógv — í báðum undirskrivar- og verifiserar-leiðunum (verifiserar-leiðin hevur týdning, tí §16.6-lokala tx → tx_id-kanningin dregur djúpu styttingina inn í hvønn sjálvstøðugan verifiserara, ikki bert skrivaran).
2. Ein einaferðar interop-hringferð gjøgnum ein tilvísingar ANS-104-bólkara, nýtt sum bert støðug royndardáta — ongantíð ein npm-koyringartreytan (Web-Crypto-bert / eingin-installeringar-kotur-støðan stendur).
3. Djúp-stytting + RSA-PSS-leiðin má fara hringferð gjøgnum somu crypto.subtle-grundleggjandi eindir, sum framleiðsla nýtir, so innanhýsis-raðfestarin er bæti-samsvarandi.
4. Eitt áhaldandi eftir-bólks góðkenningar-eftirlit váttar, at hvørt akker / fráfalls-DataItem veruliga náar Arweave-góðkenning, við einari ávaring + streymbrótara — tí djúpa styttingin tænar eisini Arweave-ótøkis-fráfalls-køuni, so ein tøgn dálking fór at fylt tá køu við net-avvístum lutum júst undir tí avbroti, sum hon er til at dekkja.

16.9 Íroknanar- og Samsvars-Prógv

Bæði eru RFC 9162, SHA3-256, tænað sum kanoniskt CBOR.

InclusionProof — GET /api/v1/qub/:tx_id/proof: ver:u8, leaf:bstr (tann júsið blað-CBOR — verifiserarin endurroknar leaf_hash sjálvur og troystar ongantíð á eina latna stytting), index:u64, size:u64, audit:[bstr[32]], root:bstr[32], anchor:{ txid:bstr[32], batch:u64, sth:bstr[32], log_id:bstr[32], block_height?:u64, anchored_at?:i64 }.

ConsistencyProof — GET /api/v1/log/consistency?first=<size_a>&second=<size_b>: ver:u8, first_size:u64, second_size:u64, first_root:bstr[32], second_root:bstr[32], nodes:[bstr[32]], first_anchor, second_anchor. Ein einasti ótvíræður lykla-listi, festur av royndarvektori.

Sjálvstøðug verifikatión (eingin qub-ambætari, víðkar §11):

1.  Parse .qub bundle → SealedQub; recompute qub_id (§4.1).
2.  Read leaf.kind.
3a. kind=0x01 (attested):
      assert leaf.ref == qub_id
      assert leaf.body_hash   == SHA3-256(body)
      assert leaf.drand_round == unlock_round(unlock_at)
3b. kind=0x02 (asserted):
      assert leaf.ref == SHA3-256(qub_id || blind)   // holder supplies blind
      OR treat ref as opaque and bind via leaf.chash == SHA3-256(stored_bytes)
4.  Recompute leaf_hash = SHA3-256(0x00 || leaf); fold `audit` per RFC 6962
    using index/size; require derived root == proof.root.
5.  Fetch anchor.txid from any gateway; verify the tx data → tx_id binding
    (do not trust a gateway /raw/ response); REQUIRE anchor_tx.owner ==
    LogProfile.anchor_owner.
6.  Parse AnchorBundle; require committed root == proof.root and size ==
    proof.size; read the Arweave block time T.
7.  Emit the claim scoped by leaf.kind (§16.11).

Prógv-tænandi goymslupláss MÁ vera samsýtis-lyklað (loyst — §16.15 Q7, blokerandi forutanseting). Kald-blað-prógv-framleiðsla er rættleika-newtral bert um R2-endurskoðanartilfarið er ein varandi Merkle-knútastoyti lyklað eftir absoluttari træ-samsýtis (level, index) — ikki per-batch-knúta-deltum. Við einum samsýtis-lyklaðum stoyti er hvør (leaf i, size N)-endurskoðanar-leið eitt sett av O(log N) beinleiðis R2 GET-um við ongari endurrokning tvørtur um bólkamørk; við einum bólk-lyklaðum stoyti er tað ikki, sum er tann goymslulags-glopp, sum henda loysn letur aftur. Blað-likamir eru somuleiðis innihaldsadresserbar eftir seq. Ein W5-royndarvektor MÁ prógva eitt genesis-aldurs kald blað ímóti einari nógv-seinni rót við bert R2 + Arweave, og við LogDO-goymslupláss strikað, so endurnýtslu-trygdar-fullyrðingin í §16.13 verður stuðlað heldur enn fullyrt. Tey O(log N) raðfylgjandi R2 GET hoyra bert til tann ósamstundisa prógv-endapunktin — ongantíð til innsiglingar-heitleiðina (§16.10) ella ein per-takt cron.

16.10 R2-Fyrst Váttanar-Raðseting

POST /api/v1/upload-raðin verður:

1. Frammanfyri-gáttir (váttan, vátting, ídempotensu-deilis-lykil) — óbroyttar.
2. Samstundis await QUB_CACHE.put(qub-cache/<tx_id>, wrappedBytes) — varandugleika-grunnurin; letur eisini aftur W1s forcache-kapping (áður eitt ctx.waitUntil eftir Arweave-innsendingina).
3. Samstundis await LogDO.append(leaf) — eitt í-koloni DO RPC; einasti skrivari tillutar seq, víðkar innfetingar-keðjuna og dagførir frontin. (RMW á deildari støðu → DO, ongantíð KV.) append RPC ger bert tað — O(batch) Merkle-bólk-aftur-lat-arbeiðið koyrir av hesum RPC á LogDO-vekjaranum, ella append p95 spikar hvønn LOG_BATCH_MAX_LEAVES-tu innsigling.
4. Lat váttanina aftur nú — við innsiglingar-kvittanini (undirskrivað av tí festa kvittanar-lyklinum, §16.6) og { tx_id, log_seq, anchor_status: "pending" }. Tann fleiri-sekund Arweave-útbreiðingin er tikin av kritisku leiðini.
5. Eitt ctx.waitUntil køar tað frestaða arbeiðið: Arweave-innsendingin fyri hvønn qub (nú besta-royndar / goldin; við miseydnan leiðir hon til bólkar-fráfalls-køu heldur enn at 503-a brúkaran) umframt tær verandi fyribils-meta-skrivingar. Bólk-aftur-lat og akkring koyra óheft frá LogDO-vekjaranum og dagliga akker-croninum. Einki ctx.waitUntil inni í einari lykkju; tann verandi ídempotensu-deilis-lykilin verður varðveittur.

Bíðanar-fíggjarætlan (loyst — §16.15 Q7). < 300 ms p95-málið er ein mátad byrjunar-gátt, ikki ein forutanseting. Tann ærliga kritiska leiðin er frammanfyri KV-lesingar + ein R2 PUT + tveir raðfylgdir Durable Objects — tann verandi QuotaDO innsiglingar-nøgd-skuld og tann nýggi LogDO append — so fíggjarætlanin má taka hædd fyri tveimum í-koloni DO-hringferðum, ikki einari. Send ein LogDO-bíðanar-vekjara, sum speglar QuotaDOs, og viðger eina p95-dálking sum ein útgávu-blokering.

16.11 Trygdarmyndil — tann nákvæma fullyrðingin, skopað eftir blað-kind

Fyri kind=0x01 (váttað): "Hetta innihald — likam, sum samsvarar body_hash, eyðmerkt av qub_id — varð skuldbundið til qubs bert-viðbótar-logg á støðu seq og var til ikki seinni enn Arweave-blokk-tíð T; tað var kryptografiskt ólesiligt fram til drand-runda R = unlock_round(unlock_at)." Hetta er tann fulli {tlock runda-binding + Merkle-íroknan + akkrað rót}-trípulin.

Fyri kind=0x02 (fullyrt, tað sjálvsetta): "Eitt ógjøgnumskygt dulorð við innihaldsadressu chash, sum fullyrðir qub_id og unlock_at, varð skuldbundið til bert-viðbótar-loggin á støðu seq og var til ikki seinni enn Arweave-blokk-tíð T." Rundu- og likams-leggirnir verða latnir av tí verandi §11 .qub-bólkar-verifikatión (qub_core::unlock), ikki av logginum; tað, sum loggin leggur afturat eini berari flutning fyri hvønn qub, er manipulatiónsstaðfestandi raðseting, ein troystleys yvirmark-skuldbindingartíð og tvíræðnis-mótstøða.

Báðar fullyrðingar útiloka, sambært §11: høvundaskap uttan sig_alg ≥ 0x01, ætlan, og undir-akker-fínkornleiks-tíðsetan. Hvørgin letur nakra fullyrðing hvíla á received_at.

Fullyrðingar-loft (bindandi byrjunartreyt — loyst §16.15 Q1). Fyri ókeypis / sjálvsettar (kind=0x02) qub-ar er tann skopaða kind=0x02-fullyrðingin omanfyri tað loft, sum nøkur vøru-, marknaðar-, treytar- ella prógv-framsýningar-flata kann fullyrða. Eingin flata kann siga ella geva í skyn, at loggin prógvar innihaldið ella avlæsingarrundu hjá einum sjálvsettum qub — loggin prógvar raðseting + ein troystleysa yvirmark-skuldbindingartíð av einum ógjøgnumskygdum dulorði. Innihalds- og rundu-prógv koma einans frá tí verandi §11 .qub-bólkar-verifikatión, sum er logg-óheft. Hetta er ein hørð byrjunar-blokering á tekst, ikki ein stílsligur fyrimunur; tað er tann loysn, sum heldur tí bæti-blindu sjálvsettu leiðini ærligari.

16.12 Útgávumerking og W3-Samanskipan

Tað er eingin SealedQub-tráða-lyft og tí eingin protokoll-útgávu-lyft (§12.1): loggin er ein síðu-vagn, sum skuldbindur seg til verandi teigar og bæti, so hann fer ikki inn í §12.2-protokoll-útgávusøguna. W3s valfría drand_chain_version er ónert og verður verandi tann eini valfríi SealedQub-teigurin. Loggin innførir í staðin sín egnu óheftu útgávurúm — LOG_VERSION_1, ANCHOR_FORMAT_1, InclusionProof.ver — sum spegla §12.4-umbúgvingsútgávu-óheftleikan (umbúgvingin ber eitt útgávu-bæti óheft av protokoll-útgávuni, og logg-útgávurnar fylgja sama skili).

Prógv-avgreiðsla verður fingin sum sjálvsett, við einari valfríari hjáríðing. Eitt prógv kann ikki vera til á innsiglingartíð (akkerið er enn ikki skrivað), so innsiglingar-tíðar .qub-bólkurin verður verandi prógv-fríur. W7s verifiserari fær GET …/proof einaferð, ella í fult-ónetaðum hátti endurbyggir prógvið av tí almenna AnchorBundle gjøgnum eina Arweave-fyrispurning á Log-Id. .qub-bólkurin (W7) varðveitir eitt valfrítt inclusion_proof-innfeting — fráverandi við innsigling, fylt av einari eftir-akker-endurútflutning fyri kalda goymslu — sum fylgir sama "valfrítt, útilatið sum sjálvsett, viðbótarliga"-myndil sum W3s drand_chain_version.

16.13 Varðveiting

Varðveitingar-vindeygu fyri LogDO-opna halan, R2-prógv-tænandi undirstøðuna, akker-streymbrótara-teljararnar og bólkar-fráfalls-køuna eru tilskilað í docs/DATA-RETENTION.md. Grundregla: loggsins heita per-innfetingar-goymslupláss (LogDO) er endurnýtanligt eftir akker; endurskoðanartilfar tess — tann samsýtis-lyklaði (level, index) Merkle-knútastoyti + tey seq-adresseraðu blað-likamir (§16.9) + Arweave-akkerini — er varandi. At endurnýta eitt kalt blað úr DO ógildar ongantíð eitt útgivið prógv, tí eitt prógv loysir seg ímóti tí varandi R2-knútastoyti og Arweave-akkerinum, ikki DO (og §16.9-strikaða-DO-royndarvektorin prógvar tað).

16.14 Royndarvektorir

W5 sendir tann tvørmáls-grundgrein tlog_v1.json (§16.8) umframt útgjørdar vektorir: eitt kind=0x01- og eitt kind=0x02-blað → leaf_hash; tann 5-blaða savnaða rótin; eitt íroknanar-prógv; eitt samsvars-prógv; eitt AnchorBundle; og eitt DataItem-id. Hesi liva saman við §14.5-ytru-umbúgvingar-vektorunum og verða roynd av bæði Rust- (qub-core) og TypeScript- (Worker) ímótkomningunum.

16.15 Endurskoðanar-Avgerðir (W5 — loystar)

W5 ytri endurskoðanin (ein mótstøðu-snið-yvirgongd + eigara-undirskrift) er liðug. Hvør avgerð niðanfyri er sett og endurspeglað í §16-tekstinum omanfyri; tær bindandi byrjunartreytir verða endurfráboðaðar í endanum. Ímótkomning kann fara fram undir teimum.

1. Sjálvsett-leið (kind=0x02) blað-ærligheit — LOYST. Send tann tveggja-blað-kinda-klovningin sum tilskilað: kind=0x02 skuldbindur hvørki body_hash ella drand_round. Onki *_body_hash-teigur á bæti-blindu leiðini (tað fór at verið tað mest lesiliga falska "verifiseraða"-merkið fyri samanknýtarar og er ein lættleiki, sum §11 longu gevur frá bólkinum). Krev ikki ambætara-innsigling fyri logg-váttaðar qub-ar (tað fór at noytt reintekst gjøgnum Worker og oytt krypto-smildru-verndarmúrin). Hvør sjálvslýsandi stuttbreytur hoyrir til .qub-bólkin / prógv-umslagið sum eitt verifiserara-endurroknað teigur, ongantíð eitt blað-teigur. Eigara-váttað fullyrðingar-loft: §16.11.
2. Tvíræðnis-/burturlatingar-ábyrgd — LOYST. Innsiglingar-kvittanar-lykilin er festur í LogProfile + anchor_owner-kross-undirskrivaður (letur aftur tann fyrra "ongan undirskriftarlykil"-mótsøgnina; §16.6). Byrjunar-vitnismyndil: fest kvittan + eftirlits-aðferð + fyrri-keðju-gongd + tvíføld sjálvs-útgivin høvur (qub-egnað alment GitHub-goymslupláss, sosialt besta-royndar), marknaðarført sum uppdagiligt + kvittað, ongantíð sjálvstøðugt vitnað. Eitt veruligt triðjamanns-vitni er frestað til eitt §15-stýringar-lyft.
3. Fest akker-eigara-trygdarrót + rotatión — LOYST. Tak LogProfile-festingina (§16.6); verifiserarin kannar anchor_tx.owner == anchor_owner og váttar tx-dáta → tx_id-bindingina lokalt. Rotatiónsstýring er ein §15-víðkan at byggja (§15.3-útloysingartreyt løgd afturat), ikki ein endurnýtsla; ætlaðar rotatiónir kross-undirskriva, brots-dripnar rotatiónir falla aftur til §15-lyftið við grein-kanninum at marka skaða.
4. Privat-qub blað-blinding — LOYST. Haldið blinding fyri privatar qub-ar (ref = SHA3-256(qub_id ‖ log_blind_secret)), rátt qub_id fyri almennar qub-ar (longu §16.2.1), chash sum tann sjálvstøðuga bindingin. log_blind_secret er ein samanbindingar-/Sybil-stigs loynd, bert-frameftir-rotering (§16.2.1).
5. received_at — LOYST. Haldið tað í blaðnum, skuldbundið men uttrýkiliga ikki-prógvberandi; ongantíð víst sum prógv ella klagu-stuðul á nakrari flatu. Hvør eftirlits-skilanskanning samanberur ímóti Arweave-blokk-tíð T, ikki ímóti tí rekstrarmaður-stýrda anchored_at (§16.6).
6. Ókeypis-stigs prógvanlig tíðsetan — LOYST (eigara-undirskrift). Varandugleiki dálkar ikki afturábak; bert tann prógvanliga yvirmark-skuldbindingartíðin verður grovari til akker-blokk-tíðina. Ókeypis-stigs tekstur nýtir onga talvíra SLA ("…lagt afturat við næsta logg-akker, vanliga dagliga"); nákvæmt-tíma prógv er ein goldin T3-eginleiki, framlagdur á stig-samanberingar-flatuni + í treytum (§16.1).
7. Savnað træ á Workers — LOYST. Eitt einasta savnað RFC 9162-træ + front-goymdur einasti-skrivara LogDO (lagaligt rúm móti ~1k skrivingar/sek DO-loftinum; fresta Merkle-av-deilis-rótum-deiling til nær tað). Blokerandi forutanseting: samsýtis-lyklað (level, index) R2-knútastoyti + strikaða-DO-kald-blað-royndarvektorin (§16.9); < 300 ms er ein mátad byrjunar-gátt yvir tveir raðfylgdar DOar (§16.10).
8. ANS-104 undirskriftarskema + djúp-stytting — LOYST. RSA-PSS (sig-slag 1, og endurnýtir tað serstaka akker-veskis-JWK); Ed25519 frestað til §15 PQ-leiðina. Tann handveltaða SHA-384 djúpa styttingin er gátta á báða-leiðina kross-impl-grundgreinini, einari bert-støðuga tilvísingar-bólkara-interop-kanning, somu-crypto.subtle-hringferðini og eftir-bólks Arweave-góðkenningar-eftirlitinum (§16.8).

Bindandi byrjunartreytir (ber inn í ímótkomning + vøru-/rættar-endurskoðan):

• Fullyrðingar-loft (Q1/Q6). Eingin flata kann siga, at loggin prógvar innihald ella avlæsingarrundu hjá einum sjálvsettum qub; tann loyvda fullyrðingin er raðað, manipulatiónsstaðfestandi, við einari troystleysari yvirmark-skuldbindingartíð. Ókeypis-stigs tíðarmerkis-tekstur ber onga talvíra bíðan; nákvæmt-tíma prógv er goldið T3 bert.
• Vitnis-ærligheit (Q2). Marknaðarfør tvíræðni sum uppdagiligt + kvittað, ongantíð sjálvstøðugt vitnað.
• Kvittanar- + akker-lyklar (Q2/Q8). Kvittanar-lykilin er festur + kross-undirskrivaður; akker-veskið er sítt egna JWK skilt frá upphalanar-veskinum.
• Djúp-stytting-gátt (Q8). Eingin akker- ella T3-flutning verður send, fyrr enn báða-leiðina grundgreinin + interop-kanningin standast; góðkenningar-eftirlitið blaðsendur við miseydnan.
• Goymslu-forutanseting (Q7). Samsýtis-lyklað knútastoyti + strikað-DO-kald-blað-vektor eru fyritreytir fyri "endurnýtsla ógildar ongantíð eitt prógv"-trygdina.