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

# 7. Abre tu app de EVM a wallets de Solana

Haz que tu contrato sea utilizable desde una billetera de Solana sin clave EVM, cubriendo la dirección sintética, el valor ERC-20, las dos firmas y el presupuesto atómico.

Tu contrato ya funciona con MetaMask. Ahora haces que una billetera de Solana lo llame con la clave que ya tiene, de modo que el usuario nunca crea una cuenta EVM. Llaman al mismo contrato, en la misma dirección, contra el mismo estado.

## Lo que aprenderás

* Cómo una billetera de Solana se convierte en un `msg.sender` en Rome.
* Por qué este curso toma valor como un depósito ERC-20, y qué `msg.value` necesita de un usuario de Solana.
* Qué firma un usuario de Solana en cada llamada, y a dónde va la transacción.
* Qué cabe en una sola transacción de Solana, y qué sucede con una llamada que no cabe.
* Qué `dependencias` necesita el SDK y de dónde viene cada una.

## Antes de empezar

* Completa [6. Tokens en ambos lados](https://docs.rome.builders/es/rome-academy/06-tokens-on-both-sides.md). Esta lección supone que sabes qué es un wrapper y por qué un usuario lo autoriza una vez.
* Ten `HelloRome` desplegado en Hadrian desde [3. Tu primer contrato en Hadrian](https://docs.rome.builders/es/rome-academy/03-first-contract-on-hadrian.md).
* Instala el SDK de TypeScript, así como en [Rome SDK](https://docs.rome.builders/es/productos/rome-sdk.md#typescript-sdk-rome-protocol-sdk).
* Ten una billetera de Solana que firme transacciones Solana v1, con un poco de SOL de devnet y USDC de devnet. Las faucets se enumeran en [Faucets](https://docs.rome.builders/es/recursos/faucets.md). La compatibilidad con transacciones v1 difiere entre billeteras, así que prueba la tuya primero. [Crear una app de doble vía](https://docs.rome.builders/es/guias-para-desarrolladores/dual-lane-app.md) nombra las billeteras comprobadas hasta ahora.

## La lección

### Paso 1. Conoce la dirección sintética

Una billetera de Solana no tiene dirección EVM, así que Rome deriva una a partir de su clave pública. El resultado es la dirección sintética de la billetera. Es la `msg.sender` que ve tu contrato, y lleva su propio nonce y almacenamiento como cualquier otra cuenta. La misma billetera siempre se mapea a la misma dirección.

```javascript
import { syntheticAddress } from "@rome-protocol/sdk";
const from = syntheticAddress(solanaPubkey); // una dirección ordinaria de 20 bytes
```

En el flujo de este curso, la sintética no mantiene tokens en reposo. Estos comienzan en la billetera Solana del usuario. La etapa de financiamiento los mueve a la cuenta de tokens de la sintética antes de un depósito, y solo entonces el `balanceOf(synthetic)` muestra eso. La etapa de barrido los devuelve a la billetera después de un retiro. Lee el modelo completo en [Llamar a EVM desde Solana](https://docs.rome.builders/es/guias-para-desarrolladores/call-evm-from-solana.md#synthetic-addresses).

### Paso 2. Haz que el contrato esté listo para Solana

La mayoría de los contratos no necesita cambios. Tres reglas deciden si el tuyo es uno de ellos:

* Recibe valor como un ERC-20. Extrae con `transferFrom` después de un `approve`, y devuelve con `transfer`.
* Apunta al wrapper canónico de cada token. No despliegues el tuyo propio.
* Mantén cada llamada de la vía de Solana dentro de una sola transacción de Solana.

La primera regla es la que muerde. Este punto de entrada funciona para usuarios de MetaMask. Falla para usuarios de Solana en el modelo de financiamiento y barrido, porque su sintética no tiene saldo nativo a menos que la financies con `fundSyntheticGas`:

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

Esta sí funciona para ambos, porque ambas vías pueden financiar una `transferFrom`:

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

Las direcciones de los wrappers están en [Direcciones de contrato](https://docs.rome.builders/es/referencia/contract-addresses.md). Las comprobaciones para un contrato listo para Solana están en [Abre tu contrato Solidity a usuarios de Solana](https://docs.rome.builders/pages/d2ec8c59ea44e09028d590f78cfa9f3a2dfd8f20#id-2.-what-makes-a-contract-solana-ready).

### Paso 3. Entiende qué firma la billetera

La llamada del SDK es `submitRomeTxV1`. Para cada llamada, el proxy compone una transacción Solana v1. La billetera firma dos veces con la misma clave. Primero firma un mensaje de autorización legible que nombra el hash de la transacción EVM. Luego firma la propia transacción.

La aplicación envía la transacción firmada al RPC de Solana, no al proxy de Rome. La cadena comprueba la autorización mediante el programa Ed25519 y ejecuta tu llamada como la dirección sintética. El usuario nunca posee una clave EVM.

Antes de que la billetera firme la transacción, el SDK comprueba que transporte exactamente la llamada que el usuario autorizó. Se rechaza cualquier otra cosa. Los detalles están en [Abre tu contrato Solidity a usuarios de Solana](https://docs.rome.builders/pages/d2ec8c59ea44e09028d590f78cfa9f3a2dfd8f20#id-3.-let-a-solana-wallet-call-it).

### Paso 4. Conecta la vía

El SDK necesita cinco valores: una URL de proxy, un ID de cadena, el ID de programa de Rome, una conexión RPC de Solana y un firmante. Cuatro describen la cadena. Uno proviene de la billetera.

```javascript
const deps = { connection, proxyUrl, chainId, programId, signer };
const res = await submitRomeTxV1(deps, { to: helloRome, data }); // helloRome: tu contrato de la lección 3; data: la llamada greet() codificada en ABI
```

Para Hadrian, lee los cuatro valores de la cadena desde el registro. El mapeo está en la `dependencias` tabla de la guía vinculada en el paso 3, y los valores están en [Hadrian](https://docs.rome.builders/es/redes/hadrian.md). La lección 11 cubre el mismo cableado para Rubicon.

Dos pasos únicos ocurren antes de la primera llamada de movimiento de valor de un usuario nuevo. Aprovisiona la sintética con `buildCreatePdaCall`, y concede el wrapper si `isEnabled` es falso. `submitRomeTxV1` no aprovisiona por ti. La lección 9 ejecuta ambos en orden.

### Paso 5. Mantente dentro de una sola transacción

Una llamada de la vía de Solana tiene que caber en una sola transacción de Solana: alrededor de 1,4 millones de unidades de cómputo, 64 cuentas y 4 KB. Mide con `computeUnitsConsumed` del recibo de Solana, no el de EVM `gasUsed`. Solicita la transacción con `maxSupportedTransactionVersion: 1`; sin ello, el RPC rechaza la solicitud.

Cuando una llamada no cabe, el compositor la rechaza y el SDK la entrega al proxy para retransmitirla con la misma firma de autorización. El usuario sigue viendo un solo aviso. El resultado lleva `route: "relay"`. Una llamada retransmitida gasta el gas nativo de la sintética, así que recárgala primero con `fundSyntheticGas`. Una llamada retransmitida que revierte no lanza una excepción. Comprueba `receipt.status`. Las reglas están en [Llamadas retransmitidas y llamadas largas](https://docs.rome.builders/es/guias-para-desarrolladores/call-evm-from-solana.md#relayed-calls-and-long-calls). Límites en una tabla: [Restricciones](https://docs.rome.builders/es/conceptos-basicos/constraints.md).

## Compruébate

Responde a estas, luego abre las respuestas.

1. ¿Por qué un `pagadero` depósito falla para un usuario de Solana?
2. ¿Cuántas firmas produce la billetera por llamada, y qué cubre cada una?
3. ¿A dónde va la transacción firmada?
4. Una llamada necesita más de una transacción. ¿Qué ve el usuario y quién paga?

<details>

<summary>Respuestas</summary>

1. El dinero del usuario es un token SPL en su billetera, mostrado en Rome como el wrapper. La sintética no mantiene saldo nativo en el modelo de financiamiento y barrido a menos que la financies, así que no hay `msg.value` que enviar.
2. Dos. La primera cubre un mensaje de autorización legible con el hash de la transacción EVM. La segunda cubre la transacción Solana.
3. Al RPC de Solana, enviado por la aplicación. El proxy compone la transacción y no la recibe, salvo en una llamada retransmitida.
4. Un solo aviso de autorización. El proxy retransmite la llamada y el saldo de gas nativo de la sintética la paga.

</details>

## Siguiente

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


---

# 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/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.
