Implementarea unui Rollup
Poți configura un rollup specific aplicației în trei moduri: prin Dashboard (un formular de cerere, nu o tranzacție on-chain), prin CLI-ul lanțului (qorechaind, control total asupra tranzacției on-chain) sau cu RDK-ul TypeScript (@qorechain/rdk plus schela create-qorechain-rollup), care acoperă configurarea, citirile și, atunci când îi dai o cheie post-cuantică, tranzacții semnate hibrid (vezi RDK 0.8.0: modificări și limite). Această pagină acoperă toate cele trei moduri, plus ciclul de viață al operatorului și comenzile de batch.
Nu a fost creat niciun rollup pe mainnet (GET /qorechain/rdk/v1/rollups a returnat o listă goală pe 12 noiembrie 2026); testnetul a fost verificat ultima oară pe 30 octombrie 2026, când nu avea niciunul. Comenzile de mai jos folosesc testnetul qorechain-diana (chain ID EVM 9800, versiunea de lanț v3.2.8: v3.2.4 a fost aplicată acolo pe 19 octombrie 2026, v3.2.5 pe 26 octombrie la înălțimea 8.890.800, v3.2.6 pe 27 octombrie la înălțimea 8.970.638, v3.2.7 pe 6 noiembrie la înălțimea 9.594.600 și v3.2.8 pe 12 noiembrie la înălțimea 9.929.500; v3.2.8 nu este pe mainnet). Mainnetul (qorechain-vladi, chain ID EVM 9801, activ din 7 iunie 2026) rulează versiunea de lanț v3.2.7 din 12 noiembrie 2026 (aplicată la înălțimea 4.164.600 prin propunerea de guvernanță 16; v3.2.6 a fost aplicată la înălțimea 4.020.000 pe 4 noiembrie 2026 prin propunerea 15; v3.2.5 a fost aplicată la înălțimea 3.906.833 pe 29 octombrie 2026 prin propunerea 14, iar v3.2.4 la înălțimea 3.742.566 pe 23 octombrie 2026 prin propunerea 13), deci ce schimbă v3.2.5 pentru rollup-uri este marcat „de la v3.2.5" și se aplică pe ambele rețele (un tabel-sumar se află în Prezentare generală Rollups). Versiunile anterioare diferă în câteva detalii, pe care această pagină le marchează „de la v3.2.4". Testnetul este o rețea de staging, cu proprii parametri de modul (de exemplu o fereastră de contestare implicită de 3.600 de secunde față de 604.800 pe mainnet și cel mult 200 de rollup-uri față de 100); citește GET /qorechain/rdk/v1/params pe rețeaua țintă. Validează fiecare implementare mai întâi pe testnet.
Rețeaua impune un preț minim al gazului de 0.1uqor, așa că un simplu --fees 500uqor este refuzat, iar fiecare tranzacție pe lane-ul nativ are nevoie de co-semnătura post-cuantică hibridă. Exemplele de CLI de pe această pagină construiesc, prin urmare, tranzacția cu --generate-only și o co-semnează cu qorechaind tx pqc cosign, care o semnează și o transmite (creează cheia o singură dată cu qorechaind tx pqc gen-key și înregistreaz-o on-chain o singură dată cu qorechaind tx pqc register-key, sau folosește QoreX ori SDK-ul, care fac asta pentru tine). Taxa este fixată când este generat fișierul nesemnat, așa că setează limita de gas și taxa împreună: taxa trebuie să fie cel puțin limita de gas × 0.1 uqor. Limitele de gas de mai jos sunt orientative — simulează înainte să te bazezi pe ele. Vezi Prima tranzacție și Semnarea post-cuantică.
Cerințe
| Cerință | Detalii |
|---|---|
| Stake minim | Cel puțin 10.000 QOR (min_stake_for_rollup); stake-ul este ținut în escrow la crearea rollup-ului |
| Ardere la creare | 1 % din stake-ul pe care îl furnizezi este ars permanent la creare (o creare care nu poate aplica arderea este refuzată); restul este ținut în escrow și este returnat când rollup-ul este oprit |
| Stake de înregistrare a stratului | Crearea înregistrează și stratul rollup-ului în modulul multilayer, ceea ce blochează încă 1.000 QOR (min_sidechain_stake) de la creator, returnați când stratul este dezafectat la oprire. Dacă stratul nu poate fi înregistrat (sold prea mic sau s-a atins limita de 10 sidechain-uri multilayer), rollup-ul este totuși creat, dar nu are strat, deci batch-urile sale nu pot fi ancorate |
| ID rollup | Folosește 3–64 de caractere: litere mici, cifre, ., _ și -, începând cu o literă sau o cifră. Lanțul impune această regulă pe ambele rețele începând cu v3.2.2 (CLI-ul o verifică înainte de a construi tranzacția), așa că un id neconform este refuzat |
| Cont | Un cont QoreChain alimentat, cu o cheie post-cuantică înregistrată, cu sold suficient pentru stake, stake-ul stratului și taxele de tranzacție |
Interoghează parametrii live ai modulului pentru stake-ul minim și rata de ardere curente înainte de a implementa:
qorechaind query rdk config
Implementare prin Dashboard (Tools → Rollups)
Dashboard-ul are un formular Deploy a Rollup sub Tools → Rollups. Este un formular de cerere: trimiterea lui înregistrează o cerere de provizionare pentru contul tău, revizuită de The Qore Trust, iar o cerere nouă afișează statusul provisioning. Nu transmite o tranzacție create-rollup on-chain — pentru a înregistra un rollup on-chain, folosește CLI-ul de mai jos.
Pași
- Autentifică-te. Formularul necesită o sesiune autentificată pentru a trimite o cerere și pentru a lista cererile tale existente.
- Denumește-ți rollup-ul. Introdu un nume pentru rollup (2–41 caractere: litere, cifre, spații, cratime sau underscore).
- Alege o mașină virtuală. Înregistrarea on-chain stochează o etichetă de VM. Rollup-ul tău se execută off-chain în propriul runtime; alegerea nu rulează pe lane-urile EVM, QoreChain Native sau SVM proprii ale QoreChain:
- EVM — contracte Solidity / Vyper cu unelte Ethereum complete (Hardhat, Foundry, MetaMask)
- QoreChain Native — contracte inteligente Rust pe runtime-ul Cosmos SDK (runtime-ul CosmWasm), cu IBC nativ
- SVM — mașina virtuală Solana, pentru aplicații cu execuție paralelă și throughput ridicat
- Alege un strat de disponibilitate a datelor. Unde publică rollup-ul tău datele de tranzacție, astfel încât oricine să poată reconstrui starea: QoreChain DA, Celestia sau EigenDA. Reține că EigenDA este o opțiune la nivel de Dashboard, în timp ce backend-urile DA on-chain ale
x/rdksunt native, Celestia sau ambele — vezi Disponibilitatea datelor. - Setează un token de gas. Token-ul folosit pentru a plăti execuția pe rollup-ul tău. Implicit este QOR; introdu un simbol personalizat pentru a folosi propriul token nativ.
- Alege un sequencer. Cine ordonează tranzacțiile înainte de settlement: Shared sequencer (setul partajat QoreChain), Dedicated (single) (rulează propriul sequencer unic) sau Decentralized (un set de sequencer permisionless).
- Alege o țintă de settlement. Unde își ancorează rollup-ul rădăcinile de stare și dovezile de validitate: mainnet QoreChain sau Ethereum.
- Trimite cererea. Provizionarea este revizuită de The Qore Trust, așa că o cerere abia trimisă apare cu statusul provisioning până la finalizarea revizuirii.
Cererile trimise apar în lista Your rollups împreună cu VM-ul, stratul DA, token-ul de gas, sequencer-ul, ținta de settlement și statusul curent.
Opțiunile formularului (mașină virtuală, strat de disponibilitate a datelor, token de gas, sequencer, țintă de settlement) descriu ceea ce ceri; sunt mai largi decât ceea ce modulul x/rdk on-chain acceptă în prezent. On-chain, disponibilitatea datelor este native (Celestia nu este activ), iar sequencing-ul este făcut de creatorul rollup-ului sau de o adresă de sequencer configurată. Vezi Disponibilitatea datelor.
Implementare prin CLI
CLI-ul creează rollup-ul direct on-chain. create-rollup primește trei argumente poziționale — ID-ul rollup-ului, un profil și suma de stake (în uqor) — plus un flag opțional --vm.
Începând cu versiunea de lanț v3.1.74, create-rollup aplică automat preset-ul profilului ales — modul de settlement, sequencer, DA, modelul de gas și VM-ul sunt toate preluate din preset. Nu mai trebuie să le setezi manual (anterior mesajul avea hardcodată o configurație sovereign). Flag-ul --vm are acum valoare implicită goală, așa că se aplică VM-ul din preset, cu excepția cazului în care îl suprascrii explicit.
qorechaind tx rdk create-rollup [rollup-id] [profile] [stake-amount] \
--from mykey \
--chain-id qorechain-diana \
--gas 600000 --fees 60000uqor \
--generate-only > create-rollup.json
Exemplu — creează un rollup din preset-ul defi (settlement, sequencer, DA și VM provin toate din preset; defi se rezolvă la settlement zk pe EVM). Construiește tranzacția nesemnată, apoi atașează co-semnătura post-cuantică și transmite-o:
# 1. Build the unsigned transaction (10,000 QOR stake)
qorechaind tx rdk create-rollup my-defi-rollup defi 10000000000 \
--from mykey \
--chain-id qorechain-diana \
--gas 600000 --fees 60000uqor \
--generate-only > create-rollup.json
# 2. Cosign with your post-quantum key and broadcast
qorechaind tx pqc cosign create-rollup.json \
--from mykey --pqc-key mypqckey --chain-id qorechain-diana
Nu crea încă un rollup defi (ZK) pe mainnet. Lanțul acceptă crearea și ține stake-ul în escrow. Mesajele de cheie de verificare sunt activate pe mainnet din lanțul v3.2.7 (12 noiembrie 2026) și au fost acceptate pe testnet, dar RDK 0.8.0 nu are un builder pentru ele și niciun rollup ZK nu a fost încercat pe nicio rețea. Alege deocamdată un profil optimistic, precum nft sau custom (vezi ZK / STARK & Withdrawals).
Flag-uri:
| Flag | Implicit | Descriere |
|---|---|---|
--vm | (gol — se folosește VM-ul din profil) | Suprascrie tipul de VM al rollup-ului: evm, cosmwasm, svm sau custom. Lasă nesetat pentru a aplica VM-ul din preset. (În clienții RDK, runtime-ul Wasm este tipul de VM native — QoreChain Native — cu cosmwasm păstrat ca alias legacy; cosmwasm este valoarea on-wire, care este cea acceptată de acest flag la nivel de lanț.) |
--vm înregistrează ce runtime folosește rollup-ul tău. Lanțul gazdă doar face settlement pentru rollup; nu îi execută contractele. Încărcarea QoreChain Native a lanțului gazdă este în prezent închisă, iar lane-ul său de tranzacții SVM este dezactivat la nivelul întregii rețele, ceea ce nu afectează settlement-ul unui rollup off-chain, dar înseamnă că nu poți implementa contracte pentru un rollup pe acele lane-uri ale lanțului gazdă.
Argumentul [profile] selectează o configurație preset care se aplică automat — vezi Profiluri preset. [stake-amount] este garanția (bond) în uqor; arderea la creare reprezintă 1 % din ea.
Inspectează ce ai implementat
# Query a specific rollup by ID
qorechaind query rdk rollup my-defi-rollup
# List all registered rollups
qorechaind query rdk list-rollups
Implementare cu RDK-ul TypeScript (@qorechain/rdk)
Rollup Development Kit-ul este livrat ca două pachete npm publice pentru același modul on-chain x/rdk ca și CLI-ul. Nu există încă niciun rollup pe vreuna dintre rețele, deci nicio cale de tranzacție a kitului nu a fost exersată pe un rollup live; citește RDK 0.8.0: modificări și limite înainte de a te baza pe el pentru a trimite tranzacții:
@qorechain/rdk(v0.9.0) — SDK-ul TypeScript: un constructor de configurație cu profiluri preset, helper-e de tranzacție pentru ciclurile de viață ale rollup-ului și ale batch-urilor de settlement, DA nativ, clienți de citire tipați, chitanțe de settlement cu semnătură ML-DSA-87, QCAI Rollup Copilot, helper-e de calldata cross-VM și watchtower. Depinde de@qorechain/sdk^0.10.0(de la 0.7.0; 0.6.x folosea^0.9.0) și@qorechain/evm^0.8.0.create-qorechain-rollup(v0.9.0) — o schelă (scaffolder) care clonează câte un șablon de pornire funcțional pentru fiecare profil (inclusiv șablonulmultivm-rollup).
Acestea sunt publicate pe npm. Repo-ul livrează de asemenea un CLI de operator publicat, @qorechain/rdk-cli (qorollup, v0.9.0), cu comenzile doctor, create, status, watch, params, suggest, cele de ciclu de viață (pause/resume/stop), keygen, manifest, withdraw și faucet, plus comenzile receipt, advise și watchtower. De la 0.7.1 comenzile sale de tranzacție semnează hibrid (vezi limitele de mai jos).
Puncte importante, pe versiuni:
- v0.4.2 — funcționează direct pe rețeaua live, fără configurare suplimentară. Preset-urile
mainnetșitestnetinclud acum endpoint-urile publiceqore.host(REST laapi.qore.host/api-testnet.qore.host), astfel încâtcreateRdkClient({ network })ajunge la lanț fărăendpointssetate manual — suprascrie doar dacă vrei să vizezi propriul nod. Aceeași versiune a redenumit identificatorul VM-ului rollup Wasm înnative(QoreChain Native);cosmwasmrămâne un alias legacy acceptat, iar ambele se mapează lacosmwasmpe wire — lanțul, explorer-ul și Dashboard-ul rămân neschimbate. - v0.4.3 — actualizare de dependențe pentru remedierea codificării semnăturii hibride din SDK. Clientul de tranzacții al RDK-ului în sine încă semna exclusiv clasic.
- v0.4.4 — urmărește
@qorechain/sdk^0.7.0, versiunea SDK pentru lane-urile de autenticator din lanțul v3.1.85. Fără modificări în API-ul RDK. - v0.5.0 (18 octombrie 2026) — verificarea chitanțelor de settlement se face față de starea lanțului și nu declară niciodată o chitanță validă pe baza propriilor câmpuri; clientul de tranzacții TypeScript semnează hibrid atunci când primește un
pqcKeypair. Depinde de@qorechain/sdk^0.8.0. - v0.6.0 (versiune GitHub din 20 octombrie 2026) — versiunea de compatibilitate pentru lanțul v3.2.2 până la v3.2.4: batch-uri ancorate, chitanțe de settlement care se pot verifica, ferestre de contestare măsurate așa cum le măsoară lanțul, un encoder care corespunde structurii cross-VM a lanțului, șabloane care semnează hibrid și
@qorechain/sdk^0.9.0. Detaliile sunt mai jos. - v0.6.1 (versiune GitHub din 25 octombrie 2026) — o versiune de remediere de securitate și de șabloane pentru lanțul v3.2.3 încoace, în toate cele cinci limbaje: verificarea chitanțelor de settlement compară fiecare câmp pe care îl declară chitanța cu ancora lanțului, cele șase șabloane de pornire nu mai trimit batch-uri pe care lanțul le refuză (lasă
dataHashgol), iar șabloanele optimistic publică rădăcina canonică de stare a lanțului în loc de un placeholder. Păstrează intervalele@qorechain/sdk^0.9.0și@qorechain/evm^0.8.0. Detaliile sunt mai jos. - v0.6.2 (versiune GitHub din 27 octombrie 2026): o remediere urgentă a CLI-ului, fără modificări de bibliotecă:
qorollupinstalat din npm (local, global sau cunpx) rulează din nou, iarqorollup --versionșicreate-qorechain-rollup --versionafișează versiunile lor reale. Celelalte pachete au fost relansate ca 0.6.2, astfel încât fiecare registru să rămână pe o singură versiune. - v0.7.0 (versiune GitHub din 27 octombrie 2026): pregătită pentru lanțul v3.2.5 în toate cele cinci limbaje (ambele rețele îl rulează, și pe v3.2.6 și v3.2.7 de asemenea: mainnetul a aplicat v3.2.5 pe 29 octombrie 2026, v3.2.6 pe 4 noiembrie și v3.2.7 pe 12 noiembrie, testnetul v3.2.5 pe 26 octombrie și v3.2.6 pe 27 octombrie; testnetul a trecut între timp la v3.2.7 și apoi la v3.2.8) și corectează modul în care se calculează hash-ul retragerilor și al blob-urilor de disponibilitate a datelor: dovezile de retragere construite cu valorile implicite din 0.6.x nu s-au verificat niciodată on-chain, iar 0.7.0 construiește exact arborele lanțului. Trece la
@qorechain/sdk^0.10.0, iar șabloanele fixează@qorechain/rdk^0.7.0. Detaliile sunt mai jos. - v0.7.1 (versiune GitHub din 30 octombrie 2026): o remediere urgentă pentru CLI-ul de operator
qorollup, ale cărui comenzi de tranzacție semnează acum hibrid, așa cum cer ambele rețele. - v0.8.0 (versiune GitHub din 30 octombrie 2026): clienții Python, Go, Rust și Java semnează și ei hibrid, deci fiecare client RDK poate trimite tranzacții pe mainnet și pe testnet. Este necesar Java 21.
- v0.9.0 (versiune GitHub din 12 noiembrie 2026; curentă): suportă lanțul v3.2.8 (testnet-ul îl rulează din 12 noiembrie 2026): postarea datelor rollup-ului, secvențiere based, rollup-uri optimistic qledger-v1 cu dovezi de fraudă, rollup-uri private, intrări ZK canonice; settlement-ul STARK este în pauză. Vezi notele de lansare pe GitHub. Un cont nou trebuie să își înregistreze cheia post-cuantică într-o tranzacție separată, înaintea oricărei alte tranzacții; clienții RDK 0.9.0 fac această înregistrare pentru tine.
Versiuni publicate (verificat pe fiecare registru la 12 noiembrie 2026). npm @qorechain/rdk, @qorechain/rdk-cli și create-qorechain-rollup: 0.9.0 (latest); PyPI qorechain-rdk: 0.9.0; crates.io qorechain-rdk: 0.9.0; Maven Central io.github.qorechain:qorechain-rdk: 0.9.0 (versiunile anterioare rămân disponibile); modulul Go github.com/qorechain/qorechain-rdk/packages/go: v0.9.0 (@latest al proxy-ului de module poate rămâne în urma unui tag nou, așa că fixează explicit @v0.9.0). Versiunea GitHub este v0.9.0.
RDK 0.8.0: modificări și limite
Această secțiune prezintă ce fac pachetele 0.8.0 publicate (și ce au schimbat 0.7.1, 0.7.0, 0.6.2, 0.6.1 și 0.6.0 înaintea lor), verificate față de conținutul pachetelor și notele de lansare GitHub, și ce încă nu pot face. Niciunul dintre aceste puncte nu este un comportament al lanțului. Unde o afirmație spune „netestat live", nu există niciun rollup pe vreuna dintre rețele, deci calea a fost verificată doar față de cod și offline.
Ce au schimbat 0.8.0 și 0.7.1 (notele de lansare 0.8.0 și 0.7.1 conțin lista completă). Ambele rețele cer o semnătură hibridă (ML-DSA-87 + secp256k1) pe tranzacțiile din lane-ul nativ.
- 0.7.1: tranzacțiile
qorollupsunt acceptate.create,pause,resume,stopșiwithdrawsemnau exclusiv clasic în 0.7.0 și anterioare, deci rețelele le refuzau pe toate. CLI-ul semnează acum hibrid. Își rezolvă cheia post-cuantică așa cum o fac șabloanele: derivată din--mnemonicsauQORE_MNEMONICși confruntată cu cheia pe care lanțul a înregistrat-o, sau luată din--pqc-seedoriQORE_PQC_SEED_HEXîmpreună cu--key. Fără o cheie refuză să trimită, în loc să plătească pentru o tranzacție refuzată. - 0.7.1: remediere de paritate în Python.
transition_root_version_for_batch,RestClient.get_applied_plan_heightșiBatchView.withdrawals_boundsunt acum și în clientul Python (notele 0.6.1 o numărau pe prima în toate cele cinci limbaje; era în patru). - 0.8.0: Python, Go, Rust și Java semnează hibrid. Înainte, doar citirile lor funcționau pe mainnet și pe testnet. Fiecare semnează acum hibrid când primește un keypair post-cuantic, prin propriul SDK QoreChain publicat (0.10.x), cu forma sign-bytes (v1 sau v2) rezolvată din lanț. Notele de lansare afirmă că fiecare client produce tranzacții identice octet cu octet cu cele ale clientului TypeScript pentru aceeași intrare (un fixture comun conține patru tranzacții hibride pe care fiecare limbaj le reproduce exact).
- 0.8.0: rezolvarea cheii în fiecare limbaj, ca în TypeScript: dintr-un mnemonic, derivarea canonică sau cea legacy, oricare este înregistrată pe lanț; sau un seed de 32 de octeți din
QORE_PQC_SEED_HEX, confruntat cu cheia înregistrată. Pythonresolve_pqc_keypair/pqc_keypair_from_env, GoResolvePqcKeypair/PqcKeypairFromEnv, Rustresolve_pqc_keypair/pqc_keypair_from_env, JavaAccounts.resolvePqcKeypair/pqcKeypairFromEnv. - 0.8.0: este necesar Java 21 (era 17), deoarece SDK-ul Java QoreChain de care depinde îl cere.
- 0.8.0: dependențe noi.
qorechain-sdk0.10.x pe PyPI, modulul Gogithub.com/qorechain/qorechain-sdk/packages/gov0.10.0,qorechain-sdk0.10 pe crates.io (Rust trece lacosmrs0.22) șiio.github.qorechain:qorechain-sdk[0.10.0,0.11)pe Maven. Șabloanele fixează@qorechain/rdk^0.8.0. - 0.8.0: Go
RdkTxClient.Signreturnează([]byte, error), deoarece semnarea hibridă poate eșua. Acest lucru strică codul Go care folosea vechea valoare returnată unică. - Netestat live. Nu există niciun rollup pe vreuna dintre rețele, deci nicio tranzacție hibridă de la vreun client nu a fost trimisă printr-un rollup live.
Ce s-a schimbat în 0.7.0 (toate cele cinci limbaje, dacă o linie nu spune altfel; notele de lansare conțin lista completă). Comportamentul care aparține lanțului v3.2.5 este etichetat cu rețeaua sa: ambele rețele rulează v3.2.5 sau ulterioare (mainnetul rulează v3.2.7 din 12 noiembrie 2026, testnetul v3.2.8 din 12 noiembrie).
- Dovezile de retragere se verifică on-chain. Helperii Merkle și de retragere foloseau implicit SHA-256 și re-calculau hash-ul fiecărei frunze, în timp ce lanțul calculează hash-ul nodurilor cu SHAKE-256 și își construiește frunzele din retragerea însăși, așa că o dovadă construită cu valorile implicite din 0.6.x nu s-a verificat niciodată.
withdrawalsTreeconstruiește acum rădăcina retragerilor unui batch și fiecare dovadă exact așa cum o face lanțul (poziția frunzei este indexul retragerii): cu frunze de prima formă sau cu frunze de a doua formă, care numesc și id-ul lanțului, pe care lanțul le folosește pentru batch-urile de la v3.2.5 (ambele rețele).withdrawalLeafV1șiwithdrawalLeafV2construiesc o singură frunză,assembleWithdrawalProofconstruiește implicit arborele lanțului, iar helperii Merkle generici folosesc implicit SHAKE-256. Este o modificare incompatibilă pentru codul care se baza pe valorile implicite SHA-256 (transmite explicithashca să le păstrezi). Noile formate de octeți au fost testate față de vectori produși de codul propriu al lanțului, iar fiecare dovadă de retragere din acei vectori este acceptată de verificatorul lanțului. Vezi Codificarea frunzelor și a nodurilor. qorollup withdrawverifică înainte să plătească. Primește retragerile batch-ului (qorollup withdraw --file withdrawal.json [--dry-run]), construiește dovada sub legarea proprie a batch-ului și refuză înainte de a plăti o taxă atunci când rezultatul nu estewithdrawals_rooton-chain al batch-ului.buildDaBlobse angajează așa cum o face lanțul. Commitment-ul său este SHAKE-256, nu SHA-256 (nicio tranzacție nu postează un blob, decidataHashrămâne gol).- Watchtower. Watchtower-ul deosebea batch-urile doar după index, așa că rata un batch retrimis la un index respins. De la lanțul v3.2.5 (ambele rețele), o fraudă confirmată respinge batch-ul și fiecare batch ulterior nefinalizat, iar sequencer-ul retrimite sub aceleași indexuri; Watchtower-ul deosebește acum batch-urile după index și rădăcină de stare și nu validează niciodată un batch respins. Helperi noi:
transitionRootValidator(un predicatvalidatecare aplică regula de fraudă a lanțului) șifraudProofForBatch(dovada care câștigă, sau niciuna pentru un batch onest), precum șiqorollup watchtower --canonical, care raportează batch-urile pe care o contestație le-ar câștiga. - Helperi de settlement pentru lanțul v3.2.5 (ambele rețele):
getRollupHealthraporteazăheldBackByatunci când ultimul batch s-ar putea finaliza în propria fereastră, dar un batch anterior este încă submitted sau challenged (batch-urile se finalizează în ordine), iarqorollup statusîl afișează;stopRollupErrorși o verificare prealabilă înstopRollup(TypeScript și Rust), deoarece un rollup al cărui ultim batch este submitted sau challenged nu poate fi oprit;MAX_PENDING_OPTIMISTIC_BATCHES(4.096);withdrawalsRootError(o rădăcină a retragerilor este goală sau are exact 32 de octeți), verificată înainte de fiecare trimitere de batch în toate cele cinci limbaje. - Helperi cross-VM pentru lanțul v3.2.5 (ambele rețele):
getCrossVmParams(lista de permisiuni, la/qorechain/crossvm/v1/params),crossVmTargetReady(precompile activ, bridge activat și țintă în lista de permisiuni, cu motivul care blochează),decodeCrossVmResult(răspunsul esteabi.encode(bytes)) șidecodeRevertReason(un refuz esteError(string)), verificați față de codificări produse de Solidity. Vezi Multi-VM. - Decodarea erorilor și adăugiri mici.
decodeRdkTxErrorșiRDK_ERRORSnumesc codurile de eroare ale modululuirdk(2 până la 36) și ce trebuie făcut în privința celor pe care le întâlnește un operator;qorehash(SHAKE-256, 32 de octeți) este exportat în toate cele cinci limbaje;FEATURE_RDK_CHALLENGE_SETTLEMENTnumește flag-ul de funcționalitate al lanțului. - Șablonul
defise oprește înainte să irosească o taxă. Nicio versiune de lanț până la v3.2.6 nu poate înregistra o cheie de verificare ZK, deci fiecare batch ZK a fost refuzat acolo. Șablonul se oprește acum înainte de trimitere, iarRollupView.hasVerificationKeycitește un câmp destinat lanțului v3.2.7 (testnet din 6 noiembrie, mainnet din 12 noiembrie 2026); nu a putut fi verificat pe un rollup live, deoarece nu există niciunul. - Dependențe.
@qorechain/sdk^0.10.0(era^0.9.0), deci o aplicație pe SDK 0.10.0 împarte acum o singură copie a SDK-ului cu kitul; șabloanele fixează@qorechain/rdk^0.7.0(^0.8.0de la 0.8.0).
Ce s-a schimbat în 0.6.2 (doar CLI-ul și schela; pachetele de bibliotecă sunt neschimbate):
qorolluprulează când este instalat din npm. CLI-ul pornea doar cândprocess.argv[1]era egal cu propria cale de fișier, dar npm pornește bin-ul unui pachet printr-un symlink dinnode_modules/.bin, așa că 0.6.1 și versiunile anterioare, instalate local, global sau rulate cunpx, ieșeau cu codul 0 și nu afișau nimic; funcționa doarnode .../dist/index.js. 0.6.2 compară căile reale. Dupănpm i -g @qorechain/rdk-cli,qorollup ...funcționează.- Versiunile se afișează corect.
qorollup --versionafișa0.4.1, iarcreate-qorechain-rollup --versionafișa0.2.0în versiunile anterioare; ambele își citesc acum propriulpackage.json(verificat la 27 octombrie 2026:qorollup --versionafișează0.6.2).
Ce s-a schimbat în 0.6.1 (toate cele cinci limbaje, dacă o linie nu spune altfel; notele de lansare conțin lista completă):
- Verificarea chitanțelor compară fiecare câmp.
verifySettlementReceiptcere acum ca fiecare câmp de ancoră declarat de chitanță să fie egal cu ancora lanțului (o nepotrivire numește câmpul), cere cabatchStateRootsă fie egal cu rădăcina batch-ului din lanț și refuză o chitanță cu unversionnecunoscut sau cu unalgorithmdiferit deML-DSA-87înainte de a citi ceva din lanț. Rezultatul poartăanchor-ul potrivit al lanțului și, când este valid, unverifiedReceiptreconstruit din starea lanțului;qorollup receipt verify --jsonreturnează acea chitanță citită din lanț careceipt. Vezi Chitanțe de settlement. - Disponibilitate nativă a datelor: lasă
dataHashgol. Fiecare profil de rollup folosește disponibilitate a datelornative, unde lanțul acceptă undata_hashnevid doar atunci când un blob corespunzător este stocat on-chain, iar nicio tranzacție nu poate stoca unul (vezi Disponibilitatea datelor). Cele șase șabloane de pornire puneau un hash de date pe batch-urile lor în 0.6.0 și mai devreme, așa că lanțul refuza fiecare batch de șablon după ce taxa era plătită. Acum îl lasă gol;SubmitBatchInput.dataHasheste opțional în TypeScript (omis înseamnă gol),dataHashError(data_hash_error,DataHashError,Rules.dataHashError) expune regula, iarRdkTxClient.submitBatchrefuză un astfel de batch înainte de transmitere atunci când poate citi rollup-ul (un client hibrid cu un endpoint REST). - Șabloanele optimistic publică rădăcina canonică de stare. Lanțul judecă un batch optimistic după rădăcina sa canonică de tranziție, un commitment SHAKE-256 al rădăcinii de stare anterioare a batch-ului, al hash-ului de date și al numărului de tranzacții (
batchTransitionRootîn RDK, cutransitionRootVersionForalegând legarea pe care o aplică rețeaua conectată). Șabloanelecustom,multivmșinfttrimiteau o rădăcină placeholder fixă, care nu corespunde rădăcinii canonice verificate de lanț; acum publică rădăcina canonică și nu mai trimit o dovadă placeholder.challenge.tsdin șablonulnftcitește batch-ul din lanț și contestă doar un batch a cărui rădăcină este demonstrabil greșită. Nu implementa formula de mână: foloseștebatchTransitionRoot, astfel încât legarea să corespundă rețelei în care trimiți. Verificarea proprie a lanțului este aceeași pentru orice client, deci un batch optimistic a cărui rădăcină de stare nu este rădăcina canonică poate fi contestat cu succes, indiferent de clientul care l-a trimis. - Helperi noi.
fraudProof,transitionRootVersionForBatch,receiptSchemaErrorcuSUPPORTED_RECEIPT_VERSIONS,RestClient.getProtocolFeatures/isProtocolFeatureEnabled(un lanț fără acea rută este citit ca „neactivat") șigetAppliedPlanHeight.@qorechain/rdkdepinde acum direct de@noble/hashes(SHAKE-256 pentru rădăcina de tranziție; era deja instalat prin@qorechain/sdk). Șabloanele fixează@qorechain/rdk^0.6.1.
Ce s-a schimbat în 0.6.0 (TypeScript, dacă o linie nu spune altfel):
- Semnare.
RdkClient.connectTx(signer, { pqcKeypair, rest })semnează hibrid (secp256k1 + ML-DSA-87) atunci când transmiți un keypair; fără el semnează exclusiv clasic, iar rețelele refuză tranzacția.signertrebuie să fie unOfflineDirectSigner, iar taxa trebuie să fie explicită (unfeesau ungasPricela conectare). Helperii noiresolvePqcKeypairșipqcKeypairFromEnvderivă dintr-un mnemonic atât cheia ML-DSA-87 canonică, cât și pe cea legacy și o folosesc pe cea pe care contul o are înregistrată on-chain; refuză, în loc să ghicească, atunci când contul deține o cheie diferită.QORE_PQC_SEED_HEXfurnizează un seed pentru un operator care semnează cu o cheie privată brută. Kitul depinde acum de@qorechain/sdk^0.9.0, deci o instalare nouă conține o singură copie a SDK-ului (0.9.0); cu 0.5.0, npm instala SDK 0.8.3 imbricat sub kit. - Batch-uri ancorate.
MsgSubmitBatchpoartăanchor_signatureșivalidator_set_hash.RdkTxClient.submitBatchsemnează ancora singur doar atunci când clientul semnează hibrid, are un endpoint REST și este creatorul rollup-ului (lanțul verifică ancora față de cheia înregistrată a creatorului); în orice alt caz trimite fără ancoră, ca înainte. Transmiteanchor: "require"pentru a refuza în loc să trimită fără ancoră,anchor: "off"pentru a nu semna niciodată, sauanchorSignaturepentru a trimite o semnătură obținută de tine.anchorSignBytesForBatchconstruiește octeții v2 pentru un creator care semnează în afara fluxului, de care are nevoie un rollup cu un sequencer separat. Netestat live. - Chitanțe de settlement. Căutarea contului PQC folosește ruta la singular
/qorechain/pqc/v1/account/{address}(0.5.0 folosea o cale la plural pe care rețelele nu o servesc). Verificarea acceptă ambele forme de sign-bytes ale ancorei și o alege pe una după înălțimea ancorei, niciodată încercându-le pe ambele: v1 sub trecerea din v3.2.2, v2 de la ea. Schema de chitanță v2 înregistreazăchainId; verificarea refuză o chitanță verificată față de un nod al altui lanț și raporteazăsignBytesVersionși o verificarechainBinding. Chitanțele versiunea 1 se verifică în continuare. Vezi Chitanțe de settlement. - Citiri.
getLatestBatchapelează/qorechain/rdk/v1/latest_batch/{rollup_id}(0.5.0 apela o formă pe care lanțul nu o servește), iarlistBatchesparcurge fiecare pagină (listBatchesPagecitește una singură).RollupViewpoartăescrowBalanceși, acolo unde nodul le raportează,challengeWindowSec,challengeBondșiproofSystem;BatchViewpoartăsubmittedTime. - Ferestre de contestare.
batchChallengeWindowcalculează fereastra unui batch așa cum o face lanțul și o evaluează față de vârful lanțului (getChainTip), nu față de ceasul local: secunde de timp de bloc pentru un batch care are un timp de trimitere înregistrat (regula v3.2.4: testnet de la înălțimea 8.337.253, mainnet din înălțimea 3.742.566),window / 6blocuri numărate de la înălțimea trimiterii în caz contrar (regula pentru batch-urile trimise înainte de înălțimea upgrade-ului). Verificarea de sănătate din spateleqorollup statusși watchtower-ul o folosesc (vezi Watchtower). - Cross-VM.
encodeCrossVmCalldatacodifică acumexecuteCrossVMCall(uint8,string,bytes), structura pe care o decodifică nodul, și primește untargetVm.isCrossVmPrecompileActivecitește lista live a precompile-urilor active (vezi Multi-VM). - Reguli verificate înainte de plata unei taxe.
rollupIdErrorverifică gramatica id-ului la validarea unei configurații și înainte cacreateRollupsă transmită;withdrawalErrorsverifică o retragere înainte caexecuteWithdrawalsă transmită. - Șabloane. Șabloanele create de schelă se conectează prin
pqcKeypairFromEnv, deci scripturile lorcreateșisubmit-batchsemnează hibrid, și depindeau de@qorechain/rdk^0.6.0(^0.6.1începând cu schela 0.6.1). Șablonulmultivm-rollupverifică dacă precompile-ul este activ și cere un răspuns nevid de la țintă. - Python, Go, Rust și Java. Remedierile de pe partea de citire de mai sus (ruta PQC la singular,
latest_batch, sign-bytes v2 ai ancorei, regulile ferestrei de contestare, verificările de id și de retragere) se află și în pachetele publicate ale celorlalte patru limbaje. - Modificări incompatibile.
encodeCrossVmCalldataprimeștetargetVm, iarCROSS_VM_DEFAULT_SIGNATUREs-a schimbat.RollupHealthșiBatchDeadlinepoartă unchallengeWindowîn loc de vechiul termen limită exprimat în secunde.
Limite care rămân în 0.8.0:
-
Settlement-ul ZK nu a fost încercat pe nicio rețea. Sunt afectate profilul
defi, șablonuldefi-rollupși fiecare rollup creat cu settlementzk: mesajele de cheie de verificare sunt activate pe mainnet din lanțul v3.2.7 (12 noiembrie 2026) și pe testnet din 6 noiembrie 2026, dar nu a fost creat niciun rollup ZK, iar RDK 0.8.0 nu are un builder pentru mesaje. Folosește deocamdată settlementoptimistic(vezi ZK / STARK & Withdrawals). -
Circuitul demo al șablonului
definu se poate verifica. Este un circuit multiplicatorsnarkjs, în timp ce lanțul verifică Groth16 peste BLS12-381 cu trei intrări publice (rădăcina de stare anterioară, rădăcina de stare nouă și hash-ul de date). Chiar și după ce există înregistrarea cheii, o dovadă din circuitul demo nu ar trece; înlocuiește circuitul cu propriul circuit de tranziție de stare. -
Remediat în 0.7.0: helperii Merkle pentru retrageri. În 0.6.2 și versiunile anterioare, helperii foloseau implicit SHA-256, iar o dovadă construită cu valorile implicite nu s-a verificat niciodată on-chain; folosește
withdrawalsTree/assembleWithdrawalProofde la 0.7.0 (vezi Codificarea frunzelor și a nodurilor). -
Semnarea hibridă are nevoie de cheia ta post-cuantică. Fiecare client (TypeScript, CLI-ul
qorollupde la 0.7.1 și Python, Go, Rust și Java de la 0.8.0) semnează hibrid doar când are un keypair post-cuantic; fără el o tranzacție este exclusiv clasică, iar ambele rețele o refuză. Versiunile dinaintea acelora semnează exclusiv clasic, deci CLI-ul dinaintea lui 0.7.1 și clienții Python, Go, Rust și Java dinaintea lui 0.8.0 nu pot trimite o tranzacție pe care rețelele să o accepte. Constructorii de mesaje Python nu au câmpulanchor_signaturesauvalidator_set_hash(verificat în sursa 0.8.0; neverificat pentru celelalte trei), deci pentru un batch ancorat din Python construiește și semnează cu CLI-ul lanțului (--generate-only, apoiqorechaind tx pqc cosign) sau folosește clientul TypeScript cu unpqcKeypair. -
Nicio creare hibridă a unui rollup nu a fost exersată live, deoarece nu există niciun rollup pe vreuna dintre rețele. Același lucru este valabil pentru batch-urile ancorate, retragerile și întregul flux al chitanțelor.
-
Ancorarea cere creatorul. Un batch este ancorat în aceeași tranzacție doar dacă semnătura creatorului se află în ea. Dacă sequencer-ul este o altă adresă, creatorul trebuie să semneze octeții v2 în afara fluxului, iar sequencer-ul trimite rezultatul.
-
Precompile-ul cross-VM de la
0x…0901nu este activ pe mainnet, deci un apel dintr-un contract nu face nimic acolo. Pe testnet este activ cu o listă de permisiuni, iar un apel a fost testat cueth_callla 7 noiembrie 2026 (vezi Multi-VM). -
Lungimea ferestrei de contestare. Kitul citește fereastra proprie a unui rollup doar atunci când nodul o raportează (pachetul documentează acest lucru ca v3.2.4 și ulterior, pe care le rulează ambele rețele). În caz contrar folosește fereastra implicită a modulului; transmite
challengeWindowSecspentru un rollup care și-a configurat-o pe a sa. Helperii mai vechichallengeWindowDeadlineșiisChallengeWindowClosedsunt în continuare exportați și primesc în continuare secunde, deci nu le da o înălțime de bloc. -
Disponibilitatea datelor. Nicio tranzacție nu postează un blob, deci un batch pe un rollup
nativesaubothtrebuie să lasedataHashgol (vezi Disponibilitatea datelor).buildDaBlobcalcula hash-ul cu SHA-256 în 0.6.2 și versiunile anterioare; de la 0.7.0, commitment-ul său este SHAKE-256 al lanțului.
Versiuni anterioare lui 0.8.0. 0.7.0 și versiunile anterioare nu pot trimite tranzacții qorollup acceptate de rețele (remediat în 0.7.1), iar înainte de 0.8.0 clienții Python, Go, Rust și Java nu puteau trimite nicio tranzacție. 0.6.2 și versiunile anterioare construiesc dovezi de retragere care nu se verifică niciodată on-chain și calculează hash-ul buildDaBlob cu SHA-256; folosește 0.8.0. 0.6.1 și versiunile anterioare instalau CLI-ul qorollup din npm într-o stare în care nu afișa nimic și ieșea cu 0 (remediat în 0.6.2). 0.6.0 compară mai puține câmpuri la verificarea chitanțelor decât 0.6.1 și livrează șabloane care trimit batch-uri pe care lanțul le refuză (un hash de date pe un rollup cu DA nativ, o rădăcină de stare placeholder pe cele optimistic). 0.5.0 și cele anterioare nu ar trebui folosite pentru chitanțe de settlement, watchtower sau calldata cross-VM: 0.5.0 căuta cheia creatorului pe o rută pe care rețelele nu o servesc (deci verificarea chitanțelor eșua închis pentru fiecare chitanță autentică), reconstruia doar mesajul de ancoră v1, citea o înălțime de bloc ca timestamp (fiecare vârstă de batch și fiecare termen limită de contestare erau greșite, iar watchtower-ul ridica imediat alerta de termen limită pentru fiecare batch), apela o rută latest-batch pe care lanțul nu o servește, citea doar primele 50 de batch-uri, codifica o funcție pe care precompile-ul nu o decodifică și livra șabloane care semnau exclusiv clasic. 0.4.x nu avea semnare hibridă în clientul de tranzacții.
Clienții Python, Go, Rust și Java
Pe lângă pachetul TypeScript, RDK-ul oferă clienți compleți în Python, Go, Rust și Java care reflectă suprafața TypeScript: constructorul de configurație cu validare, cele cinci profiluri preset, utilitare denom/economie/bech32, helper-e Merkle binar și pentru dovezi de retragere, manifeste de rollup, clienți de citire REST și JSON-RPC qor_, verificări preflight/health, conturi (mnemonic → adresă qor) și, de la 0.8.0, semnare hibridă + broadcast de tranzacții (ML-DSA-87 + secp256k1, așa cum cer ambele rețele; înainte de 0.8.0 semnau exclusiv clasic și funcționau doar citirile lor, vezi RDK 0.8.0: modificări și limite). Toate sunt verificate față de vectori de test comuni, cross-language, și sunt publicate în registrele lor:
# Python — installs as qorechain-rdk, imports as qorrdk
pip install qorechain-rdk
# Rust
cargo add qorechain-rdk
# Go (pin the version)
go get github.com/qorechain/qorechain-rdk/packages/go@v0.9.0
# Java (Maven / Gradle)
# io.github.qorechain:qorechain-rdk:0.9.0 (necesită Java 21)
import qorrdk
Versiuni curente publicate, toate 0.9.0 (verificat la 12 noiembrie 2026): Python qorechain-rdk (PyPI, import qorrdk), modulul Go github.com/qorechain/qorechain-rdk/packages/go (v0.9.0), Rust qorechain-rdk (crates.io) și Java io.github.qorechain:qorechain-rdk (Maven Central; Java 21 sau mai nou de la 0.8.0). Acești clienți citesc starea lanțului și, de la 0.8.0, trimit tranzacții semnate hibrid când le dai un keypair post-cuantic (vezi RDK 0.8.0: modificări și limite).
RDK-ul TypeScript și șabloanele sale folosesc implicit testnetul qorechain-diana, iar preset-urile ajung la endpoint-urile publice live fără configurare suplimentară. Fixează versiunile (pin) și validează pe testnet înainte de mainnet.
Crearea unui proiect cu create-qorechain-rollup
Fiecare profil are un șablon de pornire asociat (defi-rollup, gaming-rollup, nft-rollup, enterprise-rollup, custom-rollup). Creează unul cu oricare dintre formele:
npm create qorechain-rollup my-rollup
# or
npx create-qorechain-rollup my-rollup
Pentru uz non-interactiv / CI, transmite explicit șablonul și rețeaua:
npx create-qorechain-rollup my-rollup --template defi-rollup --network testnet --yes
Schela afișează costul documentat de stake și de ardere la creare, plus pașii următori pentru a crea rollup-ul și a-i citi statusul.
Șabloanele create-qorechain-rollup 0.9.0 depind de @qorechain/rdk ^0.9.0. Scripturile lor create și submit-batch se conectează prin connectOperator() din src/signer.ts, care îți rezolvă cheia post-cuantică din QORE_MNEMONIC (sau din QORE_PQC_SEED_HEX când semnezi cu QORE_OPERATOR_PRIVATE_KEY_HEX), o verifică față de lanț și semnează hibrid; dacă niciuna nu este setată, scriptul avertizează și semnează exclusiv clasic, ceea ce ambele rețele refuză. Niciun rollup nu a fost creat printr-un șablon pe o rețea live, deci această cale este netestată live. Scriptul submit-batch al șablonului de pornire este doar un flux de referință: începând cu 0.6.1 lasă dataHash gol (lanțul refuză un hash de date pe un rollup cu DA nativ), iar șabloanele optimistic publică rădăcina canonică de stare în loc de un placeholder; folosește în continuare valori ilustrative pentru restul și nu este de așteptat să finalizeze un batch pe o rețea live. Șablonul defi-rollup (ZK) se oprește înainte de a trimite un batch de la 0.7.0, deoarece lanțul l-ar refuza (vezi ZK / STARK & Withdrawals).
Construiește o configurație de rollup din cod
Construiește o configurație dintr-un preset, citește stake-ul și rata de ardere live de pe lanț și produce mesajul de creare. Constructorul de configurație aplică matricea de compatibilitate settlement → proof la validate() / build(). Trimite valorile rezultate cu CLI-ul de mai sus sau cu clientul TypeScript căruia i s-a dat un pqcKeypair — vezi RDK 0.8.0: modificări și limite.
import { createRdkClient, presets, estimateCreationCost, uqorToQor } from "@qorechain/rdk";
// A config builder pre-filled with the defi preset's defaults; override via .set({ ... }).
const config = presets.defi({ rollupId: "my-defi-rollup" }).validate();
// The public qore.host endpoints are baked into the presets (RDK ≥ 0.4.2).
// `params()` is a REST read of /qorechain/rdk/v1/params, served on both networks.
const rdk = createRdkClient({ network: "testnet" });
// Read the live module parameters — never hardcode the stake or burn rate.
const params = await rdk.params();
const cost = estimateCreationCost({
stakeUqor: params.minStakeForRollup,
burnRate: params.rollupCreationBurnRate,
});
console.log(`Stake: ${uqorToQor(cost.stakeUqor)} QOR — burned: ${uqorToQor(cost.burnUqor)} QOR`);
// The values to pass to `qorechaind tx rdk create-rollup`.
const msg = config.toCreateMsg("<your qor address>", { stakeAmount: params.minStakeForRollup });
console.log(msg.rollupId, msg.profile, msg.vmType, msg.stakeAmount);
Nu ești sigur ce profil ți se potrivește? rdk.suggestProfile(...) ar trebui să returneze o recomandare asistată de QCAI; pe endpoint-urile publice actuale returnează întotdeauna fallback-ul defi (source: "fallback"), așa că alege din tabelul de profiluri.
Citește starea din cod
Clientul REST tipat nu are nevoie de signer și citește ambele rețele:
const rollup = await rdk.rest.getRollup("my-defi-rollup");
console.log(rollup.status, rollup.settlementMode, rollup.daBackend, rollup.vmType);
Pentru batch-uri, folosește rdk.rest.getBatch(rollupId, index) sau qorechaind query rdk batch [rollup-id] (mai jos); getLatestBatch și listBatches citesc, începând cu 0.6.0, ruta latest_batch a lanțului și fiecare pagină a listei de batch-uri (vezi RDK 0.8.0: modificări și limite).
Gestionarea ciclului de viață
Un rollup trece prin stările pending, active, paused și stopped; un rollup nou începe imediat în starea active. Doar creatorul îl poate pune în pauză, relua sau opri (impus începând cu versiunea de lanț v3.2.0). Fiecare comandă de mai jos urmează același tipar în doi pași ca la creare: generează tranzacția nesemnată, apoi co-semneaz-o.
Pause
Oprește temporar rollup-ul. Starea este păstrată, iar rollup-ul poate fi reluat. Este necesar un șir de caractere care să indice motivul.
qorechaind tx rdk pause-rollup [rollup-id] [reason] \
--from mykey \
--chain-id qorechain-diana \
--gas 400000 --fees 40000uqor \
--generate-only > pause.json
qorechaind tx pqc cosign pause.json --from mykey --pqc-key mypqckey --chain-id qorechain-diana
Resume
Reia un rollup pus anterior în pauză.
qorechaind tx rdk resume-rollup [rollup-id] \
--from mykey \
--chain-id qorechain-diana \
--gas 400000 --fees 40000uqor \
--generate-only > resume.json
qorechaind tx pqc cosign resume.json --from mykey --pqc-key mypqckey --chain-id qorechain-diana
Stop
Dezafectează permanent rollup-ul și eliberează stake-ul. QOR-ul stake-uit — minus arderea unică de la creare și minus orice a fost deja plătit din escrow-ul rollup-ului prin retrageri sau recompense pentru dovezi de fraudă — este returnat creatorului: începând cu v3.2.3, un registru de escrow per rollup înregistrează ce mai deține fiecare rollup, stop-rollup returnează exact acel sold, iar un rollup oprit nu mai plătește retrageri. Stake-ul de înregistrare a stratului, de 1.000 QOR, este returnat separat când stratul rollup-ului este dezafectat.
De la lanțul v3.2.5 (ambele rețele): un rollup nu poate fi oprit cât timp ultimul său batch este submitted sau challenged, așa că rezolvă-l sau finalizează-l mai întâi; un rollup oprit eliberează locul său sub limita de rollup-uri a modulului. Înainte de v3.2.5 niciuna dintre cele două reguli nu se aplica. Din TypeScript, stopRollupError și verificarea prealabilă din stopRollup te anunță înainte să plătești taxa.
qorechaind tx rdk stop-rollup [rollup-id] \
--from mykey \
--chain-id qorechain-diana \
--gas 400000 --fees 40000uqor \
--generate-only > stop.json
qorechaind tx pqc cosign stop.json --from mykey --pqc-key mypqckey --chain-id qorechain-diana
Oprirea unui rollup este permanentă. Rollup-ul nu poate fi repornit după ce a fost oprit.
Comenzi de operator: batch-uri și contestații
Operatorii de rollup trimit batch-uri de settlement, iar contestatarii pot disputa batch-uri optimistice. Aceste comenzi stau la baza stratului de settlement descris în Prezentare generală Rollups și ZK / STARK & Withdrawals.
Cine poate trimite și în ce ordine
- Doar adresa de sequencer configurată a rollup-ului — sau, când nu este configurată niciuna (cazul tuturor preset-urilor), creatorul său — poate trimite batch-uri. Based sequencing și shared sequencing nu admit încă seturi de propunători sau liste (rosters): sunt deocamdată doar etichete, iar creatorul trimite.
- Batch-urile formează un lanț: primul batch are indexul
0; fiecare batch ulterior trebuie să folosească indexul următor și să poarte rădăcina de stare a batch-ului anterior caprev_state_root. - Un batch care poartă un hash de date pe un rollup
nativesaubotheste refuzat dacă nu este deja stocat un blob corespunzător (vezi Disponibilitatea datelor). Un batch fără hash de date nu este verificat. - Un rollup
zktrebuie să atașeze o dovadă, iar dovada trebuie să treacă verificarea; niciun batch ZK nu poate fi acceptat încă (vezi ZK / STARK & Withdrawals). - De la lanțul v3.2.5 (ambele rețele):
withdrawals_rootal unui batch trebuie să fie gol sau de exact 32 de octeți, iar un rollup poate avea cel mult 4.096 de batch-uri optimistice în așteptare (MAX_PENDING_OPTIMISTIC_BATCHESîn RDK); în plus, batch-urile se finalizează în ordinea indexului, deci un batch ulterior așteaptă unul anterior care este încăsubmittedsauchallenged. RDK verifică lungimea rădăcinii înainte de fiecare trimitere. Înainte de v3.2.5 niciuna dintre aceste trei reguli nu se aplica.
Trimite un batch
Trimite un batch de settlement pentru un rollup. Primește ID-ul rollup-ului, un index de batch și o rădăcină de stare codificată hex. Pentru fiecare batch după primul, transmite rădăcina de stare a batch-ului anterior ca --prev-state-root.
qorechaind tx rdk submit-batch [rollup-id] [batch-index] [state-root-hex] \
--prev-state-root <previous-state-root-hex> --tx-count 120 \
--from mykey \
--chain-id qorechain-diana \
--gas 400000 --fees 40000uqor \
--generate-only > batch.json
qorechaind tx pqc cosign batch.json --from mykey --pqc-key mypqckey --chain-id qorechain-diana
| Flag | Descriere |
|---|---|
--prev-state-root | Rădăcina de stare hex de la care pornește batch-ul (obligatorie pentru fiecare batch după indexul 0) |
--tx-count | Numărul de tranzacții rollup din batch |
--data-hash | Hash-ul hex al datelor batch-ului postate ca blob DA (lasă-l gol astăzi: nu există nicio modalitate de a posta un blob, vezi Disponibilitatea datelor) |
--withdrawals-root | Rădăcina Merkle hex a retragerilor L2 → L1 ale batch-ului (vezi ZK / STARK & Withdrawals) |
--anchor-signature | Semnătura hex ML-DSA-87 a creatorului rollup-ului peste octeții de semnat v2 ai ancorei (din v3.2.2); batch-ul este apoi ancorat în x/multilayer în aceeași tranzacție, iar o ancoră refuzată refuză batch-ul |
--validator-set-hash | Commitment-ul hex al setului de validatori, purtat în ancoră și acoperit de semnătură |
Fără --anchor-signature, batch-ul este decontat neancorat. Pentru a ancora un batch, afișează octeții de semnat, semnează-i cu cheia post-cuantică înregistrată a creatorului și transmite semnătura (valorile --tx-count și --validator-set-hash trebuie să corespundă celor pe care le trimiți):
qorechaind query rdk anchor-sign-bytes [layer-id] [batch-index] [state-root-hex] \
--chain-id qorechain-diana --tx-count 120
layer-id este id-ul stratului rollup-ului (id-ul rollup-ului pentru rollup-urile create de RDK). Din TypeScript, RdkTxClient.submitBatch din @qorechain/rdk 0.6.0 și ulterior semnează ancora pentru tine atunci când clientul semnează hibrid și este creatorul rollup-ului, iar anchorSignBytesForBatch oferă unui creator octeții de semnat în afara fluxului (vezi RDK 0.8.0: modificări și limite). --proof ZK pentru un rollup zk nu are astăzi niciun flag CLI, iar mesajul resolve-challenge nu este o comandă CLI: folosește un client. Vezi Chitanțe de settlement pentru ce dovedește și ce nu dovedește o ancoră. Încă nu există niciun rollup, strat sau ancoră pe vreuna dintre rețele.
Contestă un batch (rollup-uri optimistice)
Orice cont poate contesta un batch submitted în fereastra de contestare (100.800 de blocuri implicit pentru un batch trimis pe mainnet înainte de înălțimea 3.742.566; de la v3.2.4, o fereastră în secunde de timp de bloc pentru batch-urile noi: pe testnet de la înălțimea 8.337.253, pe mainnet din înălțimea 3.742.566), depunând o garanție (bond) (challenge_bond-ul rollup-ului; 1.000 QOR pentru preset-urile nft și custom) și o dovadă de fraudă. Un batch optimistic este judecat după faptul că rădăcina sa de stare este rădăcina canonică de tranziție, deci cine îl trimite ar trebui să publice exact acea rădăcină (șabloanele RDK o fac, de la 0.6.1; vezi RDK 0.8.0: modificări și limite). Primește ID-ul rollup-ului și indexul batch-ului; transmite dovada de fraudă cu --proof:
qorechaind tx rdk challenge-batch [rollup-id] [batch-index] \
--proof <hex-encoded-fraud-proof> \
--from mykey \
--chain-id qorechain-diana \
--gas 400000 --fees 40000uqor \
--generate-only > challenge.json
qorechaind tx pqc cosign challenge.json --from mykey --pqc-key mypqckey --chain-id qorechain-diana
| Flag | Descriere |
|---|---|
--proof | Dovadă de fraudă codificată hex |
O contestație îngheață batch-ul (challenged): acesta nu mai poate fi finalizat. Înainte de v3.2.5 doar creatorul rollup-ului îl putea rezolva; de la v3.2.5 (ambele rețele) îl poate rezolva orice cont, așa cum se descrie mai jos. Rezoluția se transmite cu un mesaj resolve-challenge (nu este expus ca o comandă CLI; folosește un client). Lanțul decide singur rezultatul, verificând dovada stocată. Dacă frauda este confirmată, batch-ul devine rejected, garanția este returnată, iar contestatarul primește o sumă suplimentară egală cu garanția, din stake-ul rollup-ului; dacă este respinsă, garanția ajunge la creator, iar batch-ul revine la submitted.
De la lanțul v3.2.5 (ambele rețele): orice cont poate rezolva o contestație, nu doar creatorul. O fraudă confirmată respinge acel batch și fiecare batch ulterior care nu este încă finalizat, iar sequencer-ul retrimite acele batch-uri de la ultima rădăcină de stare bună, sub aceleași indexuri; rollup-ul continuă de acolo. Watchtower-ul deosebește astfel de batch-uri după index și rădăcină de stare (vezi Watchtower).
Inspectează batch-urile
# Latest batch for a rollup
qorechaind query rdk batch [rollup-id]
# A specific batch by index
qorechaind query rdk batch [rollup-id] --index 42
# A page of batches in index order (--limit up to 100, default 50)
qorechaind query rdk batches [rollup-id] --start 0 --limit 50
Interogare
| Comandă | Scop |
|---|---|
qorechaind query rdk rollup [rollup-id] | Detaliile unui rollup specific |
qorechaind query rdk list-rollups | Toate rollup-urile înregistrate |
qorechaind query rdk batch [rollup-id] | Ultimul batch de settlement (sau --index) |
qorechaind query rdk batches [rollup-id] | O pagină de batch-uri în ordinea indexului (--start, --limit) |
qorechaind query rdk anchor-sign-bytes [layer-id] [batch-index] [state-root-hex] | Octeții de semnat v2 ai ancorei pentru un batch (offline) |
qorechaind query rdk config | Parametrii modulului RDK |
qorechaind query rdk suggest-profile [use-case] | Afișează o trimitere către RPC-ul qor_suggestRollupProfile; endpoint-urile publice nu îl servesc, așa că alege un profil din tabelul Profiluri preset |
Pașii următori
- Disponibilitatea datelor — backend-uri DA native, Celestia și redundante.
- ZK / STARK & Withdrawals — verificarea dovezilor și fluxul de retragere L2 → L1 prin
execute-withdrawal.