> For the complete documentation index, see [llms.txt](https://docs.rome.builders/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rome.builders/es/rome-zk-evm/run-a-rollup.md).

# Ejecuta un rollup

Registra y ejecuta tu propia cadena Rome ZK EVM en el devnet de Solana con el lanzador de rollups v0.3.0.

Los `./rollup` El runner inicia una cadena contra los programas compartidos de devnet de Solana de Rome. Ejecutas su nodo y pagas sus costes de Solana. No despliegas tú mismo los programas de liquidación. El registro no requiere permisos, pero las raíces probadas necesitan una clave de verificación específica de la cadena registrada por Rome.

Esta página usa **v0.3.0**. El [guía completa de devnet](https://github.com/rome-protocol/solana-zk-evm/blob/v0.3.0/docs/RUN-ON-DEVNET.md) cubre todas las configuraciones, fallos y pasos de recuperación.

## Antes de empezar

Usa una máquina Linux x86-64 con bash 4 o superior, Git, Docker Engine 28 o superior con Compose, curl, jq, openssl, la CLI de Solana y Python 3.11 o superior. Necesitas un endpoint RPC de devnet de Solana, un par de claves pagador de Solana con fondos, que también es tu autoridad de la cadena, y una clave de firma del secuenciador. Mantén ambos archivos privados y legibles por el usuario 999 del contenedor. La guía explica cómo generarlos.

Presupuesta alrededor de **7 SOL en devnet** para el pagador. El registro bloquea 5 SOL; `./rollup check` espera que queden al menos 1 SOL para publicación y renta. El depósito se vuelve reembolsable después de la primera raíz final o de diez raíces publicadas. Si la cadena se reclama antes de eso, el depósito va al tesoro. La cadena también necesita una dirección receptora de comisiones de EVM que controles.

Para liquidar raíces, necesitas un host de prueba con una GPU NVIDIA de más de 30 GB de memoria. Una tarjeta de 24 GB es demasiado pequeña para el paso final de prueba. [Host del probador](https://docs.rome.builders/es/rome-zk-evm/prover-host.md) proporciona el presupuesto de RAM y disco. El nodo puede ejecutarse y publicar lotes antes de que el probador esté listo, pero ninguna de sus raíces será final.

## Inicia el nodo

Clona la versión y trabaja desde su directorio rollup:

```sh
git clone --branch v0.3.0 https://github.com/rome-protocol/solana-zk-evm.git
cd solana-zk-evm/deploy/rollup
cp .env.example .env
cp chain.toml.example chain.toml
```

Configura el RPC de Solana, las ubicaciones de los firmantes y `ROME_ZK_TAG=v0.3.0` en `.env`. Mantén `PROGRAMS_JSON=programs.devnet.json`. Establece `ROME_ZK_GUEST_TAG=v0.3.0` y `ZISK_RELEASE=1.3.1-alpha` para la compilación posterior del guest. Mantén el RPC ligado a loopback para una primera ejecución local. Deja `PROVER` sin establecer hasta que el guest y su clave estén listos.

Establezca `genesis.fee_recipient` en `chain.toml` a tu dirección de EVM. No elijas un ID de cadena. Settlement deriva uno a partir del pagador y su número de registro; `init` lo lee antes de enviar nada. Aproximadamente la mitad de todos los IDs son demasiado grandes para MetaMask. Si el tuyo es uno de ellos, `init` se detiene con `ChainIdNotWalletSafe`; crea una nueva clave de pagador, apunta `PAYER_KEYPAIR_PATH` a ella y ejecuta `init` de nuevo.

Una nueva cadena empieza con saldos cero. Si declaras un saldo respaldado para obtener gas antes de que se abran los depósitos, bloquea la misma cantidad de SOL envuelto en la bóveda de la cadena antes de solicitar la clave de verificación.

```sh
./rollup init
./rollup register --dry-run
./rollup register --confirm
./rollup up
./rollup check
```

`init` renderiza la configuración de génesis y de servicio. `register --confirm` bloquea el depósito de 5 SOL y crea el cursor de lotes. `up` inicia el nodo del secuenciador, el batcher, derive y el verificador. `check` nombra cualquier servicio que falte y luego compara el ID de la cadena, los heads, el progreso del batcher, la inbox y las raíces. Vuelve a ejecutarlo después de que los lotes hayan tenido tiempo de cerrarse; su primera comprobación del progreso de lotes solo registra una muestra.

Sin un probador, el secuenciador sirve RPC, el batcher publica los datos de las transacciones en la inbox y derive reconstruye la cadena. Un lote de la inbox no es una raíz de liquidación final. Incluso la raíz de génesis espera una prueba.

## Pasa de lotes a raíces finales

Compila el guest para la génesis de tu cadena:

```sh
./rollup guest-build
```

La compilación usa el guest v0.3.0 y ZisK 1.3.1-alpha. Produce el programa guest de la cadena y los metadatos de la clave de verificación. Cálculo `programVK` necesita las claves de prueba de ZisK y unos 36 GB de RAM. Registrar la cadena no registra una clave de verificación. Envía la [solicitud de clave de verificación](https://docs.rome.builders/es/rome-zk-evm/verification-key.md) después de la compilación. Rome comprueba tu génesis y tu guest, y luego registra la clave con un slot de activación.

En el host del probador, establece `PROVER=on` y el guest, los metadatos de verificación y los ajustes de ZisK descritos en el runbook completo. Después de que la clave esté activa:

```sh
./rollup init
./rollup up
./rollup check
```

Comprueba que el `servicio prover` y `clave de verificación` elementos pasen. El probador procesa los lotes de la inbox en orden. Cada prueba válida publica una raíz que es final en cuanto aterriza su transacción de Solana.

## Haz el primer bloque

Sin un saldo de génesis respaldado, la cadena no tiene gas para una transacción hasta que se abran los depósitos. Los depósitos necesitan una primera raíz probada. El valor predeterminado `empty_block_interval_secs = 0` deja una cadena inactiva sin bloques, así que establécelo en `60` menos de `[profile]` en `chain.toml` después de que la clave esté activa y el probador esté en ejecución. Renderiza y reinicia:

```sh
./rollup init
./rollup up
./rollup check
```

Una vez que la primera raíz sea final, vuelve a establecer el intervalo en `0` y vuelve a ejecutar `init` y `up` a menos que quieras bloques vacíos regulares. Activarlos mientras esperas a que Rome registre la clave crea una acumulación. Cada lote debe probarse en orden.

Con un intervalo de bloques vacíos de 60 segundos y el cierre de lotes de 60 segundos, la cadena genera aproximadamente un lote por minuto, o unos 1.440 al día. En devnet, una raíz probada le costó al pagador unos **0.003 SOL**: unos 0.002 SOL en renta de cuentas pendientes, la comisión de liquidación de 0.001 SOL y además una comisión de transacción. Ese ritmo es de unos 4.4 SOL al día antes de los costes de publicación en la inbox. La renta de las cuentas pendientes permanece bloqueada con la configuración predeterminada. Con los bloques vacíos desactivados, una cadena inactiva no cierra lotes ni paga costes de publicación.

Para aceptar depósitos, primero crea la bóveda, activa la configuración de salida después de su demora y abre una cola de depósitos. Esos comandos y las comprobaciones están en [Depósitos y retiros](https://docs.rome.builders/es/rome-zk-evm/deposits-and-withdrawals.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.rome.builders/es/rome-zk-evm/run-a-rollup.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
