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.