> 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-academy/03-first-contract-on-hadrian.md).

# 3. Tu primer contrato en Hadrian

Conecta una billetera a Hadrian, cárgala con fondos, despliega un contrato con Hardhat y sigue tu transacción hasta la transacción de Solana que la liquidó.

Despliegas un pequeño contrato Solidity en Hadrian, la red de pruebas pública de Roma. El despliegue es el habitual de Hardhat. Lo nuevo es que pagas gas en USDC, y que el explorador te enlaza con la parte de Solana de lo que hiciste.

## Lo que aprenderás

* Cómo configurar una cartera y Hardhat para Hadrian.
* Por qué el gas es USDC, y cómo lo obtiene una cartera.
* Por qué una escritura en Roma cuesta más gas de lo que sugieren los hábitos de Ethereum.
* Cómo leer tu transacción en el explorador Via, y seguirla hasta la transacción de Solana que la liquidó.
* Cómo verificar tu fuente para que el explorador la muestre.

## Antes de empezar

Has leído [lección 2](https://docs.rome.builders/es/rome-academy/02-what-you-can-build.md), que muestra hacia qué es el primer paso este contrato. Ten preparados estos:

* Node.js en la versión que la [Inicio rápido](https://docs.rome.builders/es/primeros-pasos-1/quickstart.md) enumera.
* MetaMask instalado.
* Una cuenta nueva, o una clave desechable. Exportas su clave privada en tu shell, así que no uses una clave que contenga fondos reales.
* Una cartera de Solana configurada en Devnet, solo si financias desde Solana.

## La ruta

### Paso 1. Añade Hadrian a tu cartera

Hadrian es una red EVM estándar. La añades a MetaMask manualmente con un nombre, una URL RPC, un id de cadena, un símbolo de moneda y una URL del explorador. Toma cada valor de la tabla en [Inicio rápido, paso 1](https://docs.rome.builders/pages/d97bc846468a84d2c4d5b669c8fc29c1fe26b1d4#id-1.-add-hadrian-to-metamask). Los valores también están en [Hadrian](https://docs.rome.builders/es/redes/hadrian.md). Establece el símbolo de la moneda en `USDC`.

Hardhat necesita el mismo id de cadena y la misma URL RPC. Los pones en su configuración en el paso 3.

### Paso 2. Financia la cartera

El gas en Hadrian es USDC, respaldado por el USDC de Circle en Solana Devnet. SOL no es el token de gas. No hay un grifo de Roma. Obtienes USDC de prueba en otro sitio y lo traes con el puente de Roma. Un depósito que llega a través del puente aterriza como gas por defecto. Deja la elección de recepción de la página del puente en gas.

Hay dos fuentes:

* **Desde Solana Devnet.** Toma USDC de devnet del grifo de Circle y un poco de SOL de devnet para las comisiones de Solana. Puentea el USDC con su ruta de Solana, y da tu dirección EVM como destinatario. El puente pide a tu cartera EVM que firme una transacción de reclamación en Hadrian, y eso convierte el USDC en gas.
* **Desde una red de pruebas EVM.** Mintea USDC de prueba en Ethereum Sepolia, y puentéalo. Necesitas un poco de ETH de Sepolia para pagar la transacción del lado de origen.

Los pasos y los enlaces del grifo están en [Inicio rápido, paso 2](https://docs.rome.builders/pages/d97bc846468a84d2c4d5b669c8fc29c1fe26b1d4#id-2.-fund-your-wallet), [Financia una cartera en Hadrian](https://docs.rome.builders/es/redes/hadrian.md#fund-a-wallet) y [Faucets](https://docs.rome.builders/es/recursos/faucets.md). El propio puente está en [Rome Bridge](https://docs.rome.builders/es/apps-en-rome/bridge-api.md).

¿Cuánto financiar? El Inicio rápido da un mínimo y una cantidad cómoda. Léelo antes de empezar.

Comprueba el saldo en MetaMask antes de seguir. Si muestra cero, la transferencia no ha terminado. La página del puente muestra cada paso y el tiempo esperado.

### Paso 3. Crea el proyecto de Hardhat

Crea un proyecto de Hardhat 3 con la plantilla de TypeScript y viem. Luego añade una entrada `hadrian` bajo `networks` con el id de cadena y la URL RPC de la página de Hadrian. La clave privada viene de una variable de entorno o del almacén de claves cifrado de Hardhat. Prefiere el almacén de claves para cualquier cosa que no sea una clave desechable.

Los comandos exactos y la configuración están en Inicio rápido, [paso 3](https://docs.rome.builders/pages/d97bc846468a84d2c4d5b669c8fc29c1fe26b1d4#id-3.-create-a-hardhat-project) y [paso 4](https://docs.rome.builders/pages/d97bc846468a84d2c4d5b669c8fc29c1fe26b1d4#id-4.-configure-hardhat-for-rome). [Desplegar contratos de Solidity](https://docs.rome.builders/es/guias-para-desarrolladores/deploy-solidity.md#hardhat) muestra el archivo de configuración completo, y el [mismo flujo en Foundry](https://docs.rome.builders/es/guias-para-desarrolladores/deploy-solidity.md#foundry).

### Paso 4. Escribe y despliega el contrato

El contrato del Inicio rápido, `HelloRome`, es deliberadamente sencillo. Almacena un saludo, cuenta las llamadas a `greet()`, y emite un evento. Nada en él es específico de Roma.

Ese es el objetivo de este paso: `HelloRome` se despliega sin cambios. Antes de portar otro contrato, revisa [Limitaciones conocidas](https://docs.rome.builders/es/seguridad/known-limitations.md) para ver opcodes no compatibles y diferencias de gas. Escríbelo, y luego ejecuta el script de despliegue contra `hadrian`. El script despliega, llama a `greet()` una vez, y lee de vuelta el contador y el saludo. Copia ambos desde Inicio rápido, [paso 5](https://docs.rome.builders/pages/d97bc846468a84d2c4d5b669c8fc29c1fe26b1d4#id-5.-write-a-contract) y [paso 6](https://docs.rome.builders/pages/d97bc846468a84d2c4d5b669c8fc29c1fe26b1d4#id-6.-deploy).

Cuando funciona, tienes una dirección de contrato y un contador de 1.

### Paso 5. Entiende lo que costó

El despliegue usó mucho más gas del que usaría el mismo contrato en Ethereum. La mayor parte del gas de una escritura en Roma paga por crear cuentas de Solana. Un contrato desplegado crea nuevas cuentas para su código y almacenamiento. También lo hace una transferencia a un destinatario que nunca se ha usado, y también una nueva cuenta de token.

De esto se derivan dos reglas:

* Deja que tus herramientas estimen el gas con `eth_estimateGas`. Hardhat, `forge create` y `cast send` hazlo. `forge script` necesita `--skip-simulation` para hacer lo mismo.
* Nunca codifiques 21.000. Una escritura que crea cuentas, como un despliegue o una transferencia a una dirección que nunca se ha usado, falla con un límite tan bajo.

Roma cobra el gas que una transacción realmente usa, así que una estimación alta no te cuesta nada. Mantén el margen que añaden tus herramientas: para una llamada a un programa de Solana la estimación puede quedar baja. [Compatibilidad con JSON-RPC](https://docs.rome.builders/es/referencia/json-rpc.md#gas-is-solana-derived-estimate-dont-hardcode) ha medido cifras para escrituras reales.

### Paso 6. Léelo en el explorador

Abre el explorador Via para Hadrian y busca la dirección de tu contrato. Su página enlaza la transacción de creación y enumera la `greet()` llamada entre sus transacciones. El enlace del explorador está en [Hadrian](https://docs.rome.builders/es/redes/hadrian.md).

Via muestra la vista EVM habitual: bloque, remitente, gas usado, registros de eventos. Su fila "Liquidado en" contiene la firma de la transacción de Solana que liquidó la tuya. Abre ese enlace. El explorador de Solana muestra las instrucciones de esa transacción, los programas que tocó y las unidades de cómputo que consumió. [Via Explorer](https://docs.rome.builders/es/apps-en-rome/via.md) explica qué más muestra Via.

Lee allí las unidades de cómputo, no desde `gasUsed`. En Roma, `gasUsed` no es una medida fiel del cómputo de Solana.

### Paso 7. Verifica el código fuente

La verificación publica tu código fuente y la ABI, y entonces el explorador muestra una insignia "Origen verificado". Roma ejecuta un servicio Sourcify alojado, así que los flujos estándar de verificación de Hardhat y Foundry funcionan. Los apuntas al verificador de Roma y le das el id de cadena.

Los endpoints están bajo [Punto final del verificador](https://docs.rome.builders/es/guias-para-desarrolladores/verify-contracts.md#verifier-endpoint), y la configuración y los comandos están en la [Hardhat](https://docs.rome.builders/es/guias-para-desarrolladores/verify-contracts.md#hardhat) sección. Usa el verificador de la red de pruebas para Hadrian. El verificador de la red principal es una URL distinta, lo cual importa en la lección 11.

## Compruébalo tú mismo

Tu resultado: abre tu contrato en el explorador de Hadrian y ve estas tres cosas.

* Tu transacción de despliegue, con su firma de Solana "Liquidado en", y las instrucciones de esa transacción de Solana en el explorador de Solana.
* Una segunda transacción, la `greet()` llamada, con un registro de evento de la dirección de tu contrato. Ese registro es el evento `Greeted` ; su primer topic es el hash de `Greeted(address,uint256)`.
* Una insignia "Origen verificado" en el contrato.

Si te atascas, los errores comunes están en la [Inicio rápido](https://docs.rome.builders/es/primeros-pasos-1/quickstart.md#common-errors). El habitual es `fondos insuficientes`, lo que significa que la cartera tiene demasiado poco USDC para el límite de gas multiplicado por el precio del gas.

Luego responde estas preguntas.

1. ¿Por qué un primer despliegue cuesta tanto más gas que en Ethereum?
2. ¿Dónde lees las unidades de cómputo de Solana de una transacción: `gasUsed`, o de la transacción de Solana a la que Via enlaza?
3. ¿Vale algo el USDC de red de pruebas que usaste?

<details>

<summary>Respuestas</summary>

1. La mayor parte del gas paga por crear cuentas de Solana: el contrato, su almacenamiento y cualquier nueva cuenta de token.
2. La transacción de Solana. Via la enlaza desde la fila "Liquidado en", y el explorador de Solana muestra sus unidades de cómputo. `gasUsed` no es un proxy fiel.
3. No. Hadrian liquida en Solana Devnet, así que su USDC y su SOL no son dinero real.

</details>

## Siguiente

[Registra tu app en Arena](https://arena.mainnet.romeprotocol.xyz/apps/new) y vincula este contrato de Hadrian con ella. La app pasa a Construcción.

[4. Cómo Rome ejecuta tu código](https://docs.rome.builders/es/rome-academy/04-how-rome-runs-your-code.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-academy/03-first-contract-on-hadrian.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.
