Perché QoreChain SDK
Il QoreChain SDK ti offre tutto ciò che offre un moderno SDK multi-chain — messaggi tipizzati per ogni modulo, query tipizzate, account per tre VM da un unico mnemonic, auto-gas, decodifica degli errori, sottoscrizioni, wallet e un kit React.
Ma cinque funzionalità sono possibili solo su QoreChain, perché sono costruite su caratteristiche di protocollo che nessun altro Layer 1 possiede: AI on-chain, tre VM co-residenti con un bridge nativo, crittografia post-quantistica obbligatoria, un'unica identità da 20 byte su tutte e tre le corsie VM e spesa delegata sicura per la PQC per chiavi di wallet esterni. Questi sono i motivi per costruire qui.
1. Valutazione del rischio pre-flight con AI
Analizza una transazione con l'AI on-chain prima di trasmetterla (richiede che i precompile AI siano attivi sulla rete di destinazione, cosa che non è ancora vera sulle reti pubbliche).
QoreChain integra l'analisi del rischio con AI nei precompile EVM. L'SDK li invoca per te e restituisce il gas più un verdetto di rischio/anomalia in una singola chiamata — così un wallet o una dApp può avvisare (o bloccare) prima della firma. I precompile AI non sono ancora attivi su mainnet né su testnet (vedi Precompile EVM: stato della rete).
import { createEvmClient, simulateWithRiskScore } from "@qorechain/evm";
const { publicClient } = await createEvmClient({ endpoints: { evmRpc } });
const preflight = await simulateWithRiskScore(publicClient, {
from: account.address,
to: contractAddress,
data: calldata,
value: 0n,
});
console.log(preflight.gas); // estimated gas
console.log(preflight.risk.level); // on-chain risk level
console.log(preflight.anomaly.flagged);// anomalous pattern?
if (!preflight.safe) {
// advisory verdict — set your own policy
console.warn("Transaction flagged by on-chain AI risk scoring");
}
Perché è diverso: la valutazione è progettata per essere eseguita
all'interno della chain come precompile deterministico (aiRiskScore a
0x…0B01, aiAnomalyCheck a 0x…0B02), non come servizio off-chain. Finché
quei precompile non vengono attivati, gli helper qui sopra generano un errore
sulle reti pubbliche (returned no data ("0x"); i tre precompile attivi della testnet sono quelli PQC e di consenso, non questi). Vedi
AI pre-flight.
2. Chiamate cross-VM unificate — un account, tre VM, una transazione
Chiama un contratto su qualsiasi VM e raggruppa chiamate su tutte e tre in modo atomico.
QoreChain esegue contratti QoreChain Native, EVM e SVM sulla stessa chain con un bridge cross-VM nativo. L'SDK espone un'unica interfaccia per chiamarli tutti — e per raggruppare più chiamate cross-VM in una singola transazione atomica firmata una sola volta.
import { connectQueryClients, createCrossVMClient } from "@qorechain/sdk";
// rpcClient: a connected consensus-RPC client (the CosmJS RPC client type).
const crossVM = createCrossVMClient(tx, { query: connectQueryClients(rpcClient).crossvm });
// Call an EVM contract from a native account (payload ABI-encoded for you).
await crossVM.call({
targetVm: "evm",
targetContract: "0xToken…",
evm: { abi, functionName: "transfer", args: [recipient, amount] },
});
// One signature, three VMs, atomic: EVM → SVM → QoreChain Native.
await crossVM.callAtomic([
{ targetVm: "evm", targetContract: "0x…", evm: { abi, functionName: "approve", args } },
{ targetVm: "svm", targetContract: "Prog…", svm: { data } },
{ targetVm: "cosmwasm", targetContract: "qor1…", cosmwasm: { swap: {} } },
]);
Perché è diverso: QoreChain esegue tre VM co-residenti con un modulo bridge
nativo (crossvm, più il precompile CrossVMBridge una volta attivo; non è attivo sulla mainnet; la testnet lo ha attivo con una allowlist, testato con eth_call il 7 novembre 2026), così
un'unica interfaccia dell'SDK può indirizzarle tutte e tre. Le chain a VM
singola non hanno nulla di equivalente da incapsulare. Oggi la portata di una
chiamata è limitata dalla corsia a cui è destinata: MsgCrossVMCall è
disattivato su mainnet, le transazioni SVM sono disabilitate e il caricamento e
l'istanziazione di QoreChain Native sono soggetti ad autorizzazione (l'istanziazione è aperta sulla testnet). Vedi
Chiamate cross-VM.
3. Firma ibrida di default
Registra la chiave ML-DSA-87 di un signer con una sola chiamata.
QoreChain impone firme ibride post-quantistiche (ML-DSA-87 + classiche) a livello di protocollo. L'SDK rende la loro adozione una one-liner: verifica, registra e migra alla firma ibrida — con un badge React che mostra se un indirizzo ha una chiave registrata.
import { ensurePqcRegistered, migrateToHybrid } from "@qorechain/sdk";
// Registers the signer's ML-DSA-87 key on-chain unless the chain already has it:
// it reads the status over REST first and never registers blind.
const rest = "https://api.qore.host";
const { alreadyRegistered, txHash } = await ensurePqcRegistered(tx, { pqcKeypair, rest });
// Switch the signing path to hybrid (classical + post-quantum).
const hybrid = await migrateToHybrid(tx, { pqcKeypair, rest });
await hybrid.signAndBroadcastHybrid({
registry, signer, messages, fee, chainId, accountNumber, sequence,
rest: "https://api.qore.host", // resolves the v1/v2 PQC sign-bytes form
transport,
});
import { PqcStatusBadge } from "@qorechain/react";
// Shows a status badge when the address has a registered PQC key
// (read over REST, so it works on the public endpoints from `@qorechain/react` 0.9.0 and later).
<PqcStatusBadge address={account.address} />
Perché è importante: la crittografia post-quantistica è nativa e obbligatoria sul percorso Native di QoreChain, non un esperimento, e l'SDK ne riduce l'adozione a una chiamata di registrazione più un percorso di invio ibrido. La registrazione è esplicita: non esiste una registrazione automatica alla prima transazione. Vedi Firma ibrida.
4. Account eth-native unificati — una chiave, tre indirizzi, un saldo
Una chiave eth_secp256k1 è un'unica identità da 20 byte su tutte e tre le
corsie. (SDK 0.6.0, chain v3.1.83.) La corsia delle transazioni SVM è oggi
disabilitata a livello di intera rete, e la corsia EVM richiede una
finestra di autorizzazione; il saldo condiviso e la
mappatura degli indirizzi valgono comunque.
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 — SVM lane (same 20 bytes + 12 zero bytes)
// A deposit to ANY of the three lands in ONE balance,
// and the same key signs on every enabled lane (signHybridEth on the Native path).
Perché è unico: negli assetti multi-VM altrove, ogni runtime ha il proprio spazio di account e i fondi rimangono bloccati per corsia. QoreChain rende un'unica identità da 20 byte in tre modi con un unico saldo condiviso — un wallet non "ha fondi su una corsia ma non su un'altra". Un wallet esterno come Phantom può essere collegato a questa identità come authenticator limitato (Authenticator). Vedi Account unificati.
5. Corsie authenticator — spesa delegata senza rinunciare alla PQC
Una chiave Phantom o MetaMask collegata spende dall'account canonico che richiede la PQC, entro limiti, tramite un relayer. (SDK 0.7.0, chain v3.1.85.)
Il modulo abstractaccount è disattivato su qorechain-vladi
(GET /qorechain/abstractaccount/v1/config restituisce "enabled": false), e
dalla chain v3.2.0 quel flag viene applicato su ogni percorso, quindi sulla
mainnet una chiave non può essere collegata e le corsie qui sotto non possono
essere usate. Il modulo è abilitato sulla testnet qorechain-diana (verificato
il 27 ottobre 2026). Vedi la
guida agli Authenticator.
import { buildPhantomExecuteCosmos } from "@qorechain/sdk";
// The Phantom key signs a domain-separated digest; a relayer pays fees and
// broadcasts. The external key NEVER produces an ML-DSA co-signature.
const msg = await buildPhantomExecuteCosmos({
wallet: window.solana,
relayer: relayerAddress,
chainId: "qorechain-vladi",
account: canonicalAccount, // the PQC-required owner
to: recipient,
amount: "100uqor",
nonce, // per-authenticator sequence
});
Perché è importante: una volta abilitato il modulo, ogni spesa di una chiave collegata è vincolata
da una tassonomia di permessi on-chain, da limiti SpendingRule e da una
scadenza — privilegio minimo e revocabile — mentre l'account stesso resta
protetto a livello post-quantistico. Vedi
Authenticator e spesa delegata.
E anche tutto il resto
Oltre ai cinque elementi distintivi, l'SDK copre l'intera superficie della
chain in TypeScript, Python, Go, Rust e Java: composer tipizzati per ogni
modulo (incluse sidechain/paychain tramite multilayer e rollup tramite
rdk), query tipizzate, il ciclo di vita delle tx, sottoscrizioni, wallet
browser e il kit di hook @qorechain/react.
Pronto a costruire? Inizia con il Quickstart.