> 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/09-build-a-dual-lane-app.md).

# 9. Construye una app de doble carril

Construye un único contrato de bóveda en el que tanto un usuario de MetaMask como un usuario de billetera de Solana depositen y retiren fondos, y vean el mismo saldo desde ambos lados.

Esta es la lección de construcción ([2. Lo que puedes construir](https://docs.rome.builders/es/rome-academy/02-what-you-can-build.md) enumera el caso de uso). Escribes una pequeña bóveda de USDC, la despliegas una vez y la usas desde dos billeteras: MetaMask y una billetera de Solana. Al final ambos usuarios tienen un saldo en el mismo estado del contrato.

## Lo que aprenderás

* La estructura de un contrato de doble carril: una bóveda ERC-20 simple.
* Los pasos ordenados que sigue cada carril para depositar y retirar.
* Por qué el carril de Solana tiene una etapa de financiación y una etapa de barrido, y el carril EVM no.
* Cómo elegir entre un núcleo en Solidity y un núcleo de programa de Solana.
* Cómo medir cuánto cuesta cada paso.

## Antes de empezar

* Termina [8. Abre tu programa de Solana a usuarios de EVM](https://docs.rome.builders/es/rome-academy/08-open-your-solana-program-to-evm-users.md). La lección 7 cubre el carril de Solana que usa esta construcción, así que lee [7. Abre tu app de EVM a billeteras de Solana](https://docs.rome.builders/es/rome-academy/07-open-to-solana-wallets.md) primero si te la saltaste.
* Ten MetaMask en Hadrian y una billetera de Solana en Solana devnet que firme transacciones v1, ambas financiadas como en la lección 3 y [Faucets](https://docs.rome.builders/es/recursos/faucets.md).
* Ten instalado el SDK de TypeScript ([Rome SDK](https://docs.rome.builders/es/productos/rome-sdk.md#typescript-sdk-rome-protocol-sdk)) y Foundry o Hardhat ([Desplegar contratos de Solidity](https://docs.rome.builders/es/guias-para-desarrolladores/deploy-solidity.md)).

## La lección

### Paso 1. Elige tu núcleo

Una aplicación de doble carril mantiene su lógica central en un lado. O bien el núcleo está en Solidity y los usuarios de Solana acceden a él a través de su dirección sintética, o el núcleo es un programa nativo de Solana y los usuarios de EVM acceden a él a través de un enrutador ligero. Ninguna de las dos es la norma. Elige según el código que ya tienes, tu equipo y lo que hace la aplicación. [Elige tu núcleo](https://docs.rome.builders/es/conceptos-basicos/choose-your-core.md) enumera las compensaciones.

Este curso construye la primera forma. Es el camino más corto y usa herramientas estándar de EVM. Si en su lugar tienes un programa de Solana, la lección 8 y [Integra un programa de Solana](https://docs.rome.builders/es/guias-para-desarrolladores/integrate-solana-program.md) cubren quién firma, cómo se mueven los tokens y la regla de un solo carril. Su idea clave se traslada a esta lección: un contrato no puede mover los tokens de un usuario por sí mismo, así que primero el usuario concede un permiso.

### Paso 2. Escribe la bóveda

La bóveda retira un token con `transferFrom` y lo devuelve con `transfer`. Nada en ella es específico de Roma.

```solidity
function deposit(uint256 amount) external {
    require(token.transferFrom(msg.sender, address(this), amount));
    balanceOf[msg.sender] += amount;
}
function withdraw(uint256 amount) external {
    balanceOf[msg.sender] -= amount;
    require(token.transfer(msg.sender, amount));
}
```

El constructor recibe la dirección del envoltorio wUSDC. Despliégalo en Hadrian como hiciste en la lección 3 y luego verifica el código fuente ([Verificar contratos](https://docs.rome.builders/es/guias-para-desarrolladores/verify-contracts.md)). El contrato completo está en [Crear una app de doble vía](https://docs.rome.builders/es/guias-para-desarrolladores/dual-lane-app.md).

### Paso 3. Ejecuta el carril EVM

Un usuario de MetaMask tiene USDC como gas nativo, y la bóveda acepta wUSDC. Así que el carril tiene cuatro pasos, cada uno una transacción normal:

1. Envuelve algo de gas en wUSDC con `withdraw_to_ata` en el precompilado Withdraw.
2. Concede permiso al envoltorio una vez, si `isEnabled(user)` es falso.
3. `approve` la bóveda en wUSDC.
4. `depósito` en la bóveda.

No hay etapas de financiación ni de barrido. Los tokens envueltos ya residen en la dirección EVM del usuario. El código está en [La misma app desde MetaMask](https://docs.rome.builders/es/guias-para-desarrolladores/dual-lane-app.md#the-same-app-from-metamask). Las direcciones de los precompilados están en [Precompilados](https://docs.rome.builders/es/referencia/precompiles.md).

### Paso 4. Ejecuta el carril de Solana

El usuario de Solana tiene SOL y USDC SPL. Cada paso es una transacción v1 firmada por esa billetera:

1. Provisiona la sintética con `create_pda`, una vez.
2. Etapa de financiación: mueve USDC desde la cuenta de tokens de la billetera a la de la sintética.
3. Concede permiso al envoltorio, si `isEnabled` es falso.
4. `approve` la bóveda.
5. `depósito`.

Retirar se ejecuta en sentido inverso. `withdraw` devuelve los tokens a la sintética, y la etapa de barrido los mueve a la propia billetera del usuario. Después de un retiro completo y un barrido, el saldo de tokens depositados de la sintética vuelve a cero. Son transacciones separadas, así que si un depósito o un barrido falla, lee el saldo de tokens de la sintética y deja que el usuario lo reintente o que barra el resto de vuelta. El código paso a paso está en [Valor ENTRADA](https://docs.rome.builders/es/guias-para-desarrolladores/dual-lane-app.md#value-in-deposit-step-by-step) y [Valor SALIDA](https://docs.rome.builders/es/guias-para-desarrolladores/dual-lane-app.md#value-out-withdraw-step-by-step).

Mantén la comprobación del permiso en el flujo del primer depósito de tu aplicación para ambos carriles. Una cuenta de tokens tiene un solo delegado, así que una concesión posterior a otro programa, como un puente o un enrutador, reemplaza el permiso del envoltorio. Comprueba `isEnabled` antes de cada depósito en lugar de asumir que el permiso anterior sigue ahí ([Concesión única por billetera](https://docs.rome.builders/es/conceptos-basicos/token-interop.md#one-time-grant-per-wallet)).

### Paso 5. Mide cada paso

Lee `computeUnitsConsumed` a partir del recibo de Solana de cada paso del carril de Solana, como en la lección 7. La guía enumera las unidades de cómputo, bytes y cuentas que usó cada paso en Hadrian. Cada paso de esa tabla queda holgadamente por debajo del presupuesto atómico. Usa esos números como referencia y luego compara los tuyos.

Si un paso se acerca a 1,4 M de unidades de cómputo o 64 cuentas, enrútalo a través del relé o simplifícalo. Consulta [Restricciones](https://docs.rome.builders/es/conceptos-basicos/constraints.md) y [Presupuesto de cómputo](https://docs.rome.builders/es/conceptos-basicos/compute-budget.md).

## Compruébalo tú mismo

Haz esto en Hadrian y guarda los enlaces.

1. Deposita desde MetaMask. Deposita desde la billetera de Solana.
2. Lee `balanceOf` en la bóveda para ambas direcciones. Cada una muestra su propio depósito. Para el usuario de Solana, lee en la dirección sintética.
3. Abre cada transacción en el explorador de Hadrian ([Hadrian](https://docs.rome.builders/es/redes/hadrian.md) tiene el enlace; [Via](https://docs.rome.builders/es/apps-en-rome/via.md) explica lo que muestra). Para el depósito del carril de Solana, sigue el enlace "Settled in" de Via hasta la transacción de Solana; el explorador de Solana muestra sus instrucciones y unidades de cómputo.
4. Retira de ambas. El USDC del usuario de Solana vuelve a su propia billetera.

Si un depósito del carril de Solana revierte con el error SPL `0x4`, falta el permiso del envoltorio.

Luego responde:

* ¿Qué lado de la aplicación necesita una etapa de financiación y por qué?
* ¿Qué tiene la sintética del usuario de Solana después de un ciclo completo?

<details>

<summary>Respuestas</summary>

* El carril de Solana. El USDC del usuario empieza en la cuenta de tokens de su billetera. La etapa de financiación lo mueve a la cuenta de tokens de la sintética, así que el saldo del envoltorio lo refleja. Los tokens de un usuario de MetaMask ya están en su dirección EVM.
* Ningún token depositado. La etapa de barrido los devuelve a la billetera del usuario.

</details>

## Siguiente

[10. Trae usuarios y fondos desde otras cadenas](https://docs.rome.builders/es/rome-academy/10-from-other-chains.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/09-build-a-dual-lane-app.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.
