Sari la conținutul principal

SDK-ul QoreChain

SDK-ul QoreChain este kitul oficial de dezvoltare multi-limbaj pentru construirea de aplicații descentralizate pe QoreChain — o rețea Layer 1 cu triplu VM și semnături hibride ML-DSA-87 (FIPS 204).

Această documentație acoperă modul de instalare a SDK-ului, conectarea la rețea, citirea stării on-chain, derivarea conturilor, semnarea și trimiterea tranzacțiilor, precum și lucrul cu fiecare dintre mașinile virtuale ale QoreChain.

Ce este QoreChain?​

QoreChain este un blockchain Layer 1 cu trei runtime-uri de contracte inteligente de primă clasă pe un singur lanț:

  • QoreChain Native — contracte inteligente Wasm prin Cosmos SDK (runtime-ul CosmWasm).
  • QoreChain EVM Engine — execuție compatibilă Ethereum (Solidity, viem, JSON-RPC standard).
  • SVM — un runtime compatibil Solana, cu un JSON-RPC în stil Solana.

Conturile, soldurile și token-urile sunt partajate între runtime-uri, iar lanțul include modulul IBC pentru interoperabilitate cross-chain (niciun canal IBC nu este deschis pe mainnet; testnet-ul are un canal transfer deschis către un lanț de test, verificat la 27 octombrie 2026).

Ce funcționează astăzi pe rețelele live (mainnet-ul rulează v3.2.7, testnet-ul v3.2.8)

Funcționează: citiri pe fiecare bandă, tranzacții Native semnate hibrid, conturi unificate, tranzacții EVM în interiorul unei ferestre de autorizare și citiri SVM. Încă indisponibile: precompilele EVM pe mainnet (niciuna nu este activă acolo; testnet-ul are trei active, verificare PQC, starea cheii PQC și parametrii de consens, iar perechea AI și puntea cross-VM sunt inactive pe ambele), spațiul de nume JSON-RPC qor_, tranzacțiile SVM, apelurile cross-VM pe mainnet (MsgCrossVMCall este oprit de circuit breaker), încărcarea și instanțierea QoreChain Native pentru conturile obișnuite (pe testnet, instanțierea este deschisă, iar încărcarea nu), fluxurile de autentificator / cont abstract pe mainnet (modul oprit acolo, activat pe testnet), xQORE și abstractizarea gazului. Fiecare ghid repetă avertismentul acolo unde se aplică. Verificat față de endpoint-urile live la 27 octombrie 2026; pe 7 noiembrie 2026 lista precompilărilor active a mainnet-ului era în continuare goală, în timp ce lista testnet-ului conținea și puntea cross-VM 0x…0901 (activă cu o listă de permisiuni; un eth_call doar-citire a fost testat pe 7 noiembrie 2026).

SDK-ul publicat (0.14.0, 12 noiembrie 2026) semnează în forma pe care o verifică ambele rețele (sign-bytes hibrid v2, stabilit din starea lanțului), iar formatul de semnare, adresele, zecimalele, memo-urile și comisioanele nu s-au schimbat în v3.2.3, v3.2.4, v3.2.5 sau v3.2.6 (mainnet-ul rulează v3.2.7 din 12 noiembrie 2026, înălțimea 4.164.600, propunerea de guvernanță 16, după v3.2.6 pe 4 noiembrie; testnet-ul din 27 octombrie, iar din 6 noiembrie testnet-ul a rulat v3.2.7 și din 12 noiembrie rulează v3.2.8, care adaugă mesaje pentru care SDK 0.14.0 are constructori; regulile noi ale testnet-ului se aplică de la v3.2.8, iar mainnet nu l-a aplicat; mesajele v3.2.7 sunt pe mainnet din 12 noiembrie 2026). Poartă partea de client a regulilor post-cuantice ulterioare (dovada de posesie la înregistrarea cheii, ferestre EVM cu domeniu restrâns, mesaje de consimțământ EIP-7702) și a lui v3.2.4 (niveluri de staking, nonce-ul autentificatorului, comutatoarele de funcționalități de protocol) și a lui v3.2.5 (gaz exact pentru tranzacțiile hibride, registrul de chei ML-KEM); versiunile anterioare lui 0.9.0 nu o au pe prima, vezi Versiuni anterioare lui 0.9.0, Ce adaugă 0.12.0 Ce schimbă 0.13.0 și Ce schimbă 0.14.0.

Semnare pentru portofele și backend-uri: vezi QoreSign.

Semnare hibridă ML-DSA-87​

QoreChain oferă primitive de criptografie post-cuantică (PQC) bazate pe ML-DSA-87 (Dilithium-5, FIPS 204). Alături de semnarea clasică secp256k1, lanțul suportă o postură de semnare hibridă, în care o tranzacție poartă atât o semnătură clasică, cât și o semnătură post-cuantică, astfel încât rămâne validă sub verificarea clasică de astăzi, câștigând în același timp protecție post-cuantică.

SDK-ul expune astăzi generarea de chei, semnarea și verificarea ML-DSA-87, plus blocurile de construcție pentru tranzacții hibride. Pe rețelele live, o tranzacție pe calea Native trebuie să fie semnată hibrid, iar cheia ML-DSA-87 a contului trebuie înregistrată mai întâi. Vezi Conturi și semnare PQC pentru detalii. Fără afirmații de marketing aici — SDK-ul expune exact primitivele pe care lanțul le implementează.

Ce diferențiază acest SDK​

Dincolo de paritatea multi-chain completă, trei capabilități sunt posibile doar pe QoreChain, deoarece sunt construite pe funcționalități de protocol pe care niciun alt Layer 1 nu le are:

  • Scorare de risc AI înainte de trimitere — scanează o tranzacție cu AI on-chain înainte de a o difuza. simulateWithRiskScore returnează gazul plus un verdict de risc/anomalie de la precompilări EVM deterministe, astfel încât un portofel sau un dApp poate avertiza (sau bloca) înainte de semnare. Precompilele AI nu sunt încă active pe mainnet sau testnet. Vezi AI pre-flight.
  • Apeluri cross-VM unificate — un cont, trei VM-uri, o singură tranzacție. createCrossVMClient apelează un contract pe oricare VM, iar callAtomic împachetează mai multe apeluri cross-VM într-o singură tranzacție atomică, semnată o singură dată. Vezi Apeluri cross-VM.
  • DX pentru semnare hibridă — înregistrează cheia ML-DSA-87 a unui semnatar într-un singur apel idempotent (ensurePqcRegistered / migrateToHybrid), cu un badge React gata de utilizare. Vezi Semnare hibridă.

Alte două capabilități la nivel de lanț au sosit în 0.6.0 și 0.7.0 (a doua nu poate fi folosită încă pe rețelele live, vezi mai jos):

  • Conturi eth-native unificate — o singură cheie eth_secp256k1 este o singură identitate de 20 de octeți redată ca qor1…, 0x… și o adresă SVM base58, toate partajând un singur sold. Vezi Conturi unificate.
  • Benzi de autentificatori — leagă o cheie Phantom sau MetaMask de contul canonic cu PQC obligatoriu și las-o să cheltuiască printr-un relayer, în condiții de privilegii minime, cu limite de cheltuieli și revocabile. Modulul abstractaccount din spatele ei este oprit pe mainnet și activat pe testnet. Vezi Autentificatori și cheltuire delegată.

Un nou kit @qorechain/react (provider, hooks, ConnectButton, PqcStatusBadge) face din construirea unui dApp cu semnare hibridă ML-DSA-87 calea implicită — vezi ghidul kitului React. Pentru argumentația completă, citește De ce QoreChain SDK.

Familia SDK​

SDK-ul este livrat ca o familie de pachete, astfel încât să poți construi în limbajul preferat. Acestea partajează aceleași preset-uri de rețea, scheme de derivare, aritmetică a denominărilor și suprafețe de citire.

PachetLimbajInstalareStare
@qorechain/sdkTypeScriptnpm i @qorechain/sdkPublicat (npm, v0.14.0)
qorechain-sdkPythonpip install qorechain-sdk (import qorsdk)Publicat (PyPI, v0.14.0)
qorechain-sdk (modul Go)Gogo get github.com/qorechain/qorechain-sdk/packages/go/...Publicat (Go proxy, tag packages/go/v0.14.0)
qorechain-sdkRustcargo add qorechain-sdk (import qorechain)Publicat (crates.io, v0.14.0)
io.github.qorechain:qorechain-sdkJavaio.github.qorechain:qorechain-sdk:0.14.0Publicat (Maven Central, v0.14.0; JDK 17+)
@qorechain/evmTypeScript (adaptor EVM)npm i @qorechain/evm viemPublicat (npm, v0.14.0)
@qorechain/svmTypeScript (adaptor SVM)npm i @qorechain/svm @solana/web3.jsPublicat (npm, v0.14.0)
@qorechain/reactTypeScript (kit React)npm i @qorechain/reactPublicat (npm, v0.14.0)
create-qorechain-dappCLInpm create qorechain-dappPublicat (npm, v0.14.0)

Distribuția Python se instalează ca qorechain-sdk, dar se importă ca qorsdk. Toți clienții sunt publicați în registrele lor — vezi Instalare pentru comenzile specifice fiecărui limbaj.

Nucleul TypeScript (@qorechain/sdk) stă la baza exemplelor din această documentație. Clienții Python, Go, Rust și Java ating paritate completă cu lanțul nativ față de TypeScript: preset-uri de rețea, utilitare pentru denominare/adrese, derivare HD a conturilor (nativ/EVM/SVM), semnare PQC (ML-DSA-87), compozitori de mesaje tipizați pentru fiecare modul personalizat plus modulele Cosmos standard, clienți de interogare tipizați, ciclul de viață complet al tranzacției (auto-gas, decodarea erorilor, urmărirea tranzacțiilor, căutare de blocuri/tranzacții), tranzacții post-cuantice hibride și abonamente WebSocket. Toți acești clienți sunt publicați: TypeScript pe npm (@qorechain/sdk 0.14.0), Python pe PyPI (qorechain-sdk 0.14.0, import qorsdk), Go pe module proxy (tag packages/go/v0.14.0), Rust pe crates.io (qorechain-sdk 0.14.0) și Java pe Maven Central (io.github.qorechain:qorechain-sdk 0.14.0). Adaptoarele de execuție EVM/SVM (@qorechain/evm, @qorechain/svm, ambele 0.14.0), kitul @qorechain/react (0.14.0) și CLI-ul de schelet create-qorechain-dapp (0.14.0, care poartă și corecțiile de șabloane din 0.13.1) sunt exclusiv TypeScript și, de asemenea, publicate pe npm. Vezi Instalare pentru pachetele însoțitoare.

Noutăți de la 0.6 la 0.14​

0.6.0 — conturi eth-native unificate (lanț v3.1.83). O singură cheie eth_secp256k1 este o singură identitate de 20 de octeți redată ca toate cele trei codificări de adresă, partajând un singur sold cheltuibil pe fiecare bandă:

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)

Semnarea pe banda nativă cu aceeași cheie se face prin signClassicalEth / signHybridEth, iar o cheie Phantom sau MetaMask se leagă de cont ca autentificator (derivarea dintr-o semnătură Phantom a fost eliminată în 0.8.0). Funcția moștenită deriveNativeAccount, cu coin-type 118, rămâne neschimbată. Vezi Conturi unificate.

0.6.1 — corecție critică pentru consens. Extensia de corp de tranzacție PQCHybridSignature este acum codificată protobuf (era codificată JSON și respinsă la CheckTx). Tranzacțiile hibride construite cu SDK ≤ 0.6.0 sunt respinse on-chain — actualizează.

0.7.0 — benzi de autentificatori (lanț v3.1.85). Modulul abstractaccount din spatele lor este oprit în prezent pe mainnet și activat pe testnet (vezi ghidul Autentificatori). O cheie legată Phantom (ed25519) sau MetaMask (secp256k1, după adresa de 20 de octeți) poate cheltui din contul canonic cu PQC obligatoriu printr-un relayer, în condiții de privilegii minime, cu limite de cheltuieli și revocabile: compozitori pentru MsgExecuteEVM / MsgExecuteCosmos / MsgRotatePQCKey, helperi cu octeți exacți evmAuthSignBytes / cosmosAuthSignBytes / rotationSignBytes, interogarea permissionSchema, coduri de eroare decodate și buildere de portofel TypeScript (buildPhantomExecuteCosmos, buildMetaMaskExecuteEvm, …). Ghid complet cu exemple gata de copiat: Autentificatori și cheltuire delegată.

0.8.0 – 0.8.3 — sign-bytes hibrid v2 și fereastra de autorizare EVM (lanț v3.2.0). Jumătatea post-cuantică a unei tranzacții hibride este acum semnată în forma pe care o verifică rețeaua țintă (v1 sau v2, signBytesVersion: "auto" | "v1" | "v2"). Ambele rețele publice sunt pe v2, așa că este necesar SDK 0.8.1 sau mai nou pentru a tranzacționa pe mainnet (folosește versiunea curentă). 0.8.2 adaugă openEvmWindowMsg, closeEvmWindowMsg, fetchEvmWindow și classifyEvmWindowRejection pentru fereastra de autorizare a benzii EVM. 0.8.0 a eliminat helperii de cont bazați pe semnătura portofelului (connectPhantomUnified și unifiedAccountFromPhantomSignature, eliminate în 0.8.0), aplică verificări stricte ale dimensiunilor ML-DSA-87 în fiecare limbaj și adaugă flag-ul async și datele returnate de callee la apelurile cross-VM. 0.8.3 corectează căutarea tranzacțiilor, cursele (race conditions) din hook-urile React, secvențierea migrate_to_hybrid din Python și derivarea PQC canonică independentă de forma adresei (derivePqcCanonical, canonicalAccount). Vezi Note de upgrade.

0.9.0 — suport de client pentru chain v3.2.2 și v3.2.3. TxClient din TypeScript semnează hibrid când transmiți perechea de chei a contului (client.connectTx(signer, { pqcKeypair })), astfel încât bankSend și clienții SDK-ului pentru rollup, multilayer și cross-VM funcționează pe rețelele publice. ensurePqcRegistered verifică mai întâi prin REST cheia înregistrată, refuză să înregistreze o a doua cheie, diferită, și atașează singur dovada de posesie după ce rețeaua a aplicat v3.2.3. Constructori noi acoperă ferestrele EVM cu domeniu restrâns (nativeOnly, allowedTargets) și mesajele de consimțământ EIP-7702, iar derivePqcCanonical(address, mnemonic) oferă în fiecare limbaj o cheie pe care o poți recupera din mnemonic. Ruta contului PQC este cea la singular /qorechain/pqc/v1/account/{address}, eșecurile din interiorul unui bloc își păstrează codespace-ul, iar create-qorechain-dapp generează proiecte pe SDK-ul curent. Vezi Ce a adăugat 0.9.0.

0.10.0 — suport de client pentru chain v3.2.4. Compozitori și citiri pentru nivelurile de staking (lockDelegation, unlockEarly, claimBonus, fetchStakingTierParams, fetchStakingLocks), fetchAuthNonce pentru următoarea secvență a unei chei legate, fetchProtocolFeatures / isProtocolFeatureEnabled pentru regulile de consens pe care o rețea le aplică după nume, possessionProven în starea PQC și ibcTimeoutTimestamp. ensurePqcRegistered compară acum cheia înregistrată în loc să se bazeze pe o stare fără ea, iar o refuzare din partea lanțului care sosește ca text în timpul simulării taxei este numită în fiecare limbaj. Vezi Ce a adăugat 0.10.0.

0.12.0 — suport de client pentru chain v3.2.5. Presetările mainnet și testnet folosesc acum implicit endpoint-urile publice (o presetare localnet, chain id qorechain-devnet, păstrează vechile porturi localhost). Comisionul "auto" al unei tranzacții hibride folosește regula exactă de gaz pe rețelele care au aplicat v3.2.5 (ceil(simulated x 1.02) + 2000, aproximativ 171.600 de gaz pentru un transfer bancar hibrid în loc de aproximativ 289.000). Registrul de chei ML-KEM-1024 are compozitori (msg.pqc.registerKemKey, msg.pqc.removeKemKey) și o citire (fetchKemKey), care răspunde pe mainnet. Există citiri pentru regulile de cheltuire ale abstract account și pentru cheile conectate, precum și constructori verificați pentru propunerile de parametri cross-VM și de rollup. Kitul pentru dezvoltatori de lanț (șabloane EVM și QoreChain Native, lanțuri viem pentru ambele rețele) face parte din ea. Nu a existat 0.11.0 în afara npm; celelalte limbaje au trecut de la 0.10.0 la 0.12.0. Vezi Ce adaugă 0.12.0.

0.13.0, o singură schimbare la helperul de cont pe calea cu seed. unifiedAccountFromSeed și echivalentele sale din celelalte limbaje cer acum un cod de recuperare QRC1 sau un secret PQC independent de 32 de bytes; conturile derivate dintr-o mnemonică, formatul de semnare și comportamentul lanțului rămân neschimbate. Helperele pentru codul de recuperare au fost adăugate în fiecare limbaj, iar migrateToHybrid raportează keyVerified. Vezi Ce schimbă 0.13.0.

0.14.0, suport client pentru lanțul v3.2.8. Legarea unei chei cere o dovadă de posesie, cheile care mută valoare cer o regulă de cheltuire (un helper construiește perechea), actualizările de parametri de guvernanță cer toate câmpurile, execuțiile autorizate eșuate pot fi citite, iar fereastra EVM primește încă trei liste. Regulile noi se aplică de îndată ce o rețea rulează v3.2.8: testnet-ul din 12 noiembrie 2026; mainnet nu l-a aplicat. Vezi Ce schimbă 0.14.0.

Unde să mergi mai departe​