> 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/10-from-other-chains.md).

# 10. Trae usuarios y fondos desde otras cadenas

Lleva usuarios y sus fondos a tu app de Rome desde otras cadenas y desde Solana, con el puente, su API y la CLI, y mantén la pantalla de tu app en vivo.

Tu aplicación funciona con ambos tipos de billetera. Ahora los usuarios necesitan una forma de llegar. La mayoría tiene USDC en otra cadena o en Solana, y no deberían tener que aprender primero a usar Rome. En esta lección usarás la API de Rome Bridge para traer USDC desde una cadena compatible, hacer seguimiento de la transferencia y permitir que los usuarios retiren sus fondos, mientras mantienes tu aplicación actualizada. [2. Qué puedes crear](https://docs.rome.builders/es/rome-academy/02-what-you-can-build.md) muestra dónde encaja esto.

## Qué aprenderás

* Cómo puede un usuario de otra cadena acceder a tu aplicación de Rome sin salir de su entorno habitual.
* Cómo llega a Rome el USDC de un usuario desde una cadena EVM y desde Solana.
* Por qué una transferencia llega como gas o como wUSDC y cómo elegir.
* Los cuatro pasos de una transferencia entrante.
* Por qué salir de Rome requiere más pasos que llegar.
* Cómo mostrar el estado en tiempo real en tu aplicación y consultar una transferencia en el explorador.

## Antes de empezar

* Completa [9. Crear una aplicación de doble vía](https://docs.rome.builders/es/rome-academy/09-build-a-dual-lane-app.md). Necesitas la bóveda o cualquier aplicación a la que quieras que accedan los usuarios.
* Instala la CLI de Rome ([Rome CLI + MCP](https://docs.rome.builders/es/productos/rome-cli.md)).
* Consigue USDC de prueba en una cadena de origen y el token nativo de esa cadena para pagar la comisión, en [Faucets](https://docs.rome.builders/es/recursos/faucets.md).

## La lección

### Paso 1. Entiende las dos formas de entrar

Con Rome Bridge, tus usuarios llegan desde uno de dos lugares. Una cadena EVM envía USDC mediante CCTP de Circle. Una billetera de Solana envía SOL o USDC mediante transferencias SPL estándar. En ambos casos, el puente funciona en la cadena y la liquidación se realiza con la firma del propio usuario. La API de Bridge, que funciona fuera de la cadena, cotiza la ruta, verifica la transacción de origen y patrocina la comisión de liquidación. No custodia fondos ni claves, así que solo puede activar lo que el usuario ya firmó.

Las cadenas y los activos compatibles varían entre la red de prueba y la red principal, así que consulta las listas en lugar de hacer suposiciones. Están en [Rome Bridge](https://docs.rome.builders/es/apps-en-rome/bridge-api.md), y la lista actualizada está disponible en `/v1/routes`. El patrón para acceder a tu aplicación desde la cadena de origen del usuario se explica en [Desde tu entorno habitual](https://docs.rome.builders/es/guias-para-desarrolladores/from-home.md).

### Paso 2. Decide entre gas y wUSDC

De forma predeterminada, el USDC que llega mediante el puente se recibe como gas. El gas es lo que paga en comisiones un usuario de MetaMask. El token que acepta tu bóveda es wUSDC. Son dos formas del mismo USDC, y el usuario puede convertir una en la otra.

Configura la intención en la cotización. Una aplicación que acepta wUSDC, como tu bóveda, necesita que los usuarios lleguen con wUSDC. Si llegan como gas, primero deben envolver una parte, como en la lección 9. Quienes tengan pensado volver a salir necesitan wUSDC, porque al hacer el puente de salida se quema wUSDC, no gas. Pueden llegar con wUSDC o envolver parte del gas más adelante con `withdraw_to_ata`.

### Paso 3. Realiza una transferencia entrante

Una transferencia entrante consta de cuatro pasos. La ruta `/bridge` del SDK agrupa las llamadas a la API como `requestQuote`, `registerTransfer`, `getTransfer` y `reportStep`. Su versión `registerTransfer` (v0.4.0) sigue enviando la cotización completa, que la API actual rechaza. Por eso, registra la transferencia usando el `quoteId` por tu cuenta, como hace la CLI de Rome.

1. Cotiza la ruta. Envía la cadena de origen, el activo, el importe, el remitente y el destinatario. Los identificadores de cadena deben ser IDs CAIP-2, y los importes deben expresarse como cadenas de enteros en unidades base.
2. El usuario firma las transacciones del primer paso en el orden indicado y exactamente tal como se devuelven. En una transferencia CCTP, son la aprobación de USDC y la quema. En la ruta de gas, el usuario también firma una autorización de liquidación EIP-712 después de que completes el hash de quema.
3. Registra la transferencia. Envía el `quoteId` de la cotización y el hash de quema como `step1TxHash` a `POST /v1/transfers` dentro de los 15 minutos posteriores a la cotización. En la ruta de gas, añade la firma de liquidación como `userSettleSig`. La API comprueba que la transacción coincida con la cotización almacenada y devuelve un ID de transferencia.
4. Consulta la transferencia hasta que `outcome` sea `complete`, y gestiona los estados `failed` y `expired`. Una transferencia completada puede incluir una nota de `degradation` , así que revísala antes de decirle al usuario que recibió el gas o wUSDC.

Las llegadas a Solana siguen el mismo esquema, pero con pasos distintos. El usuario envía una transferencia SPL a su cuenta de Rome. Con la intención de gas, en una cadena cuyo token de gas es USDC, el usuario debe hacer una transacción más para convertir el token envuelto en gas. La cotización enumera todas las firmas que necesita una ruta. Esquemas de solicitud y respuesta: [Desde el inicio](https://docs.rome.builders/es/guias-para-desarrolladores/from-home.md#bring-assets-in).

### Paso 4. Ejecútalo primero desde la CLI

Antes de escribir código para el puente, ejecuta el flujo con la CLI. `rome fund` ingresa USDC como gas; `rome bridge` acepta una intención de gas o de token envuelto; y `rome verify --path from-home` comprueba un recorrido de ida y vuelta completo: ingresar por el puente, operar en Rome y retirar por el puente. Así tendrás una referencia funcional con la que comparar tu integración. Comandos y opciones: [CLI + MCP de Rome](https://docs.rome.builders/es/productos/rome-cli.md).

### Paso 5. Gestiona la salida

Retirar por el puente no es simplemente invertir el flujo de entrada. Para transferir USDC mediante CCTP, el usuario firma dos pasos. El paso 1 consta de dos transacciones en Rome: una autorización que permite al contrato del puente mover el importe exacto que se va a quemar y, a continuación, la quema. Registra la transferencia con el hash de la quema. El paso 2 es la reclamación. Cuando el paso 2 de la transferencia muestra `ready`, incluye el mensaje y la atestación, que el usuario presenta con `receiveMessage` en la cadena de destino. La reclamación no está patrocinada, así que el usuario necesita gas en esa cadena. Envía el hash de la reclamación a la API (`reportStep` en el SDK). Llamadas y esquemas: [Retirar los activos](https://docs.rome.builders/es/guias-para-desarrolladores/from-home.md#take-assets-back-out).

Retirar a una dirección de Solana no requiere ningún paso de reclamación. Para USDC, se trata de una única transacción en Rome que retira los fondos a la cuenta de Solana del usuario.

La autorización afecta a tu aplicación. Una cuenta de token solo puede tener un delegado, así que la autorización del puente sustituye a la del token envuelto hasta que el usuario vuelva a autorizarlo. Comprueba `isEnabled` antes del siguiente depósito, como aprendiste en la lección 9.

### Paso 6. Mantén tu aplicación activa

Los endpoints de Rome admiten `eth_subscribe` para `newHeads` y `logs`, en el mismo host que el RPC HTTPS. Con ethers, `provider.on("block")` y `contract.on(event)` funcionan igual que en cualquier otro lugar. Con viem, el `webSocket` transporte descarta los ID numéricos de suscripción de Rome, así que pasa `poll: true` a `watchBlocks` y `watchEvent`o usa ethers para recibir actualizaciones push. `newPendingTransactions` nunca emite nada, porque Rome no tiene un mempool público. Código: [Suscripciones de WebSocket](https://docs.rome.builders/es/guias-para-desarrolladores/websocket-subscriptions.md).

Al consultar el historial, limita cada llamada a `eth_getLogs` un rango de bloques. El RPC de Rome rechaza los rangos superiores a unos 12 000 bloques. En una transacción que interactúe con Solana, la fila «Liquidada en» de Via enlaza a la transacción de Solana que la liquidó, y el explorador de Solana muestra sus instrucciones y unidades de cómputo. Así puedes responder a un usuario que pregunta dónde está su transferencia. Consulta [Via](https://docs.rome.builders/es/apps-en-rome/via.md) y [Compatibilidad con JSON-RPC](https://docs.rome.builders/es/referencia/json-rpc.md).

## Solgate: activos de Solana y cadenas EVM de AggLayer

[Solgate](https://docs.rome.builders/es/apps-en-rome/solgate.md) conecta activos de Solana con cadenas EVM de AggLayer en ambas direcciones, tanto en la red principal como en la red de pruebas. USDC usa CCTP. Los pasos anteriores usan la API de Rome Bridge.

Para transferir otros tokens o enviar mensajes, consulta [13. Desarrolla en Solgate](https://docs.rome.builders/es/rome-academy/13-build-on-solgate.md).

## Comprueba lo aprendido

Realiza una transferencia real y observa cómo se procesa.

1. Añade fondos a una nueva billetera de Hadrian con algo de USDC para gas y luego transfiere más USDC usando `rome bridge` y la intención de wrapper. Reserva suficiente gas para las aprobaciones, las llamadas a la bóveda y la quema de salida.
2. Consulta el saldo de wUSDC de la billetera en Hadrian, por ejemplo, con `rome call` en el `balanceOf`del wrapper. Con la intención de wrapper, la llegada corresponde a la transacción de Solana del puente (el mensaje de recepción de Circle), no a una transacción de Rome, así que no esperes ver una transacción de llegada en el explorador de Hadrian.
3. Repite la transferencia mediante la API: solicita una cotización, firma, registra y luego consulta `GET /v1/transfers/{id}` hasta que `outcome` indique `complete`.
4. Ejecuta `rome verify hadrian --path from-home` con `--from` (tu cadena de origen) y `--amount` (una cantidad pequeña, como 0.2), y luego consulta el resultado. Tarda unos 20 minutos.

Después, responde:

* ¿De qué saldo se descuentan los USDC que se queman en una transferencia de salida y cómo puede obtenerlo un usuario?
* ¿Quién paga la reclamación en la cadena de destino?

<details>

<summary>Respuestas</summary>

* wUSDC. Los USDC que llegaron como gas corresponden a un saldo distinto. Un usuario obtiene wUSDC mediante la intención de wrapper o envolviendo parte de sus fondos para gas con `withdraw_to_ata`.
* El usuario. La reclamación es una transacción en la cadena de destino, por lo que el usuario necesita gas allí.

</details>

## Siguiente

[11. Enviar a Rubicon](https://docs.rome.builders/es/rome-academy/11-ship-to-rubicon.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/10-from-other-chains.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.
