Desarrollo con SVM

QoreChain incluye un entorno de ejecución Solana Virtual Machine (SVM) que permite a los desarrolladores desplegar y ejecutar programas SBF/BPF usando las herramientas habituales de Solana. El módulo SVM expone una interfaz JSON-RPC compatible con Solana en el puerto 8899, que qorechaind start inicia automáticamente (véase Servidor JSON-RPC más abajo).

nota

Los comandos siguientes usan la mainnet qorechain-vladi, activa desde el 7 de junio de 2026 y ejecutando la versión de cadena v3.1.97. Sustituya --chain-id qorechain-diana para la testnet.

El envío de transacciones SVM está actualmente deshabilitado

Desde la versión de cadena v3.1.89 (22 de agosto), tras un incidente, el carril de ejecución SVM está deshabilitado en toda la red para el envío de transacciones — cualquier transacción enviada a x/svm (despliegue de programas, ejecución de instrucciones, creación de cuentas, transferencias) devuelve code 11, "SVM module is disabled". Esto se aplica tanto a su propio nodo como a los endpoints públicos. Los métodos RPC de solo lectura pueden seguir respondiendo, pero no construya ni ensaye una integración SVM en producción hasta que el carril vuelva a abrirse — se trata de una deshabilitación en tiempo de compilación, no de un parámetro en tiempo de ejecución, por lo que no puede reactivarse mediante una votación de gobernanza; se espera que permanezca deshabilitado hasta que una auditoría externa lo autorice.

Visión general

El módulo x/svm proporciona:

QOR nativo como activo SVM de primera clase — el balance unificado de la cuenta, visible en lamports
Despliegue y ejecución de programas SBF/BPF
Creación y gestión de cuentas de datos
Un endpoint JSON-RPC compatible con Solana
Mapeo bidireccional de direcciones entre los formatos de QoreChain y de Solana
Medición de presupuesto de cómputo y economía de almacenamiento basada en rent

QOR nativo en la interfaz SVM

Desde la versión de cadena v3.1.82, la interfaz SVM es una interfaz de QOR nativo de primera clase, no un balance de sandbox separado. El único balance unificado de la cuenta — los mismos fondos visibles como uqor en la interfaz Cosmos y como wei de 18 decimales en la EVM — aparece en el lado SVM en lamports (9 decimales):

1 uqor = 1,000 lamports    ·    1 QOR = 1,000,000,000 lamports

getBalance / getAccountInfo devuelven el QOR nativo de la cuenta (en lamports).
getSignaturesForAddress devuelve el historial de transacciones que afectan a una dirección — útil para la detección de depósitos con las herramientas estándar de Solana.
Las transferencias del System Program mueven QOR nativo — una instrucción de transferencia al estilo Solana mueve los mismos fondos que movería un MsgSend de Cosmos o una transferencia EVM.
Formato de dirección SVM — la dirección SVM de una cuenta son sus 20 bytes de cuenta rellenados a la derecha hasta 32 bytes y codificados en base58. Las tres formas de dirección (qor1..., 0x..., base58) se refieren a la misma cuenta.

Los endpoints públicos (https://svm.qore.host, https://svm-testnet.qore.host) son de solo lectura — el envío de transacciones está deshabilitado en el borde. Normalmente ejecutaría su propio nodo (puerto 8899) para enviar transacciones SVM, pero véase la advertencia anterior: el propio carril de transacciones de x/svm está actualmente deshabilitado en toda la red, incluido en su propio nodo.

Servidor JSON-RPC

El servidor JSON-RPC compatible con Solana es iniciado por qorechaind start y está habilitado por defecto. Se configura mediante una sección [svm-rpc] en app.toml:

[svm-rpc]
# Enable the Solana-compatible JSON-RPC server
enable = true
# Address the server listens on
address = "127.0.0.1:8899"

Los valores por defecto son enable = true y address = "127.0.0.1:8899", de modo que un nodo recién iniciado ya sirve la interfaz JSON-RPC de Solana en el puerto 8899 — @solana/web3.js se conecta en http://127.0.0.1:8899 sin configuración adicional. getVersion informa 1.18.0-qorechain, y getBalance / getAccountInfo devuelven cuentas SVM en cadena en tiempo real.

Propiedad	Valor
URL por defecto	`http://127.0.0.1:8899`
Habilitado	Sí, por defecto
Iniciado por	`qorechaind start`
Compatibilidad	JSON-RPC de Solana (subconjunto)
`getVersion`	`1.18.0-qorechain`

Métodos compatibles

Método	Descripción
`getAccountInfo`	Recupera los datos y el balance en lamports de una cuenta
`getBalance`	Obtiene el balance de la cuenta en lamports (QOR nativo)
`getSignaturesForAddress`	Historial de transacciones de una dirección
`getSlot`	Número de slot actual
`getMinimumBalanceForRentExemption`	Balance mínimo para un tamaño de datos dado
`getVersion`	Información de versión del runtime SVM
`getHealth`	Comprobación de salud del endpoint SVM

Despliegue e interacción con programas

información

Ejecución SBF moderna. El motor de ejecución SVM se ha modernizado sobre solana-sbpf 0.21.1, de modo que los programas SBF recién compilados con la cadena de herramientas actual de Solana (platform-tools v1.53 / agave 4.x) se despliegan y ejecutan en QoreChain — la ejecución es totalmente compatible, no solo el despliegue. Los programas construidos con cargo build-sbf --arch v0 o --arch v3 son compatibles.

Desplegar un programa SBF — Compile su programa de Solana a un objeto compartido SBF con las platform-tools actuales (v1.53 / agave 4.x), y luego despliéguelo en QoreChain:
```
# Build with the current Solana toolchain (--arch v0 or --arch v3)
cargo build-sbf --arch v3

# Deploy the compiled program
qorechaind tx svm deploy-program ./my_program.so \
  --from mykey \
  --gas auto \
  --gas-adjustment 1.3 \
  -y
```
La respuesta de la transacción incluye el ID del programa en formato base58.
Ejecutar una instrucción — Llame a un programa BPF en cadena con datos de instrucción:
```
# Execute instruction
qorechaind tx svm execute <program-id-base58> <data-hex> \
  --from mykey \
  --gas auto \
  -y
```
Parámetro Formato Descripción
program-id-base58 Cadena base58 La dirección del programa desplegado
data-hex Bytes codificados en hex Datos de instrucción serializados
Crear una cuenta de datos — Los programas suelen necesitar cuentas donde almacenar estado. Cree una con un tamaño y un propietario especificados:
```
# Create data account
qorechaind tx svm create-account <owner-base58> <space> <lamports> \
  --from mykey \
  --gas auto \
  -y
```
Parámetro Descripción
owner-base58 El programa propietario de esta cuenta (base58)
space Tamaño del campo de datos en bytes
lamports Balance inicial (debe alcanzar el mínimo de exención de rent)

Consulte el balance mínimo exento de rent para un tamaño dado:
```
# RPC: getMinimumBalanceForRentExemption
curl -X POST http://localhost:8899 \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getMinimumBalanceForRentExemption",
    "params": [1024]
  }'
```

Parámetro	Formato	Descripción
`program-id-base58`	Cadena base58	La dirección del programa desplegado
`data-hex`	Bytes codificados en hex	Datos de instrucción serializados

Parámetro	Descripción
`owner-base58`	El programa propietario de esta cuenta (base58)
`space`	Tamaño del campo de datos en bytes
`lamports`	Balance inicial (debe alcanzar el mínimo de exención de rent)

Usando @solana/web3.js — El SDK de JavaScript de Solana funciona directamente con el endpoint SVM de QoreChain:

import { Connection, PublicKey } from "@solana/web3.js";

const connection = new Connection("http://127.0.0.1:8899");

// Check health
const health = await connection.getHealth();
console.log("SVM health:", health);

// Get slot
const slot = await connection.getSlot();
console.log("Current slot:", slot);

// Get account info
const pubkey = new PublicKey("YourBase58ProgramId...");
const accountInfo = await connection.getAccountInfo(pubkey);
console.log("Account data:", accountInfo);

// Get balance
const balance = await connection.getBalance(pubkey);
console.log("Balance (lamports):", balance);

Mapeo de direcciones

QoreChain mantiene un mapeo bidireccional de direcciones entre las direcciones Bech32 nativas (qor1...) y las direcciones base58 al estilo Solana:

Dirección	Ejemplo
Nativa a SVM	`qor1abc...xyz` se mapea a una dirección base58 determinista
SVM a nativa	Las direcciones de programa base58 se mapean de vuelta a los equivalentes `qor1...`

El mapeo es determinista y lo gestiona el módulo x/svm. Ambas representaciones se refieren a la misma cuenta subyacente.

Modelo de rent

El módulo SVM usa un modelo de almacenamiento basado en rent para evitar el hinchamiento del estado:

Parámetro	Valor
Lamports por byte por año	`3,480`
Multiplicador de exención de rent	`2.0`
Frecuencia de cobro	Cada época

Las cuentas con un balance por encima de 2 * (data_size * 3480 / seconds_per_year) en lamports están exentas de rent y nunca se les cobra.
A las cuentas por debajo del umbral de exención de rent se les cobra rent en cada época. Si el balance llega a cero, la cuenta se purga.

información

Buena práctica: financie siempre las cuentas de datos por encima del mínimo de exención de rent para evitar la eliminación inesperada de la cuenta.

Presupuesto de cómputo

Cada ejecución de instrucción se mide en unidades de cómputo:

Parámetro	Valor
Máximo de unidades de cómputo por instrucción	`1,400,000`
Profundidad máxima de CPI (invocación entre programas)	`4`
Tamaño máximo de programa	`10 MB`
Tamaño máximo de datos de cuenta	`10 MB`

Los programas que superan el presupuesto de cómputo se detienen y la transacción se revierte.

Resumen de parámetros

Parámetro	Valor
`max_program_size`	10 MB
`max_account_data_size`	10 MB
`compute_budget_max`	1,400,000 CU
`max_cpi_depth`	4
`lamports_per_byte_year`	3,480
`rent_exemption_multiplier`	2.0
Puerto JSON-RPC	8899

Interoperabilidad entre VMs

Los programas SVM pueden comunicarse con contratos EVM y CosmWasm a través de la ruta de mensajes entre VMs asíncrona:

# Cross-VM call example
qorechaind tx crossvm call \
  --source-vm svm \
  --target-vm evm \
  --target-contract 0x1234...abcd \
  --payload '...' \
  --from mykey \
  -y

Los mensajes se encolan y se procesan en el EndBlocker. Véase Interoperabilidad entre VMs para más detalles sobre el ciclo de vida del mensaje y el comportamiento de tiempo de espera.

Próximos pasos

Interoperabilidad entre VMs — Comunicación entre SVM, EVM y CosmWasm
Desarrollo con EVM — Contratos inteligentes en Solidity en QoreChain
Desarrollo con CosmWasm — Contratos de WebAssembly basados en Rust

Visión general​

QOR nativo en la interfaz SVM​

Servidor JSON-RPC​

Métodos compatibles​

Despliegue e interacción con programas​

Mapeo de direcciones​

Modelo de rent​

Presupuesto de cómputo​

Resumen de parámetros​

Interoperabilidad entre VMs​

Próximos pasos​