Passa al contenuto principale

Installazione

Installa l'SDK per il tuo linguaggio. Il core TypeScript (@qorechain/sdk), gli adattatori EVM e SVM (@qorechain/evm, @qorechain/svm), il kit React (@qorechain/react) e i client Python, Go, Rust e Java sono tutti pubblicati sui rispettivi registry con piena parità con la catena nativa (messaggi tipizzati, query, il ciclo di vita delle tx, transazioni PQC ibride e sottoscrizioni WebSocket). La release corrente è la 0.14.0, pubblicata il 12 novembre 2026 (verificata sui registry il 12 novembre 2026):

RegistryPacchettoVersione
npm@qorechain/sdk, @qorechain/react, @qorechain/evm, @qorechain/svm, create-qorechain-dapp0.14.0 (anche create-qorechain-dapp; porta anche le correzioni ai template della 0.13.1)
PyPIqorechain-sdk (import qorsdk)0.14.0
crates.ioqorechain-sdk (import qorechain)0.14.0
Proxy dei moduli Gogithub.com/qorechain/qorechain-sdk/packages/gov0.14.0
Maven Centralio.github.qorechain:qorechain-sdk0.14.0 (JDK 17 o successivo)

Non esiste una 0.11.0 per Python, Rust, Go o Java: i pacchetti npm hanno avuto una 0.11.0 il 29 ottobre 2026 (il kit di sviluppo della catena, vedi sotto) e ogni linguaggio è passato dalla 0.10.0 alla 0.12.0 insieme. La 0.13.0 è seguita l'11 novembre 2026 e la 0.14.0 il 12 novembre 2026 in ogni linguaggio.

Scegli il tuo linguaggio qui sotto.

Note di aggiornamento​

Usa l'SDK 0.8.1 o successivo sulle reti live

Entrambe le reti pubbliche verificano la forma sign-bytes ibrida v2 (con tag di dominio e vincolata al chain id) e rifiutano la vecchia forma con il codice pqc 21. Ogni release dell'SDK precedente alla 0.8.0 firma la vecchia forma, e la 0.8.0 cerca il passaggio sotto uno solo dei due nomi di aggiornamento usati dalle reti (la mainnet lo ha registrato come v3.2.0, la testnet come v3.1.98 e poi v3.2.0), quindi firma la forma sbagliata su mainnet. Usa la 0.14.0 (o almeno la 0.8.1) in ogni linguaggio; serve la 0.8.2 o successiva per aprire una finestra di autorizzazione EVM. I builder ibridi accettano un'opzione signBytesVersion ("auto" | "v1" | "v2"); "auto" interroga la rete e quindi richiede l'endpoint REST (rest) su qorechain-vladi / qorechain-diana: solleva un errore invece di tirare a indovinare. Vedi Quale forma di sign-bytes?. La forma non è cambiata nella chain v3.2.3 né nella v3.2.4 (la v3.2.4 gira sulla testnet dal 19 ottobre 2026 e sulla mainnet dal 23 ottobre 2026; la v3.2.5 e la v3.2.6 non hanno cambiato nulla qui; la mainnet esegue la v3.2.7 dal 12 novembre 2026): "auto" si risolve in v2 su entrambe le reti, perché entrambe hanno applicato l'aggiornamento che è passato a essa.

Cosa cambia la 0.14.0​

L'SDK 0.14.0 (12 novembre 2026) è una sola release per tutti i linguaggi: TypeScript, Python, Go, Rust e Java, con @qorechain/react, @qorechain/evm, @qorechain/svm e create-qorechain-dapp (che porta anche le correzioni ai template della 0.13.1). Aggiunge il supporto client per la chain v3.2.8. Le nuove regole valgono su una rete una volta che esegue la v3.2.8: la testnet qorechain-diana la esegue dal 12 novembre 2026; la mainnet non l'ha applicata. Sulle reti precedenti i nuovi campi restano facoltativi.

AreaNella 0.14.0
Collegamento di una chiaveRichiede una prova di possesso. I builder e i firmatari per ed25519, secp256k1 ed EIP-191 (personal_sign) firmano un messaggio di collegamento in chiaro che nomina la chain, l'account, lo schema e la chiave. I composer di registrazione rifiutano una prova vuota
Chiavi che muovono valoreUna chiave con send, evm, deploy, svm o all richiede che la prima regola di spesa abilitata dell'account limiti ogni denom. Un helper costruisce l'aggiornamento della regola di spesa e il collegamento come coppia in un'unica transazione firmata dal proprietario, e controlla la regola
Parametri di governanceI composer MsgUpdateParams di crossvm, svm e rdk richiedono ogni campo (la chain sostituisce i parametri per intero). Nuovi helper costruiscono l'aggiornamento a partire dai parametri attuali letti dalla rete. Il composer svm rifiuta enabled finché il tetto rigido di custodia è 0
Query cross-VM in sospesoLa query paginata ora restituisce ogni pagina
Risultati di esecuzioneMsgExecuteEVM e MsgExecuteCosmos possono fallire con success=false dentro una transazione con codice 0 (il nonce viene consumato). Nuovi helper decodificano le risposte e il motivo del fallimento, e lanciano un errore su un'esecuzione fallita
Chiamate asincrone cross-VMAccettano async_gas_limit e async_max_factor
Ambito della finestra EVMNuovi campi validators, staking_validators e ibc_receivers
GasLe transazioni EVM sopra 30.000.000 (letto da evm_limits) e le transazioni Cosmos sopra 50.000.000 vengono rifiutate prima della firma. Le transazioni CosmWasm e cross-VM ricevono almeno 1,3 volte il gas simulato e mai un valore di ripiego fisso
Prezzo minimo del gasHelper facoltativi leggono il prezzo minimo del gas della rete; il prezzo del gas predefinito non cambia
ProtosIl codice generato in tutti e cinque i linguaggi segue la v3.2.8

Il lato wallet della stessa modifica è in @qorechain/wallet-adapter 0.6.0.

Cosa cambia la 0.13.0​

L'SDK 0.13.0 (11 novembre 2026) è una sola release per tutti i linguaggi: TypeScript, Python, Go, Rust e Java, con @qorechain/react, @qorechain/evm, @qorechain/svm e create-qorechain-dapp. Ha una modifica incompatibile, all'helper di account per il percorso da seed. Gli account derivati da un mnemonico non cambiano, e lo stesso vale per il formato della firma ibrida e per il comportamento della chain: una transazione costruita con la 0.12.0 resta valida.

Modifica incompatibile. Gli helper del percorso da seed unifiedAccountFromSeed (TypeScript), unified_account_from_seed (Python, Rust), unified.UnifiedAccountFromSeed (Go) e UnifiedAccounts.unifiedAccountFromSeed (Java) richiedono ora esattamente uno tra due input: un codice di recupero QRC1, oppure un segreto PQC indipendente di 32 byte. La chiave ML-DSA-87 viene derivata da quel secondo segreto. Chiamare l'helper senza alcuna opzione, o con più di una, solleva un errore.

L'opzione legacySeedDerivation (Python legacy_seed_derivation=True, Go LegacySeedDerivation, Rust SeedPqcOptions::legacy_seed_derivation(), Java SeedPqcOptions.legacy()) è facoltativa. Usala solo per recuperare la chiave PQC di un account creato prima della 0.13.0 così da poterla ruotare con MsgRotatePQCKey; non è per i nuovi account.

AreaNella 0.13.0
Helper del percorso da seedRichiedono un codice di recupero QRC1 o un segreto PQC indipendente di 32 byte (esattamente uno); nessuna opzione, o più di una, solleva un errore. Gli account da mnemonico non cambiano
legacySeedDerivationFacoltativa, solo per recuperare la chiave PQC di un account creato prima della 0.13.0 così da poterla ruotare con MsgRotatePQCKey
Codici di recupero QRC1Aggiunti in ogni linguaggio: generatePqcRecoveryCode, isValidRecoveryCode, normalizeRecoveryCode, pqcKeyFromRecoveryCode, pqcRecoveryCodeFromSecret (snake_case in Python e Rust; in Go GeneratePQCRecoveryCode, IsValidRecoveryCode, PQCKeyFromRecoveryCode, PQCRecoveryCodeFromSecret)
migrateToHybridRiporta keyVerified
Templatepnpm window recovery-code stampa un nuovo codice. Con PRIVATE_KEY, pnpm window legge QORE_PQC_RECOVERY_CODE e si ferma con un messaggio se manca; con QORE_MNEMONIC non cambia nulla. I template Foundry e Hardhat dipendono da ^0.13.0
Versione dei sign-bytes "auto"Legge prima la funzionalità di protocollo pqc-sign-bytes-v2 da /qorechain/pqc/v1/protocol_features, e ricade sui piani di aggiornamento applicati solo se quella lettura fallisce
getPqcStatus / get_pqc_statusSollevano un errore quando la risposta del nodo non ha il flag di registrazione, invece di riportare "non registrata"
PythonInterpreta in modo rigoroso i codici di risultato delle transazioni e i campi found e live della finestra EVM; wait_for_tx considera ancora in attesa una risposta senza tx_response o txhash

Opzioni del percorso da seed in ogni linguaggio. Passa esattamente una delle tre:

LinguaggioChiamataCodice di recuperoSegreto indipendente di 32 byteChiave precedente, solo recupero
TypeScriptunifiedAccountFromSeed(seed32, opts){ recoveryCode } (una stringa "QRC1-..."){ pqcSecret } (un Uint8Array di 32 byte, indipendente da seed32){ legacySeedDerivation: true }
Pythonunified_account_from_seed(seed32, ...)recovery_code=...pqc_secret=...legacy_seed_derivation=True
Gounified.UnifiedAccountFromSeed(seed32, opts)unified.SeedPQCOptions{RecoveryCode: ...}unified.SeedPQCOptions{PQCSecret: ...}unified.SeedPQCOptions{LegacySeedDerivation: true}
Rustunified_account_from_seed(seed32, opts)SeedPqcOptions::recovery_code(code)SeedPqcOptions::pqc_secret(secret32)SeedPqcOptions::legacy_seed_derivation()
JavaUnifiedAccounts.unifiedAccountFromSeed(seed32, opts)SeedPqcOptions.withRecoveryCode(code)SeedPqcOptions.withPqcSecret(secret32)SeedPqcOptions.legacy()

Le opzioni di Python sono solo per parola chiave. Un pqcSecret produce la stessa chiave del codice di recupero ricavato da esso con pqcRecoveryCodeFromSecret(secret32). TypeScript ha anche pqcKeyFromRecoveryCode(code, qor1).

Migrazione (TypeScript). Crea una sola volta un codice di recupero e conservalo separato dal seed:

import { generatePqcRecoveryCode, unifiedAccountFromSeed } from "@qorechain/sdk";

const recoveryCode = generatePqcRecoveryCode(); // once; store it apart from the seed
const account = unifiedAccountFromSeed(seed32, { recoveryCode });

Un account che ha registrato la sua chiave PQC con la 0.12 o precedenti carica la vecchia chiave con { legacySeedDerivation: true } e la ruota con rotatePqcKeyMsg:

const old = unifiedAccountFromSeed(seed32, { legacySeedDerivation: true });
// rotate it with rotatePqcKeyMsg, then use { recoveryCode } from then on

Conserva il codice di recupero: un codice diverso dà una chiave diversa.

Cosa aggiunge la 0.12.0​

L'SDK 0.12.0 è la release client per la chain v3.2.5, che la mainnet ha applicato all'altezza 3.906.833 il 29 ottobre 2026 (la testnet l'ha applicata il 26 ottobre). La mainnet esegue la v3.2.6 dal 4 novembre e la v3.2.7 dal 12 novembre; la testnet ha eseguito la v3.2.6 dal 27 ottobre, la v3.2.7 dal 6 al 12 novembre e la v3.2.8 dal 12 novembre; il formato di firma ibrida, gli indirizzi, i decimali e i memo non sono cambiati, quindi una transazione costruita con la 0.10.0 resta valida. TypeScript, Python, Go, Rust e Java passano tutti alla 0.12.0, insieme a @qorechain/react, @qorechain/evm, @qorechain/svm e create-qorechain-dapp. La release è stata verificata in ogni linguaggio con un invio bancario ibrido sulla testnet e con una chiave KEM registrata, riletta e rimossa lì, più letture sulla mainnet.

AreaNella 0.12.0
Endpoint pubblici per defaultI preset mainnet e testnet ora puntano agli endpoint pubblici (REST, RPC di consenso e JSON-RPC EVM su entrambe, più il WebSocket EVM sulla testnet) invece di localhost. Un semplice createClient() quindi parla con la testnet pubblica. Vedi Rete ed endpoint
Preset localnetLe porte localhost che ogni preset usava prima della 0.12.0, chain id qorechain-devnet. Selezionalo con createClient({ network: "localnet" }) per mantenere il vecchio comportamento
Gas esatto per le transazioni ibrideSu una rete che ha applicato la v3.2.5 la commissione "auto" di una transazione native ibrida è ceil(simulated x 1.02) + 2000, perché la simulazione ora addebita da sé la verifica post-quantistica. Un invio bancario ibrido richiede circa 171,600 di gas invece di circa 289,000, e la commissione scende di conseguenza. Le reti più vecchie, le transazioni classiche e una ricerca del piano fallita mantengono la regola precedente; un moltiplicatore che passi sostituisce entrambe le regole. exactHybridGas (e i suoi equivalenti in ogni linguaggio) e, in TypeScript, estimateGasDetails (riporta la simulazione, il limite di gas e quale regola lo ha impostato). Java ha guadagnato il percorso auto-gas
Registro delle chiavi ML-KEM-1024Un account pubblica una chiave di incapsulamento ML-KEM-1024 (algoritmo 2, 1,568 byte) così chiunque può cifrare verso di essa: msg.pqc.registerKemKey e msg.pqc.removeKemKey (la chiave viene controllata prima: dimensione, ogni coefficiente inferiore a 3329, non tutti zero), validateKemPublicKey, e la lettura fetchKemKey di /qorechain/pqc/v1/kem/{address} (bech32 o 0x). Entrambi i messaggi richiedono la firma ibrida. La route risponde su mainnet e testnet. L'SDK non cifra: per i payload sigillati vedi QoreSeal
Account astrattiLetture delle regole di spesa memorizzate di un account e delle sue chiavi collegate (comprese quelle revocate), MsgUpdateConfig (il messaggio di governance che attiva o disattiva il modulo), e authenticators_count nella vista dell'account
Controlli delle regole di spesaLe regole vengono controllate come le controlla la chain: un denom erc20/, erc721/ o erc1155/ deve indicare un indirizzo di contratto 0x. I codici abstractaccount 8 (regola di spesa non valida) e 9 (modulo disabilitato) sono nominati
Parametri di governanceIl MsgUpdateParams cross-VM (inclusi i contratti CosmWasm che il precompilato bridge EVM può chiamare) e il MsgUpdateParams del rollup, ciascuno controllato rispetto ai limiti della chain prima della firma. La lettura dei parametri cross-VM porta bridge_allowed_targets
Costante di upgrade e protoCHAIN_UPGRADE_V3_2_5; definizioni protobuf sincronizzate con la chain v3.2.5
Kit di sviluppo della catenaDalla 0.11.0 solo su npm e incluso nella 0.12.0: @qorechain/evm esporta le chain viem qorechain (9801) e qorechainTestnet (9800) e gli helper della finestra di autorizzazione EVM (evmWindowStatus, openEvmWindowMessage, anche come @qorechain/evm/window senza viem). create-qorechain-dapp ha i template foundry, hardhat, viem-wagmi e cosmwasm. @qorechain/react ha PqcStatusBadge (i vecchi nomi QuantumSafeBadge sono mantenuti come alias deprecati)
Correzioni@qorechain/svm con endpoint senza svmRpc usava localhost; ora dice che l'endpoint non è configurato. La generazione del codice Python indirizza gli import tra i proto QoreChain dentro il pacchetto

Cambiamento di comportamento da verificare quando aggiorni. Se il tuo codice si basava sul default localhost, seleziona localnet oppure passa endpoints. Gli endpoint pubblici della testnet hanno un limite di richieste per IP, quindi il traffico di produzione dovrebbe eseguire o usare un proprio nodo. Nessun preset imposta un endpoint gRPC o SVM sulle reti pubbliche (le transazioni SVM non sono aperte), e la mainnet non ha un WebSocket EVM pubblico: il codice che ne ha bisogno fallisce con un errore che nomina l'endpoint da passare, invece di ripiegare su localhost. In Rust gli endpoint opzionali sono ora Option<String>; in Python, Go e Java un endpoint non impostato è None, una stringa vuota e null.

I nodi non riportano la versione del loro binario. Per rilevare una funzionalità, chiedi a isUpgradeApplied per ogni nome di upgrade che la introduce, oppure leggi .version da https://download.qore.host/<net>/latest.json.

Cosa ha aggiunto la 0.10.0​

L'SDK 0.10.0 è la release client per la chain v3.2.4, che la mainnet ha applicato all'altezza 3.742.566 il 23 ottobre 2026 (la testnet l'ha applicata all'altezza 8.337.253 il 19 ottobre). Il formato di firma, gli indirizzi, i decimali, i memo e le commissioni non sono cambiati, e una transazione costruita con la 0.9.0 resta valida. La release è stata verificata in ogni linguaggio con transazioni reali sulla testnet. Non aveva builder per nulla di introdotto dopo la v3.2.4; le aggiunte della v3.2.5 sono arrivate con la 0.12.0. La mainnet esegue la v3.2.7 dal 12 novembre 2026 (altezza 4.164.600, proposta di governance 16; la v3.2.6 dal 4 novembre all'altezza 4.020.000; prima di essa la v3.2.5, dal 29 ottobre all'altezza 3.906.833) e la 0.10.0 continua a funzionare lì perché il formato di firma non è cambiato. La testnet ha applicato la v3.2.5 e la v3.2.6 il 26 e 27 ottobre 2026, la v3.2.7 il 6 novembre e la v3.2.8 il 12 novembre (nessuna release dell'SDK ha builder per i messaggi della v3.2.7, che sono sulla mainnet dal 12 novembre 2026). Che cosa ha portato la 0.10.0 (è tutto ancora nella 0.14.0):

AreaNella 0.10.0
Tier di staking (x/stakingtier)Composer lockDelegation (i controlli propri della chain: una durata di 3, 6 o 12 mesi e un importo intero positivo), unlockEarly, claimBonus e updateParams; letture per i parametri del modulo, i lock di un detentore e il pool dei bonus (fetchStakingTierParams, fetchStakingLocks, fetchStakingTierPool); i codici di errore del modulo. Ciò che fa il modulo è descritto in Staking e Delega
Nonce dell'authenticatorfetchAuthNonce({ rest, address, pubkey }) legge la sequenza che una chiave collegata deve firmare successivamente per MsgExecuteEVM / MsgExecuteCosmos da /qorechain/abstractaccount/v1/auth_nonce/{address}/{pubkey_hex}, invece di tracciarla a mano. Entrambe le reti servono la route; il modulo abstractaccount stesso è disattivato sulla mainnet (attivo sulla testnet), quindi una spesa sulla mainnet viene rifiutata prima che venga controllato qualsiasi nonce
Interruttori delle funzionalità di protocollofetchProtocolFeatures e isProtocolFeatureEnabled leggono quali regole di consenso una rete applica, per nome, da /qorechain/pqc/v1/protocol_features (entrambe le reti la servono). Una rete precedente alla v3.2.4 non serve la route; lì usa isUpgradeApplied
possessionProvenLo stato PQC indica se la chiave dell'account è stata registrata con una prova di possesso
ibcTimeoutTimestamp(seconds)Un timeout IBC assoluto nell'unità che MsgTransfer accetta (nanosecondi Unix). I timeout IBC sono orari assoluti; i pacchetti IBC v2 accettano secondi Unix assoluti, e un valore relativo lì viene rifiutato dopo l'addebito della commissione. Nessun canale IBC è aperto sulla mainnet (verificato il 27 ottobre 2026)
Costante di upgrade e protoCHAIN_UPGRADE_V3_2_4; definizioni protobuf sincronizzate con la chain v3.2.4 (nuovi campi nella registrazione dei validatori del bridge, nelle query dei light node e dei rollup)
ensurePqcRegisteredConfrontava uno stato privo di chiave pubblica come una corrispondenza; ora legge la chiave tramite rest e la confronta. Se non c'è nulla da cui leggerla, il risultato riporta keyVerified: false invece di affermare che la chiave è quella del chiamante
Rifiuti durante la simulazione della commissioneUn rifiuto della chain che arriva solo come testo (ad esempio "no bonus to claim") ora viene nominato a partire dalle descrizioni di errore registrate dalla chain in ogni linguaggio: decodeTxError (TypeScript), SimulationRefusedError (Python), tx.DecodeRefusalText (Go), tx::decode_refusal_text (Rust), TxError.decode (Java)

@qorechain/react e create-qorechain-dapp sono passati alla 0.10.0 insieme a essa; ora sono alla 0.14.0.

Cosa ha aggiunto la 0.9.0​

L'SDK 0.9.0 era la release client per la chain v3.2.2 e v3.2.3 (la mainnet le ha applicate alle altezze 3.556.788 e 3.662.051; la mainnet ha eseguito la v3.2.4 dal 23 ottobre 2026 (altezza 3.742.566) ed ha eseguito la v3.2.5 dal 29 ottobre, ha eseguito la v3.2.6 dal 4 novembre ed esegue la v3.2.7 dal 12 novembre 2026, e la testnet esegue la v3.2.4 o successive dal 19 ottobre 2026). Il formato di firma, gli indirizzi, i decimali, i memo e le commissioni non sono cambiati, quindi la forma sign-bytes ibrida v2 che firmano la 0.8.1 e le successive è ancora quella giusta. Le novità:

AreaNella 0.9.0 (e successive)
TxClient ibrido (TypeScript)Passa la coppia di chiavi dell'account: client.connectTx(signer, { pqcKeypair }) oppure TxClient.connect({ …, pqcKeypair, rest }). Ogni transazione viene allora firmata in modo ibrido e fee: "auto" simula la transazione ibrida stessa; una semplice registrazione di chiave resta classica (il percorso di bootstrap della chain). bankSend e i client rollup, multilayer e cross-VM dell'SDK lo usano. Senza una coppia di chiavi non cambia nulla
Chiave PQC recuperabilederivePqcCanonical(address, mnemonic) e i suoi equivalenti in ogni linguaggio (vedi Firma ibrida)
ensurePqcRegisteredLegge prima lo stato della chiave via REST (rest), rifiuta di registrare quando non riesce a stabilirlo, lancia PqcKeyMismatchError quando l'account detiene già una chiave diversa e tratta come successo il rifiuto «già registrata» della chain. Dalla chain v3.2.3 firma e allega da sé la prova di possesso; prima della v3.2.3 lascia il campo vuoto
Finestre EVM con ambito limitatoopenEvmWindowMsg accetta nativeOnly e allowedTargets (al massimo 16, senza duplicati); fetchEvmWindow rilegge entrambi (vedi la guida EVM)
Consenso EIP-7702authorizeEvmDelegationMsg, clearEvmDelegationMsg, fetchEvmDelegationConsent, evmDelegationTupleNonce, classifyEvmDelegationRejection
Integrità delle chiaviI builder di registrazione rifiutano classical_only, una chiave vuota e una chiave ML-DSA-87 degenere, che la chain rifiuta dalla v3.2.3. signProofOfPossession / verifyProofOfPossession sono esportate; migratePqcKeyHybrid invia il MsgMigratePQCKey firmato in modo ibrido che gli account con chiave richiedono dalla v3.2.3
Digest v2 dell'abstract accountevmAuthSignBytesV2 (vincola il gas limit della chiamata) e resolveEvmAuthDigestVersion. Il modulo abstractaccount è disattivato sulla mainnet (attivo sulla testnet), quindi sulla mainnet questo è solo di riferimento
Rilevamento degli upgradeisUpgradeApplied, requireUpgradeApplied: i nuovi campi opzionali vengono impostati solo dopo che applied_plan riporta la release, perché un nodo che non ha applicato una release rifiuta l'intera transazione quando viene impostato uno dei nuovi campi di quella release
Decodifica degli erroriUn fallimento all'interno di un blocco mantiene il suo codespace (per esempio pqc 231, non sdk_231); rate_limited e i codici di delega vengono decodificati; decodeTxError legge il log o il messaggio di un errore sollevato
Regole di spesavalidateSpendingRules viene eseguita nei builder di MsgUpdateSpendingRules e rifiuta una regola che non limita nulla
CorrezioniLa route dell'account PQC è la /qorechain/pqc/v1/account/{address} al singolare in ogni SDK (e in client.rest.getPqcAccount, isPqcRegistered e getPqcStatus quando ricevono il client composto); la VERSION esportata corrisponde al pacchetto; i client Go e Rust creati dall'SDK vanno in timeout invece di restare bloccati; i template di create-qorechain-dapp dipendono dalla release con cui vengono distribuiti

La derivazione PQC legacy per le nuove chiavi (derivePqcLegacy, "bridge") è deprecata: non è vincolata all'account, quindi una stessa mnemonic darebbe la stessa chiave a ogni account. Gli helper di rotazione la rifiutano come nuova chiave; recuperare o ruotare allontanandosi da una chiave legacy esistente funziona ancora.

Versioni precedenti alla 0.9.0​

Se sei sulla 0.8.x, firma ancora la forma che entrambe le reti verificano e funziona sulla mainnet e sulla testnet. Questi sono i limiti che la 0.9.0 ha rimosso, e alcuni di essi costano una commissione se non li conosci:

Release precedente alla 0.9.0Soluzione alternativa
Nessun builder per prova di possesso, finestre con ambito limitato o consenso EIP-7702Usa qorechaind tx pqc register-key-v2 … --pqc-key <name>, open-evm-window --native-only / --allowed-targets e authorize-evm-delegation / clear-evm-delegation (vedi Finestra di autorizzazione EVM, Deleghe EIP-7702)
ensurePqcRegistered senza status trasmetteva la registrazione senza controlli e segnalava successo quando era registrata una chiave diversaUna seconda registrazione per un account che detiene già una chiave viene rifiutata dopo che la commissione è stata prelevata. Leggi prima GET /qorechain/pqc/v1/account/{address} e passa status: { registered: found }
client.rest.getPqcAccount, isPqcRegistered, getPqcStatusChiamavano un percorso /accounts/ al plurale o il namespace qor_, che gli endpoint pubblici non servono (HTTP 501, -32601). Leggi la route REST al singolare indicata sopra
TxClient / bankSend e i client rollup, multilayer e cross-VM firmavano solo in modo classicoLe reti lo rifiutano per qualsiasi account che abbia una chiave. Invia tramite signAndBroadcastHybrid
Le transazioni fallite all'interno di un blocco perdevano il loro codespaceLeggi la transazione da GET /cosmos/tx/v1beta1/txs/{hash}
La costante VERSION esportata della 0.8.3 riportava 0.8.0Leggi la versione installata da package.json
create-qorechain-dapp 0.8.0 fissava @qorechain/sdk / @qorechain/evm a ^0.3.0 (un caret su una versione 0.x resta dentro la 0.3)Esegui npm i @qorechain/sdk@latest dopo la generazione
@qorechain/react 0.8.x lasciava illeggibile lo stato della chiave registrata sugli endpoint pubbliciUsa @qorechain/react 0.9.0 o successiva
Correzioni precedenti

L'SDK 0.6.1 ha corretto un bug critico per il consenso: l'estensione del tx-body /qorechain.pqc.v1.PQCHybridSignature veniva serializzata in JSON dentro Any.value e rifiutata dalla catena a CheckTx. Le transazioni ibride (PQC + classica) costruite con SDK ≤ 0.6.0 vengono rifiutate on-chain. La 0.8.0 ha rimosso gli helper di account con firma da wallet (vedi Account e firma PQC).

TypeScript​

Il pacchetto core:

npm i @qorechain/sdk

Ha come target Node.js 20+ e include ESM, CommonJS e definizioni di tipo. Gli esempi di transazioni ibride in questa documentazione importano anche StargateClient da @cosmjs/stargate (npm i @cosmjs/stargate).

Adattatore EVM​

@qorechain/evm è un adattatore sottile e type-safe sopra viem. viem è una peer dependency — installalo insieme:

npm i @qorechain/evm viem

Pubblicato su npm alla 0.14.0. Esporta le chain viem qorechain (chain id 9801) e qorechainTestnet (9800) e gli helper della finestra di autorizzazione EVM.

Adattatore SVM​

@qorechain/svm è un adattatore sottile sopra @solana/web3.js, che è una peer dependency:

npm i @qorechain/svm @solana/web3.js

Pubblicato su npm alla 0.14.0.

Kit React​

@qorechain/react è il livello React ufficiale sopra @qorechain/sdk — un provider, hook e i componenti ConnectButton / PqcStatusBadge. react (>=18) è una peer dependency:

npm i @qorechain/react

Pubblicato su npm alla 0.14.0; dipende da @qorechain/sdk ^0.14.0. Vedi la guida al kit React.

Scaffolder​

create-qorechain-dapp (npm, 0.14.0) genera una dApp pronta all'uso:

npm create qorechain-dapp@latest my-dapp

I file package.json generati dipendono dalla release dell'SDK con cui viene distribuito lo scaffolder (@qorechain/sdk ^0.14.0; i template EVM usano @qorechain/evm ^0.14.0). La versione 0.13.1 ha cambiato solo i template e la 0.14.0 ne porta le correzioni; vedi Scaffolder e CLI. Ha anche i template foundry, hardhat, viem-wagmi e cosmwasm per il lavoro sui contratti. La versione 0.8.0 dello scaffolder scriveva intervalli ^0.3.0, che su una versione 0.x restano dentro la 0.3 e non possono firmare per le reti live; se hai generato il progetto con la 0.8.0, esegui npm i @qorechain/sdk@latest. Vedi il riferimento della CLI.

Python​

pip install qorechain-sdk

Richiede Python 3.10+. Il pacchetto include type hint e un marcatore py.typed.

La distribuzione si installa come qorechain-sdk (pubblicato su PyPI alla 0.14.0) ma si importa come qorsdk:

import qorsdk

Go​

go get github.com/qorechain/qorechain-sdk/packages/go/...

Richiede Go 1.23+. Importa i sotto-pacchetti che ti servono, per esempio:

import (
"github.com/qorechain/qorechain-sdk/packages/go/qorechain/client"
"github.com/qorechain/qorechain-sdk/packages/go/qorechain/accounts"
)

Pubblicato come modulo Go autonomo (tag packages/go/v0.14.0). Fissa la versione in modo esplicito: go get github.com/qorechain/qorechain-sdk/packages/go@v0.14.0.

Rust​

cargo add qorechain-sdk

Oppure, per seguire la head del repository:

[dependencies]
qorechain-sdk = { git = "https://github.com/qorechain/qorechain-sdk" }
tokio = { version = "1", features = ["macros", "rt-multi-thread"] }

Richiede Rust 1.74+. I client di lettura sono asincroni (Tokio). Il crate si importa come qorechain (use qorechain;).

Pubblicato su crates.io come qorechain-sdk (0.14.0); cargo add qorechain-sdk installa l'ultima release.

Java​

Maven (pom.xml):

<dependency>
<groupId>io.github.qorechain</groupId>
<artifactId>qorechain-sdk</artifactId>
<version>0.14.0</version>
</dependency>

Oppure Gradle:

implementation 'io.github.qorechain:qorechain-sdk:0.14.0'

Pubblicato su Maven Central come io.github.qorechain:qorechain-sdk (la 0.14.0 è la versione corrente). Richiede JDK 17 o successivo. Central non ha alcuna build 0.8.0 o 0.8.1, quindi sulle reti live usa la 0.8.2 o successiva. La 0.9.1 era una release solo Java che ha portato Bouncy Castle dalla 1.80 alla 1.85 senza modifiche all'API.

PacchettoScopoVersione
@qorechain/wallet-adapterHelper lato wallet: generazione del wallet (generateQoreWallet), firma ibrida eth_secp256k1 (signHybridEth, QoreChainSigner), registrazione della rete in MetaMask (addQoreEvmToWallet), builder di messaggi per authenticator e finestre EVM (il suo openEvmWindowMsg costruisce solo la forma senza ambito limitato), il digest v2 dell'abstract account. Non allega una prova di possesso. Peer dependency: @cosmjs/proto-signing e @cosmjs/stargate ^0.32 (l'SDK usa cosmjs 0.39, quindi installarli entrambi nello stesso progetto fa segnalare a npm un conflitto di peer, ERESOLVE; tienili in progetti separati oppure passa --legacy-peer-deps)0.5.0
@qorechain/chain-bridgeWorker lato server per i backend: deriva la chiave PQC, firma in modo ibrido e trasmette (sendTokens, registerPqc e altro). Passa cosmosRest: con esso, una registrazione include la prova di possesso una volta che la rete ha applicato la v3.2.3, e un rifiuto dall'aspetto PQC viene verificato sulla chain prima di qualsiasi nuova registrazione (una chiave registrata diversa solleva pqc_key_mismatch invece di pagare una seconda registrazione)0.2.3
@qorechain/pqcPrimitive ML-DSA / ML-KEM / SHAKE-256 solo conformi agli standard e hybridSignBytes (vedi Firma post-quantistica); anche su PyPI, crates.io, Maven Central e sul proxy Go (Go v0.2.3) alla stessa versione0.2.3
@qorechain/handlesRisoluzione verificata degli @handle (HandleClient): fornisci tu la chiave pubblica del registro e un archivio dei pin, e fai il pin dopo che l'utente ha visto l'indirizzo; il pacchetto non fa mai il pin da solo. Vedi Chain bridge e handle0.1.0
@qorechain/connectDeprecato su npm e non più mantenuto; non usarlo per nuovi lavori. Usa invece @qorechain/wallet-adapter (le alternative per la connessione a QoreX sono nella panoramica degli strumenti per sviluppatori). Un unico connettore per wallet EVM, Cosmos e SVM, costruito sul wallet adapter (il suo intervallo di peer è @qorechain/wallet-adapter ^0.2.1, che non include la 0.5.0). Non apre una finestra di autorizzazione EVM, quindi un invio EVM tramite esso viene rifiutato finché l'account non ha una chiave registrata e una finestra aperta0.2.1
@qorechain/rdkClient del Rollup Development Kit (vedi Rollup). Dalla 0.7.0 dipende da @qorechain/sdk ^0.10.0 e @qorechain/evm ^0.8.0 (verificato su npm, 4 novembre 2026). Un caret su una versione 0.x resta dentro quella minor, quindi un'app con l'SDK 0.13.0 riceve per il kit una seconda copia annidata dell'SDK 0.10.x; tienile separate (non passare un client da una copia all'altra) finché una release del kit non passa alla 0.13. Firma in modo ibrido solo quando passi una pqcKeypair; le letture funzionano senza. Pubblicato anche come qorechain-rdk su PyPI, crates.io e Maven Central e come modulo Go (fissa @v0.8.0); dalla 0.8.0 anche questi quattro client firmano in modo ibrido (le versioni precedenti firmavano solo in modo classico; Java richiede Java 21). Vedi RDK 0.8.0: modifiche e limiti0.9.0
@qorechain/rdk-cliLa CLI operatore qorollup per l'RDK. Dalla 0.7.1 i suoi comandi di transazione (create, pause, resume, stop, withdraw) firmano in modo ibrido (la 0.7.0 e le precedenti firmavano solo in modo classico e venivano rifiutate dalle reti); installata da npm funziona e --version stampa la versione installata (la 0.6.1 e le precedenti non stampavano nulla)0.9.0
@qorechain/qoresealQoreSeal: cifra un payload verso le chiavi ML-KEM-1024 che gli account pubblicano nel registro KEM (l'SDK 0.12.0 e successivi registrano e leggono le chiavi; QoreSeal fa la cifratura). Anche su PyPI (qorechain-qoreseal; wheel per macOS e Linux, wheel per Windows nella prossima versione), crates.io, Maven Central (io.github.qorechain:qoreseal e qoreseal-android; i consumer Kotlin richiedono Kotlin 2.3 o successivo), il proxy dei moduli Go (github.com/qorechain/qoreseal/go, Go v0.1.0) e come pacchetto Swift. Vedi QoreSeal0.1.0
@qorechain/asset-kitAsset Kit: strumenti per token di asset del mondo reale con permessi sull'EVM Engine, con client in TypeScript, Python, Java e Go e contratti Solidity (forge install qorechain/qorechain-asset-kit@v0.1.0). Apache-2.0, tranne gli script e i test ERC-3643 (GPL-3.0-or-later). I moduli nativi che descrive sono una proposta, non costruiti. Anche qorechain-asset-kit su PyPI e io.github.qorechain:asset-kit su Maven Central. Vedi Asset Kit0.1.0
@qorechain/qoresignQoreSign: firma per wallet e backend, e inspectTransaction per verificare il livello post-quantistico di una transazione confermata. Anche su PyPI, crates.io e Maven Central. Vedi QoreSign0.2.0
create-qorechain-rollupScaffolder di starter per rollup; i suoi template dipendono da @qorechain/rdk ^0.9.0 e firmano in modo ibrido quando riescono a risolvere la tua chiave post-quantistica da QORE_MNEMONIC o QORE_PQC_SEED_HEX0.9.0

Avanti​

Continua con il Quickstart per connetterti e leggere lo stato on-chain.