Desplegar un rollup

Puedes desplegar un rollup específico de aplicación de tres maneras: a través del Dashboard (un asistente guiado sin código), a través de la CLI de la cadena (qorechaind, con control total sobre la transacción on-chain), o de forma programática con el RDK de TypeScript (@qorechain/rdk más el generador de plantillas create-qorechain-rollup). Esta página cubre las tres opciones, además del ciclo de vida del operador y los comandos de lotes.

nota

Los comandos siguientes apuntan a la testnet qorechain-diana. La mainnet (qorechain-vladi, EVM chain ID 9801) está en vivo desde el 7 de junio de 2026 y ejecuta la versión de cadena v3.1.85 — sustituye el chain ID y los endpoints de mainnet cuando despliegues en mainnet. Valida cada despliegue primero en la testnet.

Requisitos

Requisito	Detalles
Stake mínimo	Al crear el rollup se deposita en garantía (escrow) un bono de stake en QOR
Quema de creación	Una fracción del importe en stake se quema de forma permanente en la creación; el resto queda en garantía y se devuelve cuando el rollup se detiene
Cuenta	Una cuenta de QoreChain con fondos suficientes para el stake más las comisiones de transacción

Consulta los parámetros vivos del módulo para conocer el stake mínimo y la tasa de quema actuales antes de desplegar:

qorechaind query rdk config

Desplegar mediante el Dashboard (Tools → Rollups)

El Dashboard ofrece un asistente guiado Deploy a Rollup en Tools → Rollups. Es la vía más rápida para lanzar un rollup específico de aplicación sin ensamblar una transacción a mano.

Pasos

Inicia sesión. El asistente requiere una sesión autenticada para desplegar y para listar tus despliegues existentes.
Ponle nombre a tu rollup. Introduce un nombre de rollup (2–41 caracteres: letras, números, espacios, guiones o guiones bajos).
Elige una máquina virtual. QoreChain es una cadena de triple VM, así que tu rollup puede ejecutar cualquiera de estas:
- EVM — contratos en Solidity / Vyper con todas las herramientas de Ethereum (Hardhat, Foundry, MetaMask)
- CosmWasm — contratos inteligentes en Rust sobre el runtime del Cosmos SDK, con IBC nativo
- SVM — la Solana Virtual Machine, para aplicaciones de alto rendimiento con ejecución en paralelo
Elige una capa de disponibilidad de datos. Dónde publica tu rollup los datos de transacciones para que cualquiera pueda reconstruir el estado: QoreChain DA, Celestia o EigenDA. Ten en cuenta que EigenDA es una opción a nivel de Dashboard, mientras que los backends de DA on-chain de x/rdk son native, Celestia o ambos — consulta Disponibilidad de datos.
Define un token de gas. El token que se usa para pagar la ejecución en tu rollup. Por defecto es QOR; introduce un símbolo personalizado para usar tu propio token nativo.
Elige un secuenciador. Quién ordena las transacciones antes de la liquidación: Shared sequencer (el conjunto compartido de QoreChain), Dedicated (single) (ejecuta tu propio secuenciador único) o Decentralized (un conjunto de secuenciadores sin permisos).
Elige un destino de liquidación. Dónde ancla el rollup sus raíces de estado y pruebas de validez: QoreChain mainnet o Ethereum.
Despliega. Envía el asistente. El aprovisionamiento lo revisa The Qore Trust antes de que el rollup entre en servicio, por lo que un rollup recién enviado aparece con estado provisioning hasta que la revisión termina.

Los rollups que envíes aparecen en la lista Your rollups con su VM, capa de DA, token de gas, secuenciador, destino de liquidación y estado actual.

nota

El asistente del Dashboard presenta opciones amigables a nivel de producto y encauza el aprovisionamiento a través de un pipeline revisado. La CLI que sigue trabaja directamente contra la superficie de mensajes on-chain del módulo x/rdk. Ambos comparten los mismos conceptos subyacentes (VM, DA, secuenciador, liquidación), pero los exponen a distintas altitudes.

Desplegar mediante la CLI

La CLI crea el rollup directamente on-chain. create-rollup toma tres argumentos posicionales — el ID del rollup, un perfil y el importe del stake (en uqor) — más un flag opcional --vm.

consejo

A partir de la versión de cadena v3.1.74, create-rollup aplica automáticamente el preset del perfil elegido — el modo de liquidación, el secuenciador, la DA, el modelo de gas y la VM se toman todos del preset. Ya no necesitas configurarlos a mano (antes el mensaje fijaba en el código una configuración soberana). El flag --vm ahora está vacío por defecto, de modo que se aplica la VM del perfil salvo que la sobreescribas explícitamente.

qorechaind tx rdk create-rollup [rollup-id] [profile] [stake-amount] \
  --from mykey \
  --chain-id qorechain-diana \
  --fees 500uqor

Ejemplo — crea un rollup a partir del preset defi (la liquidación, el secuenciador, la DA y la VM vienen todos del preset; defi se resuelve en liquidación zk sobre la EVM):

qorechaind tx rdk create-rollup my-defi-rollup defi 10000000000 \
  --from mykey \
  --chain-id qorechain-diana \
  --fees 500uqor

Flags:

Flag	Por defecto	Descripción
`--vm`	(vacío — usa la VM del perfil)	Sobreescribe el tipo de VM del rollup: `evm`, `cosmwasm`, `svm` o `custom`. Déjalo sin definir para aplicar la VM del preset. (En los clientes del RDK el runtime Wasm es el tipo de VM `native` — QoreChain Native — con `cosmwasm` mantenido como alias heredado; `cosmwasm` es el valor on-wire, que es lo que acepta este flag a nivel de cadena.)

El argumento [profile] selecciona una configuración preset que se aplica automáticamente — consulta Perfiles preconfigurados. El [stake-amount] es el bono en uqor.

Inspecciona lo que has desplegado

# Query a specific rollup by ID
qorechaind query rdk rollup my-defi-rollup

# List all registered rollups
qorechaind query rdk list-rollups

Desplegar con el RDK de TypeScript (`@qorechain/rdk`)

El Rollup Development Kit se distribuye como dos paquetes públicos de npm que operan el mismo módulo on-chain x/rdk que la CLI, sobre RPC/REST/gRPC/JSON-RPC públicos y cualquier OfflineSigner de cosmjs:

@qorechain/rdk (v0.4.4) — el SDK de TypeScript: un constructor de configuración con perfiles preset, helpers de transacción para los ciclos de vida del rollup y de los lotes de liquidación, DA nativa, clientes de lectura tipados y las incorporaciones de la v0.4 — recibos de liquidación con seguridad cuántica, el QCAI Rollup Copilot, helpers de calldata cross-VM y el watchtower.
create-qorechain-rollup (v0.4.4) — un generador que clona una plantilla inicial ejecutable por perfil (incluida la plantilla multivm-rollup).

Están publicados en npm. El repositorio también incluye una CLI de operador publicada, @qorechain/rdk-cli (qorollup, v0.4.4), con los comandos doctor, create, status, watch, params, suggest, de ciclo de vida (pause/resume/stop), keygen, manifest, withdraw y faucet, además de los comandos receipt, advise y watchtower de la v0.4.

Aspectos destacados desde el lanzamiento inicial v0.4.0:

v0.4.2 — funciona contra la red en vivo sin configuración adicional. Los presets mainnet y testnet ahora incluyen los endpoints públicos de qore.host (REST en api.qore.host / api-testnet.qore.host), de modo que createRdkClient({ network }) alcanza la cadena sin endpoints manuales — sobreescríbelos solo para apuntar a tu propio nodo. La misma versión renombró el identificador de la VM de rollup Wasm a native (QoreChain Native); cosmwasm sigue siendo un alias heredado aceptado, y ambos se mapean a cosmwasm on-wire — la cadena, el explorador y el Dashboard no cambian.
v0.4.3 — corrección de la codificación de la firma híbrida para la ruta de firma de TypeScript (ver la advertencia más abajo).
v0.4.4 — sigue a @qorechain/sdk ^0.7.0, la versión del SDK para los carriles de autenticadores de la cadena v3.1.85, de modo que esas capacidades llegan directamente a los usuarios de TypeScript del RDK a través del SDK. Sin cambios en la API del RDK.

precaución

Los usuarios de TypeScript deben estar en RDK ≥ 0.4.3. Las versiones anteriores codificaban mal la extensión de transacción PQC híbrida, por lo que la cadena rechazaba todas las transacciones firmadas en modo híbrido. La v0.4.3 (vía @qorechain/sdk ≥ 0.6.1) corrige la codificación. Solo la ruta de firma híbrida de TypeScript estaba afectada — los clientes de Python, Go, Rust y Java firman solo en modo clásico y nunca se vieron afectados.

Clientes de Python, Go, Rust y Java

Junto al paquete de TypeScript, el RDK ofrece clientes completos de Python, Go, Rust y Java que reflejan la superficie de TypeScript: el constructor de configuración con validación, los cinco perfiles preset, utilidades de denominación/economía/bech32, helpers de Merkle binario y de pruebas de retiro, manifiestos de rollup, clientes de lectura REST y JSON-RPC qor_, comprobaciones de preflight/salud, cuentas (mnemónico → dirección qor) y firma y difusión de transacciones (SIGN_MODE_DIRECT). Todos están verificados contra vectores dorados compartidos entre lenguajes y están publicados en sus registros:

# Python — installs as qorechain-rdk, imports as qorrdk
pip install qorechain-rdk

# Rust
cargo add qorechain-rdk

# Go
go get github.com/qorechain/qorechain-rdk/packages/go

# Java (Maven / Gradle)
# io.github.qorechain:qorechain-rdk:0.4.4

import qorrdk

Versiones publicadas actuales: Python qorechain-rdk 0.4.4 (PyPI, se importa como qorrdk), Rust qorechain-rdk (crates.io — instala la última versión publicada, o compila desde el repositorio), módulo de Go github.com/qorechain/qorechain-rdk/packages/go (v0.4.4) y Java io.github.qorechain:qorechain-rdk 0.4.4 (Maven Central). La difusión en vivo requiere un endpoint de nodo.

nota

El RDK de TypeScript y sus plantillas apuntan por defecto a la testnet qorechain-diana, y desde la v0.4.2 los presets alcanzan los endpoints públicos en vivo sin configuración adicional. Fija las versiones y valida en la testnet antes de mainnet.

Genera un proyecto con `create-qorechain-rollup`

Cada perfil tiene una plantilla inicial correspondiente (defi-rollup, gaming-rollup, nft-rollup, enterprise-rollup, custom-rollup). Genera una con cualquiera de estas dos formas:

npm create qorechain-rollup my-rollup
# or
npx create-qorechain-rollup my-rollup

Para uso no interactivo / CI, pasa la plantilla y la red de forma explícita:

npx create-qorechain-rollup my-rollup --template defi-rollup --network testnet --yes

El generador imprime el coste documentado de stake y quema de creación, y los siguientes pasos para crear tu rollup y leer su estado.

Crea un rollup desde código

Construye una configuración a partir de un preset, lee de la cadena el stake y la tasa de quema en vivo y, después, crea el rollup con un cliente de firma. El constructor de configuración impone la matriz de compatibilidad liquidación → prueba en validate() / build().

import { createRdkClient, presets, estimateCreationCost, uqorToQor } from "@qorechain/rdk";

// A config builder pre-filled with the defi preset's defaults; override via .set({ ... }).
const config = presets.defi({ rollupId: "my-defi-rollup" }).validate();

// The public qore.host endpoints are baked into the presets (RDK ≥ 0.4.2) —
// no manual `endpoints` config needed; override to target your own node.
const rdk = createRdkClient({ network: "testnet" });

// Read the live module parameters — never hardcode the stake or burn rate.
const params = await rdk.params();
const cost = estimateCreationCost({
  stakeUqor: params.minStakeForRollup,
  burnRate: params.rollupCreationBurnRate,
});
console.log(`Stake: ${uqorToQor(cost.stakeUqor)} QOR — burned: ${uqorToQor(cost.burnUqor)} QOR`);

// Connect a signing client with any cosmjs OfflineSigner.
const tx = await rdk.connectTx(signer, { gasPrice: "0.15uqor" }); // the chain enforces a 0.1uqor/gas fee floor
const msg = config.toCreateMsg(tx.address, { stakeAmount: params.minStakeForRollup });

const res = await tx.createRollup({
  rollupId: msg.rollupId,
  profile: msg.profile,
  vmType: msg.vmType,
  stakeAmount: msg.stakeAmount,
});
console.log(`Submitted: ${res.transactionHash} (code ${res.code})`);

¿No sabes qué perfil encaja? rdk.suggestProfile("a lending protocol with predictable fees") devuelve una recomendación asistida por QCAI (con un mecanismo de respaldo documentado).

Gestiona el ciclo de vida y lee el estado desde código

El cliente de firma expone el ciclo de vida completo — pauseRollup, resumeRollup, stopRollup, además de submitBatch, challengeBatch, resolveChallenge y executeWithdrawal. Las transiciones del ciclo de vida pueden protegerse pasando currentStatus.

await tx.pauseRollup({ rollupId: "my-defi-rollup", reason: "maintenance" });
await tx.resumeRollup({ rollupId: "my-defi-rollup" });
await tx.stopRollup({ rollupId: "my-defi-rollup" });

Lee el estado con el cliente REST tipado (no requiere firmante):

const rollup = await rdk.rest.getRollup("my-defi-rollup");
console.log(rollup.status, rollup.settlementMode, rollup.daBackend, rollup.vmType);

const batch = await rdk.rest.getLatestBatch("my-defi-rollup");
console.log(batch.batchIndex, batch.status, batch.txCount);

Gestión del ciclo de vida

Un rollup pasa por los estados pending, active, paused y stopped. El creador gestiona las transiciones con los siguientes comandos.

Pausar

Detén temporalmente el rollup. El estado se conserva y el rollup puede reanudarse. Se requiere una cadena de texto con el motivo.

qorechaind tx rdk pause-rollup [rollup-id] [reason] \
  --from mykey \
  --chain-id qorechain-diana \
  --fees 500uqor

Reanudar

Reanuda un rollup pausado previamente.

qorechaind tx rdk resume-rollup [rollup-id] \
  --from mykey \
  --chain-id qorechain-diana \
  --fees 500uqor

Detener

Desmantela permanentemente el rollup y libera su stake. El QOR en stake — menos la quema única de creación — se devuelve al creador.

qorechaind tx rdk stop-rollup [rollup-id] \
  --from mykey \
  --chain-id qorechain-diana \
  --fees 500uqor

peligro

Detener un rollup es permanente. El rollup no puede reiniciarse una vez detenido.

Comandos del operador: lotes y desafíos

Los operadores de rollups envían lotes de liquidación, y los desafiantes pueden disputar los lotes optimistas. Estos comandos sustentan la capa de liquidación descrita en Visión general de rollups y ZK / STARK y retiros.

Enviar un lote

Envía un lote de liquidación para un rollup. Toma el ID del rollup, un índice de lote y una raíz de estado codificada en hexadecimal.

qorechaind tx rdk submit-batch [rollup-id] [batch-index] [state-root-hex] \
  --from mykey \
  --chain-id qorechain-diana \
  --fees 500uqor

Desafiar un lote

Desafía un lote enviado (para rollups optimistas). Toma el ID del rollup y el índice del lote; pasa la prueba de fraude con --proof. A partir de la versión de cadena v3.1.74, la ruta optimista submit-batch → challenge-batch está en vivo y funciona de extremo a extremo.

qorechaind tx rdk challenge-batch [rollup-id] [batch-index] \
  --proof <hex-encoded-fraud-proof> \
  --from mykey \
  --chain-id qorechain-diana \
  --fees 500uqor

Flag	Descripción
`--proof`	Prueba de fraude codificada en hexadecimal

Inspeccionar lotes

# Latest batch for a rollup
qorechaind query rdk batch [rollup-id]

# A specific batch by index
qorechaind query rdk batch [rollup-id] --index 42

Consultas

Comando	Propósito
`qorechaind query rdk rollup [rollup-id]`	Detalles de un rollup específico
`qorechaind query rdk list-rollups`	Todos los rollups registrados
`qorechaind query rdk batch [rollup-id]`	Último lote de liquidación (o `--index`)
`qorechaind query rdk config`	Parámetros del módulo RDK
`qorechaind query rdk suggest-profile [use-case]`	Recomienda un preset para un caso de uso

Próximos pasos

Disponibilidad de datos — backends de DA nativos, Celestia y redundantes.
ZK / STARK y retiros — verificación de pruebas y el flujo de retiro L2 → L1 vía execute-withdrawal.

Requisitos​

Desplegar mediante el Dashboard (Tools → Rollups)​

Pasos​

Desplegar mediante la CLI​

Inspecciona lo que has desplegado​

Desplegar con el RDK de TypeScript (@qorechain/rdk)​

Clientes de Python, Go, Rust y Java​

Genera un proyecto con create-qorechain-rollup​

Crea un rollup desde código​

Gestiona el ciclo de vida y lee el estado desde código​

Gestión del ciclo de vida​

Pausar​

Reanudar​

Detener​

Comandos del operador: lotes y desafíos​

Enviar un lote​

Desafiar un lote​

Inspeccionar lotes​

Consultas​

Próximos pasos​

Requisitos

Desplegar mediante el Dashboard (Tools → Rollups)

Pasos

Desplegar mediante la CLI

Inspecciona lo que has desplegado

Desplegar con el RDK de TypeScript (`@qorechain/rdk`)

Clientes de Python, Go, Rust y Java

Genera un proyecto con `create-qorechain-rollup`

Crea un rollup desde código

Gestiona el ciclo de vida y lee el estado desde código

Gestión del ciclo de vida

Pausar

Reanudar

Detener

Comandos del operador: lotes y desafíos

Enviar un lote

Desafiar un lote

Inspeccionar lotes

Consultas

Próximos pasos