Rollups-Überblick
Das QoreChain Rollup Development Kit (RDK) ist eine Sammlung von Client-Bibliotheken (TypeScript, Python, Go, Rust und Java), ein Kommandozeilenwerkzeug für Betreiber und Starter-Templates, um anwendungsspezifische Rollups zu bauen, die über das On-Chain-Modul x/rdk auf QoreChain abgewickelt werden. Damit konfigurieren Sie ein Rollup, bauen und signieren seine Transaktionen, lesen seinen Zustand, verfolgen seine Challenge-Fenster, stellen Settlement-Quittungen aus und verifizieren sie und stellen Cross-VM-Aufrufe und Abhebungsbeweise zusammen. Jedes Rollup ist eine unabhängige Ausführungsumgebung mit eigener Blockzeit, eigener virtueller Maschine, eigenem Gebührenmodell und eigener Sequenzierung, erbt dabei jedoch die Sicherheit, die Post-Quanten-Kryptographie und die Datenverfügbarkeit von QoreChain. Diese Seite richtet sich an Entwickler, die ein Rollup starten oder betreiben möchten, und an alle, die entscheiden wollen, ob das RDK zu ihrer Anwendung passt.
Das RDK ist auf beiden Netzwerken bereitgestellt, aber bislang wurde auf keinem von beiden ein Rollup erstellt (geprüft am 27. Oktober 2026), sodass die in diesem Abschnitt beschriebenen Abläufe von Dritten noch nicht erprobt wurden. ZK-Settlement (das Profil defi, das Template defi-rollup und jedes zk-Rollup) wurde auf keinem der beiden Netzwerke ausprobiert: Die Nachrichten für Verifikationsschlüssel sind im Mainnet seit Chain v3.2.7 (12. November 2026) und im Testnet seit dem 6. November 2026 aktiviert (siehe ZK / STARK & Abhebungen), aber es wurde kein ZK-Rollup erstellt. Verwenden Sie optimistic-Settlement, bis ein ZK-Rollup Ende-zu-Ende betrieben wurde.
Das Mainnet (qorechain-vladi, EVM-Chain-ID 9801, live seit dem 7. Juni 2026) läuft mit der Chain-Version v3.2.7 (Governance-Vorschlag 16 hat sie auf Höhe 4.164.600 am 12. November 2026 angewendet; v3.2.6 war auf Höhe 4.020.000 am 4. November 2026 durch Vorschlag 15 angewendet worden; v3.2.5 war auf Höhe 3.906.833 am 29. Oktober 2026 durch Vorschlag 14 angewendet worden und v3.2.4 auf Höhe 3.742.566 am 23. Oktober 2026, Vorschlag 13); das Testnet (qorechain-diana, EVM-Chain-ID 9800) läuft seit dem 12. November 2026 mit v3.2.8 (Höhe 9.929.500; v3.2.4 erreichte es am 19. Oktober 2026, v3.2.5 am 26. Oktober, v3.2.6 am 27. Oktober, v3.2.7 am 6. November). Das Mainnet ist dem Testnet ein Release zurück: Es hat v3.2.8 nicht angewendet. Was v3.2.5 für Rollups ändert, ist unter Verhalten von Chain v3.2.5 aufgeführt; es gilt in beiden Netzwerken. Wo sich das Verhalten zwischen v3.2.3 und v3.2.4 geändert hat, nennt dieser Abschnitt, welches Release gilt. Validieren Sie jedes Deployment zuerst im Testnet und lesen Sie die Statushinweise auf jeder Seite: Mehrere Funktionen (ZK-Verifikation, Celestia-Datenverfügbarkeit, der QCAI Copilot, Cross-VM-Aufrufe, Settlement-Quittungen) sind heute nicht durchgängig nutzbar.
Innovationen
- Post-Quanten-Settlement-Quittungen. Der State Anchor eines Batches wird mit ML-DSA-87 durch den registrierten Schlüssel des Rollup-Erstellers signiert.
verifySettlementReceiptliest jedes Feld der Quittung erneut von der Chain (Rollup, Layer, Batch-Root und den Anker: State Root, Layer-Höhe, Höhe der Main Chain, Ankerzeit, Hash des Validator-Sets, Transaktionsanzahl, Beweis, Signatur). Der verifizierende Schlüssel stammt von der Chain und nie aus der Quittung; die Quittung muss das Netzwerk nennen, das Sie abfragen; eine unbekannte Quittungsversion oder ein anderer Algorithmus als ML-DSA-87 wird vor jedem Lesezugriff abgelehnt; und eine reine Signaturprüfung wird nie als gültig gemeldet. Die Ankernachricht hat unterhalb der Höhe von Chain v3.2.2 eine erste Form und ab dieser Höhe eine zweite Form, die zusätzlich die Chain-ID bindet; die Version wird anhand der Höhe des Ankers gewählt. Siehe Settlement-Quittungen. - Hybrides Signieren mit zwei Schlüsselableitungen. Transaktionen werden mit secp256k1 plus ML-DSA-87 signiert. Der Post-Quanten-Schlüssel wird aus der Mnemonic sowohl auf kanonische Weise (SHAKE-256 über
qorechain:pqc:v1|, die Adresse und die Mnemonic) als auch auf die Legacy-Weise abgeleitet, und der Client verwendet denjenigen Schlüssel, den die Chain für das Konto registriert hat. Die Clients für Python, Go, Rust und Java signieren ab 0.8.0 hybrid und die CLI ab 0.7.1; davor tat dies nur der TypeScript-Client. - Abhebungsbeweise, gebaut wie die Chain sie baut.
withdrawalsTree(0.7.0, alle fünf Sprachen) baut die Abhebungs-Root eines Batches und jeden Beweis genau so wie die Chain: Die Blattposition ist der Abhebungsindex, die Knoten werden mit SHAKE-256 gehasht, und Batches ab Chain v3.2.5 verwenden Blätter der zweiten Form, die zusätzlich die Chain-ID nennen. Es wurde gegen Vektoren getestet, die vom eigenen Code der Chain erzeugt wurden, und jeder Beweis in diesen Vektoren wird vom Verifizierer der Chain akzeptiert.qorollup withdrawbricht vor dem Bezahlen einer Gebühr ab, wenn sein Ergebnis nicht dem On-Chain-Wertwithdrawals_rootdes Batches entspricht. - Kanonische Transition Root.
batchTransitionRootberechnet exakt die State Root, nach der die Chain einen optimistischen Batch beurteilt (die heute im Mainnet angewendete Form ist eine SHAKE-256-Verpflichtung auf die vorherige State Root, den Daten-Hash und die Transaktionsanzahl;transitionRootVersionForwählt die Form, die das verbundene Netzwerk anwendet), undfraudProofbaut daraus den 64-Byte-Beweis. Beides wurde gegen Vektoren getestet, die vom eigenen Code der Chain erzeugt wurden. - Chain-exakte Challenge-Fenster.
batchChallengeWindowberechnet das Fenster eines Batches so, wie es die Chain tut (zeitbasiert: offen, solange die Blockzeit unter der Einreichungszeit plus Fenster liegt; bei älteren Batches das Fenster geteilt durch sechs, in Blöcken ab der Einreichungshöhe), und beurteilt es gegen die Chain-Spitze aus dem RPC/status, nicht gegen die lokale Uhr. Der Watchtower und der Health-Monitor verwenden es. Ab 0.7.0 meldetgetRollupHealthzusätzlichheldBackBy, wenn die Finalität in Reihenfolge der Chain (v3.2.5, beide Netzwerke, siehe Verhalten von Chain v3.2.5) einen Batch zurückhält, undqorollup watchtower --canonicalmeldet die Batches, bei denen eine Anfechtung gewinnen würde. - Prüfungen, bevor eine Gebühr bezahlt wird. Das Kit lehnt eine Rollup-ID außerhalb von
^[a-z0-9][a-z0-9._-]{2,63}$ab; eine Abhebung, die nicht inuqorlautet, einen Betrag von null hat, einen Beweis mit mehr als 64 Ebenen zu je 32 Byte trägt oder eine ungültige bech32-Adresse nennt; eine Abhebungs-Root, die weder leer noch genau 32 Byte lang ist; ein Stoppen des Rollups, das die Chain ablehnen wird (v3.2.5 und später); und, wenn es das Rollup lesen kann, einen Batch, der bei einem Rollup mit Datenverfügbarkeitnativeoderbotheinen Daten-Hash nennt. Jedes davon würde sonst von der Chain abgelehnt, nachdem die Gebühr ausgegeben wurde. - Cross-VM-Calldata und eine Live-Prüfung.
encodeCrossVmCalldatabaut Calldata fürexecuteCrossVMCall(uint8,string,bytes)(Selektor0x3c11078c, Precompile0x...0901), undisCrossVmPrecompileActiveliest, ob das Precompile im Netzwerk aktiv ist. Ab 0.7.0 deckengetCrossVmParams,crossVmTargetReady,decodeCrossVmResultunddecodeRevertReasondie Allowlist und die Antwortformate von Chain v3.2.5 ab (beide Netzwerke). Siehe Multi-VM. - Ein Satz Testvektoren für fünf Sprachen. Die Pakete für TypeScript, Python, Go, Rust und Java werden gegen dieselbe Golden Fixture geprüft (das Go-Paket hat 100 Unit-Tests, Rust 77 und Java 75).
Anwendung
Lesezugriffe brauchen weder einen Schlüssel noch Guthaben. Die folgenden Snippets lesen die Live-Parameter des Moduls rdk und die Liste der Rollups im öffentlichen Testnet (qorechain-diana) und wurden am 27. Oktober 2026 aus den veröffentlichten Paketen ausgeführt (diese Läufe verwendeten 0.7.0; die aktuelle Version ist 0.9.0; 0.8.0 fügte den Clients für Python, Go, Rust und Java hybrides Signieren hinzu und die hier gezeigten Lese-Aufrufe unverändert lässt, aber die Snippets wurden damit nicht erneut ausgeführt). Jedes gab die Testnet-Parameter aus (maximale Rollups 200, Mindest-Stake 10.000 QOR, Burn-Rate bei der Erstellung 0,01, Standard-Challenge-Fenster 3.600 Sekunden, maximale DA-Blob-Größe 2.097.152 Byte, Blob-Aufbewahrung 432.000 Blöcke, höchstens 10 Batches pro Block) und 0 rollups.
TypeScript (getestet)
npm install @qorechain/rdk
import { createRdkClient } from "@qorechain/rdk";
// Public testnet (chain id qorechain-diana).
const rdk = createRdkClient({
network: "testnet",
endpoints: { rest: "https://api-testnet.qore.host" },
});
// Read the live rdk module parameters and the registered rollups.
const params = await rdk.params();
const rollups = await rdk.rest.listRollups();
console.log(rdk.network.chainId, params, `${rollups.length} rollups`);
Die Presets mainnet und testnet bringen die öffentlichen qore.host-Endpunkte bereits mit, sodass createRdkClient({ network: "testnet" }) auch ohne das Feld endpoints funktioniert; es ist oben gezeigt, weil das getestete Snippet es übergeben hat. Ausführen mit Node 20 oder neuer (der Test verwendete Node 26).
Python (getestet)
pip install qorechain-rdk
from qorrdk import create_rdk_client
# Public testnet (chain id qorechain-diana).
rdk = create_rdk_client(network="testnet", endpoints={"rest": "https://api-testnet.qore.host"})
# Read the live rdk module parameters and the registered rollups.
params = rdk.params()
rollups = rdk.rest.list_rollups()
print(rdk.network.chain_id, params, f"{len(rollups)} rollups")
Python 3.10 oder neuer. qorechain-rdk hängt von qorechain-pqc ab, das liboqs-python nachzieht und die Bibliothek liboqs benötigt; auf einer Maschine ohne sie baut der erste Import sie (git, CMake und ein C-Compiler werden benötigt). Getestet in einer frischen virtuellen Umgebung mit Python 3.12.
Go (getestet)
go get github.com/qorechain/qorechain-rdk/packages/go@v0.9.0
package main
import (
"context"
"fmt"
rdk "github.com/qorechain/qorechain-rdk/packages/go"
)
func main() {
// Public testnet (chain id qorechain-diana).
client := rdk.NewRdkClient(rdk.RdkClientOptions{
Network: "testnet",
Endpoints: &rdk.Endpoints{Rest: "https://api-testnet.qore.host"},
})
ctx := context.Background()
// Read the live rdk module parameters and the registered rollups.
params, err := client.Params(ctx)
if err != nil {
panic(err)
}
rollups, _ := client.Rest.ListRollups(ctx)
fmt.Printf("%s %+v %d rollups\n", client.Network.ChainID, params, len(rollups))
}
Getestet mit Go 1.26, mit dem vom Go-Proxy geholten Modul.
Rust (getestet)
cargo add qorechain-rdk
use qorechain_rdk::client::{RdkClient, RdkClientOptions};
fn main() -> Result<(), Box<dyn std::error::Error>> {
// Public testnet (chain id qorechain-diana).
let rdk = RdkClient::new(RdkClientOptions {
rest_url: Some("https://api-testnet.qore.host".into()),
..Default::default()
});
// Read the live rdk module parameters and the registered rollups.
let params = rdk.params()?;
let rollups = rdk.rest.list_rollups()?;
println!("{} {:?} {} rollups", rdk.network.chain_id, params, rollups.len());
Ok(())
}
Die Bibliothek heißt qorechain_rdk. Getestet mit Rust 1.95, gebaut gegen crates.io.
Java (getestet)
// build.gradle.kts
implementation("io.github.qorechain:qorechain-rdk:0.9.0")
import io.github.qorechain.rdk.client.RdkClient;
import io.github.qorechain.rdk.client.Views.ParamsView;
import io.github.qorechain.rdk.config.Networks;
public class RdkQuickstart {
public static void main(String[] args) {
// Public testnet (chain id qorechain-diana).
RdkClient.Options options = new RdkClient.Options();
options.network = "testnet";
options.endpoints = new Networks.Endpoints();
options.endpoints.rest = "https://api-testnet.qore.host";
RdkClient rdk = new RdkClient(options);
// Read the live rdk module parameters and the registered rollups.
ParamsView params = rdk.params();
int rollups = rdk.rest.listRollups().size();
System.out.println(rdk.network.chainId + " maxRollups=" + params.maxRollups
+ " minStakeForRollup=" + params.minStakeForRollup + " " + rollups + " rollups");
}
}
Java 21 oder neuer ab 0.8.0 (0.7.1 und früher liefen mit JDK 17); getestet mit JDK 21 und Gradle 9.6, aufgelöst aus Maven Central. Die Datei muss RdkQuickstart.java heißen. Maven Central liefert 0.7.0, 0.7.1 und 0.8.0 aus (geprüft am 31. Oktober 2026).
Kommandozeile (getestet)
npm install -g @qorechain/rdk-cli
qorollup --version
qorollup params --network testnet
qorollup --version gibt die installierte Version aus (0.7.0 im Testlauf), und qorollup params --network testnet gibt die Live-Modulparameter aus. Das funktioniert ab 0.6.2. Die Releases 0.6.1 und früher beendeten sich mit Code 0 und gaben nichts aus, wenn sie aus npm installiert wurden. Der Test installierte @qorechain/rdk-cli@0.7.0 in einem leeren Projekt und führte es über node_modules/.bin/qorollup aus; eine globale Installation und npx verwenden denselben Bin-Link. Node 20 oder neuer ist erforderlich.
Ein Projekt aufsetzen (getestet)
npx create-qorechain-rollup my-rollup --template nft-rollup --network testnet --yes
cd my-rollup && npm run doctor
Die Templates sind defi-rollup, gaming-rollup, nft-rollup, enterprise-rollup, custom-rollup und multivm-rollup. Das aufgesetzte Projekt hängt von @qorechain/rdk ^0.9.0 ab (^0.8.0 in 0.8.0, ^0.7.0 davor). Das Aufsetzen von nft-rollup mit dem Scaffolder 0.6.1 erzeugte ein Projekt, dessen npm run doctor gegen das Testnet durchlief (REST erreichbar, Parameter lesbar, Netzwerk qorechain-diana; es warnt vor Celestia-Datenverfügbarkeit und einem fehlenden Signer); das Aufsetzen von defi-rollup und npm run typecheck liefen am 27. Oktober 2026 mit dem aktuellen Release erneut durch. Verwenden Sie defi-rollup noch nicht, um ein Rollup zu starten (siehe Einschränkungen). Um ein Rollup zu erstellen und Batches einzureichen, folgen Sie Ein Rollup deployen; Transaktionen benötigen einen registrierten Post-Quanten-Schlüssel und im RDK den TypeScript-Client mit einem pqcKeypair.
Zugang
Netzwerke und Endpunkte. Das RDK spricht mit den öffentlichen Endpunkten der beiden Netzwerke; die Presets mainnet und testnet bringen sie bereits mit.
| Netzwerk | Chain-ID | EVM-Chain-ID | REST-Endpunkt | Chain-Version |
|---|---|---|---|---|
| Mainnet | qorechain-vladi | 9801 | https://api.qore.host | v3.2.7 |
| Testnet | qorechain-diana | 9800 | https://api-testnet.qore.host | v3.2.8 |
Beide Netzwerke bedienen die RDK-Abfragen (/qorechain/rdk/v1/...) über REST, gRPC und die CLI, sodass Lesezugriffe wie rdk.params() gegen beide funktionieren. Das Testnet ist ein Staging-Netzwerk mit eigenen Parametern: Das Standard-Challenge-Fenster beträgt 3.600 Sekunden im Testnet und 604.800 im Mainnet, im Testnet können höchstens 200 Rollups existieren und im Mainnet 100, und das Multilayer-Modul erlaubt 64 Sidechain-Layer im Testnet und 10 im Mainnet (geprüft am 27. Oktober 2026). Lesen Sie GET /qorechain/rdk/v1/params auf dem Netzwerk, das Sie anpeilen.
Voraussetzungen, um ein Rollup zu erstellen.
| Anforderung | Details |
|---|---|
| Finanziertes Konto | Ein Konto mit genügend QOR für den Stake, den Layer-Stake und die Gebühren. |
| Hinterlegter Stake | Das Erstellen eines Rollups hinterlegt min_stake_for_rollup im Escrow, auf beiden Netzwerken 10.000 QOR. 1 % des Stakes (100 QOR) werden bei der Erstellung verbrannt; der Rest bleibt im Escrow und wird zurückgegeben, wenn das Rollup gestoppt wird. |
| Layer-Stake | Die Erstellung registriert außerdem den Layer des Rollups im Multilayer-Modul (Mindest-Stake 1.000 QOR). Kann der Layer nicht registriert werden, wird das Rollup dennoch erstellt, hat aber keinen echten Layer, sodass seine Batches nicht verankert und keine Quittungen ausgestellt werden können. |
| Registrierter Post-Quanten-Schlüssel | Ein für das Konto registrierter ML-DSA-87-Schlüssel. Transaktionen auf der nativen Lane, die nur mit dem klassischen Schlüssel signiert sind, werden abgelehnt. Ein neues Konto muss seinen Post-Quanten-Schlüssel in einer eigenen Transaktion registrieren, bevor irgendetwas anderes geschieht; die RDK-Clients 0.9.0 übernehmen diese Registrierung für Sie. |
| Gebühren | Die Gebührenuntergrenze beträgt 0,1 uqor pro Gas-Einheit; setzen Sie Gaslimit und Gebühr gemeinsam. |
| Tooling | Node 20 oder neuer für die CLI und den Scaffolder; Python 3.10 oder neuer (mit liboqs, siehe oben) für den Python-Client; Java 21 oder neuer für Java (ab RDK 0.8.0); das Go-Modul github.com/qorechain/qorechain-rdk/packages/go. |
Für Lesezugriffe braucht man nichts davon. Sie können ein Rollup auch über das Dashboard anfordern (ein Anfrageformular, keine On-Chain-Transaktion) oder mit der Chain-CLI erstellen; den vollständigen Ablauf, die CLI-Befehle und den TypeScript-Signierpfad finden Sie unter Ein Rollup deployen.
Verhalten von Chain v3.2.5: live in beiden Netzwerken
Chain v3.2.5 ist im Mainnet live (angewendet auf Höhe 3.906.833 am 29. Oktober 2026, Governance-Vorschlag 14) und im Testnet (seit dem 26. Oktober 2026). Das Mainnet läuft mit v3.2.7 und das Testnet mit v3.2.8, und beide enthalten sie. RDK 0.7.0 und neuer unterstützen beide. Diese Regeln gelten in beiden Netzwerken; im Mainnet wurde noch kein Rollup erstellt (GET /qorechain/rdk/v1/rollups lieferte am 4. November 2026 eine leere Liste), sodass die folgenden Regeln die Regeln des Releases sind und von einem live betriebenen Mainnet-Rollup noch nicht erprobt wurden. Für einen Rollup-Entwickler:
| Verhalten | Beide Netzwerke (v3.2.5 und später) |
|---|---|
| Wer eine Anfechtung auflösen kann | Jedes Konto |
| Nach einem bestätigten Betrug | Der Batch und jeder spätere nicht finalisierte Batch werden verworfen; der Sequencer reicht ab der letzten guten Root unter denselben Indizes erneut ein |
| Finalitätsreihenfolge | Batches werden in Indexreihenfolge finalisiert |
| Ausstehende optimistische Batches | Höchstens 4.096 pro Rollup |
| Ein Rollup stoppen | Abgelehnt, solange der letzte Batch submitted oder challenged ist; ein gestopptes Rollup gibt seinen Platz frei |
withdrawals_root | Leer oder genau 32 Byte; Abhebungsblätter der zweiten Form nennen die Chain-ID |
| Cross-VM-Brücke | GET /qorechain/crossvm/v1/params liefert die Allowlist (bridge_allowed_targets: im Mainnet leer, am 4. November 2026 erneut geprüft; im Testnet war sie am 30. Oktober leer und enthielt am 4. November drei CosmWasm-Ziele); das Precompile gibt abi.encode(bytes) zurück und lehnt mit Error(string) ab |
Cross-VM-Precompile 0x...0901 | Im Testnet aktiv, mit einer Allowlist geprüfter CosmWasm-Contracts (ein Aufruf wurde am 7. November 2026 mit eth_call getestet); im Mainnet nicht aktiv |
Chain v3.2.6 ist in beiden Netzwerken live (im Mainnet seit dem 4. November 2026, Höhe 4.020.000, Vorschlag 15). Für Rollups fügt das Release withdrawals_bound zur Batch-Ansicht hinzu (ob die Abhebungen eines Batches an ihn gebunden sind); außerdem bringt es IBC- und Observability-Änderungen, die nicht ändern, wie ein Rollup abgerechnet wird. Es existiert kein Mainnet-Rollup, das das neue Feld zeigen könnte, daher stammt die Angabe aus den Release Notes und wurde nicht beobachtet.
Chain v3.2.7: beide Netzwerke
Das Testnet lief ab dem 6. November 2026 mit Chain v3.2.7 (Höhe 9.594.600, per Governance angewendet) und wechselte am 12. November auf v3.2.8. Das Mainnet läuft seit dem 12. November 2026 mit v3.2.7 (Höhe 4.164.600, Governance-Vorschlag 16). Die folgenden Prüfungen wurden am 7. November 2026 im Testnet durchgeführt; sie wurden im Mainnet nicht wiederholt, wo nur die Schalter des Releases bekannt sind. Für Rollups:
- Nachrichten für ZK-Verifikationsschlüssel. Das Testnet akzeptierte
MsgSetVerificationKeyundMsgUpdateVerificationKey(eine simulierte Transaktion mit leerer Nachricht kam an der Auflösung des Nachrichtentyps vorbei und scheiterte am leeren Adressfeld; das Mainnet antwortete am 7. November, vor der Anwendung von v3.2.7, für dieselbe Nachricht mit „unable to resolve type URL“). Die Nachrichten für Verifikationsschlüssel sind im Mainnet ab dem 12. November 2026 aktiviert. Laut Release Notes wird ein ZK-Batch ohne registrierten Schlüssel abgelehnt, bevor die Gebühr bezahlt wird. Im Testnet existiert kein Rollup (GET /qorechain/rdk/v1/rollupslieferte eine leere Liste), undGET /qorechain/rdk/v1/rollupslieferte am 12. November 2026 auch im Mainnet eine leere Liste, daher wurde kein Schlüssel registriert und kein ZK-Batch verifiziert. RDK 0.8.0 hat keinen Builder für diese Nachrichten. - Cross-VM-Precompile
0x...0901. Im Testnet aktiv, mit einer Allowlist aus drei geprüften CosmWasm-Contracts; ein schreibgeschütztereth_callerreichte einen Contract der Allowlist und wurde für jedes andere Ziel abgelehnt (Details unter Multi-VM). Im Mainnet bleiben das Precompile und Cross-VM-Aufrufe aus, auch nach v3.2.7 (die Cross-VM-Aufrufnachricht ist pausiert).
Was heute existiert
| Status | |
|---|---|
| Registrierte Rollups (Mainnet und Testnet) | Keine |
Modul x/rdk und seine Parameter | Auf beiden Netzwerken bereitgestellt; lesen Sie sie mit qorechaind query rdk config |
| RDK-Abfragen | Auf beiden Netzwerken über die CLI, gRPC und REST (/qorechain/rdk/v1/...) verfügbar, sodass REST-basierte Lesezugriffe wie das TypeScript-rdk.params() gegen das Mainnet funktionieren |
| Vom RDK geschriebene Settlement-Anker | Keine. Seit v3.2.2 kann ein Batch eine anchor_signature tragen und wird dann in derselben Transaktion in x/multilayer verankert; ohne sie wird der Batch unverankert abgewickelt. Es existiert noch kein Rollup, kein Layer und kein Anker. Das TypeScript-RDK (0.6.0 und neuer) sendet das Feld, wenn sein Client hybrid signiert und der Ersteller des Rollups ist (live nicht getestet); die Clients für Python, Go, Rust und Java signieren ab 0.8.0 hybrid, senden das Feld aber nicht (für Python geprüft) |
In x/multilayer registrierte Rollup-Layer | Keine |
| ZK-Settlement | Nachrichten für Verifikationsschlüssel sind im Mainnet aktiviert (v3.2.7, 12. November 2026) und werden im Testnet akzeptiert; auf keinem von beiden wurde bisher ein ZK-Rollup ausprobiert |
| Abhebungen | Werden seit v3.2.3 aus einem Escrow-Ledger je Rollup ausgezahlt (siehe ZK / STARK & Abhebungen); es wurde keine vorgenommen, da kein Rollup existiert |
Für die tiefergehende Modulreferenz (Modulparameter, Lifecycle-Interna, Burn-Integration und Multilayer-Verankerung) siehe die Seite Rollup Development Kit im Architektur-Abschnitt. Dieser Rollups-Abschnitt ist die entwicklerorientierte Anleitung.
Wo es veröffentlicht ist
Versionen auf den Registries am 12. November 2026 geprüft. Alle Pakete stehen unter Apache-2.0.
RDK 0.9.0 (12. November 2026) unterstützt Chain v3.2.8 (das Testnet führt sie seit dem 12. November 2026 aus): Senden von Rollup-Daten, Based Sequencing, optimistische qledger-v1-Rollups mit Fraud-Proofs, private Rollups, kanonische ZK-Eingaben; STARK-Settlement ist pausiert. Siehe die Release Notes auf GitHub.
| Registry | Paket | Aktuelle Version | Link |
|---|---|---|---|
| npm | @qorechain/rdk (TypeScript-Client) | 0.9.0 | npmjs.com |
| npm | @qorechain/rdk-cli (qorollup) | 0.9.0 | npmjs.com |
| npm | create-qorechain-rollup (Scaffolder) | 0.9.0 | npmjs.com |
| PyPI | qorechain-rdk (Import qorrdk) | 0.9.0 | pypi.org |
| crates.io | qorechain-rdk (Bibliothek qorechain_rdk) | 0.9.0 | crates.io |
| Go-Modul-Proxy | github.com/qorechain/qorechain-rdk/packages/go | v0.9.0 | pkg.go.dev |
| Maven Central | io.github.qorechain:qorechain-rdk | 0.9.0 | central.sonatype.com |
Maven Central liefert 0.7.0, 0.7.1, 0.8.0 und 0.9.0 sowie frühere Versionen aus, und das @latest des Go-Proxys kann einem neuen Tag hinterherhinken, daher sollten Sie die Go-Version festlegen. Der Quellcode ist öffentlich unter github.com/qorechain/qorechain-rdk, die Release-Hinweise stehen unter v0.9.0 (und v0.8.0, v0.7.1), und die eigene Dokumentation des Kits befindet sich unter qorechain.github.io/qorechain-rdk. Das TypeScript-Paket hängt von @qorechain/sdk ^0.10.0 (ab 0.7.0; 0.6.x verwendete ^0.9.0; die Pakete für Python, Go, Rust und Java verwenden ab 0.8.0 das passende QoreChain-SDK 0.10.x) und @qorechain/evm ^0.8.0 ab, und das Python-Paket von qorechain-pqc 0.2.x. Die Modullogik x/rdk der Chain selbst ist nicht Teil des öffentlichen Kits.
Einschränkungen und bekannte Probleme
- ZK-Settlement wurde auf keinem der beiden Netzwerke ausprobiert. Das betrifft das Profil
defi, das Templatedefi-rollupund jedes mitzk-Settlement erstellte Rollup. Die Nachrichten für Verifikationsschlüssel sind im Mainnet seit Chain v3.2.7 (12. November 2026) und im Testnet seit dem 6. November 2026 aktiviert, aber es wurde kein ZK-Rollup erstellt, RDK 0.8.0 hat keinen Builder für die Nachrichten, und ein ZK-Batch ohne registrierten Schlüssel wird abgelehnt. Verwenden Sie vorerstoptimistic-Settlement (siehe ZK / STARK & Abhebungen). - Auf keinem Netzwerk wurde ein Rollup erstellt. Die Pfade für Erstellen, Batch, Challenge, Quittung und Abhebung sind durch Unit-Tests und gemeinsame Vektoren abgedeckt, wurden aber on-chain nicht erprobt.
- Hybrides Signieren braucht Ihren Post-Quanten-Schlüssel. Ab RDK 0.8.0 signieren alle fünf Clients hybrid, wenn ihnen ein Post-Quanten-Schlüsselpaar übergeben wird, und die Transaktionsbefehle von
qorollup(create,pause,resume,stop,withdraw) tun dies ab 0.7.1; ohne Schlüssel oder in früheren Versionen ist eine Transaktion nur klassisch signiert, und beide Netzwerke lehnen sie ab. Keine hybride Transaktion eines Clients wurde über ein Live-Rollup gesendet. Verankerte Batches sendet nur der TypeScript-Client. - (a) Die CLI
qorollupgab in 0.6.1 und früher nichts aus, wenn sie aus npm installiert wurde. Das ist in 0.6.2 behoben: Nachnpm i -g @qorechain/rdk-clifunktioniertqorollup ..., undqorollup --versiongibt 0.6.2 aus. - (b) Die Merkle-Helfer für Abhebungen verwendeten in 0.6.2 und früher standardmäßig SHA-256, während die Chain SHAKE-256 verwendet. Ein mit diesen Standardwerten gebauter Beweis wurde on-chain nie verifiziert. In 0.7.0 behoben:
withdrawalsTreebaut den exakten Baum der Chain und wurde gegen den eigenen Verifizierer der Chain geprüft (siehe Blatt- und Knoten-Kodierung). Aktualisieren Sie; Code, der sich auf die SHA-256-Standardwerte stützte, muss jetzthashausdrücklich übergeben. - (c)
buildDaBlobhashte in 0.6.2 und früher mit SHA-256, während die Blob-Verpflichtung der Chain SHAKE-256 ist. In 0.7.0 behoben, wo seine Verpflichtung die der Chain ist. Es hatte nie eine praktische Wirkung, da keine Transaktion einen Blob veröffentlicht; lassen SiedataHashbeinativeundbothDatenverfügbarkeit leer (siehe Datenverfügbarkeit). - (d) Die Demo-Schaltung des Templates
defikann nicht verifizieren. Es ist einsnarkjs-Multiplikator, und die Chain prüft Groth16 über BLS12-381 mit der vorherigen State Root, der State Root und dem Daten-Hash als öffentlichen Eingaben, die diese Schaltung nicht bereitstellt. Selbst nachdem die Schlüsselregistrierung ausgeliefert ist, benötigen Sie Ihre eigene Schaltung. - Jedes Konto kann eine Anfechtung auflösen (v3.2.5 und später, beide Netzwerke). Die Chain prüft den Fraud Proof selbst; vor v3.2.5 konnte nur der Ersteller des Rollups die Auflösung einreichen (siehe Verhalten von Chain v3.2.5 und Optimistic).
- Auf den Live-Netzwerken nicht nutzbar: Celestia-Datenverfügbarkeit (nicht implementiert), der QCAI Rollup Copilot (seine Beratungsdienste sind auf den öffentlichen Endpunkten nicht verfügbar), Cross-VM-Aufrufe (das Precompile unter
0x...0901ist im Mainnet nicht aktiv; im Testnet ist es mit einer Allowlist aktiv, am 7. November 2026 miteth_callgetestet), gemeinsame und Based-Sequencer (die Chain lässt nur den konfigurierten Sequencer zu oder, wenn keiner gesetzt ist, den Ersteller) undsuggest-profile(es liefertdefials festen Fallback). - Versionshinweise. Verwenden Sie 0.9.0 für alles (0.7.0 und früher können keine
qorollup-Transaktionen senden, die die Netzwerke akzeptieren, und vor 0.8.0 können die Clients für Python, Go, Rust und Java gar keine Transaktion senden): 0.6.2 und früher bauen Abhebungsbeweise, die on-chain nie verifiziert werden, und 0.6.1 und früher geben nichts ausqorollupaus, wenn es aus npm installiert wurde. 0.5.0 und früher sollten nicht für Quittungen, den Watchtower oder Cross-VM-Calldata verwendet werden. Die vollständige Liste dessen, was jedes Release geändert hat, steht unter RDK 0.8.0: Änderungen und Einschränkungen.
Referenz: woraus ein Rollup besteht
Was das RDK Ihnen bietet
Ein über das RDK erstelltes Rollup bündelt vier konfigurierbare Aspekte:
| Aspekt | Was er steuert | Optionen |
|---|---|---|
| Settlement-Modus | Wie die Zustandsübergänge des Rollups auf QoreChain verifiziert und finalisiert werden | optimistic, zk, based, sovereign |
| Beweissystem | Der kryptographische oder ökonomische Mechanismus, der das Settlement absichert | fraud, snark, stark, none |
| Sequencer-Modus | Wer Transaktionen ordnet, bevor sie abgewickelt werden | dedicated, shared, based |
| Datenverfügbarkeit | Wo Transaktionsdaten veröffentlicht werden, damit jeder den Zustand rekonstruieren kann | native, celestia, both |
Jedes Rollup wird mit einer eindeutigen rollup-id registriert, durch einen Stake-Bond in QOR abgesichert und erhält einen Lifecycle-Status (pending, active, paused, stopped). Siehe Ein Rollup deployen für den vollständigen Erstellungs- und Lifecycle-Ablauf.
QoreChain-spezifische Fähigkeiten und ihr Status
Über die Grundausstattung jedes Rollup-Kits hinaus enthält das RDK drei Fähigkeiten, die um die Layer 1 von QoreChain herum aufgebaut sind, plus einen Watchtower-Auto-Challenger. Ihr Status unterscheidet sich; die Tabelle nennt, was heute funktioniert.
| Fähigkeit | Was sie tut |
|---|---|
| Settlement-Quittungen | Verpacken einen Settlement-Anker als portable Quittung, die eine Post-Quanten-Signatur (ML-DSA-87 / Dilithium-5) trägt. Frühes Stadium: Es existieren noch keine Anker, daher wurde nichts gegen einen echten Anker verifiziert; eine Quittung ist eine Behauptung, die gegen den Chain-Zustand geprüft werden muss, was der Verifizierer in 0.7.0 tut, Feld für Feld. |
| QCAI Rollup Copilot | Ein schreibgeschützter Beratungshelfer für ein Rollup (Gebührenschätzung, Empfehlungen, Betrugsuntersuchungen). Die Beratungsdienste, aus denen er liest, sind auf den öffentlichen Endpunkten noch nicht verfügbar. |
| Multi-VM Cross-VM-Aufrufe | Tooling zum Kodieren eines EVM-zu-QoreChain-Native-Aufrufs über das Cross-VM-Precompile (0x...0901). Das Precompile ist im Mainnet nicht aktiv (ein Aufruf bewirkt dort nichts) und im Testnet mit einer Allowlist aktiv (am 7. November 2026 mit eth_call getestet); der Encoder seit 0.6.0 entspricht dem Layout, das die Chain dekodiert. |
| Watchtower | Ein Auto-Challenger-Framework für optimistische Rollups, das neue Batches und Fristen des Challenge-Fensters sichtbar macht und ungültige Batches gegen Ihr Gültigkeitsprädikat anficht. Es liest über REST, das beide Netzwerke bereitstellen; seit 0.6.0 beurteilt es das Fenster jedes Batches so, wie es die Chain tut (spätere Releases behalten das bei). |
Siehe Warum das QoreChain RDK für die vollständige Begründung samt Codebeispielen.
Die vier Settlement-Paradigmen
Das QoreChain RDK unterstützt vier Settlement-Modi, jeweils mit unterschiedlichen Vertrauensannahmen, Finalitätsmerkmalen und Beweisanforderungen. Die Kombination aus Settlement-Modus und Beweissystem wird on-chain validiert, und eine inkompatible Paarung wird bei der Erstellung abgelehnt. Das Diagramm ordnet jedem Settlement-Modus sein gültiges Beweissystem zu.
Optimistic
Optimistische Rollups gehen standardmäßig davon aus, dass eingereichte Batches gültig sind, und stützen sich zur Streitbeilegung auf Fraud Proofs.
- Beweissystem:
fraud(interaktive Fraud Proofs). - Sequencer:
dedicatedodershared. - Finalität: Verzögert, bis ein konfigurierbares Challenge-Fenster ohne erfolgreiche Anfechtung abläuft.
- Anfechtungen: Jeder kann einen eingereichten Batch innerhalb des Fensters anfechten, indem er eine Kaution und einen Fraud Proof hinterlegt. Eine Anfechtung friert den Batch ein; ab v3.2.5 (beide Netzwerke) kann sie anschließend jedes Konto auflösen, während es vorher nur der Ersteller des Rollups konnte. Die Chain prüft den Beweis selbst: Ein bestätigter Betrug verwirft den Batch und zahlt den Anfechtenden aus, eine abgewiesene Anfechtung setzt den Batch zurück auf
submitted. Ab v3.2.5 verwirft ein bestätigter Betrug zusätzlich jeden späteren nicht finalisierten Batch, den der Sequencer ab der letzten guten Root unter denselben Indizes erneut einreicht (siehe Verhalten von Chain v3.2.5). Siehe Ein Rollup deployen. - Fensterlänge: Das Standardfenster beträgt im Mainnet 604.800 „Sekunden“ (der
default_challenge_windowdes Moduls; der Standard des Testnets beträgt 3.600 Sekunden, gelesen am 27. Oktober 2026, und ein Rollup kann ein eigenes festlegen). Vor v3.2.4 (im Mainnet vor Höhe 3.742.566) rechnet die Chain dies mit festen 6 Sekunden pro Block in Blöcke um, das sind 100.800 Blöcke, sodass die tatsächlich verstrichene Zeit der realen Blockzeit folgt (etwa 3,7 Tage bei den aktuellen ≈3,1-s-Blöcken des Mainnets); planen Sie also in Blöcken, nicht in Tagen. Ab v3.2.4 erhält ein Batch, der ab der Upgrade-Höhe eingereicht wird, ein in Sekunden Blockzeit gemessenes Fenster (volle 7 Tage); frühere Batches behalten die Regel nach Blockanzahl. Die Upgrade-Höhe ist 8.337.253 auf dem Testnet (seit dem 19. Oktober 2026) und 3.742.566 auf dem Mainnet (23. Oktober 2026).
ZK (Zero-Knowledge)
ZK-Rollups fügen jedem Batch einen kryptographischen Gültigkeitsbeweis bei, der die Korrektheit des Zustandsübergangs ohne erneute Ausführung belegt.
- Beweissystem:
snark(kompakte Beweise) oderstark(transparente Beweise, kein Trusted Setup). - Sequencer:
dedicatedodershared. - Finalität: Bei erfolgreicher Beweisverifikation, ohne Challenge-Fenster.
- Reifegrad: ZK-Settlement wurde auf keinem der beiden Netzwerke ausprobiert. SNARK-Batches sollen on-chain verifiziert werden (Groth16 über BLS12-381), und zwar gegen einen zusammen mit dem Rollup gespeicherten Verifikationsschlüssel; die Nachrichten für Verifikationsschlüssel sind im Mainnet seit Chain v3.2.7 (12. November 2026) und im Testnet seit dem 6. November 2026 aktiviert, wobei noch kein ZK-Rollup ausprobiert wurde. Die STARK-Verifikation ist experimentell: Sie ist optional und prüft eine Demonstrationsschaltung, nicht den Zustandsübergang Ihres eigenen Rollups. Siehe ZK / STARK & Abhebungen.
Based
Based-Rollups delegieren die Transaktionssequenzierung an die Proposer von QoreChain (L1) und erben so die Liveness und Zensurresistenz der Host-Chain.
- Beweissystem:
none(L1-Proposer sind die maßgebliche Quelle der Reihenfolge). - Sequencer:
based(erforderlich, durch On-Chain-Validierung erzwungen). - Finalität: Folgt der Bestätigung der Host-Chain.
- Kompromiss: Das einfachste Betriebsmodell, da die QoreChain-Validatoren die Sequenzierung übernehmen, um den Preis der Latenzkontrolle eines dedizierten Sequencers.
- Status heute:
basedwird in der Rollup-Konfiguration festgehalten, aber QoreChain lässt L1-Proposer noch nicht als Batch-Einreicher zu; der Ersteller des Rollups reicht ein (siehe Sequencer-Modi).
Sovereign
Sovereign-Rollups betreiben ihren eigenen Konsens und sequenzieren selbst. Sie verankern ihren Zustand zur Verifizierbarkeit auf QoreChain, sind für die Finalität jedoch nicht von der Host-Chain abhängig.
- Beweissystem:
none. - Sequencer: vom Rollup selbst verwaltet.
- Finalität: Unabhängig, bestimmt durch den eigenen Konsens des Rollups.
- Zustandsverankerung: State Roots werden zur Transparenz auf QoreChain veröffentlicht, aber die Host-Chain erzwingt sie nicht.
Beweissystem-Kompatibilität
Der Settlement-Modus schränkt ein, welche Beweissysteme gültig sind. Diese Paarungen werden bei der Erstellung eines Rollups erzwungen.
| Settlement-Modus | fraud | snark | stark | none |
|---|---|---|---|---|
| optimistic | Erforderlich | - | - | - |
| zk | - | Unterstützt | Unterstützt | - |
| based | - | - | - | Erforderlich |
| sovereign | - | - | - | Erforderlich |
Sequencer-Modi
Der Sequencer bestimmt, wer Transaktionen innerhalb eines Rollup-Blocks vor dem Settlement ordnet.
| Modus | Wer sequenziert | Hinweise |
|---|---|---|
dedicated | Eine einzelne designierte Operator-Adresse | Geringste Latenz; erfordert Vertrauen in den Operator hinsichtlich Liveness und fairer Reihenfolge |
shared | Ein gemeinsam genutztes Sequencer-Set | Reihenfolge über das Set verteilt; etwas höherer Koordinationsaufwand |
based | QoreChain-L1-Proposer | Erbt die Validator-Sicherheit und Zensurresistenz der Host-Chain; erforderlich für based-Settlement |
On-Chain darf ein Batch nur von der konfigurierten Sequencer-Adresse des Rollups oder, wenn keine gesetzt ist (bei jedem Preset), von seinem Ersteller eingereicht werden. Die Modi shared und based werden in der Rollup-Konfiguration festgehalten, aber QoreChain lässt noch kein gemeinsames Sequencer-Roster und keine L1-Proposer als Batch-Einreicher zu; diese Modi beschreiben das beabsichtigte Design.
Ein Paradigma wählen
| Wenn Sie ... möchten | Erwägen Sie |
|---|---|
| Das einfachste Betriebsmodell, bei dem QoreChain-Validatoren sequenzieren | based |
| Schnelle Finalität mit kryptographischen Garantien (noch nicht nutzbar) | zk (snark / stark) |
| Ein bewährtes Modell mit ökonomischer Streitbeilegung | optimistic (fraud) |
| Volle Unabhängigkeit mit eigenem Konsens, verankert zur Verifizierbarkeit | sovereign |
Nicht sicher, wo Sie anfangen sollen? Das RDK liefert Preset-Profile mit, die diese Entscheidungen für gängige Anwendungskategorien bündeln; siehe Preset-Profile. Ein Helfer suggest-profile existiert, liefert derzeit aber einen festen Fallback defi (und defi kann noch nicht genutzt werden), wählen Sie also anhand der Profiltabelle.
Verwandte Themen
- Ein Rollup deployen: ein Rollup über die CLI oder das TypeScript-RDK starten.
- Preset-Profile: Bundles für gängige Anwendungskategorien.
- Datenverfügbarkeit: der native DA-Router und Blob-Speicher.
- ZK / STARK Abhebungen: beweisgestützte Abhebungsabläufe.
- Settlement-Quittungen, Watchtower, Multi-VM und Warum das QoreChain RDK.