Aller au contenu principal

Configuration du portefeuille

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

remarque

Les valeurs ci-dessous couvrent à la fois le mainnet qorechain-vladi (ID de chaîne EVM 9801, en production 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 listé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 et rendez-vous dans Settings > Add Custom Chain, puis saisissez :

ChampMainnetTestnet
Nom de la chaîneQoreChainQoreChain Diana Testnet
ID de 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 du jetonQORQOR
Dénomination minimaleuqoruqor
Décimales66
Coin Type (BIP-44)118118

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

Prix du gaz minimum

Le prix du gaz minimum du réseau est de 0.1uqor. Si vous configurez les paliers de prix du gaz de Keplr (par exemple via suggestChain), utilisez des valeurs supérieures ou égales à 0.1 (valeurs basse/moyenne/haute suggérées : 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éployer des contrats Solidity, gérer des jetons ERC-20 et utiliser l'outillage Ethereum habituel.

Ajouter QoreChain comme réseau personnalisé​

Ouvrez MetaMask et rendez-vous dans Settings > Networks > Add Network, puis saisissez :

ChampMainnetTestnet
Nom du réseauQoreChainQoreChain Diana Testnet
URL RPChttps://evm.qore.hosthttps://evm-testnet.qore.host
ID de 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 (à la manière du 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 jetons 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 du gaz 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… (Native), 0x… (EVM) et une forme base58 (SVM). Il détient un solde unique et — pour les comptes eth-natifs — signe sur les trois voies avec une seule clé, y compris la signature hybride post-quantique requise sur le chemin 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 n'importe laquelle des trois formes arrivent sur 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 (par son adresse Ethereum, via personal_sign) peut être enregistrée comme authentificateur sur votre compte — avec des permissions à portée limitée, des plafonds de dépense, une date d'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 Authentificateurs du SDK pour des exemples de bout en bout.

Portefeuilles Solana (SVM)​

L'environnement d'exécution SVM de QoreChain est compatible avec l'outillage Solana standard, et le solde de 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.

Utiliser @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 (obligatoires sur le chemin Cosmos)​

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

Les transactions Cosmos exigent l'extension PQC hybride

L'envoi d'une transaction classique simple sur le chemin cosmos sera rejeté. Vous devez joindre la signature Dilithium-5 en tant qu'extension de transaction PQCHybridSignature. L'outillage standard CosmJS / Keplr ne produit pas cette extension par lui-même — 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/de 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 séparée n'est nécessaire. (Les transactions d'enregistrement/de 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 embarque la clé publique pour l'enregistrement automatique. Consultez SDK Accounts & PQC signing.

Modes PQC​

Les trois modes d'application restent contrôlés par la gouvernance ; le paramètre 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 présentes, elles sont vérifiées.
Required (par défaut)Toutes les transactions du chemin cosmos doivent inclure une signature PQC valide.

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

EVM / MetaMask non concernés

Le flux MetaMask (EVM) ci-dessus n'est pas concerné par l'exigence hybride. Les transactions EVM utilisent un chemin ante eth_secp256k1 distinct 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 un usage en ligne de commande.

Créer une nouvelle clé​

qorechaind keys add mykey

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

Afficher votre adresse​

qorechaind keys show mykey -a

Cette commande 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émonique.

Prochaines étapes​