Passa al contenuto principale

Architettura & concetti

QoreChain è una singola chain Layer 1 che esegue tre virtual machine per smart contract affiancate, con account condivisi e un token condiviso.

Il modello triple-VM​

VMContrattiSuperficie client nell'SDK
QoreChain NativeContratti Rust/Wasm (il runtime CosmWasm)client.cosmwasm() e gli helper queryContractSmart / execute in @qorechain/sdk
QoreChain EVM EngineSolidity / Vyper@qorechain/evm (un adapter viem)
SVMProgrammi Solana@qorechain/svm (un adapter @solana/web3.js)

Il layer nativo (Cosmos) gestisce i bank transfer, lo staking, la governance e il modulo x/crossvm che instrada i messaggi tra i runtime.

Superfici di lettura​

L'SDK comunica con un nodo attraverso diversi endpoint:

  • Cosmos REST (LCD) — saldi bank, info account, query dei moduli.
  • Consensus RPC — usato per firmare/trasmettere transazioni native e per il read client QoreChain Native.
  • EVM JSON-RPC — chiamate standard eth_*, net_*, web3_* e txpool_* sugli endpoint pubblici. Il namespace QoreChain qor_* e i precompile EVM non sono ancora disponibili lì (vedi sotto).
  • SVM JSON-RPC — RPC compatibile con Solana per il runtime SVM (sola lettura sugli endpoint pubblici; l'invio di transazioni SVM è disabilitato su tutta la rete).

Sui nodi che lo abilitano, il namespace JSON-RPC qor_* espone letture specifiche di QoreChain come tokenomics, stato delle chiavi PQC, modalità di firma ibrida, messaggi cross-VM e statistiche di rete. In TypeScript questi sono metodi tipizzati su client.qor (QorClient); la stessa superficie esiste negli SDK Python, Go e Rust. Sugli endpoint pubblici usa invece le route REST (ad esempio GET /qorechain/pqc/v1/account/{address} per lo stato delle chiavi PQC e GET /qorechain/burn/v1/stats per le statistiche di burn).

Non ancora servito: nessuna build di nodo rilasciata serve il namespace JSON-RPC qor_, quindi oggi ogni chiamata qor_* restituisce -32601 (metodo non trovato) su ogni endpoint pubblico. Vedi il namespace qor_.

Token & denominazioni​

  • Token di visualizzazione: QOR.
  • Denominazione base: uqor, con 10^6 unità base per QOR.

Esegui sempre i calcoli monetari in unità base. L'SDK fornisce conversioni esatte così non perdi mai precisione a causa della virgola mobile:

import { toBase, fromBase } from "@qorechain/sdk";

toBase("1.5");        // "1500000"  (QOR -> uqor)
fromBase("1500000");  // "1.5"      (uqor -> QOR)

Nota: il runtime EVM rappresenta QOR con 18 decimali (la convenzione EVM), che è distinta dalla base Cosmos uqor di 10^6. Il client @qorechain/evm usa per default 18 decimali per la visualizzazione. Verifica il valore per la tua rete di destinazione.

Indirizzi​

Lo stesso materiale di chiave può essere espresso in tre formati di indirizzo:

  • native — bech32 con il prefisso qor (qor1…), i validator usano qorvaloper.
  • EVM — 0x…, con checksum EIP-55.
  • SVM — base58 della chiave pubblica ed25519.

Vedi Account & firma PQC per i percorsi di derivazione.

Cross-VM​

Il modulo x/crossvm di QoreChain permette ai contratti su una VM di attivare azioni su un'altra. Il percorso EVM→native viene eseguito on-chain attraverso il precompile del bridge cross-VM (@qorechain/evm; non ancora attivo sulle reti pubbliche), e l'SDK fornisce helper di lettura REST tipizzati (getCrossVmMessage, getPendingCrossVmMessages, getCrossVmParams) più client.qor.getCrossVmMessage(...) per tracciare lo stato dei messaggi. Sugli endpoint pubblici gli helper REST e client.qor non sono serviti; leggi i messaggi con connectQueryClients(rpc).crossvm. Vedi la guida cross-VM.