Sari la conținutul principal

ZK / STARK și retrageri

Această pagină acoperă două subiecte conexe: sistemele de demonstrații ZK (snark și stark) folosite de rollup-urile decontate prin ZK și fluxul de retragere L2 → L1 care mută fondurile dintr-un rollup înapoi în QoreChain odată ce un lot este finalizat.

Capabilitate în etapă timpurie

Până acum nu a fost creat niciun rollup pe niciuna dintre rețele (verificat la 27 octombrie 2026), așa că nici verificarea demonstrațiilor, nici fluxul de retragere descrise aici nu au fost exersate pe un rollup live. Retragerile pot reuși pe mainnet doar începând cu v3.2.3 (înălțimea 3,662,051, 20 octombrie 2026), când registrul de escrow pe fiecare rollup a intrat în funcțiune (vezi De unde provin fondurile); înainte de aceasta, fiecare retragere eșua. Decontarea ZK nu a fost încercată pe nicio rețea (profilul defi și fiecare rollup zk): mesajele de cheie de verificare au venit cu chain v3.2.7 (testnet din 6 noiembrie 2026, mainnet din 12 noiembrie 2026), iar un lot ZK fără cheie înregistrată este refuzat. Verificarea STARK este experimentală. Validează pe testnet-ul qorechain-diana și nu presupune garanții consolidate pentru producție pe mainnet.


Sisteme de demonstrații ZK​

Un rollup decontat prin ZK (modul de decontare zk) atașează o demonstrație de validitate fiecărui lot de decontare, dovedind că tranziția de stare este corectă fără a re-executa tranzacțiile rollup-ului. Decontarea ZK suportă două sisteme de demonstrații:

Sistem de demonstrațiiCaracteristici
snarkDemonstrații succinte (Groth16 peste BLS12-381), verificate on-chain față de cheia de verificare a rollup-ului
starkDemonstrații transparente, fără setup de încredere (trusted setup) — experimental; opt-in și legat de un circuit demonstrativ

Modul de decontare zk necesită fie snark, fie stark; asocierea este impusă on-chain atunci când rollup-ul este creat. Prin contrast, decontarea optimistic folosește sistemul de demonstrații fraud, iar decontările based și sovereign folosesc none. Vezi Prezentare generală a rollup-urilor pentru întreaga matrice de compatibilitate.

Finalitate​

Spre deosebire de rollup-urile optimiste — care așteaptă scurgerea unei ferestre de contestare prin demonstrație de fraudă — un lot ZK poate fi finalizat la verificarea unei demonstrații valide, fără o fereastră de dispută. Acesta este compromisul de bază al decontării ZK: finalitate mai puternică și mai rapidă în schimbul costului și complexității generării demonstrațiilor.

Maturitate​

Decontarea ZK nu a fost încercată cap-coadă pe nicio rețea. Loturile SNARK sunt menite să fie verificate on-chain (Groth16 peste BLS12-381, cu trei intrări publice: rădăcina de stare anterioară, rădăcina de stare nouă și hash-ul datelor) față de o cheie de verificare stocată împreună cu rollup-ul. Înainte de chain v3.2.7 nu exista nicio modalitate de a înregistra acea cheie, deci un rollup creat cu decontare zk nu avea niciuna, iar fiecare lot ZK pe care îl trimitea era refuzat după ce taxa fusese plătită. Chain v3.2.7 a adăugat mesajele de înregistrare, activate pe mainnet din 12 noiembrie 2026. Pe testnet (v3.2.7 aplicat pe 6 noiembrie 2026) un rollup ZK își poate înregistra cheia de verificare: testnet-ul acceptă MsgSetVerificationKey și, ulterior, MsgUpdateVerificationKey (verificat pe 7 noiembrie 2026 simulând fiecare mesaj cu corp gol, care a trecut de rezolvarea tipului de mesaj și a eșuat doar pe câmpul de adresă gol). Notele de lansare spun că un lot ZK fără cheie este refuzat înainte de plata taxei. Aceeași verificare nu a fost repetată pe mainnet după ce a aplicat v3.2.7, și acolo nu există niciun rollup (GET /qorechain/rdk/v1/rollups a returnat o listă goală pe 12 noiembrie 2026). RDK 0.8.0 nu are un builder pentru aceste mesaje, iar pe testnet nu există niciun rollup, deci niciun lot ZK nu a fost verificat cap-coadă. Circuitul demonstrativ al șablonului defi (un multiplicator snarkjs) tot nu se poate verifica, deoarece nu are intrările publice pe care le verifică lanțul; va trebui să ai propriul circuit. Din RDK 0.7.0, șablonul defi-rollup se oprește înainte de a trimite un lot, deci nu mai cheltuiește o taxă pe unul pe care lanțul îl refuză întotdeauna. Verificarea STARK este experimentală: este opt-in și verifică un circuit demonstrativ, nu tranziția de stare proprie a rollup-ului tău. Pentru o decontare pe care o poți folosi astăzi, alege optimistic (profilurile nft și custom).


Cum transportă loturile retragerile​

Când un rollup decontează un lot, acel lot poate, de asemenea, angaja mesajele inter-strat de ieșire ale rollup-ului — retragerile sale L2 → L1. Conceptual:

  • Un lot finalizat poate transporta un angajament către setul său de retrageri (o rădăcină Merkle peste mesajele de retragere ale lotului).
  • Fiecare retragere individuală este o frunză sub acea rădăcină, identificată prin indexul lotului și un index de retragere.
  • Odată ce lotul este finalizat, orice parte poate dovedi că o anumită frunză de retragere este inclusă sub rădăcina angajată și poate declanșa plata.

Acesta este motivul pentru care retragerile depind de decontare: o retragere poate fi executată doar față de un lot finalizat, deoarece finalizarea este cea care face canonică rădăcina de retrageri angajată.

Pentru modul în care loturile sunt trimise și finalizate — inclusiv submit-batch și calea de dispută challenge-batch pentru rollup-urile optimiste — vezi Implementarea unui rollup.


Executarea unei retrageri: execute-withdrawal​

Comanda execute-withdrawal finalizează o retragere L2 → L1 față de rădăcina de retrageri a unui lot finalizat. Aceasta dovedește că o frunză de retragere este angajată în acea rădăcină și plătește destinatarul din escrow-ul modulului rdk. Acțiunea este fără permisiuni (permissionless) — oricine poate trimite o demonstrație validă. Ca orice tranzacție pe lane-ul nativ, necesită co-semnătura post-cuantică hibridă, așa că construiește-o cu --generate-only și co-semn-o (vezi Implementarea unui rollup). Retragerile nu au fost încă exersate pe un rollup live; tratează fluxul ca netestat. Verifică următoarele înainte de a plăti o taxă, deoarece altfel lanțul refuză tranzacția: denominația trebuie să fie exact uqor, suma trebuie să fie pozitivă, demonstrația are cel mult 64 de niveluri și fiecare frate are exact 32 de octeți, trimițătorul și destinatarul sunt adrese qor1… valide, lotul este finalizat și a angajat un withdrawals_root, rollup-ul nu este oprit, iar frunza respectivă de retragere nu a mai fost plătită înainte. @qorechain/rdk pentru TypeScript (0.6.0 și ulterior) rulează pentru tine primul grup dintre aceste verificări (withdrawalErrors: adrese, denominație, sumă, adâncimea demonstrației și lungimea fraților), iar executeWithdrawal aruncă o eroare înainte de a transmite tranzacția dacă oricare dintre ele eșuează; de la 0.7.0, qorollup withdraw --file withdrawal.json [--dry-run] construiește și demonstrația din retragerile lotului și refuză înainte de a plăti o taxă când rezultatul nu este withdrawals_root on-chain al lotului; condițiile privind lotul, rollup-ul și registrul depind de starea lanțului, pe care această verificare nu o citește.

qorechaind tx rdk execute-withdrawal \
[rollup-id] [batch-index] [withdrawal-index] [recipient] [denom] [amount] \
--proof <sibling-hash-1>,<sibling-hash-2>,... \
--from mykey \
--chain-id qorechain-diana \
--gas 400000 --fees 40000uqor \
--generate-only > withdrawal.json
qorechaind tx pqc cosign withdrawal.json --from mykey --pqc-key mypqckey --chain-id qorechain-diana

Argumente poziționale:

ArgumentDescriere
rollup-idRollup-ul căruia îi aparține retragerea
batch-indexLotul finalizat a cărui rădăcină de retrageri angajează această retragere
withdrawal-indexIndexul frunzei de retragere în cadrul acelui lot
recipientAdresa către care se face plata
denomDenominația de plătit
amountSuma de plătit

Flag:

FlagDescriere
--proofHash-uri Merkle de frați (siblings) în format hex, separate prin virgulă, ordonate de la frunză la rădăcină, care dovedesc că frunza de retragere este angajată în rădăcina de retrageri a lotului

Valoarea --proof este demonstrația de incluziune: hash-urile de frați de-a lungul căii de la frunza de retragere până la rădăcina de retrageri angajată a lotului. Modulul recalculează rădăcina din frunză și frații furnizați și o verifică față de rădăcina angajată a lotului finalizat înainte de a plăti.

Codificarea frunzelor și a nodurilor​

  • Frunză (prima formă, pentru loturile dinainte de chain v3.2.5) = SHAKE-256 (32 de octeți) din rollup_id, un octet 0x00, indexul retragerii (8 octeți big-endian), șirul recipient, 0x00, șirul denom, 0x00 și amount (8 octeți big-endian).
  • Frunză (a doua formă, de la chain v3.2.5 pe ambele rețele): pentru loturile de la chain v3.2.5, frunza numește și chain id-ul. RDK le construiește pe ambele forme (withdrawalLeafV1, withdrawalLeafV2).
  • Părinte = SHAKE-256 din left || right. La fiecare nivel, bitul corespunzător din indexul retragerii decide partea: 0 înseamnă că frunza (sau hash-ul curent) este nodul din stânga, deci poziția frunzei în arbore este indexul ei de retragere.
  • Fiecare hash de frate trebuie să aibă exact 32 de octeți.
  • Rădăcina retragerilor (de la chain v3.2.5, ambele rețele): withdrawals_root al unui lot este fie gol, fie de exact 32 de octeți; înainte de v3.2.5 această regulă de lungime nu era impusă.

Nu construi acest arbore de mână. withdrawalsTree din @qorechain/rdk 0.7.0 și ulterior (și echivalentele sale din Python, Go, Rust și Java) construiește rădăcina retragerilor unui lot și fiecare demonstrație exact așa cum o face lanțul și a fost verificat față de propriul verificator al lanțului; assembleWithdrawalProof construiește implicit arborele lanțului, iar helperele Merkle generice folosesc acum implicit SHAKE-256.

Versiuni anterioare lui 0.7.0

În @qorechain/rdk 0.6.2 și anterioare, helperele generice binaryMerkleRoot / binaryMerkleProof (și echivalentele lor din Python, Go, Rust și Java) foloseau implicit SHA-256 cu noduri impare duplicate și re-hash-uiau fiecare frunză, în timp ce lanțul folosește SHAKE-256 și își construiește frunzele din retragere, deci o demonstrație construită cu acele valori implicite nu s-a verificat niciodată pe lanț. Fă upgrade la 0.7.0 sau suprascrie hash-ul și codificarea frunzelor conform regulilor de mai sus, altfel demonstrația nu se va verifica on-chain.

De unde provin fondurile​

O retragere este plătită din stake-ul aflat în escrow al rollup-ului însuși (stake-ul minus arderea de 1% de la creare). Escrow-ul tuturor rollup-urilor se află într-un singur sold comun al modulului, iar începând cu v3.2.3 un registru de escrow pe fiecare rollup ține evidența a ceea ce deține fiecare rollup: create-rollup îl creditează cu escrow-ul pe care rollup-ul îl păstrează, o retragere sau o recompensă pentru demonstrație de fraudă este plătită din el și debitată din el, iar o retragere mai mare decât ceea ce rollup-ul încă deține este refuzată cu o eroare de escrow insuficient. stop-rollup rambursează doar ce a rămas și aduce registrul la zero, iar un rollup oprit nu mai plătește retrageri. O retragere dovedită pentru un rollup nu poate fi, așadar, plătită din stake-ul altui rollup. Interogările rollup-ului conțin escrow_balance (uqor încă deținuți pentru acel rollup). Modulul nu are niciun mesaj de depunere L1 → L2, deci aceasta nu este o punte (bridge) pentru fondurile utilizatorilor.


Fluxul de retragere de la cap la cap​

Calea L2 către L1: un lot de decontare angajează o rădăcină de retrageri, lotul se finalizează, apoi o demonstrație de incluziune fără permisiuni eliberează fondurile din escrow pe QoreChain.

  1. Decontează un lot. Operatorul rollup-ului trimite un lot de decontare cu submit-batch. Lotul poate angaja o rădăcină de retrageri peste mesajele sale de ieșire L2 → L1.
  2. Finalizează. Lotul se finalizează conform modului de decontare al rollup-ului — la verificarea unei demonstrații valide pentru zk sau după fereastra de contestare pentru optimistic (în timpul căreia challenge-batch îl poate disputa). Începând cu chain v3.2.5 (testnet din 26 octombrie 2026, mainnet din 29 octombrie 2026), loturile se finalizează și strict în ordinea indexului, deci un lot așteaptă orice lot anterior care este încă submitted sau challenged. Fereastra optimistă este implicit de 100,800 de blocuri pentru un lot trimis înainte de upgrade-ul v3.2.4; începând cu v3.2.4 se măsoară în secunde de timp de bloc pentru loturile trimise de la înălțimea upgrade-ului încolo (testnet de la înălțimea 8,337,253, 19 octombrie 2026, mainnet de la înălțimea 3,742,566, 23 octombrie 2026).
  3. Dovedește și execută. Odată finalizat, oricine trimite execute-withdrawal cu demonstrația de incluziune Merkle (--proof) pentru frunza de retragere specifică. Modulul verifică incluziunea față de rădăcina de retrageri a lotului finalizat și plătește destinatarul din escrow.

Deoarece pasul 3 este fără permisiuni și bazat pe demonstrație, o retragere nu depinde de cooperarea operatorului rollup-ului odată ce lotul care o transportă este finalizat.


Conexe​