Aller au contenu principal

FAQ et dépannage

Le mainnet est-il en ligne ?​

Oui. Le mainnet est en ligne (identifiant de chaîne qorechain-vladi, en production depuis le 7 juin 2026) et exécute la version de chaîne v3.2.7 (appliquée à la hauteur 4,164,600 le 12 novembre 2026, proposition de gouvernance 16 ; la v3.2.6 a été appliquée à la hauteur 4,020,000 le 4 novembre 2026, proposition 15 ; la v3.2.5 a été appliquée à la hauteur 3,906,833 le 29 octobre 2026 et la v3.2.4 à la hauteur 3,742,566 le 23 octobre 2026) ; le testnet exécute la v3.2.6 depuis le 27 octobre 2026, la v3.2.7 depuis le 6 novembre et la v3.2.8 depuis le 12 novembre 2026 (hauteur 9,929,500 ; le mainnet ne l'a pas appliquée). Le préréglage testnet (qorechain-diana) reste également disponible. Depuis le SDK 0.12.0, les deux préréglages utilisent par défaut les points de terminaison publics ; sélectionnez le réseau avec createClient({ network: "mainnet" }) et remplacez endpoints uniquement pour votre propre nœud. Voir Réseau et points de terminaison.

Pourquoi mes appels atteignent-ils localhost ?​

Vous utilisez un SDK antérieur à la 0.12.0, dont les préréglages utilisent par défaut des points de terminaison localhost : mettez à jour, ou passez un objet endpoints. Depuis la 0.12.0, createClient() et createClient({ network: "mainnet" }) utilisent les points de terminaison publics, et le préréglage localnet est celui qui utilise localhost.

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

Si vous obtenez plutôt « endpoint ... is not configured for the mainnet preset », l'appel a besoin d'un point de terminaison que les préréglages publics ne définissent pas (gRPC, un RPC SVM, le WebSocket EVM du mainnet) ; passez-le dans endpoints.

Le chemin de signature (connectTx) a besoin du point de terminaison consensus rpc ; les lectures QoreChain Native l'utilisent également. Les lectures REST utilisent rest ; les appels EVM utilisent evmRpc (ainsi que les appels qor_, sur un nœud qui sert cet espace de noms). Les URL du mainnet figurent dans la référence réseau.

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

Ce sont des dépendances pairs (peer dependencies) de @qorechain/evm et @qorechain/svm respectivement. Installez-les dans votre projet :

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

Un appel à un précompilé lève « returned no data » / « feature not present »​

Les précompilés EVM de QoreChain sont compilés dans le nœud mais ne sont pas actifs sur le mainnet, et seuls trois sont actifs sur le testnet : ils ne répondent que là où leurs adresses figurent dans le paramètre active_static_precompiles du module EVM. Cette liste est vide sur le mainnet ; sur le testnet, elle contient les précompilés de vérification PQC (0x…0A01), d'état de clé PQC (0x…0A02) et de paramètres de consensus (0x…0C01) (vérifié le 27 octobre 2026 ; la liste du testnet contenait aussi le pont cross-VM 0x…0901 à partir du 4 novembre et le 7 novembre 2026, actif avec une liste d'autorisation (testé avec eth_call), et la liste du mainnet était toujours vide) : la paire IA n'y répond donc toujours rien. Là où un précompilé est inactif, l'appel renvoie des données vides ; viem signale donc returned no data ("0x") et le helper lève une erreur (voir Précompilés EVM : statut réseau). Sur un nœud EVM standard, les appels échouent de la même façon. Consultez GET /cosmos/evm/vm/v1/params et encapsulez chaque appel de précompilé afin que l'erreur soit gérée appel par appel.

Mon appel client.qor échoue avec -32601​

client.qor appelle l'espace de noms JSON-RPC qor_, qu'aucune version publiée du nœud ne sert ; rpc_modules sur les points de terminaison EVM publics ne liste que eth, net, rpc, txpool et web3. Utilisez plutôt une route REST, par exemple GET /qorechain/pqc/v1/account/{address} (statut de la clé PQC) ou GET /qorechain/burn/v1/stats, via client.rest.get(...). Voir l'espace de noms qor_.

Mes montants sont décalés d'un facteur d'un million​

Le QOR a 10^6 unités de base uqor. Utilisez toBase / fromBase et effectuez tous les calculs en unités de base :

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

Notez que l'environnement d'exécution EVM représente le QOR avec 18 décimales (convention EVM), ce qui est distinct de la base native uqor de 10^6.

Quels paquets sont publiés, et où ?​

Tous (vérifié le 12 novembre 2026). Le cœur TypeScript (@qorechain/sdk, 0.14.0), le kit React (@qorechain/react, 0.14.0), le générateur create-qorechain-dapp (0.14.0, qui reprend aussi les correctifs de modèles de la 0.13.1) et les adaptateurs EVM/SVM (@qorechain/evm, @qorechain/svm, 0.14.0) sont sur npm ; le client Python est sur PyPI (pip install qorechain-sdk en version 0.14.0, import qorsdk) ; le client Go est sur le proxy de modules (go get github.com/qorechain/qorechain-sdk/packages/go@v0.14.0) ; le client Rust est sur crates.io (cargo add qorechain-sdk, 0.14.0) ; et le client Java est sur Maven Central (io.github.qorechain:qorechain-sdk, 0.14.0, JDK 17 ou ultérieur). Voir Installation pour la liste complète des commandes par langage.

Ma phrase mnémotechnique est rejetée​

Le SDK valide à la fois la liste de mots BIP-39 et la somme de contrôle avant de dériver la moindre clé, de sorte qu'une phrase mal saisie lève une erreur au lieu de produire silencieusement le mauvais compte. Revérifiez les mots ; utilisez validateMnemonic pour tester une phrase.

Transactions hybrides (PQC)​

La soumission hybride (classique + ML-DSA-87) est en ligne et obligatoire sur le chemin Native : les transactions Native purement classiques sont rejetées on-chain (chaîne v3.2.0). Avant qu'une transaction hybride ne soit vérifiée par PQC, la clé publique PQC du signataire doit être enregistrée explicitement avec MsgRegisterPQCKeyV2 (une transaction signée de manière classique et exemptée de la signature hybride) ; intégrer la clé publique dans l'extension (includePqcPublicKey: true) ne l'enregistre pas, et la chaîne n'enregistre pas de clé à la première utilisation. En TypeScript, donnez la paire de clés au client (client.connectTx(signer, { pqcKeypair }), SDK 0.9.0 ou ultérieur) et chaque transaction qu'il envoie est signée en mode hybride. La chaîne accepte toute signature ML-DSA-87 valide selon FIPS-204, hedged ou déterministe. Le SDK signe de manière déterministe par défaut (depuis la 0.5.1) pour qu'une transaction ait toujours la même signature et le même hash de tx. Si une tx hybride échoue avec le code pqc 21 (hybrid_verify_failed), la cause est la version des sign-bytes, le chain-id, une bibliothèque PQC obsolète ou une clé non enregistrée ou différente, jamais la signature hedged. Les deux réseaux vérifient la forme v2 des sign-bytes ; utilisez donc le SDK 0.8.1 ou ultérieur (la 0.14.0 est la version actuelle) et passez rest (ou signBytesVersion) : les builders lèvent une erreur sur qorechain-vladi / qorechain-diana sans l'un des deux. Voir Dépannage du code 21 et Comptes et signature PQC.

Ma transaction EVM est refusée avec « no open EVM authorisation window »​

Depuis la chaîne v3.2.0, la voie EVM n'admet une transaction que d'un compte disposant d'une clé PQC enregistrée et d'une fenêtre d'autorisation ouverte. Enregistrez une clé, ouvrez une fenêtre, puis envoyez. Voir Fenêtre d'autorisation EVM. Avec le SDK, classifyEvmWindowRejection(err) renvoie "no-pqc-key", "no-window", "exhausted" ou "invalid".

Mes transactions hybrides échouent à CheckTx avec une erreur d'analyse de transaction​

Mettez à jour le SDK. Les versions 0.6.0 et antérieures sérialisaient en JSON l'extension de corps de transaction /qorechain.pqc.v1.PQCHybridSignature, que le décodeur de transactions de la chaîne rejette à CheckTx. Depuis la 0.6.1, l'extension est encodée en protobuf (la valeur commence par 0x08) dans les cinq langages — les transactions hybrides construites avec des versions plus anciennes sont rejetées on-chain, sur toutes les voies (y compris eth-native).

Avec quelles versions de chaîne le SDK fonctionne-t-il ?​

Le SDK 0.12.0 est la version cliente pour la chaîne v3.2.5 (mainnet depuis le 29 octobre 2026 à la hauteur 3,906,833 ; testnet depuis le 26 octobre). Le mainnet exécute la v3.2.7 (depuis le 12 novembre) et le testnet la v3.2.8 (depuis le 12 novembre ; la v3.2.7 depuis le 6 novembre, la v3.2.6 depuis le 27 octobre) ; le format de signature n'a pas changé jusqu'à la v3.2.7, la 0.12.0 fonctionne donc sur le mainnet. La 0.12.0 n'a pas de constructeurs pour les ajouts de la v3.2.7 (enregistrement du multisig PQC, le mode de signature textuel, l'APR, l'identité de cluster et les messages de clé de vérification), qui sont sur le mainnet depuis le 12 novembre 2026, et son chemin de signature n'a pas été revérifié sur la v3.2.7 ; utilisez la CLI pour ceux-ci. Elle ajoute la règle de gas exacte pour les transactions hybrides, les constructeurs et la lecture du registre de clés ML-KEM, les lectures de compte abstrait et les constructeurs de paramètres de gouvernance vérifiés (voir Ce qu'ajoute la 0.12.0), en plus de ce qu'avait ajouté la 0.10.0 pour la v3.2.4 (les constructeurs et lectures de staking tiers, fetchAuthNonce et les lectures des fonctionnalités de protocole, voir Ce qu'a ajouté la 0.10.0) et la 0.9.0 pour la v3.2.2 et la v3.2.3 : des constructeurs pour la preuve de possession facultative à l'enregistrement (jointe automatiquement par ensurePqcRegistered une fois que le réseau a appliqué la v3.2.3), les fenêtres EVM à portée limitée et les messages de consentement EIP-7702. Le SDK 0.8.1 ou ultérieur transige aussi sur les deux réseaux (la forme v2 des sign-bytes hybrides, l'enregistrement, les envois hybrides et la fenêtre EVM fonctionnent sans changement), mais n'a aucun de ces constructeurs : utilisez la CLI pour ceux-ci (voir Versions antérieures à la 0.9.0). Le format de signature n'a pas changé dans la v3.2.4, la v3.2.5 ni la v3.2.6. Le mainnet exécute la v3.2.7 et le testnet la v3.2.8 (le testnet a appliqué la v3.2.5 le 26 octobre 2026, la v3.2.6 le 27 octobre, la v3.2.7 le 6 novembre et la v3.2.8 le 12 novembre ; le mainnet a appliqué la v3.2.5 le 29 octobre, la v3.2.6 le 4 novembre et la v3.2.7 le 12 novembre) . Les SDK 0.10.0 et 0.9.0 continuent d'y fonctionner mais n'ont pas de constructeurs pour les ajouts de la v3.2.5 (le registre de clés ML-KEM, la règle de gas exacte) ; avec ces versions, utilisez la CLI, ou passez à la 0.14.0. La 0.12.0 a été construite et vérifiée contre la v3.2.5.

Mon enregistrement de clé PQC a été refusé mais les frais ont été prélevés​

Un enregistrement pour un compte qui détient déjà une clé est refusé par la chaîne après la déduction des frais. ensurePqcRegistered en 0.9.0 et ultérieur lit d'abord GET /qorechain/pqc/v1/account/{address} (passez rest), ignore l'enregistrement lorsque la clé de cette paire de clés est enregistrée, et lève PqcKeyMismatchError lorsqu'une autre l'est. Les versions antérieures ne regardaient pas d'abord, sauf si vous passiez vous-même status: { registered: found }, où found provient de cette route. Depuis la v3.2.3, la chaîne refuse aussi les clés faibles, dégénérées et réutilisées ; les clés issues de derivePqcCanonical ou de tx pqc gen-key conviennent.

create-qorechain-dapp installe un SDK qui ne peut pas signer​

Seule la version 0.8.0 du générateur le faisait : elle écrivait des plages ^0.3.0 pour @qorechain/sdk et @qorechain/evm, et une plage caret sur une version 0.x reste dans la 0.3. Les versions 0.9.0 et ultérieures génèrent sur le SDK actuel ; si vous avez utilisé la 0.8.0, exécutez npm i @qorechain/sdk@latest (et @qorechain/evm@latest) après la génération.

VERSION indique 0.8.0 mais j'ai installé la 0.8.3​

La constante exportée VERSION de la 0.8.3 n'a pas été mise à jour et indique 0.8.0 ; à partir de la 0.9.0, elle correspond au paquet. Sur les versions antérieures, lisez la version installée dans package.json.

Ma dépense via authenticator est rejetée avec authenticator_replay​

(Le module abstractaccount est désactivé sur le mainnet ; une dépense y est refusée avec abstract account module is disabled avant que le moindre nonce ne soit vérifié. Il est activé sur le testnet. Voir Authenticators et dépense déléguée. Les indications ci-dessous s'appliquent partout où le module est activé.)

Le nonce est incorrect. MsgExecuteEVM.nonce et MsgExecuteCosmos.nonce sont tous deux la séquence d'authenticator de la clé liée pour (account, pubkey) : un compteur que la chaîne tient par clé liée, qui démarre à 0 et est incrémenté à chaque exécution réussie. Ce n'est pas le nonce EVM du compte. Lisez-le avec fetchAuthNonce (SDK 0.10.0 ou ultérieur, chaîne v3.2.4 ou ultérieure), ou suivez-le par clé liée sur les versions plus anciennes. Depuis la v3.2.3, la voie EVM signe aussi evmAuthSignBytesV2, qui lie la limite de gas de l'appel (resolveEvmAuthDigestVersion choisit la forme). Utilisez le compteur que vous lisez (ou suivez) pour cette clé et re-signez.

Les autres échecs d'authenticator se décodent via decodeTxError : codes abstractaccount 5 (spending_limit_exceeded), 6 (session_key_expired), et 10 (permission_denied). Voir Authenticators et dépense déléguée.