Saltar al contenido principal

Arquitectura y conceptos

QoreChain es una única cadena Layer 1 que ejecuta tres máquinas virtuales de contratos inteligentes en paralelo, con cuentas compartidas y un token compartido.

El modelo triple-VM​

VMContratosSuperficie de cliente en el SDK
CosmWasmContratos Rust/Wasmclient.cosmwasm() y los helpers queryContractSmart / execute en @qorechain/sdk
QoreChain EVM EngineSolidity / Vyper@qorechain/evm (un adaptador de viem)
SVMProgramas de Solana@qorechain/svm (un adaptador de @solana/web3.js)

La capa nativa (Cosmos) gestiona las transferencias bancarias, el staking, la gobernanza y el módulo x/crossvm que enruta mensajes entre runtimes.

Superficies de lectura​

El SDK se comunica con un nodo a través de varios endpoints:

  • Cosmos REST (LCD) — balances bancarios, información de cuentas, consultas de módulos.
  • Consensus RPC — usado para firmar/difundir transacciones nativas y para el cliente de lectura de CosmWasm.
  • EVM JSON-RPC — llamadas eth_* estándar más el namespace qor_* de QoreChain y los precompilados de EVM.
  • SVM JSON-RPC — RPC compatible con Solana para el runtime SVM.

El namespace JSON-RPC qor_* expone lecturas específicas de QoreChain como tokenómica, estado de las claves PQC, modo de firma híbrida, mensajes entre VMs y estadísticas de red. En TypeScript estos son métodos tipados en client.qor (QorClient); la misma superficie existe en los SDK de Python, Go y Rust.

Tokens y denominaciones​

  • Token de visualización: QOR.
  • Denominación base: uqor, con 10^6 unidades base por QOR.

Haz siempre las operaciones matemáticas de dinero en unidades base. El SDK proporciona conversiones exactas para que nunca pierdas precisión por culpa del punto flotante:

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

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

Nota: el runtime EVM representa QOR con 18 decimales (la convención de EVM), lo cual es distinto de la base uqor de Cosmos de 10^6. El cliente @qorechain/evm usa 18 decimales por defecto para la visualización. Confirma el valor para tu red objetivo.

Direcciones​

El mismo material de clave puede expresarse en tres formatos de dirección:

  • native — bech32 con el prefijo qor (qor1…); los validadores usan qorvaloper.
  • EVM — 0x…, con checksum EIP-55.
  • SVM — base58 de la clave pública ed25519.

Consulta Cuentas y firma PQC para conocer las rutas de derivación.

Cross-VM​

El módulo x/crossvm de QoreChain permite que los contratos de una VM activen acciones en otra. La ruta EVM→native se ejecuta on-chain a través del precompilado del puente cross-VM (@qorechain/evm), y el SDK proporciona helpers tipados de lectura REST (getCrossVmMessage, getPendingCrossVmMessages, getCrossVmParams) además de client.qor.getCrossVMMessage(...) para rastrear el estado de los mensajes. Consulta la guía cross-VM.