Zum Hauptinhalt springen

Installation

Installieren Sie das SDK für Ihre Sprache. Der TypeScript-Kern (@qorechain/sdk), die EVM- und SVM-Adapter (@qorechain/evm, @qorechain/svm), das React-Kit (@qorechain/react) sowie die Clients für Python, Go, Rust und Java sind allesamt in ihren jeweiligen Registries veröffentlicht und bieten vollständige Parität mit der nativen Chain (typisierte Nachrichten, Abfragen, der Tx-Lebenszyklus, hybride PQC-Transaktionen sowie WebSocket-Abonnements). Die aktuelle Release ist 0.14.0, veröffentlicht am 12. November 2026 (am 12. November 2026 gegen die Registries geprüft):

RegistryPaketVersion
npm@qorechain/sdk, @qorechain/react, @qorechain/evm, @qorechain/svm, create-qorechain-dapp0.14.0 (auch create-qorechain-dapp; es enthält zudem die Vorlagen-Korrekturen von 0.13.1)
PyPIqorechain-sdk (Import qorsdk)0.14.0
crates.ioqorechain-sdk (Import qorechain)0.14.0
Go-Modul-Proxygithub.com/qorechain/qorechain-sdk/packages/gov0.14.0
Maven Centralio.github.qorechain:qorechain-sdk0.14.0 (JDK 17 oder neuer)

Für Python, Rust, Go und Java gibt es kein 0.11.0: Die npm-Pakete hatten am 29. Oktober 2026 ein 0.11.0 (das Chain Developer Kit, siehe unten), und jede Sprache wechselte gemeinsam von 0.10.0 auf 0.12.0. 0.13.0 folgte am 11. November 2026 und 0.14.0 am 12. November 2026 in jeder Sprache.

Wählen Sie unten Ihre Sprache.

Upgrade-Hinweise​

Verwenden Sie auf den Live-Netzwerken SDK 0.8.1 oder neuer

Beide öffentlichen Netzwerke verifizieren die Form der hybriden v2-Sign-Bytes (domänengetaggt und an die Chain-ID gebunden) und lehnen die alte Form mit pqc-Code 21 ab. Jedes SDK-Release vor 0.8.0 signiert die alte Form, und 0.8.0 sucht die Umstellung nur unter einem der beiden Upgrade-Namen, die die Netzwerke verwendet haben (das Mainnet hat sie als v3.2.0 verzeichnet, das Testnet als v3.1.98 und später v3.2.0), und signiert daher auf dem Mainnet die falsche Form. Verwenden Sie in jeder Sprache 0.14.0 (oder mindestens 0.8.1); 0.8.2 oder neuer wird benötigt, um ein EVM-Autorisierungsfenster zu öffnen. Hybride Builder akzeptieren die Option signBytesVersion ("auto" | "v1" | "v2"); "auto" fragt das Netzwerk ab und benötigt daher den REST-Endpunkt (rest) auf qorechain-vladi / qorechain-diana: Es wirft einen Fehler, statt zu raten. Siehe Welche Sign-Bytes-Form?. Die Form hat sich in Chain v3.2.3 oder v3.2.4 (v3.2.4 läuft im Testnet seit dem 19. Oktober 2026 und im Mainnet seit dem 23. Oktober 2026; v3.2.5 und v3.2.6 haben hier nichts geändert; das Mainnet läuft seit dem 12. November 2026 mit v3.2.7) nicht geändert: "auto" wird auf beiden Netzwerken zu v2 aufgelöst, weil beide das Upgrade angewendet haben, das darauf umgestellt hat.

Was 0.14.0 ändert​

SDK 0.14.0 (12. November 2026) ist ein Release für alle Sprachen: TypeScript, Python, Go, Rust und Java, mit @qorechain/react, @qorechain/evm, @qorechain/svm und create-qorechain-dapp (das auch die Vorlagen-Korrekturen von 0.13.1 enthält). Es bringt Client-Unterstützung für Chain v3.2.8. Die neuen Regeln gelten in einem Netzwerk, sobald es v3.2.8 betreibt: Das Testnet qorechain-diana läuft seit dem 12. November 2026 mit ihr; das Mainnet hat sie nicht angewendet. In früheren Netzwerken bleiben die neuen Felder optional.

BereichIn 0.14.0
Einen Schlüssel verknüpfenBraucht einen Besitznachweis. Builder und Signierer für ed25519, secp256k1 und EIP-191 (personal_sign) signieren eine Klartext-Verknüpfungsnachricht, die die Chain, das Konto, das Schema und den Schlüssel nennt. Die Register-Composer lehnen einen leeren Nachweis ab
Schlüssel, die Werte bewegenEin Schlüssel mit send, evm, deploy, svm oder all braucht eine erste aktivierte Ausgabenregel des Kontos, die jede Denom begrenzt. Ein Helfer baut die Aktualisierung der Ausgabenregel und die Verknüpfung als Paar in einer vom Eigentümer signierten Transaktion und prüft die Regel
Governance-ParameterDie MsgUpdateParams-Composer für crossvm, svm und rdk brauchen jedes Feld (die Chain ersetzt Parameter vollständig). Neue Helfer bauen die Aktualisierung aus den aktuellen Parametern, die aus dem Netzwerk gelesen werden. Der svm-Composer lehnt enabled ab, solange die harte Verwahrungsobergrenze 0 ist
Cross-VM-Abfrage ausstehender AufrufeDie seitenweise Abfrage gibt jetzt jede Seite zurück
AusführungsergebnisseMsgExecuteEVM und MsgExecuteCosmos können mit success=false innerhalb einer Transaktion mit Code 0 fehlschlagen (die Nonce wird verbraucht). Neue Helfer dekodieren die Antworten und den Fehlergrund und werfen bei einer fehlgeschlagenen Ausführung einen Fehler
Asynchrone Cross-VM-AufrufeNehmen async_gas_limit und async_max_factor entgegen
Umfang des EVM-FenstersNeue Felder validators, staking_validators und ibc_receivers
GasEVM-Transaktionen über 30.000.000 (aus evm_limits gelesen) und Cosmos-Transaktionen über 50.000.000 werden vor dem Signieren abgelehnt. CosmWasm- und Cross-VM-Transaktionen erhalten mindestens das 1,3-Fache des simulierten Gas und nie einen festen Ersatzwert
Minimaler GaspreisOpt-in-Helfer lesen den minimalen Gaspreis des Netzwerks; der Standard-Gaspreis bleibt unverändert
ProtosDer generierte Code in allen fünf Sprachen folgt v3.2.8

Die Wallet-Seite derselben Änderung steht unter @qorechain/wallet-adapter 0.6.0.

Was 0.13.0 ändert​

SDK 0.13.0 (11. November 2026) ist ein Release für alle Sprachen: TypeScript, Python, Go, Rust und Java, mit @qorechain/react, @qorechain/evm, @qorechain/svm und create-qorechain-dapp. Es hat eine inkompatible Änderung, am Konto-Helfer des Seed-Pfads. Konten, die aus einer Mnemonic abgeleitet werden, sind unverändert, ebenso das hybride Signaturformat und das Chain-Verhalten: Eine mit 0.12.0 erstellte Transaktion bleibt gültig.

Inkompatible Änderung. Die Seed-Pfad-Helfer unifiedAccountFromSeed (TypeScript), unified_account_from_seed (Python, Rust), unified.UnifiedAccountFromSeed (Go) und UnifiedAccounts.unifiedAccountFromSeed (Java) brauchen nun genau eine von zwei Eingaben: einen QRC1-Wiederherstellungscode oder ein unabhängiges 32-Byte-PQC-Geheimnis. Der ML-DSA-87-Schlüssel wird aus diesem zweiten Geheimnis abgeleitet. Ruft man den Helfer ohne Option oder mit mehr als einer auf, löst er einen Fehler aus.

Die Option legacySeedDerivation (Python legacy_seed_derivation=True, Go LegacySeedDerivation, Rust SeedPqcOptions::legacy_seed_derivation(), Java SeedPqcOptions.legacy()) ist optional zuzuschalten. Verwenden Sie sie nur, um den PQC-Schlüssel eines vor 0.13.0 erstellten Kontos wiederherzustellen, damit Sie ihn mit MsgRotatePQCKey rotieren können; sie ist nicht für neue Konten gedacht.

BereichIn 0.13.0
Seed-Pfad-HelferBrauchen einen QRC1-Wiederherstellungscode oder ein unabhängiges 32-Byte-PQC-Geheimnis (genau eines); ohne Option oder mit mehr als einer wird ein Fehler ausgelöst. Mnemonic-Konten sind unverändert
legacySeedDerivationOptional zuzuschalten, nur um den PQC-Schlüssel eines vor 0.13.0 erstellten Kontos wiederherzustellen, damit er mit MsgRotatePQCKey rotiert werden kann
QRC1-WiederherstellungscodesIn jeder Sprache ergänzt: generatePqcRecoveryCode, isValidRecoveryCode, normalizeRecoveryCode, pqcKeyFromRecoveryCode, pqcRecoveryCodeFromSecret (snake_case in Python und Rust; in Go GeneratePQCRecoveryCode, IsValidRecoveryCode, PQCKeyFromRecoveryCode, PQCRecoveryCodeFromSecret)
migrateToHybridMeldet keyVerified
Vorlagenpnpm window recovery-code gibt einen neuen Code aus. Mit PRIVATE_KEY liest pnpm window QORE_PQC_RECOVERY_CODE und bricht mit einer Meldung ab, wenn er fehlt; mit QORE_MNEMONIC ändert sich nichts. Die Vorlagen Foundry und Hardhat hängen von ^0.13.0 ab
Sign-Bytes-Version "auto"Liest zuerst die Protokollfunktion pqc-sign-bytes-v2 aus /qorechain/pqc/v1/protocol_features und greift nur auf die angewendeten Upgrade-Pläne zurück, wenn dieser Lesezugriff fehlschlägt
getPqcStatus / get_pqc_statusLösen einen Fehler aus, wenn die Antwort des Nodes kein Registrierungsflag enthält, statt "nicht registriert" zu melden
PythonParst Transaktions-Ergebniscodes und die EVM-Fenster-Felder found und live strikt; wait_for_tx behandelt eine Antwort ohne tx_response oder txhash weiterhin als ausstehend

Seed-Pfad-Optionen in jeder Sprache. Übergeben Sie genau eine der drei:

SpracheAufrufWiederherstellungscodeUnabhängiges 32-Byte-GeheimnisÄlterer Schlüssel, nur Wiederherstellung
TypeScriptunifiedAccountFromSeed(seed32, opts){ recoveryCode } (ein "QRC1-..."-String){ pqcSecret } (ein Uint8Array mit 32 Bytes, unabhängig von seed32){ legacySeedDerivation: true }
Pythonunified_account_from_seed(seed32, ...)recovery_code=...pqc_secret=...legacy_seed_derivation=True
Gounified.UnifiedAccountFromSeed(seed32, opts)unified.SeedPQCOptions{RecoveryCode: ...}unified.SeedPQCOptions{PQCSecret: ...}unified.SeedPQCOptions{LegacySeedDerivation: true}
Rustunified_account_from_seed(seed32, opts)SeedPqcOptions::recovery_code(code)SeedPqcOptions::pqc_secret(secret32)SeedPqcOptions::legacy_seed_derivation()
JavaUnifiedAccounts.unifiedAccountFromSeed(seed32, opts)SeedPqcOptions.withRecoveryCode(code)SeedPqcOptions.withPqcSecret(secret32)SeedPqcOptions.legacy()

Die Python-Optionen sind nur als Schlüsselwortargumente verwendbar. Ein pqcSecret ergibt denselben Schlüssel wie der daraus mit pqcRecoveryCodeFromSecret(secret32) erzeugte Wiederherstellungscode. TypeScript bietet zusätzlich pqcKeyFromRecoveryCode(code, qor1).

Migration (TypeScript). Erzeugen Sie einmal einen Wiederherstellungscode und bewahren Sie ihn getrennt vom Seed auf:

import { generatePqcRecoveryCode, unifiedAccountFromSeed } from "@qorechain/sdk";

const recoveryCode = generatePqcRecoveryCode(); // once; store it apart from the seed
const account = unifiedAccountFromSeed(seed32, { recoveryCode });

Ein Konto, das seinen PQC-Schlüssel mit 0.12 oder früher registriert hat, lädt den alten Schlüssel mit { legacySeedDerivation: true } und rotiert ihn mit rotatePqcKeyMsg:

const old = unifiedAccountFromSeed(seed32, { legacySeedDerivation: true });
// rotate it with rotatePqcKeyMsg, then use { recoveryCode } from then on

Bewahren Sie den Wiederherstellungscode auf: Ein anderer Code ergibt einen anderen Schlüssel.

Was 0.12.0 neu bringt​

SDK 0.12.0 ist das Client-Release für die Chain v3.2.5, die das Mainnet bei Höhe 3.906.833 am 29. Oktober 2026 angewendet hat (das Testnet hat sie am 26. Oktober angewendet). Das Mainnet läuft seit dem 4. November mit v3.2.6 und seit dem 12. November mit v3.2.7; das Testnet lief ab dem 27. Oktober mit v3.2.6, vom 6. bis 12. November mit v3.2.7 und läuft seit dem 12. November mit v3.2.8; das hybride Signaturformat, Adressen, Dezimalstellen und Memos haben sich nicht geändert, sodass eine mit 0.10.0 erstellte Transaktion gültig bleibt. TypeScript, Python, Go, Rust und Java wechseln alle auf 0.12.0, ebenso @qorechain/react, @qorechain/evm, @qorechain/svm und create-qorechain-dapp. Das Release wurde in jeder Sprache mit einer hybriden Bank-Überweisung auf dem Testnet geprüft sowie mit einem KEM-Schlüssel, der dort registriert, zurückgelesen und entfernt wurde, dazu Lesezugriffe auf dem Mainnet.

BereichIn 0.12.0
Öffentliche Endpoints als StandardDie Presets mainnet und testnet zeigen jetzt auf die öffentlichen Endpoints (REST, Konsens-RPC und EVM-JSON-RPC auf beiden, dazu der EVM-WebSocket auf dem Testnet) statt auf localhost. Ein bloßes createClient() spricht daher mit dem öffentlichen Testnet. Siehe Netzwerk & Endpoints
Preset localnetDie localhost-Ports, die jedes Preset vor 0.12.0 verwendete, Chain-ID qorechain-devnet. Wählen Sie es mit createClient({ network: "localnet" }), um das bisherige Verhalten beizubehalten
Exaktes Gas für Hybrid-TransaktionenAuf einem Netzwerk, das v3.2.5 angewendet hat, ist die "auto"-Gebühr einer hybriden nativen Transaktion ceil(simulated x 1.02) + 2000, weil die Simulation jetzt die Post-Quanten-Verifikation selbst berechnet. Eine hybride Bank-Überweisung fordert etwa 171.600 Gas statt etwa 289.000, und die Gebühr sinkt entsprechend. Ältere Netzwerke, klassische Transaktionen und eine fehlgeschlagene Plan-Abfrage behalten die frühere Regel; ein von Ihnen übergebener Multiplikator ersetzt beide Regeln. exactHybridGas (und seine Entsprechungen in jeder Sprache) und, in TypeScript, estimateGasDetails (meldet die Simulation, das Gas-Limit und welche Regel es festgelegt hat). Java erhielt den Auto-Gas-Pfad
ML-KEM-1024-SchlüsselregisterEin Konto veröffentlicht einen ML-KEM-1024-Encapsulation-Schlüssel (Algorithmus 2, 1.568 Bytes), sodass jeder an ihn verschlüsseln kann: msg.pqc.registerKemKey und msg.pqc.removeKemKey (der Schlüssel wird zuerst geprüft: Größe, jeder Koeffizient unter 3329, nicht komplett null), validateKemPublicKey und der Lesezugriff fetchKemKey auf /qorechain/pqc/v1/kem/{address} (bech32 oder 0x). Beide Nachrichten brauchen die hybride Signatur. Die Route antwortet auf dem Mainnet und dem Testnet. Das SDK verschlüsselt nicht: für versiegelte Nutzlasten siehe QoreSeal
Abstract AccountsLesezugriffe auf die gespeicherten Spending-Regeln eines Kontos und auf seine verknüpften Schlüssel (widerrufene eingeschlossen), MsgUpdateConfig (die Governance-Nachricht, die das Modul schaltet) und authenticators_count in der Kontoansicht
Prüfungen der Spending-RegelnRegeln werden so geprüft, wie die Chain sie prüft: ein Denom erc20/, erc721/ oder erc1155/ muss eine 0x-Contract-Adresse nennen. Die abstractaccount-Codes 8 (ungültige Spending-Regel) und 9 (Modul deaktiviert) werden benannt
Governance-ParameterDas CrossVM-MsgUpdateParams (einschließlich der CosmWasm-Contracts, die der Bridge-Precompile der EVM aufrufen darf) und das Rollup-MsgUpdateParams, jeweils vor dem Signieren gegen die Grenzen der Chain geprüft. Der Lesezugriff auf die CrossVM-Parameter enthält bridge_allowed_targets
Upgrade-Konstante und ProtosCHAIN_UPGRADE_V3_2_5; Protobuf-Definitionen, synchronisiert mit Chain v3.2.5
Chain Developer KitAus dem nur auf npm veröffentlichten 0.11.0 und in 0.12.0 enthalten: @qorechain/evm exportiert die viem-Chains qorechain (9801) und qorechainTestnet (9800) sowie die Helfer für das EVM-Autorisierungsfenster (evmWindowStatus, openEvmWindowMessage, auch als @qorechain/evm/window ohne viem). create-qorechain-dapp hat die Vorlagen foundry, hardhat, viem-wagmi und cosmwasm. @qorechain/react hat PqcStatusBadge (die alten QuantumSafeBadge-Namen bleiben als veraltete Aliase erhalten)
Korrekturen@qorechain/svm mit Endpoints ohne svmRpc verwendete localhost; jetzt meldet es, dass der Endpoint nicht konfiguriert ist. Die Python-Codegenerierung verweist Importe zwischen QoreChain-Protos in das Paket

Verhaltensänderung, die Sie beim Upgrade prüfen sollten. Wenn Ihr Code sich auf den localhost-Standard verlassen hat, wählen Sie localnet oder übergeben Sie endpoints. Die öffentlichen Testnet-Endpoints sind pro IP ratenbegrenzt, Produktionsverkehr sollte also einen eigenen Node betreiben oder verwenden. Kein Preset setzt auf den öffentlichen Netzwerken einen gRPC- oder einen SVM-Endpoint (SVM-Transaktionen sind nicht offen), und das Mainnet hat keinen öffentlichen EVM-WebSocket: Code, der einen davon braucht, schlägt mit einem Fehler fehl, der den zu übergebenden Endpoint nennt, statt auf localhost zurückzufallen. In Rust sind die optionalen Endpoints jetzt Option<String>; in Python, Go und Java ist ein nicht gesetzter Endpoint None, ein leerer String bzw. null.

Nodes melden ihre Binärversion nicht. Um ein Feature zu erkennen, fragen Sie isUpgradeApplied für jeden Upgrade-Namen ab, der es mitbringt, oder lesen Sie .version aus https://download.qore.host/<net>/latest.json.

Was 0.10.0 hinzugefügt hat​

SDK 0.10.0 war das Client-Release für die Chain v3.2.4, die das Mainnet am 23. Oktober 2026 bei Höhe 3.742.566 angewendet hat (das Testnet hat sie am 19. Oktober bei Höhe 8.337.253 angewendet). Signaturformat, Adressen, Dezimalstellen, Memos und Gebühren haben sich nicht geändert, und eine mit 0.9.0 erstellte Transaktion bleibt gültig. Das Release wurde in jeder Sprache mit echten Transaktionen auf dem Testnet geprüft. Es hatte keine Builder für alles, was nach v3.2.4 eingeführt wurde; die Ergänzungen von v3.2.5 kamen mit 0.12.0. Das Mainnet läuft seit dem 12. November 2026 mit v3.2.7 (Höhe 4.164.600, Governance-Vorschlag 16; v3.2.6 ab dem 4. November bei Höhe 4.020.000; davor v3.2.5, ab dem 29. Oktober bei Höhe 3.906.833), und 0.10.0 funktioniert dort weiter, weil sich das Signaturformat nicht geändert hat. Das Testnet hat v3.2.5 und v3.2.6 am 26. und 27. Oktober 2026, v3.2.7 am 6. November und v3.2.8 am 12. November angewendet (kein SDK-Release hat Builder für die Nachrichten von v3.2.7, die seit dem 12. November 2026 im Mainnet sind). Was 0.10.0 brachte (alles davon ist weiterhin in 0.14.0 enthalten):

BereichIn 0.10.0
Staking-Stufen (x/stakingtier)Composer lockDelegation (die eigenen Prüfungen der Chain: eine Laufzeit von 3, 6 oder 12 Monaten und ein positiver ganzzahliger Betrag), unlockEarly, claimBonus und updateParams; Lesezugriffe auf die Modulparameter, die Sperren eines Halters und den Bonus-Pool (fetchStakingTierParams, fetchStakingLocks, fetchStakingTierPool); die Fehlercodes des Moduls. Was das Modul tut, steht in Staking und Delegation
Authenticator-NoncefetchAuthNonce({ rest, address, pubkey }) liest die Sequenz, die ein verknüpfter Schlüssel als Nächstes für MsgExecuteEVM / MsgExecuteCosmos signieren muss, von /qorechain/abstractaccount/v1/auth_nonce/{address}/{pubkey_hex}, statt sie von Hand mitzuführen. Beide Netzwerke stellen die Route bereit; das Modul abstractaccount selbst ist im Mainnet abgeschaltet (im Testnet aktiviert), sodass eine Mainnet-Ausgabe abgelehnt wird, bevor eine Nonce geprüft wird
Schalter für Protokoll-FeaturesfetchProtocolFeatures und isProtocolFeatureEnabled lesen unter /qorechain/pqc/v1/protocol_features (beide Netzwerke stellen sie bereit), welche Konsensregeln ein Netzwerk durchsetzt, nach Namen. Ein Netzwerk unterhalb von v3.2.4 stellt die Route nicht bereit; verwenden Sie dort isUpgradeApplied
possessionProvenDer PQC-Status gibt an, ob der Schlüssel des Kontos mit einem Besitznachweis registriert wurde
ibcTimeoutTimestamp(seconds)Ein absolutes IBC-Timeout in der Einheit, die MsgTransfer verwendet (Unix-Nanosekunden). IBC-Timeouts sind absolute Zeiten; IBC-v2-Pakete nehmen absolute Unix-Sekunden, und ein relativer Wert dort wird abgelehnt, nachdem die Gebühr berechnet wurde. Im Mainnet ist kein IBC-Kanal geöffnet (geprüft am 27. Oktober 2026)
Upgrade-Konstante und ProtosCHAIN_UPGRADE_V3_2_4; Protobuf-Definitionen, synchronisiert mit Chain v3.2.4 (neue Felder bei der Bridge-Validator-Registrierung sowie bei den Light-Node- und Rollup-Abfragen)
ensurePqcRegisteredEs verglich einen Status ohne öffentlichen Schlüssel als Übereinstimmung; jetzt liest es den Schlüssel über rest und vergleicht ihn. Wenn es nichts zum Lesen gibt, meldet das Ergebnis keyVerified: false, statt zu behaupten, der Schlüssel gehöre dem Aufrufer
Ablehnungen bei der GebührensimulationEine Ablehnung der Chain, die nur als Text eintrifft (zum Beispiel „no bonus to claim“), wird jetzt in jeder Sprache anhand der registrierten Fehlerbeschreibungen der Chain benannt: decodeTxError (TypeScript), SimulationRefusedError (Python), tx.DecodeRefusalText (Go), tx::decode_refusal_text (Rust), TxError.decode (Java)

@qorechain/react und create-qorechain-dapp sind damit auf 0.10.0 gewechselt; beide sind jetzt bei 0.14.0.

Was 0.9.0 brachte​

SDK 0.9.0 war das Client-Release für die Chain-Versionen v3.2.2 und v3.2.3 (das Mainnet hat sie bei den Höhen 3,556,788 und 3,662,051 angewendet; das Mainnet lief seit dem 23. Oktober 2026 (Höhe 3.742.566) mit v3.2.4 und lief ab dem 29. Oktober mit v3.2.5, läuft seit dem 4. November mit v3.2.6 und seit dem 12. November 2026 mit v3.2.7, und das Testnet läuft seit dem 19. Oktober 2026 mit v3.2.4 oder neuer). Signaturformat, Adressen, Dezimalstellen, Memos und Gebühren haben sich nicht geändert, sodass die hybride v2-Sign-Bytes-Form, die 0.8.1 und neuer signieren, weiterhin die richtige ist. Neu ist Folgendes:

BereichIn 0.9.0 (und später)
Hybrider TxClient (TypeScript)Übergeben Sie das Schlüsselpaar des Kontos: client.connectTx(signer, { pqcKeypair }) oder TxClient.connect({ …, pqcKeypair, rest }). Jede Transaktion wird dann hybrid signiert, und fee: "auto" simuliert die hybride Transaktion selbst; eine reine Schlüsselregistrierung bleibt klassisch (der Bootstrap-Pfad der Chain). bankSend sowie die Rollup-, Multilayer- und Cross-VM-Clients des SDK verwenden ihn. Ohne Schlüsselpaar ändert sich nichts
Wiederherstellbarer PQC-SchlüsselderivePqcCanonical(address, mnemonic) und seine Entsprechungen in jeder Sprache (siehe Hybrides Signieren)
ensurePqcRegisteredLiest zuerst den Schlüsselstatus über REST (rest), verweigert die Registrierung, wenn es ihn nicht bestimmen kann, wirft PqcKeyMismatchError, wenn das Konto bereits einen anderen Schlüssel besitzt, und behandelt die Ablehnung „bereits registriert“ der Chain als Erfolg. Ab Chain v3.2.3 signiert und hängt es den Besitznachweis selbst an; vor v3.2.3 lässt es das Feld weg
Eingeschränkte EVM-FensteropenEvmWindowMsg nimmt nativeOnly und allowedTargets entgegen (höchstens 16, keine Duplikate); fetchEvmWindow liest beides zurück (siehe EVM-Leitfaden)
EIP-7702-ZustimmungauthorizeEvmDelegationMsg, clearEvmDelegationMsg, fetchEvmDelegationConsent, evmDelegationTupleNonce, classifyEvmDelegationRejection
SchlüsselintegritätDie Registrierungs-Builder lehnen classical_only, einen leeren Schlüssel und einen degenerierten ML-DSA-87-Schlüssel ab, was die Chain ab v3.2.3 ebenfalls tut. signProofOfPossession / verifyProofOfPossession werden exportiert; migratePqcKeyHybrid sendet die hybrid signierte MsgMigratePQCKey, die Konten mit Schlüssel ab v3.2.3 benötigen
Abstract-Account-Digest v2evmAuthSignBytesV2 (bindet das Gas-Limit des Aufrufs) und resolveEvmAuthDigestVersion. Das Modul abstractaccount ist im Mainnet abgeschaltet (im Testnet aktiviert), dies dient im Mainnet daher nur als Referenz
Upgrade-ErkennungisUpgradeApplied, requireUpgradeApplied: neue optionale Felder werden erst gesetzt, nachdem applied_plan das Release meldet, denn ein Node, der ein Release nicht angewendet hat, lehnt die gesamte Transaktion ab, wenn eines der neuen Felder dieses Releases gesetzt ist
FehlerdekodierungEin Fehlschlag innerhalb eines Blocks behält seinen Codespace (zum Beispiel pqc 231, nicht sdk_231); rate_limited und die Delegationscodes werden dekodiert; decodeTxError liest das Log oder die Nachricht eines geworfenen Fehlers
AusgabenregelnvalidateSpendingRules läuft in den MsgUpdateSpendingRules-Buildern und lehnt eine Regel ab, die nichts begrenzt
KorrekturenDie PQC-Konto-Route ist in jedem SDK die Singular-Route /qorechain/pqc/v1/account/{address} (und in client.rest.getPqcAccount, isPqcRegistered und getPqcStatus, wenn der zusammengesetzte Client übergeben wird); die exportierte VERSION entspricht dem Paket; vom SDK erzeugte Go- und Rust-Clients laufen in ein Timeout, statt zu hängen; die Vorlagen von create-qorechain-dapp hängen von dem Release ab, mit dem sie ausgeliefert werden

Die Legacy-PQC-Ableitung für neue Schlüssel (derivePqcLegacy, "bridge") ist veraltet: Sie ist nicht an das Konto gebunden, sodass eine Mnemonic jedem Konto denselben Schlüssel geben würde. Die Rotations-Helfer lehnen sie als neuen Schlüssel ab; das Wiederherstellen eines bestehenden Legacy-Schlüssels oder das Wegrotieren von ihm funktioniert weiterhin.

Versionen vor 0.9.0​

Wenn Sie 0.8.x einsetzen, signiert es weiterhin die Form, die beide Netzwerke verifizieren, und funktioniert auf dem Mainnet und dem Testnet. Dies sind die Einschränkungen, die 0.9.0 beseitigt hat, und einige davon kosten eine Gebühr, wenn man sie nicht kennt:

Release vor 0.9.0Workaround
Keine Builder für Besitznachweis, eingeschränkte Fenster oder EIP-7702-ZustimmungVerwenden Sie qorechaind tx pqc register-key-v2 … --pqc-key <name>, open-evm-window --native-only / --allowed-targets und authorize-evm-delegation / clear-evm-delegation (siehe EVM-Autorisierungsfenster, EIP-7702-Delegierungen)
ensurePqcRegistered ohne status sendete die Registrierung ungeprüft und meldete Erfolg, wenn ein anderer Schlüssel registriert warEine zweite Registrierung für ein Konto, das bereits einen Schlüssel besitzt, wird abgelehnt, nachdem die Gebühr abgezogen wurde. Lesen Sie zuerst GET /qorechain/pqc/v1/account/{address} und übergeben Sie status: { registered: found }
client.rest.getPqcAccount, isPqcRegistered, getPqcStatusSie riefen einen Pfad im Plural /accounts/ oder den Namensraum qor_ auf, die die öffentlichen Endpunkte nicht bereitstellen (HTTP 501, -32601). Lesen Sie die oben genannte REST-Route im Singular
TxClient / bankSend sowie die Rollup-, Multilayer- und Cross-VM-Clients signierten nur klassischDie Netzwerke lehnen das für jedes Konto mit Schlüssel ab. Senden Sie über signAndBroadcastHybrid
Fehlgeschlagene Transaktionen innerhalb eines Blocks verloren ihren CodespaceLesen Sie die Transaktion über GET /cosmos/tx/v1beta1/txs/{hash}
Die exportierte Konstante VERSION von 0.8.3 meldete 0.8.0Lesen Sie die installierte Version aus package.json
create-qorechain-dapp 0.8.0 pinnte @qorechain/sdk / @qorechain/evm auf ^0.3.0 (ein Caret auf eine 0.x-Version bleibt innerhalb von 0.3)Führen Sie nach dem Scaffolding npm i @qorechain/sdk@latest aus
@qorechain/react 0.8.x ließ den Status des registrierten Schlüssels auf den öffentlichen Endpunkten unlesbarVerwenden Sie @qorechain/react 0.9.0 oder neuer
Ältere Fixes

SDK 0.6.1 behob einen konsenskritischen Bug: Die Tx-Body-Extension /qorechain.pqc.v1.PQCHybridSignature wurde JSON-serialisiert in Any.value geschrieben und von der Chain bei CheckTx abgelehnt. Hybride (PQC + klassische) Transaktionen, die mit SDK ≤ 0.6.0 erstellt wurden, werden on-chain abgelehnt. 0.8.0 hat die Konto-Helfer für Wallet-Signaturen entfernt (siehe Konten & PQC-Signierung).

TypeScript​

Das Kern-Paket:

npm i @qorechain/sdk

Es zielt auf Node.js 20+ und liefert ESM, CommonJS sowie Typdefinitionen. Die Beispiele für hybride Transaktionen in dieser Dokumentation importieren außerdem StargateClient aus @cosmjs/stargate (npm i @cosmjs/stargate).

EVM-Adapter​

@qorechain/evm ist ein schlanker, typsicherer Adapter über viem. viem ist eine Peer-Abhängigkeit — installieren Sie es zusätzlich:

npm i @qorechain/evm viem

Veröffentlicht auf npm unter 0.14.0. Es exportiert die viem-Chains qorechain (Chain-ID 9801) und qorechainTestnet (9800) sowie die Helfer für das EVM-Autorisierungsfenster.

SVM-Adapter​

@qorechain/svm ist ein schlanker Adapter über @solana/web3.js, das eine Peer-Abhängigkeit ist:

npm i @qorechain/svm @solana/web3.js

Veröffentlicht auf npm unter 0.14.0.

React-Kit​

@qorechain/react ist die offizielle React-Schicht über @qorechain/sdk — ein Provider, Hooks sowie die Komponenten ConnectButton / PqcStatusBadge. react (>=18) ist eine Peer-Abhängigkeit:

npm i @qorechain/react

Veröffentlicht auf npm unter 0.14.0; es hängt von @qorechain/sdk ^0.14.0 ab. Siehe den React-Kit-Leitfaden.

Scaffolder​

create-qorechain-dapp (npm, 0.14.0) erzeugt eine sofort lauffähige dApp:

npm create qorechain-dapp@latest my-dapp

Die generierten package.json-Dateien hängen von dem SDK-Release ab, mit dem der Scaffolder ausgeliefert wird (@qorechain/sdk ^0.14.0; die EVM-Vorlagen verwenden @qorechain/evm ^0.14.0). Version 0.13.1 änderte nur die Vorlagen und 0.14.0 enthält diese Korrekturen; siehe Scaffolder und CLI. Es hat außerdem die Vorlagen foundry, hardhat, viem-wagmi und cosmwasm für die Contract-Arbeit. Version 0.8.0 des Scaffolders schrieb Bereiche ^0.3.0, die bei einer 0.x-Version innerhalb von 0.3 bleiben und für die Live-Netzwerke nicht signieren können; wenn Sie mit 0.8.0 ein Scaffolding durchgeführt haben, führen Sie npm i @qorechain/sdk@latest aus. Siehe die CLI-Referenz.

Python​

pip install qorechain-sdk

Erfordert Python 3.10+. Das Paket liefert Type Hints und einen py.typed-Marker.

Die Distribution wird als qorechain-sdk installiert (veröffentlicht auf PyPI unter 0.14.0), wird aber als qorsdk importiert:

import qorsdk

Go​

go get github.com/qorechain/qorechain-sdk/packages/go/...

Erfordert Go 1.23+. Importieren Sie die benötigten Sub-Pakete, zum Beispiel:

import (
"github.com/qorechain/qorechain-sdk/packages/go/qorechain/client"
"github.com/qorechain/qorechain-sdk/packages/go/qorechain/accounts"
)

Veröffentlicht als eigenständiges Go-Modul (getaggt als packages/go/v0.14.0). Pinnen Sie die Version explizit: go get github.com/qorechain/qorechain-sdk/packages/go@v0.14.0.

Rust​

cargo add qorechain-sdk

Oder, um den Repository-Stand (Head) zu verfolgen:

[dependencies]
qorechain-sdk = { git = "https://github.com/qorechain/qorechain-sdk" }
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

Erfordert Rust 1.74+. Die Lese-Clients sind asynchron (Tokio). Die Crate wird als qorechain importiert (use qorechain;).

Veröffentlicht auf crates.io als qorechain-sdk (0.14.0); cargo add qorechain-sdk installiert das neueste Release.

Java​

Maven (pom.xml):

<dependency>
<groupId>io.github.qorechain</groupId>
<artifactId>qorechain-sdk</artifactId>
<version>0.14.0</version>
</dependency>

Oder Gradle:

implementation 'io.github.qorechain:qorechain-sdk:0.14.0'

Veröffentlicht auf Maven Central als io.github.qorechain:qorechain-sdk (0.14.0 ist die aktuelle Version). Es braucht JDK 17 oder neuer. Central hat keinen Build 0.8.0 oder 0.8.1, verwenden Sie daher auf den Live-Netzwerken 0.8.2 oder neuer. 0.9.1 war ein reines Java-Release, das Bouncy Castle von 1.80 auf 1.85 hob, ohne API-Änderung.

PaketZweckVersion
@qorechain/wallet-adapterWallet-seitige Helfer: Wallet-Erzeugung (generateQoreWallet), hybrides Signieren mit eth_secp256k1 (signHybridEth, QoreChainSigner), MetaMask-Netzwerkregistrierung (addQoreEvmToWallet), Message-Builder für Authenticators und EVM-Fenster (sein openEvmWindowMsg baut nur die uneingeschränkte Form), der v2-Abstract-Account-Digest. Er hängt keinen Besitznachweis an. Peer-Abhängigkeiten: @cosmjs/proto-signing und @cosmjs/stargate ^0.32 (das SDK verwendet cosmjs 0.39, daher meldet npm bei der Installation beider in einem Projekt einen Peer-Konflikt, ERESOLVE; halten Sie sie in getrennten Projekten oder übergeben Sie --legacy-peer-deps)0.5.0
@qorechain/chain-bridgeServerseitiger Worker für Backends: leitet den PQC-Schlüssel ab, signiert hybrid und sendet (sendTokens, registerPqc und mehr). Übergeben Sie cosmosRest: Damit trägt eine Registrierung den Besitznachweis, sobald das Netzwerk v3.2.3 angewendet hat, und eine PQC-artige Ablehnung wird vor jeder erneuten Registrierung gegen die Chain geprüft (ein anderer registrierter Schlüssel löst pqc_key_mismatch aus, statt eine zweite Registrierung zu bezahlen)0.2.3
@qorechain/pqcRein standardbasierte Primitive für ML-DSA / ML-KEM / SHAKE-256 sowie hybridSignBytes (siehe Post-Quantum Signing); auch auf PyPI, crates.io, Maven Central und dem Go-Proxy (Go v0.2.3) in derselben Version0.2.3
@qorechain/handlesVerifizierte @handle-Auflösung (HandleClient): Sie liefern den öffentlichen Schlüssel der Registry und einen Pin-Speicher, und Sie pinnen, nachdem der Nutzer die Adresse gesehen hat; das Paket pinnt nie von selbst. Siehe Chain Bridge und Handles0.1.0
@qorechain/connectAuf npm als veraltet markiert und nicht mehr gepflegt; verwenden Sie es nicht für neue Arbeiten. Verwenden Sie stattdessen @qorechain/wallet-adapter (Ersatz für die QoreX-Verbindung steht in der Übersicht der Entwickler-Tools). Ein einziger Connector für EVM-, Cosmos- und SVM-Wallets, aufgebaut auf dem Wallet-Adapter (sein Peer-Bereich ist @qorechain/wallet-adapter ^0.2.1, der 0.5.0 nicht einschließt). Er öffnet kein EVM-Autorisierungsfenster, sodass ein EVM-Versand darüber abgelehnt wird, bis das Konto einen registrierten Schlüssel und ein offenes Fenster hat0.2.1
@qorechain/rdkClient des Rollup Development Kit (siehe Rollups). Ab 0.7.0 hängt er von @qorechain/sdk ^0.10.0 und @qorechain/evm ^0.8.0 ab (auf npm geprüft, 4. November 2026). Ein Caret auf eine 0.x-Version bleibt innerhalb dieser Minor-Version, sodass eine App mit dem SDK 0.13.0 für das Kit eine zweite, verschachtelte SDK-0.10.x-Kopie erhält; halten Sie die beiden getrennt (übergeben Sie keinen Client von einer Kopie an die andere), bis ein Kit-Release auf 0.13 wechselt. Signiert nur hybrid, wenn Sie ein pqcKeypair übergeben; Lesevorgänge funktionieren ohne. Auch als qorechain-rdk auf PyPI, crates.io und Maven Central sowie als Go-Modul veröffentlicht (pinnen Sie @v0.8.0); ab 0.8.0 signieren diese vier Clients ebenfalls hybrid (frühere Versionen signierten nur klassisch; Java benötigt Java 21). Siehe RDK 0.8.0: Änderungen und Einschränkungen0.9.0
@qorechain/rdk-cliDie qorollup-Operator-CLI für das RDK. Seit 0.7.1 signieren ihre Transaktionsbefehle (create, pause, resume, stop, withdraw) hybrid (0.7.0 und früher signierten nur klassisch und wurden von den Netzwerken abgelehnt); von npm installiert läuft sie, und --version gibt die installierte Version aus (0.6.1 und früher gaben nichts aus)0.9.0
@qorechain/qoresealQoreSeal: verschlüsselt eine Nutzlast an die ML-KEM-1024-Schlüssel, die Konten im KEM-Register veröffentlichen (SDK 0.12.0 und später registrieren und lesen die Schlüssel; QoreSeal übernimmt die Verschlüsselung). Auch auf PyPI (qorechain-qoreseal; Wheels für macOS und Linux, das Windows-Wheel in der nächsten Version), crates.io, Maven Central (io.github.qorechain:qoreseal und qoreseal-android; Kotlin-Nutzer brauchen Kotlin 2.3 oder neuer), dem Go-Modul-Proxy (github.com/qorechain/qoreseal/go, Go v0.1.0) und als Swift-Paket. Siehe QoreSeal0.1.0
@qorechain/asset-kitAsset Kit: Werkzeuge für zugangsbeschränkte Real-World-Asset-Token auf der EVM Engine, mit Clients in TypeScript, Python, Java und Go sowie Solidity-Contracts (forge install qorechain/qorechain-asset-kit@v0.1.0). Apache-2.0, mit Ausnahme der ERC-3643-Skripte und -Tests (GPL-3.0-or-later). Die nativen Module, die es beschreibt, sind ein Vorschlag und nicht gebaut. Auch qorechain-asset-kit auf PyPI und io.github.qorechain:asset-kit auf Maven Central. Siehe Asset Kit0.1.0
@qorechain/qoresignQoreSign: Wallet- und Backend-Signierung sowie inspectTransaction, um die Post-Quanten-Ebene einer bestätigten Transaktion zu prüfen. Auch auf PyPI, crates.io und Maven Central. Siehe QoreSign0.2.0
create-qorechain-rollupScaffolder für Rollup-Starter; seine Vorlagen hängen von @qorechain/rdk ^0.8.0 ab und signieren hybrid, wenn sie Ihren Post-Quanten-Schlüssel aus QORE_MNEMONIC oder QORE_PQC_SEED_HEX auflösen können0.9.0

Weiter​

Fahren Sie mit dem Schnellstart fort, um sich zu verbinden und den On-Chain-Zustand zu lesen.