Zum Hauptinhalt springen

QoreChain SDK

Das QoreChain SDK ist das offizielle, mehrsprachige Entwickler-Kit zum Erstellen dezentraler Anwendungen auf QoreChain — einem Layer-1-Netzwerk mit drei virtuellen Maschinen und hybriden ML-DSA-87-Signaturen (FIPS 204).

Diese Dokumentation beschreibt, wie Sie das SDK installieren, sich mit dem Netzwerk verbinden, On-Chain-Zustand lesen, Konten ableiten, Transaktionen signieren und senden und mit jeder der virtuellen Maschinen von QoreChain arbeiten.

Was ist QoreChain?​

QoreChain ist eine Layer-1-Blockchain mit drei vollwertigen Smart-Contract-Laufzeitumgebungen auf einer einzigen Chain:

  • QoreChain Native — Wasm-Smart-Contracts über das Cosmos SDK (die CosmWasm-Runtime).
  • QoreChain EVM Engine — Ethereum-kompatible Ausführung (Solidity, viem, Standard-JSON-RPC).
  • SVM — eine Solana-kompatible Laufzeitumgebung mit einem JSON-RPC im Solana-Stil.

Konten, Guthaben und Token werden über die Laufzeitumgebungen hinweg geteilt, und die Chain enthält das IBC-Modul für Cross-Chain-Interoperabilität (im Mainnet ist kein IBC-Channel geöffnet; das Testnet hat einen geöffneten transfer-Channel zu einer Test-Chain, geprüft am 27. Oktober 2026).

Was heute auf den Live-Netzwerken funktioniert (das Mainnet läuft mit v3.2.7, das Testnet mit v3.2.8)

Funktioniert: Lesezugriffe auf jeder Lane, hybrid-signierte Native-Transaktionen, vereinheitlichte Konten, EVM-Transaktionen innerhalb eines Autorisierungsfensters und SVM-Lesezugriffe. Noch nicht verfügbar: die EVM-Precompiles im Mainnet (dort ist keines aktiv; das Testnet hat drei aktiv, PQC verify, PQC key status und die Konsensparameter, und das KI-Paar sowie die Cross-VM-Bridge sind auf beiden inaktiv), der qor_-JSON-RPC-Namespace, SVM-Transaktionen, Cross-VM-Aufrufe im Mainnet (MsgCrossVMCall ist durch den Circuit Breaker abgeschaltet), QoreChain Native-Upload und -Instanziierung für normale Konten (im Testnet ist die Instanziierung offen und der Upload nicht), die Authenticator-/Abstract-Account-Abläufe im Mainnet (Modul dort abgeschaltet, im Testnet aktiviert), xQORE und Gas-Abstraktion. Jeder Leitfaden wiederholt den Vorbehalt dort, wo er zutrifft. Geprüft gegen die Live-Endpunkte am 27. Oktober 2026; am 7. November 2026 war die Liste der aktiven Precompiles des Mainnets weiterhin leer, während die Liste des Testnets auch die Cross-VM-Bridge 0x…0901 enthielt (aktiv mit einer Allowlist; am 7. November 2026 wurde ein schreibgeschützter eth_call getestet).

Das veröffentlichte SDK (0.14.0, 12. November 2026) signiert in der Form, die beide Netzwerke verifizieren (v2-Hybrid-Sign-Bytes, aus dem Chain-Zustand aufgelöst), und das Signaturformat, die Adressen, Dezimalstellen, Memos und Gebühren haben sich in v3.2.3, v3.2.4, v3.2.5 oder v3.2.6 nicht geändert (das Mainnet läuft seit dem 12. November 2026 mit v3.2.7, Höhe 4.164.600, Governance-Vorschlag 16, nach v3.2.6 am 4. November; das Testnet seit dem 27. Oktober, und seit dem 6. November lief das Testnet mit v3.2.7 und seit dem 12. November läuft es mit v3.2.8, die Nachrichten hinzufügen, für die SDK 0.14.0 Builder hat; die neuen Regeln des Testnets gelten ab v3.2.8, und das Mainnet hat sie nicht angewendet; die Nachrichten von v3.2.7 sind seit dem 12. November 2026 im Mainnet). Es enthält die Client-Seite der späteren Post-Quanten-Regeln (den Besitznachweis bei der Schlüsselregistrierung, EVM-Fenster mit Gültigkeitsbereich, EIP-7702-Einwilligungsnachrichten) und von v3.2.4 (Staking- Stufen, die Authenticator-Nonce, Schalter für Protokollfunktionen) und v3.2.5 (exaktes Gas für Hybrid-Transaktionen, das ML-KEM-Schlüsselregister); Versionen vor 0.9.0 enthalten die erste Gruppe nicht, siehe Versionen vor 0.9.0, Was 0.12.0 neu bringt Was 0.13.0 ändert und Was 0.14.0 ändert.

Wallet- und Backend-Signierung: siehe QoreSign.

Hybrides ML-DSA-87-Signieren​

QoreChain stellt Post-Quanten-Kryptografie-Primitive (PQC) auf Basis von ML-DSA-87 (Dilithium-5, FIPS 204) bereit. Neben klassischem secp256k1-Signieren unterstützt die Chain eine hybride Signatur-Strategie, bei der eine Transaktion sowohl eine klassische Signatur als auch eine Post-Quanten-Signatur trägt — sie bleibt damit heute unter klassischer Verifikation gültig und erhält zugleich Post-Quanten-Schutz.

Das SDK stellt bereits heute ML-DSA-87-Schlüsselerzeugung, -Signierung und -Verifikation bereit, dazu die Bausteine für hybride Transaktionen. Auf den Live-Netzwerken muss eine Transaktion auf dem Native-Pfad hybrid signiert sein, und der ML-DSA-87-Schlüssel des Kontos muss zuvor registriert werden. Details finden Sie unter Konten & PQC-Signierung. Keine Marketing-Versprechen — das SDK stellt exakt die Primitive bereit, die die Chain implementiert.

Was dieses SDK besonders macht​

Über die vollständige Multi-Chain-Parität hinaus sind drei Fähigkeiten nur auf QoreChain möglich, weil sie auf Protokollfunktionen aufbauen, die keine andere Layer 1 besitzt:

  • KI-Preflight-Risikobewertung — prüfen Sie eine Transaktion mit On-Chain-KI, bevor Sie sie broadcasten. simulateWithRiskScore liefert Gas plus ein Risiko-/Anomalie-Urteil aus deterministischen EVM-Precompiles, sodass eine Wallet oder dApp vor dem Signieren warnen (oder blockieren) kann. Die KI-Precompiles sind im Mainnet und im Testnet noch nicht aktiv. Siehe KI-Preflight.
  • Vereinheitlichte Cross-VM-Aufrufe — ein Konto, drei VMs, eine Transaktion. createCrossVMClient ruft einen Contract auf jeder beliebigen VM auf, und callAtomic bündelt mehrere Cross-VM-Aufrufe in einer einzigen, einmal signierten atomaren Transaktion. Siehe Cross-VM-Aufrufe.
  • DX für hybrides Signieren — registrieren Sie den ML-DSA-87-Schlüssel eines Signers mit einem einzigen idempotenten Aufruf (ensurePqcRegistered / migrateToHybrid), inklusive eines Drop-in-React-Badges. Siehe Hybrides Signieren.

Zwei weitere Fähigkeiten auf Chain-Ebene kamen mit 0.6.0 und 0.7.0 hinzu (die zweite ist auf den Live-Netzwerken noch nicht nutzbar, siehe unten):

  • Vereinheitlichte eth-native Konten — ein eth_secp256k1-Schlüssel ist eine 20-Byte-Identität, dargestellt als qor1…, 0x… und eine SVM-Base58-Adresse, die alle ein gemeinsames Guthaben teilen. Siehe Vereinheitlichte Konten.
  • Authenticator-Lanes — verknüpfen Sie einen Phantom- oder MetaMask-Schlüssel mit dem kanonischen PQC-pflichtigen Konto und lassen Sie ihn über einen Relayer ausgeben — nach dem Least-Privilege-Prinzip, mit Ausgabenlimits und jederzeit widerrufbar. Das dahinterliegende abstractaccount-Modul ist im Mainnet abgeschaltet und im Testnet aktiviert. Siehe Authenticators & delegiertes Ausgeben.

Ein neues @qorechain/react-Kit (Provider, Hooks, ConnectButton, PqcStatusBadge) macht den Bau einer dApp mit hybrider ML-DSA-87-Signierung zum Standardweg — siehe den React-Kit-Guide. Die vollständige Argumentation finden Sie unter Warum QoreChain SDK.

Die SDK-Familie​

Das SDK erscheint als Paketfamilie, sodass Sie in der Sprache Ihrer Wahl entwickeln können. Alle Pakete teilen dieselben Netzwerk-Presets, Ableitungsschemata, Denominations-Arithmetik und Lese-Schnittstellen.

PaketSpracheInstallationStatus
@qorechain/sdkTypeScriptnpm i @qorechain/sdkVeröffentlicht (npm, v0.14.0)
qorechain-sdkPythonpip install qorechain-sdk (Import qorsdk)Veröffentlicht (PyPI, v0.14.0)
qorechain-sdk (Go-Modul)Gogo get github.com/qorechain/qorechain-sdk/packages/go/...Veröffentlicht (Go-Proxy, Tag packages/go/v0.14.0)
qorechain-sdkRustcargo add qorechain-sdk (Import qorechain)Veröffentlicht (crates.io, v0.14.0)
io.github.qorechain:qorechain-sdkJavaio.github.qorechain:qorechain-sdk:0.14.0Veröffentlicht (Maven Central, v0.14.0; JDK 17+)
@qorechain/evmTypeScript (EVM-Adapter)npm i @qorechain/evm viemVeröffentlicht (npm, v0.14.0)
@qorechain/svmTypeScript (SVM-Adapter)npm i @qorechain/svm @solana/web3.jsVeröffentlicht (npm, v0.14.0)
@qorechain/reactTypeScript (React-Kit)npm i @qorechain/reactVeröffentlicht (npm, v0.14.0)
create-qorechain-dappCLInpm create qorechain-dappVeröffentlicht (npm, v0.14.0)

Die Python-Distribution wird als qorechain-sdk installiert, aber als qorsdk importiert. Alle Clients sind in ihren Registries veröffentlicht — die Befehle pro Sprache finden Sie unter Installation.

Der TypeScript-Kern (@qorechain/sdk) ist die Grundlage für die Beispiele in dieser Dokumentation. Die Python-, Go-, Rust- und Java-Clients erreichen vollständige Native-Chain-Parität mit TypeScript: Netzwerk-Presets, Denom-/Adress-Utilities, HD-Kontoableitung (Native/EVM/SVM), PQC-Signierung (ML-DSA-87), typisierte Message-Composer für jedes Custom-Modul sowie die Standard-Cosmos-Module, typisierte Query-Clients, den kompletten Transaktionslebenszyklus (Auto-Gas, Fehlerdecodierung, Tx-Tracking, Block-/Tx-Suche), hybride Post-Quanten-Transaktionen und WebSocket-Subscriptions. Alle diese Clients sind veröffentlicht: TypeScript auf npm (@qorechain/sdk 0.14.0), Python auf PyPI (qorechain-sdk 0.14.0, Import qorsdk), Go auf dem Modul-Proxy (Tag packages/go/v0.14.0), Rust auf crates.io (qorechain-sdk 0.14.0) und Java auf Maven Central (io.github.qorechain:qorechain-sdk 0.14.0). Die EVM-/SVM-Ausführungsadapter (@qorechain/evm, @qorechain/svm, beide 0.14.0), das @qorechain/react-Kit (0.14.0) und die create-qorechain-dapp-Scaffolding-CLI (0.14.0, die auch die Vorlagen-Korrekturen von 0.13.1 enthält) sind reine TypeScript-Pakete und ebenfalls auf npm veröffentlicht. Die Begleitpakete finden Sie unter Installation.

Neu in 0.6 bis 0.14​

0.6.0 — vereinheitlichte eth-native Konten (Chain v3.1.83). Ein eth_secp256k1-Schlüssel ist eine 20-Byte-Identität, dargestellt in allen drei Adresskodierungen, mit einem gemeinsamen ausgabefähigen Guthaben auf jeder Lane:

import { deriveUnifiedAccount } from "@qorechain/sdk";

const account = await deriveUnifiedAccount(mnemonic);
account.cosmos; // "qor1…" (bech32, Native lane)
account.evm; // "0x…" (EIP-55, EVM lane)
account.svm; // base58 (20 bytes + 12 zero bytes)

Native-Lane-Signierung mit demselben Schlüssel erfolgt über signClassicalEth / signHybridEth, und ein Phantom- oder MetaMask-Schlüssel wird als Authenticator mit dem Konto verknüpft (die Ableitung aus einer Phantom-Signatur wurde in 0.8.0 entfernt). Das Legacy-deriveNativeAccount mit Coin-Type 118 bleibt unverändert. Siehe Vereinheitlichte Konten.

0.6.1 — konsenskritischer Fix. Die PQCHybridSignature-Tx-Body-Extension wird jetzt protobuf-kodiert (zuvor war sie JSON-kodiert und wurde bei CheckTx abgelehnt). Hybride Transaktionen, die mit SDK ≤ 0.6.0 gebaut wurden, werden on-chain abgelehnt — bitte upgraden.

0.7.0 — Authenticator-Lanes (Chain v3.1.85). Das dahinterliegende abstractaccount-Modul ist derzeit im Mainnet abgeschaltet und im Testnet aktiviert (siehe den Authenticators-Guide). Ein verknüpfter Phantom- (ed25519) oder MetaMask-Schlüssel (secp256k1, über die 20-Byte-Adresse) kann über einen Relayer vom kanonischen PQC-pflichtigen Konto ausgeben — nach dem Least-Privilege-Prinzip, mit Ausgabenlimits und widerrufbar: Composer für MsgExecuteEVM / MsgExecuteCosmos / MsgRotatePQCKey, byte-exakte Helfer evmAuthSignBytes / cosmosAuthSignBytes / rotationSignBytes, die permissionSchema-Query, decodierte Fehlercodes und TypeScript-Wallet-Builder (buildPhantomExecuteCosmos, buildMetaMaskExecuteEvm, …). Vollständiger Walkthrough mit kopierbaren Beispielen: Authenticators & delegiertes Ausgeben.

0.8.0 – 0.8.3 — v2-Hybrid-Sign-Bytes und das EVM-Autorisierungsfenster (Chain v3.2.0). Die Post-Quanten-Hälfte einer hybriden Transaktion wird jetzt in der Form signiert, die das Zielnetzwerk verifiziert (v1 oder v2, signBytesVersion: "auto" | "v1" | "v2"). Beide öffentlichen Netzwerke laufen auf v2, daher ist SDK 0.8.1 oder neuer erforderlich, um im Mainnet Transaktionen zu senden (verwenden Sie das aktuelle Release). 0.8.2 ergänzt openEvmWindowMsg, closeEvmWindowMsg, fetchEvmWindow und classifyEvmWindowRejection für das EVM-Lane- Autorisierungsfenster. 0.8.0 hat die Wallet-Signatur-Kontohelfer entfernt (connectPhantomUnified und unifiedAccountFromPhantomSignature, in 0.8.0 entfernt), wendet in jeder Sprache strikte ML-DSA-87-Größenprüfungen an und ergänzt das async-Flag sowie zurückgegebene Callee-Daten bei Cross-VM-Aufrufen. 0.8.3 behebt die Tx-Suche, Race Conditions in React-Hooks, die Sequenzierung von Python-migrate_to_hybrid und die adressformunabhängige kanonische PQC-Ableitung (derivePqcCanonical, canonicalAccount). Siehe Upgrade-Hinweise.

0.9.0 — Client-Unterstützung für Chain v3.2.2 und v3.2.3. Der TypeScript-TxClient signiert hybrid, wenn Sie das Schlüsselpaar des Kontos übergeben (client.connectTx(signer, { pqcKeypair })), sodass bankSend und die Rollup-, Multilayer- und Cross-VM-Clients des SDK auf den öffentlichen Netzwerken funktionieren. ensurePqcRegistered prüft zuerst den registrierten Schlüssel über REST, verweigert die Registrierung eines zweiten, anderen Schlüssels und hängt den Besitznachweis selbst an, sobald das Netzwerk v3.2.3 angewendet hat. Neue Builder decken EVM-Fenster mit Gültigkeitsbereich (nativeOnly, allowedTargets) und die EIP-7702-Einwilligungsnachrichten ab, und derivePqcCanonical(address, mnemonic) liefert in jeder Sprache einen Schlüssel, den Sie aus der Mnemonic wiederherstellen können. Die PQC-Konto-Route ist die Singular-Route /qorechain/pqc/v1/account/{address}, Fehlschläge innerhalb eines Blocks behalten ihren Codespace, und create-qorechain-dapp erzeugt Projekte auf dem aktuellen SDK. Siehe Was 0.9.0 neu brachte.

0.10.0 — Client-Unterstützung für Chain v3.2.4. Composer und Lesezugriffe für Staking-Stufen (lockDelegation, unlockEarly, claimBonus, fetchStakingTierParams, fetchStakingLocks), fetchAuthNonce für die nächste Sequenz eines verknüpften Schlüssels, fetchProtocolFeatures / isProtocolFeatureEnabled für die Konsensregeln, die ein Netzwerk namentlich durchsetzt, possessionProven im PQC-Status und ibcTimeoutTimestamp. ensurePqcRegistered vergleicht jetzt den registrierten Schlüssel, statt einem Status ohne einen solchen zu vertrauen, und eine Ablehnung durch die Chain, die während der Gebührensimulation als Text eintrifft, wird in jeder Sprache benannt. Siehe Was 0.10.0 hinzugefügt hat.

0.12.0, Client-Unterstützung für Chain v3.2.5. Die Presets mainnet und testnet verwenden jetzt standardmäßig die öffentlichen Endpoints (ein Preset localnet, Chain-ID qorechain-devnet, behält die alten localhost-Ports). Die "auto"-Gebühr einer Hybrid-Transaktion nutzt auf Netzwerken, die v3.2.5 angewendet haben, die exakte Gas-Regel (ceil(simulated x 1.02) + 2000, etwa 171.600 Gas für eine hybride Bank-Überweisung statt etwa 289.000). Das ML-KEM-1024-Schlüsselregister hat Composer (msg.pqc.registerKemKey, msg.pqc.removeKemKey) und einen Lesezugriff (fetchKemKey), der auf dem Mainnet antwortet. Es gibt Lesezugriffe für die Spending-Regeln und verknüpften Schlüssel von Abstract Accounts sowie geprüfte Builder für die CrossVM- und Rollup-Parametervorschläge. Das Chain Developer Kit (EVM- und QoreChain-Native-Vorlagen, viem-Chains für beide Netzwerke) ist Teil davon. Außerhalb von npm gab es kein 0.11.0; die anderen Sprachen gingen von 0.10.0 auf 0.12.0. Siehe Was 0.12.0 neu bringt.

0.13.0, eine Änderung am Konto-Helfer des Seed-Pfads. unifiedAccountFromSeed und seine Gegenstücke in den anderen Sprachen brauchen nun einen QRC1-Wiederherstellungscode oder ein unabhängiges 32-Byte-PQC-Geheimnis; Konten aus einer Mnemonic, das Signaturformat und das Chain-Verhalten sind unverändert. Helfer für Wiederherstellungscodes wurden in jeder Sprache ergänzt, und migrateToHybrid meldet keyVerified. Siehe Was 0.13.0 ändert.

0.14.0, Client-Unterstützung für Chain v3.2.8. Das Verknüpfen eines Schlüssels braucht einen Besitznachweis, Schlüssel, die Werte bewegen, brauchen eine Ausgabenregel (ein Helfer baut das Paar), Aktualisierungen der Governance-Parameter brauchen jedes Feld, fehlgeschlagene autorisierte Ausführungen lassen sich lesen, und das EVM-Fenster nimmt drei weitere Listen entgegen. Die neuen Regeln gelten, sobald ein Netzwerk v3.2.8 betreibt: das Testnet seit dem 12. November 2026; das Mainnet hat sie nicht angewendet. Siehe Was 0.14.0 ändert.

Nächste Schritte​