Aller au contenu principal

Configuration du portefeuille

QoreChain prend en charge plusieurs types de portefeuilles dans ses environnements d'exécution natif, EVM et SVM. Choisissez le portefeuille adapté à votre cas d'usage.

remarque

Les valeurs ci-dessous couvrent à la fois le mainnet qorechain-vladi (ID de chaîne EVM 9801, actif depuis le 7 juin 2026) et le testnet qorechain-diana (ID de chaîne EVM 9800). Les points de terminaison publics des deux réseaux sont répertoriés dans Réseaux.

Portefeuille Keplr​

Keplr est le portefeuille recommandé pour les transactions natives QoreChain, le staking et la gouvernance.

Ajouter QoreChain comme chaîne personnalisée​

Ouvrez Keplr, accédez à Settings > Add Custom Chain (Paramètres > Ajouter une chaîne personnalisée), puis saisissez :

ChampMainnetTestnet
Nom de la chaîneQoreChainQoreChain Diana Testnet
ID de la chaîneqorechain-vladiqorechain-diana
URL RPChttps://rpc.qore.hosthttps://rpc-testnet.qore.host
URL RESThttps://api.qore.hosthttps://api-testnet.qore.host
Préfixe Bech32qorqor
Dénomination de la deviseQORQOR
Dénomination minimale de la deviseuqoruqor
Décimales66
Type de devise (BIP-44)118118

Une fois la chaîne ajoutée, Keplr génère une adresse qor1... pour votre compte.

Seuil minimal du prix du gas

Le prix de gas minimum du réseau est de 0.1uqor. Si vous configurez les paliers de prix de gas de Keplr (par exemple via suggestChain), utilisez des valeurs égales ou supérieures à 0.1 (bas/moyen/élevé suggérés : 0.1 / 0.15 / 0.25) — les transactions signées en dessous de ce seuil sont rejetées.

MetaMask (EVM)​

MetaMask permet d'interagir avec l'environnement d'exécution EVM de QoreChain — déployez des contrats Solidity, gérez des tokens ERC-20 et utilisez les outils Ethereum habituels.

Ajouter QoreChain comme réseau personnalisé​

Ouvrez MetaMask, accédez à Settings > Networks > Add Network (Paramètres > Réseaux > Ajouter un réseau), puis saisissez :

ChampMainnetTestnet
Nom du réseauQoreChainQoreChain Diana Testnet
URL RPChttps://evm.qore.hosthttps://evm-testnet.qore.host
ID de la chaîne98019800
Symbole de la deviseQORQOR
URL de l'explorateur de blocshttps://explore.qore.networkhttps://explore.qore.network

Le QOR natif possède 18 décimales sur l'interface EVM (façon wei). Une fois connecté, vous pouvez utiliser MetaMask pour signer des transactions EVM, interagir avec des contrats intelligents déployés et gérer des tokens ERC-20 sur QoreChain.

Enregistrement du réseau en un seul appel​

Pour les dApps, les paquets @qorechain/wallet-adapter et @qorechain/connect (publiés sur npm) enregistrent QoreChain auprès du portefeuille de l'utilisateur en un seul appel — en invitant MetaMask à ajouter le réseau via EIP-3085 (avec le QOR natif à 18 décimales correct sur le rail EVM) et en configurant le palier de prix de gas de Keplr :

npm install @qorechain/wallet-adapter @qorechain/connect
import { addQoreEvmToWallet } from "@qorechain/wallet-adapter";

await addQoreEvmToWallet(); // prompts MetaMask with QoreChain's EVM network params

Un compte, trois adresses (comptes unifiés)​

Depuis la version de chaîne v3.1.83, un compte QoreChain est une identité unique de 20 octets avec trois encodages : qor1… (Natif), 0x… (EVM) et une forme base58 (SVM). Il possède un seul solde et — pour les comptes eth-natifs — signe sur les trois voies avec une seule clé, y compris la signature hybride post-quantique requise sur la voie native.

Générez un portefeuille unifié en code avec @qorechain/wallet-adapter :

import { generateQoreWallet } from "@qorechain/wallet-adapter";

const w = await generateQoreWallet();          // or walletFromMnemonic(mnemonic)
console.log(w.addresses.cosmos);               // qor1...
console.log(w.addresses.evm);                  // 0x... (same identity)
console.log(w.addresses.svm);                  // base58 (same identity)
// Native-lane sends use signHybridEth (classical eth_secp256k1 + ML-DSA-87 hybrid).

Les fonds envoyés vers l'une des trois formes atterrissent dans le même solde.

Portefeuilles liés : Phantom et MetaMask comme clés de dépense​

Depuis la version de chaîne v3.1.85, vous n'avez plus besoin d'exposer votre clé racine pour dépenser depuis un compte QoreChain dans une dApp. Une clé Phantom (ed25519) ou MetaMask (via son adresse Ethereum, par personal_sign) peut être enregistrée comme authentificateur sur votre compte — avec des permissions limitées, des plafonds de dépense, une expiration et une révocation instantanée — puis autoriser des transferts relayés par le backend de la dApp. Consultez Authentificateurs de portefeuilles liés pour le modèle complet et le code, ainsi que le guide des authentificateurs du SDK pour des exemples de bout en bout.

Portefeuilles Solana (SVM)​

La soumission de transactions SVM est actuellement désactivée

La voie d'exécution SVM est actuellement désactivée à l'échelle du réseau pour la soumission de transactions — n'envoyez pas de transactions via un portefeuille compatible Solana vers QoreChain pour le moment. La lecture des soldes/slots peut encore fonctionner ; consultez Développement SVM pour le statut actuel.

L'environnement d'exécution SVM de QoreChain est compatible avec les outils Solana standard, et le solde en QOR natif du compte est visible directement sur l'interface SVM (en lamports, 9 décimales ; 1 uqor = 1 000 lamports). Connectez n'importe quel portefeuille ou bibliothèque compatible Solana.

Utilisation de @solana/web3.js​

import { Connection } from "@solana/web3.js";

// Public read-only endpoint (or http://localhost:8899 on your own node)
const connection = new Connection("https://svm.qore.host");
const slot = await connection.getSlot();
console.log("Current slot:", slot);

Les points de terminaison SVM publics sont en lecture seule ; la soumission de transactions nécessite votre propre nœud. Consultez Développement SVM pour plus de détails.

Portefeuilles compatibles PQC (requis sur la voie Cosmos)​

QoreChain exige une cryptographie post-quantique (PQC) hybride sur la voie de transaction cosmos. Depuis la version de chaîne actuelle (v3.1.82), la valeur par défaut du réseau est hybrid_signature_mode = required avec allow_classical_fallback = false — ainsi chaque transaction sur la voie cosmos doit porter une signature ML-DSA-87 (Dilithium-5) en plus de la signature secp256k1 (ECDSA) standard. Les transactions cosmos purement classiques provenant d'un compte PQC sont rejetées.

Les transactions Cosmos nécessitent l'extension PQC hybride

L'envoi d'une transaction purement classique sur la voie cosmos sera rejeté. Vous devez joindre la signature Dilithium-5 en tant qu'extension de transaction PQCHybridSignature. Les outils CosmJS / Keplr standard ne produisent pas cette extension par eux-mêmes — utilisez la commande CLI qorechaind tx pqc cosign, la signature hybride du SDK QoreChain (voir ci-dessous), ou, pour la construire vous-même en code, la bibliothèque open source qorechain-pqc (hybridSignBytes). Les seules exemptions sont les gentxs de genèse et les transactions d'enregistrement/migration de clé PQC.

Fonctionnement​

Les portefeuilles joignent une signature PQC ML-DSA-87 en tant qu'extension de transaction, en plus de la signature secp256k1 (ECDSA) standard. La signature classique est calculée sur des octets de signature qui excluent l'extension, de sorte qu'elle reste valide pour la vérification classique tandis que la signature PQC apporte la résistance quantique.

Générer une clé Dilithium-5​

Générez une clé post-quantique pour la signature hybride :

qorechaind tx pqc gen-key

Enregistrement automatique​

Lorsque vous incluez une clé publique PQC dans votre première transaction, QoreChain l'enregistre automatiquement sur la chaîne. Aucune étape d'enregistrement distincte n'est nécessaire. (Les transactions d'enregistrement/migration de clé PQC sont elles-mêmes exemptées de l'exigence hybride, ce qui permet à un compte d'amorcer sa première clé.)

Signature hybride avec le SDK​

Le SDK QoreChain produit des transactions cosmos conformes via buildHybridTx avec includePqcPublicKey: true, qui joint l'extension Dilithium-5 et intègre la clé publique pour l'enregistrement automatique. Consultez Comptes SDK et signature PQC.

Modes PQC​

Les trois modes d'application restent contrôlés par la gouvernance ; le mode par défaut actuel du réseau est Required :

ModeDescription
DisabledLa vérification PQC est désactivée. Signatures standard uniquement.
OptionalLes transactions peuvent inclure des signatures PQC. Si elles sont présentes, elles sont vérifiées.
Required (par défaut)Toutes les transactions sur la voie cosmos doivent inclure une signature PQC valide.

Le mode actif est configuré au niveau de la chaîne et peut être mis à jour par la gouvernance.

EVM / MetaMask non affecté

Le flux MetaMask (EVM) ci-dessus n'est pas affecté par l'exigence hybride. Les transactions EVM utilisent une voie ante eth_secp256k1 distincte et n'ont jamais besoin de l'extension PQC.

Portefeuille CLI​

Le binaire qorechaind inclut un système de gestion de clés intégré pour une utilisation en ligne de commande.

Créer une nouvelle clé​

qorechaind keys add mykey

Cela génère une nouvelle paire de clés et affiche la phrase mnémotechnique. Conservez la phrase mnémotechnique en lieu sûr — c'est le seul moyen de récupérer cette clé.

Afficher votre adresse​

qorechaind keys show mykey -a

Cela affiche votre adresse bech32 qor1....

Lister toutes les clés​

qorechaind keys list

Importer une clé existante​

qorechaind keys add mykey --recover

Vous serez invité à saisir votre phrase mnémotechnique.

Prochaines étapes​