Zum Hauptinhalt springen

FAQ & Fehlerbehebung

Ist das Mainnet live?​

Ja. Das Mainnet ist live (Chain-ID qorechain-vladi, live seit dem 7. Juni 2026) und läuft mit der Chain-Version v3.2.7 (angewendet bei Höhe 4.164.600 am 12. November 2026, Governance-Vorschlag 16; v3.2.6 wurde bei Höhe 4.020.000 am 4. November 2026 angewendet, Vorschlag 15; v3.2.5 wurde bei Höhe 3.906.833 am 29. Oktober 2026 angewendet und v3.2.4 bei Höhe 3.742.566 am 23. Oktober 2026); das Testnet läuft seit dem 27. Oktober 2026 mit v3.2.6, ab dem 6. November mit v3.2.7 und seit dem 12. November 2026 mit v3.2.8 (Höhe 9.929.500; das Mainnet hat es nicht angewendet). Das Testnet-Preset (qorechain-diana) bleibt ebenfalls verfügbar. Ab SDK 0.12.0 verwenden beide Presets standardmäßig die öffentlichen Endpoints; wählen Sie das Netzwerk mit createClient({ network: "mainnet" }) und überschreiben Sie endpoints nur für Ihren eigenen Node. Siehe Netzwerk & Endpoints.

Warum gehen meine Aufrufe an localhost?​

Sie verwenden ein SDK vor 0.12.0, dessen Presets standardmäßig localhost-Endpoints nutzen: aktualisieren Sie oder übergeben Sie ein endpoints-Objekt. Ab 0.12.0 verwenden createClient() und createClient({ network: "mainnet" }) die öffentlichen Endpoints, und das Preset localnet ist dasjenige, das localhost verwendet.

const client = createClient({
endpoints: {
rest: "https://api-testnet.qore.host",
rpc: "https://rpc-testnet.qore.host",
evmRpc: "https://evm-testnet.qore.host",
},
});

Wenn Sie stattdessen „endpoint ... is not configured for the mainnet preset" erhalten, braucht der Aufruf einen Endpoint, den die öffentlichen Presets nicht setzen (gRPC, einen SVM-RPC, den Mainnet-EVM-WebSocket); übergeben Sie ihn in endpoints.

Der Signierpfad (connectTx) benötigt den Konsens-Endpoint rpc; QoreChain Native-Lesezugriffe verwenden ihn ebenfalls. REST-Lesezugriffe verwenden rest; EVM-Aufrufe verwenden evmRpc (ebenso qor_-Aufrufe, auf einem Node, der diesen Namespace bereitstellt). Die Mainnet-URLs stehen in der Netzwerkreferenz.

"Cannot find module 'viem'" / "'@solana/web3.js'"​

Dies sind Peer-Dependencies von @qorechain/evm bzw. @qorechain/svm. Installieren Sie sie in Ihrem Projekt:

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

Ein Precompile-Aufruf wirft "returned no data" / "feature not present"​

Die QoreChain-EVM-Precompiles sind in den Node einkompiliert, aber im Mainnet nicht aktiv, und im Testnet sind nur drei aktiv: Sie antworten nur dort, wo ihre Adressen im Parameter active_static_precompiles des EVM-Moduls aufgeführt sind. Diese Liste ist im Mainnet leer; im Testnet enthält sie die Precompiles PQC Verify (0x…0A01), PQC Key Status (0x…0A02) und Consensus Parameters (0x…0C01) (geprüft am 27. Oktober 2026; die Testnet-Liste enthielt die Cross-VM-Bridge 0x…0901 auch seit dem 4. November und am 7. November 2026, aktiv mit einer Allowlist (mit eth_call getestet), und die Liste des Mainnets war weiterhin leer), sodass das AI-Paar dort weiterhin nichts beantwortet. Wo ein Precompile inaktiv ist, liefert der Aufruf leere Daten, sodass viem returned no data ("0x") meldet und der Helper einen Fehler wirft (siehe EVM-Precompiles: Netzwerkstatus). Auf einem gewöhnlichen EVM-Node schlagen die Aufrufe auf dieselbe Weise fehl. Prüfen Sie GET /cosmos/evm/vm/v1/params und kapseln Sie jeden Precompile-Aufruf, sodass der Fehler pro Aufruf behandelt wird.

Mein client.qor-Aufruf scheitert mit -32601​

client.qor ruft den JSON-RPC-Namespace qor_ auf, den kein veröffentlichter Node-Build bereitstellt; rpc_modules auf den öffentlichen EVM-Endpoints listet nur eth, net, rpc, txpool und web3. Verwenden Sie stattdessen eine REST-Route, zum Beispiel GET /qorechain/pqc/v1/account/{address} (PQC-Schlüsselstatus) oder GET /qorechain/burn/v1/stats, über client.rest.get(...). Siehe den qor_-Namespace.

Meine Beträge weichen um den Faktor eine Million ab​

QOR hat 10^6 Basiseinheiten in uqor. Verwenden Sie toBase / fromBase und führen Sie alle Berechnungen in Basiseinheiten durch:

toBase("1.5"); // "1500000"
fromBase("1500000"); // "1.5"

Beachten Sie, dass die EVM-Laufzeitumgebung QOR mit 18 Dezimalstellen darstellt (EVM-Konvention), was sich von der Native-uqor-Basis von 10^6 unterscheidet.

Welche Pakete sind veröffentlicht, und wo?​

Alle (geprüft am 12. November 2026). Der TypeScript-Core (@qorechain/sdk, 0.14.0), das React-Kit (@qorechain/react, 0.14.0), der create-qorechain-dapp-Scaffolder (0.14.0, der auch die Vorlagen-Korrekturen von 0.13.1 enthält) und die EVM/SVM-Adapter (@qorechain/evm, @qorechain/svm, 0.14.0) sind auf npm; der Python-Client ist auf PyPI (pip install qorechain-sdk in Version 0.14.0, Import qorsdk); der Go-Client ist über den Module-Proxy verfügbar (go get github.com/qorechain/qorechain-sdk/packages/go@v0.14.0); der Rust-Client ist auf crates.io (cargo add qorechain-sdk, 0.14.0); und der Java-Client ist auf Maven Central (io.github.qorechain:qorechain-sdk, 0.14.0, JDK 17 oder neuer). Siehe Installation für die vollständigen Befehle pro Sprache.

Meine Mnemonic wird abgelehnt​

Das SDK validiert sowohl die BIP-39-Wortliste als auch die Prüfsumme, bevor ein Schlüssel abgeleitet wird — eine Phrase mit Tippfehler löst also einen Fehler aus, statt stillschweigend das falsche Konto zu erzeugen. Prüfen Sie die Wörter erneut; verwenden Sie validateMnemonic, um eine Phrase zu testen.

Hybride (PQC-)Transaktionen​

Die hybride Einreichung (klassisch + ML-DSA-87) ist auf dem Native-Pfad live und verpflichtend — rein klassische Native-Transaktionen werden on-chain abgelehnt (Chain v3.2.0). Bevor eine hybride Tx PQC-verifiziert wird, muss der öffentliche PQC-Schlüssel des Signierers ausdrücklich registriert werden, und zwar mit MsgRegisterPQCKeyV2 (einer klassisch signierten, von der Hybrid-Pflicht befreiten Transaktion); das Einbetten des öffentlichen Schlüssels in die Erweiterung (includePqcPublicKey: true) registriert ihn nicht, und die Chain registriert einen Schlüssel nicht bei der ersten Verwendung. In TypeScript übergeben Sie dem Client das Schlüsselpaar (client.connectTx(signer, { pqcKeypair }), SDK 0.9.0 oder neuer), und jede Transaktion, die er sendet, wird hybrid signiert. Die Chain akzeptiert jede gültige FIPS-204-ML-DSA-87-Signatur, ob hedged oder deterministisch. Das SDK signiert standardmäßig deterministisch (seit 0.5.1), damit eine Transaktion immer dieselbe Signatur und denselben Tx-Hash hat. Wenn eine hybride Tx mit pqc-Code 21 (hybrid_verify_failed) fehlschlägt, liegt es an der Sign-Bytes-Version, der Chain-ID, einer veralteten PQC-Bibliothek oder einem nicht registrierten Schlüssel, nie an hedged Signierung. Beide Netzwerke verifizieren die Sign-Bytes-Form v2; verwenden Sie daher SDK 0.8.1 oder neuer (0.14.0 ist aktuell) und übergeben Sie rest (oder signBytesVersion): Die Builder werfen auf qorechain-vladi / qorechain-diana einen Fehler, wenn keines von beiden angegeben ist. Siehe Fehlerbehebung für Code 21 und Konten & PQC-Signierung.

Meine EVM-Transaktion wird mit "no open EVM authorisation window" abgelehnt​

Seit Chain v3.2.0 lässt die EVM-Lane eine Transaktion nur von einem Konto zu, das einen registrierten PQC-Schlüssel und ein offenes Autorisierungsfenster hat. Registrieren Sie einen Schlüssel, öffnen Sie ein Fenster und senden Sie dann. Siehe EVM-Autorisierungsfenster. Mit dem SDK liefert classifyEvmWindowRejection(err) "no-pqc-key", "no-window", "exhausted" oder "invalid".

Meine hybriden Transaktionen scheitern bei CheckTx mit einem Tx-Parse-Fehler​

Aktualisieren Sie das SDK. Die Versionen 0.6.0 und früher haben die Tx-Body-Erweiterung /qorechain.pqc.v1.PQCHybridSignature JSON-serialisiert, was der Tx-Decoder der Chain bei CheckTx ablehnt. Seit 0.6.1 ist die Erweiterung protobuf-kodiert (der Wert beginnt mit 0x08) — in allen fünf Sprachen. Hybride Transaktionen, die mit älteren Versionen erstellt wurden, werden on-chain abgelehnt, und zwar in jeder Lane (einschließlich eth-native).

Mit welchen Chain-Versionen funktioniert das SDK?​

SDK 0.12.0 ist das Client-Release für die Chain v3.2.5 (Mainnet seit dem 29. Oktober 2026 auf Höhe 3.906.833; das Testnet seit dem 26. Oktober). Das Mainnet läuft mit v3.2.7 (seit dem 12. November) und das Testnet mit v3.2.8 (seit dem 12. November; v3.2.7 ab dem 6. November, v3.2.6 ab dem 27. Oktober); das Signaturformat hat sich bis v3.2.7 nicht geändert, daher funktioniert 0.12.0 im Mainnet. 0.12.0 hat keine Builder für die Ergänzungen von v3.2.7 (Registrierung von PQC-Multisig, den Textual-Signiermodus, die APR, die Cluster-Identität und die Nachrichten für Verifikationsschlüssel), die seit dem 12. November 2026 im Mainnet sind, und sein Signierpfad wurde nicht erneut gegen v3.2.7 geprüft; verwenden Sie dafür die CLI. Es fügt die exakte Gas-Regel für Hybrid-Transaktionen, die Builder und den Lesezugriff des ML-KEM-Schlüsselregisters, die Lesezugriffe für Abstract Accounts und die geprüften Builder für Governance-Parameter hinzu (siehe Was 0.12.0 hinzufügt), zusätzlich zu dem, was 0.10.0 für v3.2.4 hinzugefügt hat (die Staking-Tier-Builder und -Lesezugriffe, fetchAuthNonce und die Protocol-Feature-Lesezugriffe, siehe Was 0.10.0 hinzugefügt hat) und 0.9.0 für v3.2.2 und v3.2.3: Builder für den optionalen Besitznachweis (Proof of Possession) bei der Registrierung (automatisch angefügt von ensurePqcRegistered, sobald das Netzwerk v3.2.3 angewendet hat), EVM-Fenster mit Gültigkeitsbereich und die EIP-7702-Einwilligungsnachrichten. SDK 0.8.1 oder neuer transagiert ebenfalls auf beiden Netzwerken (die Sign-Bytes-Form v2 für Hybrid, die Registrierung, hybride Sendungen und das EVM-Fenster funktionieren unverändert), hat aber keinen dieser Builder: Verwenden Sie dafür die CLI (siehe Versionen vor 0.9.0). Das Signaturformat hat sich in v3.2.4, v3.2.5 oder v3.2.6 nicht geändert. Das Mainnet läuft mit v3.2.7 und das Testnet mit v3.2.8 (das Testnet hat v3.2.5 am 26. Oktober 2026, v3.2.6 am 27. Oktober, v3.2.7 am 6. November und v3.2.8 am 12. November angewendet; das Mainnet v3.2.5 am 29. Oktober, v3.2.6 am 4. November und v3.2.7 am 12. November). SDK 0.10.0 und 0.9.0 funktionieren dort weiter, haben aber keine Builder für die Ergänzungen von v3.2.5 (das ML-KEM-Schlüsselregister, die exakte Gas-Regel); verwenden Sie mit diesen Releases die CLI oder aktualisieren Sie auf 0.14.0. 0.12.0 wurde gegen v3.2.5 gebaut und geprüft.

Meine PQC-Schlüsselregistrierung wurde abgelehnt, aber die Gebühr wurde abgebucht​

Eine Registrierung für ein Konto, das bereits einen Schlüssel besitzt, wird von der Chain abgelehnt, nachdem die Gebühr abgezogen wurde. ensurePqcRegistered in 0.9.0 und neuer liest zuerst GET /qorechain/pqc/v1/account/{address} (übergeben Sie rest), überspringt die Registrierung, wenn der Schlüssel dieses Schlüsselpaars registriert ist, und wirft PqcKeyMismatchError, wenn ein anderer registriert ist. Frühere Releases schauten nicht vorab nach, sofern Sie nicht selbst status: { registered: found } übergaben, wobei found aus dieser Route stammt. Seit v3.2.3 lehnt die Chain außerdem schwache, entartete und wiederverwendete Schlüssel ab; Schlüssel aus derivePqcCanonical oder tx pqc gen-key sind in Ordnung.

create-qorechain-dapp installiert ein SDK, das nicht signieren kann​

Das tat nur Version 0.8.0 des Scaffolders: Sie schrieb die Bereiche ^0.3.0 für @qorechain/sdk und @qorechain/evm, und ein Caret-Bereich auf einer 0.x-Version bleibt innerhalb von 0.3. Version 0.9.0 und neuer erstellen Gerüste auf dem aktuellen SDK; wenn Sie 0.8.0 verwendet haben, führen Sie nach dem Scaffolding npm i @qorechain/sdk@latest (und @qorechain/evm@latest) aus.

VERSION meldet 0.8.0, aber ich habe 0.8.3 installiert​

Die exportierte Konstante VERSION von 0.8.3 wurde nicht aktualisiert und meldet 0.8.0; ab 0.9.0 entspricht sie dem Paket. Lesen Sie bei früheren Releases die installierte Version aus der package.json.

Meine Authenticator-Ausgabe wird mit authenticator_replay abgelehnt​

(Das Modul abstractaccount ist im Mainnet abgeschaltet; eine Ausgabe dort wird mit abstract account module is disabled abgelehnt, bevor eine Nonce geprüft wird. Im Testnet ist es aktiviert. Siehe Authenticators & delegiertes Ausgeben. Die folgenden Hinweise gelten überall dort, wo das Modul aktiviert ist.)

Die Nonce ist falsch. Sowohl MsgExecuteEVM.nonce als auch MsgExecuteCosmos.nonce sind die Authenticator-Sequenz des verknüpften Schlüssels für (account, pubkey): ein Zähler, den die Chain pro verknüpftem Schlüssel führt, bei 0 beginnt und mit jeder erfolgreichen Ausführung erhöht wird. Sie ist nicht die EVM-Nonce des Kontos. Lesen Sie sie mit fetchAuthNonce (SDK 0.10.0 oder neuer, Chain v3.2.4 oder neuer) oder verfolgen Sie sie bei älteren Versionen pro verknüpftem Schlüssel. Seit v3.2.3 signiert die EVM-Lane außerdem evmAuthSignBytesV2, das das Gas-Limit des Aufrufs bindet (resolveEvmAuthDigestVersion wählt die Form). Verwenden Sie den Zähler, den Sie für diesen Schlüssel lesen (oder verfolgen), und signieren Sie neu.

Andere Authenticator-Fehler lassen sich über decodeTxError dekodieren: abstractaccount-Codes 5 (spending_limit_exceeded), 6 (session_key_expired) und 10 (permission_denied). Siehe Authenticators & delegiertes Ausgeben.