Aller au contenu principal

SDK QoreChain

Le SDK QoreChain est le kit de développement multilangage officiel pour créer des applications décentralisées sur QoreChain — un réseau Layer 1 triple-VM et résistant au quantique.

Cette documentation explique comment installer le SDK, se connecter au réseau, lire l'état on-chain, dériver des comptes, signer et envoyer des transactions, et travailler avec chacune des machines virtuelles de QoreChain.

Qu'est-ce que QoreChain ?​

QoreChain est une blockchain Layer 1 dotée de trois environnements d'exécution de smart contracts de première classe sur une seule chaîne :

  • CosmWasm — smart contracts Wasm via le Cosmos SDK.
  • QoreChain EVM Engine — exécution compatible Ethereum (Solidity, viem, JSON-RPC standard).
  • SVM — un environnement d'exécution compatible Solana avec un JSON-RPC de style Solana.

Les comptes, soldes et tokens sont partagés entre les environnements d'exécution, et la chaîne prend en charge IBC pour l'interopérabilité inter-chaînes.

Résistant au quantique par conception​

QoreChain fournit des primitives de cryptographie post-quantique (PQC) basées sur ML-DSA-87 (Dilithium-5, FIPS 204). Aux côtés de la signature classique secp256k1, la chaîne prend en charge une posture de signature hybride dans laquelle une transaction porte à la fois une signature classique et une signature post-quantique : elle reste ainsi valide sous vérification classique aujourd'hui tout en bénéficiant d'une protection post-quantique.

Le SDK expose dès aujourd'hui la génération de clés, la signature et la vérification ML-DSA-87, ainsi que les briques de base des transactions hybrides. Voir Comptes & signature PQC pour les détails. Aucune promesse marketing ici — le SDK expose exactement les primitives que la chaîne implémente.

Ce qui distingue ce SDK​

Au-delà d'une parité multi-chaînes complète, trois capacités ne sont possibles que sur QoreChain, car elles s'appuient sur des fonctionnalités protocolaires qu'aucun autre Layer 1 ne possède :

  • Évaluation de risque par IA avant envoi — analysez une transaction avec l'IA on-chain avant de la diffuser. simulateWithRiskScore renvoie le gas ainsi qu'un verdict de risque/anomalie issu de précompilés EVM déterministes, de sorte qu'un wallet ou une dApp peut avertir (ou bloquer) avant la signature. Voir AI pre-flight.
  • Appels inter-VM unifiés — un compte, trois VM, une transaction. createCrossVMClient appelle un contrat sur n'importe quelle VM et callAtomic regroupe plusieurs appels inter-VM dans une seule transaction atomique signée une seule fois. Voir Appels inter-VM.
  • DX résistante au quantique — rendez un signataire protégé en post-quantique en un seul appel idempotent (ensurePqcRegistered / migrateToHybrid), avec un badge React prêt à l'emploi. Voir Quantum-safe.

Deux capacités supplémentaires au niveau de la chaîne sont arrivées en 0.6.0 et 0.7.0 :

  • Comptes eth-natifs unifiés — une clé eth_secp256k1 est une identité unique de 20 octets rendue sous les formes qor1…, 0x… et une adresse SVM en base58, partageant toutes un même solde. Voir Comptes unifiés.
  • Voies d'authenticators — liez une clé Phantom ou MetaMask au compte canonique exigeant la PQC et laissez-la dépenser via un relayer selon des conditions à moindre privilège, plafonnées en dépenses et révocables. Voir Authenticators & dépenses déléguées.

Un nouveau kit @qorechain/react (provider, hooks, ConnectButton, QuantumSafeBadge) fait de la construction d'une dApp résistante au quantique le chemin par défaut — voir le guide du kit React. Pour l'argumentaire complet, lisez Pourquoi le SDK QoreChain.

La famille du SDK​

Le SDK est distribué sous la forme d'une famille de packages afin que vous puissiez développer dans le langage de votre choix. Ils partagent les mêmes préréglages réseau, schémas de dérivation, calculs de dénomination et surfaces de lecture.

PackageLangageInstallationStatut
@qorechain/sdkTypeScriptnpm i @qorechain/sdkPublié (npm, v0.7.0)
qorechain-sdkPythonpip install qorechain-sdk (import qorsdk)Publié (PyPI, v0.7.0)
qorechain-sdk (module Go)Gogo get github.com/qorechain/qorechain-sdk/packages/go/...Publié (proxy Go, tag packages/go/v0.7.0)
qorechain-sdkRustcargo add qorechain-sdk (import qorechain)Publié (crates.io, dernière version publiée ; 0.7.0 depuis le dépôt)
io.github.qorechain:qorechain-sdkJavaio.github.qorechain:qorechain-sdk:0.7.0Publié (Maven Central, v0.7.0)
@qorechain/evmTypeScript (adaptateur EVM)npm i @qorechain/evm viemPublié (npm, v0.7.0)
@qorechain/svmTypeScript (adaptateur SVM)npm i @qorechain/svm @solana/web3.jsPublié (npm, v0.7.0)
@qorechain/reactTypeScript (kit React)npm i @qorechain/reactPublié (npm, v0.7.0)
create-qorechain-dappCLInpm create qorechain-dappPublié (npm, v0.7.0)

La distribution Python s'installe sous le nom qorechain-sdk mais s'importe sous qorsdk. Tous les clients sont publiés sur leurs registres respectifs — voir Installation pour les commandes propres à chaque langage.

Le cœur TypeScript (@qorechain/sdk) sert de base aux exemples de cette documentation. Les clients Python, Go, Rust et Java atteignent une parité native-chaîne complète avec TypeScript : préréglages réseau, utilitaires de denom et d'adresses, dérivation de comptes HD (native/EVM/SVM), signature PQC (ML-DSA-87), compositeurs de messages typés pour chaque module personnalisé ainsi que pour les modules Cosmos standard, clients de requête typés, le cycle de vie complet des transactions (auto-gas, décodage d'erreurs, suivi des tx, recherche de blocs/tx), les transactions post-quantiques hybrides et les abonnements WebSocket. Tous ces clients sont publiés : TypeScript sur npm (@qorechain/sdk 0.7.0), Python sur PyPI (qorechain-sdk 0.7.0, import qorsdk), Go sur le proxy de modules (tag packages/go/v0.7.0), Rust sur crates.io (qorechain-sdk, dernière version publiée — la publication du crate 0.7.0 est en attente, installez donc depuis crates.io ou depuis le dépôt), et Java sur Maven Central (io.github.qorechain:qorechain-sdk 0.7.0). Les adaptateurs d'exécution EVM/SVM (@qorechain/evm, @qorechain/svm, tous deux en 0.7.0), le kit @qorechain/react (0.7.0) et la CLI d'échafaudage create-qorechain-dapp (0.7.0) sont uniquement en TypeScript et également publiés sur npm.

Nouveautés des versions 0.6 et 0.7​

0.6.0 — comptes eth-natifs unifiés (chaîne v3.1.83). Une clé eth_secp256k1 est une identité unique de 20 octets rendue sous les trois encodages d'adresse, partageant un même solde dépensable sur chaque voie :

import { deriveUnifiedAccount } from "@qorechain/sdk";

const account = await deriveUnifiedAccount(mnemonic);
account.cosmos; // "qor1…"   (bech32, Native lane)
account.evm;    // "0x…"     (EIP-55, EVM lane)
account.svm;    // base58    (20 bytes + 12 zero bytes)

La signature sur la voie native avec la même clé se fait via signClassicalEth / signHybridEth, et connectPhantomUnified dérive un compte unifié non custodial à partir d'une signature Phantom déterministe. Le deriveNativeAccount historique en coin-type 118 reste inchangé. Voir Comptes unifiés.

0.6.1 — correctif critique pour le consensus. L'extension de corps de transaction PQCHybridSignature est désormais encodée en protobuf (elle était encodée en JSON et rejetée à l'étape CheckTx). Les transactions hybrides construites avec un SDK ≤ 0.6.0 sont rejetées on-chain — mettez à niveau.

0.7.0 — voies d'authenticators (chaîne v3.1.85). Une clé Phantom (ed25519) ou MetaMask (secp256k1, par adresse de 20 octets) liée peut dépenser depuis le compte canonique exigeant la PQC via un relayer, selon des conditions à moindre privilège, plafonnées en dépenses et révocables : compositeurs MsgExecuteEVM / MsgExecuteCosmos / MsgRotatePQCKey, assistants evmAuthSignBytes / cosmosAuthSignBytes / rotationSignBytes exacts à l'octet près, la requête permissionSchema, des codes d'erreur décodés, et des constructeurs de wallet TypeScript (buildPhantomExecuteCosmos, buildMetaMaskExecuteEvm, …). Guide complet avec exemples à copier-coller : Authenticators & dépenses déléguées.

Pour aller plus loin​