> 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/07-open-to-solana-wallets.md).

# 7. Abra seu app EVM para carteiras Solana

Torne seu contrato utilizável a partir de uma carteira Solana sem chave EVM, cobrindo o endereço sintético, o valor ERC-20, as duas assinaturas e o orçamento atômico.

Seu contrato já funciona com MetaMask. Agora você permite que uma carteira Solana o chame com a chave que ela já tem, de modo que o usuário nunca cria uma conta EVM. Eles chamam o mesmo contrato, no mesmo endereço, contra o mesmo estado.

## O que você vai aprender

* Como uma carteira Solana se torna um msg.sender normal `msg.sender` na Rome.
* Por que este curso recebe valor como um depósito em ERC-20 e o que `msg.value` ele precisa de um usuário Solana.
* O que um usuário Solana assina em cada chamada e para onde a transação vai.
* O que cabe em uma transação Solana e o que acontece com uma chamada que não cabe.
* Quais `deps` o SDK precisa e de onde cada um vem.

## Antes de começar

* Conclua [6. Tokens nos dois lados](https://docs.rome.builders/pt-br/rome-academy/06-tokens-on-both-sides.md). Esta lição pressupõe que você sabe o que é um wrapper e por que um usuário o autoriza uma vez.
* Tenha `HelloRome` implantado no Hadrian a partir de [3. Seu primeiro contrato no Hadrian](https://docs.rome.builders/pt-br/rome-academy/03-first-contract-on-hadrian.md).
* Instale o SDK TypeScript, como em [Rome SDK](https://docs.rome.builders/pt-br/produtos/rome-sdk.md#typescript-sdk-rome-protocol-sdk).
* Tenha uma carteira Solana que assine transações Solana v1, com um pouco de SOL da devnet e USDC da devnet. Os faucets estão listados em [Faucets](https://docs.rome.builders/pt-br/recursos/faucets.md). O suporte a transações v1 varia entre carteiras, então teste a sua primeiro. [Construir um app de duas vias](https://docs.rome.builders/pt-br/guias-do-desenvolvedor/dual-lane-app.md) nomeia as carteiras verificadas até agora.

## A lição

### Etapa 1. Conheça o endereço sintético

Uma carteira Solana não tem endereço EVM, então a Rome deriva um a partir da sua chave pública. O resultado é o endereço sintético da carteira. Ele é o `msg.sender` que o seu contrato vê, e ele carrega seu próprio nonce e armazenamento como qualquer outra conta. A mesma carteira sempre mapeia para o mesmo endereço.

```javascript
import { syntheticAddress } from "@rome-protocol/sdk";
const from = syntheticAddress(solanaPubkey); // um endereço comum de 20 bytes
```

No fluxo deste curso, o sintético não mantém tokens em repouso. Eles começam na carteira Solana do usuário. A etapa de funding os move para a conta de token do sintético antes de um depósito, e só então o `balanceOf(synthetic)` os mostra. A etapa de sweep os move de volta para a carteira após um saque. Leia o modelo completo em [Chamar EVM a partir da Solana](https://docs.rome.builders/pt-br/guias-do-desenvolvedor/call-evm-from-solana.md#synthetic-addresses).

### Etapa 2. Torne o contrato compatível com Solana

A maioria dos contratos não precisa de mudanças. Três regras determinam se o seu é um deles:

* Receba valor como um ERC-20. Puxe com `transferFrom` após um `approve`, e devolva com `transfer`.
* Aponte para o wrapper canônico de cada token. Não implante o seu próprio.
* Mantenha cada chamada da via Solana dentro de uma única transação Solana.

A primeira regra é a que pega. Este ponto de entrada funciona para usuários da MetaMask. Ele falha para usuários Solana no modelo de funding e sweep, porque o sintético deles não mantém saldo nativo a menos que você o abasteça com `fundSyntheticGas`:

```solidity
function deposit() external payable { balanceOf[msg.sender] += msg.value; }
```

Este funciona para ambos, porque ambas as vias podem financiar um `transferFrom`:

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

Os endereços dos wrappers estão em [Contract Addresses](https://docs.rome.builders/pt-br/referencia/contract-addresses.md). As verificações para um contrato pronto para Solana estão em [Abra seu contrato Solidity para usuários Solana](https://docs.rome.builders/pages/a5c83a448f3b243ea29815751311e5f8fd8a2ade#id-2.-what-makes-a-contract-solana-ready).

### Etapa 3. Saiba o que a carteira assina

A chamada do SDK é `submitRomeTxV1`. Para cada chamada, o proxy compõe uma transação Solana v1. A carteira assina duas vezes com a mesma chave. Primeiro, ela assina uma mensagem de autorização legível que nomeia o hash da transação EVM. Depois, ela assina a própria transação.

O app envia a transação assinada para o RPC da Solana, não para o proxy da Rome. A cadeia verifica a autorização por meio do programa Ed25519 e executa sua chamada como o endereço sintético. O usuário nunca possui uma chave EVM.

Antes de a carteira assinar a transação, o SDK verifica se ela carrega exatamente a chamada que o usuário autorizou. Qualquer outra coisa é recusada. Os detalhes estão em [Abra seu contrato Solidity para usuários Solana](https://docs.rome.builders/pages/a5c83a448f3b243ea29815751311e5f8fd8a2ade#id-3.-let-a-solana-wallet-call-it).

### Etapa 4. Conecte a via

O SDK precisa de cinco valores: uma URL do proxy, um chain ID, o ID do programa da Rome, uma conexão RPC da Solana e um signer. Quatro descrevem a cadeia. Um vem da carteira.

```javascript
const deps = { connection, proxyUrl, chainId, programId, signer };
const res = await submitRomeTxV1(deps, { to: helloRome, data }); // helloRome: seu contrato da lição 3; data: a chamada greet() codificada em ABI
```

Para Hadrian, leia os quatro valores da cadeia no registro. O mapeamento está na `deps` tabela do guia vinculada na etapa 3, e os valores estão em [Hadrian](https://docs.rome.builders/pt-br/redes/hadrian.md). A lição 11 cobre a mesma integração para Rubicon.

Duas etapas únicas vêm antes da primeira chamada de movimentação de valor de um novo usuário. Provisione o sintético com `buildCreatePdaCall`, e conceda ao wrapper se `isEnabled` for falso. `submitRomeTxV1` não provisiona para você. A lição 9 executa ambas em ordem.

### Etapa 5. Fique dentro de uma única transação

Uma chamada da via Solana precisa caber em uma transação Solana: cerca de 1,4 milhão de unidades de computação, 64 contas e 4 KB. Meça com `computeUnitsConsumed` do recibo da Solana, não do EVM `gasUsed`. Solicite a transação com `maxSupportedTransactionVersion: 1`; sem isso, o RPC recusa a solicitação.

Quando uma chamada não cabe, o composer a recusa e o SDK a entrega ao proxy para retransmitir com a mesma assinatura de autorização. O usuário ainda vê um único prompt. O resultado traz `route: "relay"`. Uma chamada retransmitida gasta o gás nativo do sintético, então recarregue-o primeiro com `fundSyntheticGas`. Uma chamada retransmitida que reverte não lança erro. Verifique `receipt.status`. As regras estão em [Chamadas retransmitidas e chamadas longas](https://docs.rome.builders/pt-br/guias-do-desenvolvedor/call-evm-from-solana.md#relayed-calls-and-long-calls). Limites em uma tabela: [Restrições](https://docs.rome.builders/pt-br/conceitos-principais/constraints.md).

## Teste-se

Responda a estas, depois abra as respostas.

1. Por que um `payable` depósito falha para um usuário Solana?
2. Quantas assinaturas a carteira produz por chamada, e o que cada uma cobre?
3. Para onde vai a transação assinada?
4. Uma chamada precisa de mais de uma transação. O que o usuário vê e quem paga?

<details>

<summary>Respostas</summary>

1. O dinheiro do usuário é um token SPL na carteira dele, mostrado na Rome como o wrapper. O sintético não mantém saldo nativo no modelo de funding e sweep a menos que você o abasteça, então não há `msg.value` nada para enviar.
2. Duas. A primeira cobre uma mensagem de autorização legível com o hash da transação EVM. A segunda cobre a transação Solana.
3. Para o RPC da Solana, enviada pelo app. O proxy compõe a transação e não a recebe, exceto em uma chamada retransmitida.
4. Um único prompt de autorização. O proxy retransmite a chamada e o saldo de gás nativo do sintético paga por ela.

</details>

## Próximo

[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)


---

# 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/07-open-to-solana-wallets.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.
