> 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/06-tokens-on-both-sides.md).

# 6. Tokens en ambos lados

Cómo un token SPL aparece como un envoltorio ERC-20 para billeteras EVM y como una cuenta de token para billeteras de Solana, y la autorización única que permite a los contratos moverlo.

Los tokens son la base de todos los casos de uso en [2. Qué puedes crear](https://docs.rome.builders/es/rome-academy/02-what-you-can-build.md): un pool, una bóveda o un mercado de préstamos mueven el mismo activo que tienen las billeteras de Solana. Un wrapper SPL expone un mint SPL mediante una interfaz ERC-20. Para los tokens que tiene una billetera, el wrapper consulta el saldo en la cuenta de tokens derivada de Rome de la billetera, de modo que Solana y Solidity ven el mismo saldo. En esta lección se explica cómo funciona y cuál es la única autorización que debe conceder cada usuario para que tu contrato pueda mover sus tokens.

## Qué aprenderás

* Cómo un wrapper SPL expone el saldo de tokens de Solana de una billetera mediante métodos ERC-20.
* Qué hacen la fábrica y el wrapper, y qué wrapper usar.
* En qué se diferencian los tokens que tienen los contratos de los que tienen las billeteras.
* La autorización única `approve_spl` , cómo comprobarla y qué puede invalidarla.

## Antes de empezar

* Finalizar [5. Llamar a Solana desde Solidity](https://docs.rome.builders/es/rome-academy/05-call-solana-from-solidity.md). Necesitas conocer el concepto de PDA de autoridad externa y el precompilado Helper.
* Ten una billetera Hadrian con fondos y un contrato desplegado. Las direcciones canónicas de los wrappers están en el archivo `tokens.json` del registro de la cadena: la entrada con `kind: "spl_wrapper"` y el símbolo `wUSDC`. [Hadrian](https://docs.rome.builders/es/redes/hadrian.md) enlaza a la carpeta del registro de la cadena.
* La cuenta de tokens de USDC que creaste con `createMyAta` en la lección 5. La autorización requiere que exista.

## Un saldo, dos formas de verlo

Cada dirección EVM tiene una PDA de autoridad externa en Solana, y esa PDA es propietaria de las cuentas de tokens de la dirección. El método `balanceOf` del wrapper ERC-20 consulta directamente la cuenta de tokens de la billetera. `totalSupply` consulta el mint.

En Rome, el token SPL de una billetera y su wrapper ERC-20 consultan la misma cuenta de tokens. Tanto una billetera de Solana con USDC como una dirección EVM con USDC tienen el mismo mint y operan contra las mismas cuentas de pool. Así es como la liquidez permanece en un solo lugar en Rome. La ilustración y los detalles están en [Interoperabilidad de tokens](https://docs.rome.builders/es/conceptos-basicos/token-interop.md#the-shared-state-model).

## Las billeteras y los contratos tienen los tokens de forma distinta

El saldo compartido se aplica a las billeteras, pero los contratos son distintos. Un contrato no puede conceder en nombre de un usuario la autorización única que se describe a continuación, por lo que los wrappers habituales mantienen los tokens de un contrato en una cuenta de tokens de depósito en garantía y llevan un registro de lo que pertenece a cada contrato. Los wrappers de Token-2022 con hooks no llevan ningún registro y usan la propia cuenta de tokens del contrato.

De esto se desprenden dos cosas:

* Dos wrappers del mismo mint muestran el mismo saldo de una billetera. Pueden mostrar saldos distintos para un contrato, porque cada uno lleva su propio registro.
* Para pools, bóvedas y mercados de préstamos, usa el wrapper canónico que el registro indica para cada mint en cada cadena. No lo elijas por el nombre.

Una transferencia a un contrato a través del wrapper abona el saldo en ese registro. No le proporciona al contrato una cuenta de tokens desde la que pueda gastar. Los flujos que requieren que el contrato actúe en Solana usan el proceso descrito en [Integrar un programa de Solana](https://docs.rome.builders/pages/52b676b8d62317a0f46fd6ed850e41457cb887c8#id-3.-tokens-in-tokens-out).

## La fábrica y el wrapper

`ERC20SPLFactory` despliega un wrapper para un mint SPL. Cada fábrica permite un solo wrapper por mint. El wrapper ofrece una interfaz ERC-20 completa:

* `balanceOf` y `totalSupply` consultan el estado de Solana.
* `transfer` y `transferFrom` mueven tokens en Solana.
* `approve` y `allowance` mantiene las allowances habituales de ERC-20 en el almacenamiento de EVM, porque una cuenta de tokens no tiene nada equivalente.

Rara vez tendrás que desplegar un wrapper. Rome y el registro ya incluyen los canónicos para USDC, ETH y SOL. Solo despliegas uno cuando incorporas un nuevo mint. Ambas llamadas a la fábrica están en [La fábrica](https://docs.rome.builders/es/conceptos-basicos/token-interop.md#the-factory). La fábrica también admite mints de Token-2022, pero sus extensiones cambian la integración: un wrapper con hook revierte las llamadas simples a `transfer` y `transferFrom`, y un mint con comisión por transferencia puede entregar menos de lo que envías. Lee [Mints de Token-2022](https://docs.rome.builders/es/conceptos-basicos/token-interop.md#token-2022-mints) antes de usar uno en tu bóveda.

Los importes deben caber en `uint64`, porque los importes SPL usan ese tipo y el wrapper rechaza cualquier valor superior. El token de gas tiene sus propios decimales, mientras que los saldos de gas nativo usan 18. La conversión entre ambos debe ser exacta. El token de gas en Hadrian y Rubicon es USDC.

## La autorización única

El wrapper mueve los tokens de un usuario como delegado SPL de la cuenta de tokens del usuario. La cuenta de tokens debe designar a ese delegado antes de que el wrapper pueda mover nada. El usuario lo hace una vez por wrapper con una sola llamada, por el importe máximo:

`approve_spl(wrapper, type(uint64).max, mint)` en el precompilado Helper.

En la práctica, hay cuatro detalles importantes:

* **El usuario la envía.** La autorización la firma la propia cuenta del usuario y se envía directamente al precompilado Helper. Tu contrato no puede enviarla en su nombre. Añade un paso «Habilitar» a tu interfaz.
* **Se aplica a todos.** Tanto las carteras de MetaMask como las direcciones sintéticas de las carteras de Solana la necesitan para cada wrapper cuyos tokens quieran mover.
* **Compruébala primero.** La función `isEnabled(user)` del wrapper devuelve `true` cuando la autorización está concedida. Compruébalo antes de una transferencia, en lugar de darlo por hecho.
* **Concede el máximo.** `isEnabled` sigue devolviendo `true` mientras quede alguna parte de una autorización limitada. Una autorización limitada interrumpe las transferencias habituales cuando se agota, y tu aplicación no sabrá que debe volver a solicitarla.

El mint que debes pasar es `mint_id()` del wrapper. En [Concesión única: autorizar el wrapper](https://docs.rome.builders/es/guias-para-desarrolladores/dual-lane-app.md#one-time-grant-the-wrapper).

### Cómo se rompe

Una cuenta de tokens tiene un solo delegado. Si el usuario autoriza a un puente o a un router, esa autorización reemplaza la del wrapper, que deja de funcionar para ese usuario. El síntoma es una reversión con el error SPL `0x4`, que indica una discrepancia del propietario. La solución es volver a autorizar el wrapper. Por eso, comprueba `isEnabled` antes de un flujo que dependa del wrapper, no solo durante el registro.

Una nueva versión de la fábrica incorpora un nuevo wrapper, y cada cartera autoriza el nuevo de la misma manera.

## Transferir tokens desde el wrapper

Como el saldo del wrapper ya es el saldo SPL, transferir un token a Solana es una transferencia SPL.

* A otra cartera de Solana desde una cartera de EVM: `transfer_spl` enviados directamente desde la cartera al precompilado Helper, o `RomeBridgeWithdraw.bridgeOutToSolana`, que también requiere una autorización para el contrato del puente. En ambos casos, la cuenta de tokens del destinatario debe existir.
* A la cartera que firmó la transacción: `transfer_spl_to_signer`. Solo llega a la propia cartera del usuario por la vía de Solana firmada con la cartera. Desde MetaMask, quien firma es el pagador proxy de Rome, así que usa las otras dos opciones.
* Para el token de gas, `withdraw_to_ata` y `deposit_from_ata` convierten entre el gas nativo y el token en una cuenta de tokens.

Solgate conecta activos de Solana con cadenas EVM de AggLayer en ambas direcciones, tanto en la red principal como en la red de pruebas. En la red de pruebas, el registro de tokens SPL no requiere permisos. USDC usa CCTP. [Lección 10](https://docs.rome.builders/es/rome-academy/10-from-other-chains.md) vuelve a los flujos entrantes y al puente. La lista de métodos está en [Depósitos y retiros](https://docs.rome.builders/es/conceptos-basicos/token-interop.md#deposit-and-withdraw).

## Comprueba lo aprendido

En Hadrian, con la cartera que has financiado:

1. Consulta `isEnabled` para tu dirección en el wrapper canónico de wUSDC del registro.
2. Asegúrate de que exista tu cuenta de tokens de USDC. La llamada `createMyAta` de la lección 5 la creó. Si omitiste ese paso, convierte una pequeña cantidad de gas en wUSDC con `withdraw_to_ata`, como se muestra en [La misma aplicación desde MetaMask](https://docs.rome.builders/es/guias-para-desarrolladores/dual-lane-app.md#the-same-app-from-metamask).
3. Si `isEnabled` es `false`, envía la autorización `approve_spl` al precompilado Helper. Usa el código de la guía de doble vía enlazada arriba.
4. Vuelve a consultar `isEnabled` . Ahora debería ser `true`.
5. Encuentra la transacción de autorización en el [Explorador de Via](https://docs.rome.builders/es/apps-en-rome/via.md). Busca la instrucción SPL Token `ApproveChecked` .

<details>

<summary>1. ¿Por qué dos wrappers sobre una misma mint muestran el mismo saldo de la cartera?</summary>

Ambos leen la cuenta de tokens de la cartera en Solana. Un wrapper es una vista del token SPL, no un libro mayor independiente. Solo los saldos que mantienen los contratos se contabilizan por wrapper.

</details>

<details>

<summary>2. Un usuario aporta activos a tu bóveda y luego usa un router que solicita su propia autorización <code>approve_spl</code>. Tu siguiente llamada a <code>transferFrom</code> falla con el error SPL 0x4. ¿Por qué?</summary>

Una cuenta de tokens tiene un solo delegado. La autorización del router sustituyó la del wrapper. El usuario debe volver a autorizar al wrapper, y tu aplicación debería comprobar `isEnabled` antes de la transferencia.

</details>

<details>

<summary>3. ¿Qué wrapper de pool usas para un nuevo pool de liquidez?</summary>

El wrapper canónico que el registro asigna a ese mint en esa cadena. Los saldos retenidos por el contrato difieren entre wrappers.

</details>

## Siguiente

[7. Abre tu app de EVM para las wallets de Solana](https://docs.rome.builders/es/rome-academy/07-open-to-solana-wallets.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/06-tokens-on-both-sides.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.
