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.