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

# 9. Construa um app de duas vias

Construa um contrato de cofre único no qual tanto um usuário do MetaMask quanto um usuário de carteira Solana possam depositar e sacar, e veja o mesmo saldo de ambos os lados.

Esta é a lição de construção ([2. O que você pode construir](https://docs.rome.builders/pt-br/rome-academy/02-what-you-can-build.md) lista o caso de uso). Você escreve um pequeno cofre de USDC, faz o deploy uma vez e o usa a partir de duas carteiras: MetaMask e uma carteira Solana. No fim, ambos os usuários têm um saldo no mesmo estado do contrato.

## O que você vai aprender

* A estrutura de um contrato de duas pistas: um cofre ERC-20 simples.
* As etapas ordenadas que cada pista segue para depositar e sacar.
* Por que a pista Solana tem uma etapa de funding e uma etapa de sweep, e a pista EVM não.
* Como escolher entre um núcleo em Solidity e um núcleo de programa Solana.
* Como medir quanto cada etapa custa.

## Antes de começar

* Concluir [8. Abra seu programa Solana para usuários de EVM](https://docs.rome.builders/pt-br/rome-academy/08-open-your-solana-program-to-evm-users.md). A lição 7 cobre a pista Solana que esta construção usa, então leia [7. Abra seu app EVM para carteiras Solana](https://docs.rome.builders/pt-br/rome-academy/07-open-to-solana-wallets.md) primeiro, se você pulou ela.
* Tenha a MetaMask no Hadrian e uma carteira Solana na devnet da Solana que assine transações v1, ambas financiadas como na lição 3 e [Faucets](https://docs.rome.builders/pt-br/recursos/faucets.md).
* Tenha o SDK TypeScript instalado ([Rome SDK](https://docs.rome.builders/pt-br/produtos/rome-sdk.md#typescript-sdk-rome-protocol-sdk)) e Foundry ou Hardhat ([Implantar contratos Solidity](https://docs.rome.builders/pt-br/guias-do-desenvolvedor/deploy-solidity.md)).

## A lição

### Etapa 1. Escolha seu núcleo

Uma app de duas pistas mantém sua lógica central em um lado. Ou o núcleo é Solidity e os usuários da Solana o acessam por meio de seu endereço sintético, ou o núcleo é um programa Solana nativo e os usuários EVM o acessam por meio de um roteador fino. Nenhuma das opções é obrigatória. Escolha com base no código que você já tem, na sua equipe e no que o app faz. [Escolha seu núcleo](https://docs.rome.builders/pt-br/conceitos-principais/choose-your-core.md) lista os compromissos.

Este curso constrói a primeira estrutura. É o caminho mais curto e usa ferramentas padrão da EVM. Se, em vez disso, você tiver um programa Solana, a lição 8 e [Integrar um programa Solana](https://docs.rome.builders/pt-br/guias-do-desenvolvedor/integrate-solana-program.md) cobrem quem assina, como os tokens se movem e a regra de uma única pista. O ponto principal se aplica a esta lição: um contrato não pode mover os tokens de um usuário por conta própria, então o usuário concede um direito primeiro.

### Etapa 2. Escreva o cofre

O cofre puxa um token com `transferFrom` e o devolve com `transfer`. Nada nele é específico para 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));
}
```

O construtor recebe o endereço do wrapper wUSDC. Faça o deploy no Hadrian como você fez na lição 3 e então verifique o código-fonte ([Verificar contratos](https://docs.rome.builders/pt-br/guias-do-desenvolvedor/verify-contracts.md)). O contrato completo está em [Construir um app de duas vias](https://docs.rome.builders/pt-br/guias-do-desenvolvedor/dual-lane-app.md).

### Etapa 3. Execute a pista EVM

Um usuário da MetaMask mantém USDC como gás nativo, e o cofre aceita wUSDC. Então a pista tem quatro etapas, cada uma uma transação normal:

1. Embrulhe um pouco de gás em wUSDC com `withdraw_to_ata` no precompile Withdraw.
2. Conceda a permissão ao wrapper uma vez, se `isEnabled(user)` for falso.
3. `approve` o cofre em wUSDC.
4. `depósito` para o cofre.

Não há etapas de funding nem de sweep. Os tokens embrulhados já vivem no endereço EVM do usuário. O código está em [O mesmo app a partir do MetaMask](https://docs.rome.builders/pt-br/guias-do-desenvolvedor/dual-lane-app.md#the-same-app-from-metamask). Os endereços de precompile estão em [Precompiles](https://docs.rome.builders/pt-br/referencia/precompiles.md).

### Etapa 4. Execute a pista Solana

O usuário Solana mantém SOL e USDC SPL. Cada etapa é uma transação v1 assinada por essa carteira:

1. Provisione o sintético com `create_pda`, uma vez.
2. Etapa de funding: mova USDC da conta de token da carteira para a conta do sintético.
3. Conceda a permissão ao wrapper, se `isEnabled` for falso.
4. `approve` o cofre.
5. `depósito`.

O saque funciona ao contrário. `withdraw` devolve os tokens para o sintético, e a etapa de sweep os move para a própria carteira do usuário. Após um saque e sweep completos, o saldo de tokens depositados do sintético volta a zero. Essas são transações separadas, então, se um depósito ou um sweep falhar, leia o saldo de tokens do sintético e permita que o usuário tente novamente ou faça o sweep do restante de volta. O código passo a passo está em [Valor de ENTRADA](https://docs.rome.builders/pt-br/guias-do-desenvolvedor/dual-lane-app.md#value-in-deposit-step-by-step) e [Valor de SAÍDA](https://docs.rome.builders/pt-br/guias-do-desenvolvedor/dual-lane-app.md#value-out-withdraw-step-by-step).

Mantenha a verificação da permissão no fluxo do primeiro depósito do seu app para ambas as pistas. Uma conta de token tem um único delegado, então uma concessão posterior para outro programa, como uma bridge ou um roteador, substitui a permissão do wrapper. Verifique `isEnabled` antes de cada depósito, em vez de assumir que a permissão anterior ainda está lá ([Concessão única por carteira](https://docs.rome.builders/pt-br/conceitos-principais/token-interop.md#one-time-grant-per-wallet)).

### Etapa 5. Meça cada etapa

Leia `computeUnitsConsumed` do recibo Solana de cada etapa da pista Solana, como na lição 7. O guia lista as unidades de compute, bytes e contas que cada etapa usou no Hadrian. Cada etapa dessa tabela fica bem abaixo do orçamento atômico. Use esses números como base e depois compare com os seus.

Se uma etapa ficar perto de 1,4M unidades de compute ou 64 contas, roteie-a pelo relay ou simplifique-a. Veja [Restrições](https://docs.rome.builders/pt-br/conceitos-principais/constraints.md) e [Orçamento de Computação](https://docs.rome.builders/pt-br/conceitos-principais/compute-budget.md).

## Teste seus conhecimentos

Faça isso no Hadrian e guarde os links.

1. Deposite pela MetaMask. Deposite pela carteira Solana.
2. Leia `balanceOf` no cofre para ambos os endereços. Cada um mostra seu próprio depósito. Para o usuário Solana, consulte no endereço sintético.
3. Abra cada transação no explorador Hadrian ([Hadrian](https://docs.rome.builders/pt-br/redes/hadrian.md) tem o link; [Via](https://docs.rome.builders/pt-br/apps-na-rome/via.md) explica o que ele mostra). Para o depósito da pista Solana, siga o link "Settled in" da Via para a transação Solana; o explorador Solana mostra suas instruções e unidades de compute.
4. Saque de ambos. O USDC do usuário Solana volta para a própria carteira.

Se um depósito da pista Solana reverter com erro SPL `0x4`, a permissão do wrapper está ausente.

Depois responda:

* Qual lado do app precisa de uma etapa de funding, e por quê?
* O que o sintético do usuário Solana mantém após uma ida e volta completa?

<details>

<summary>Respostas</summary>

* A pista Solana. O USDC do usuário começa na conta de token da carteira dele. A etapa de funding o move para a conta de token do sintético, então o saldo do wrapper o mostra. Os tokens de um usuário da MetaMask já estão no endereço EVM dele.
* Nenhum token depositado. A etapa de sweep os devolve para a carteira do usuário.

</details>

## Próximo

[10. Traga usuários e fundos de outras chains](https://docs.rome.builders/pt-br/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/pt-br/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.
