> 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/guias-para-desarrolladores/from-home.md).

# Desde casa: accede a Rome desde otra cadena

Permite que usuarios de otra cadena lleguen a tu aplicación Rome sin salir de casa: introduce activos, actúa y retíralos de nuevo.

Tus usuarios no tienen que mudarse a Roma. Desde su cadena de origen — una L2 como Arbitrum o Monad, o Solana — traen activos, usan tu app de Roma y retiran los activos de vuelta. El puente está en cadena y autorizado por la propia firma del usuario; conectas tu app a él a través de una sola API.

## Cómo funciona

* **Entrada (origen → Roma):** en la ruta del token de gas USDC sobre CCTP, la `settle_inbound_bridge_v2` instrucción del programa Rome acredita al usuario, bajo una **EIP-712** `SettleAuthorization`, así que no hay un liquidador privilegiado. Las demás rutas de entrada no usan esa instrucción ni esa firma. El USDC envuelto, ETH sobre Wormhole y SOL llegan directamente como el token envuelto en la cuenta del usuario. El USDC de Solana en una cadena cuyo token de gas es USDC necesita una transacción más, firmada por el usuario, para convertir el envoltorio en gas. La cotización te indica qué firmas necesita una ruta.
* **Salida (Roma → origen):** `RomeBridgeWithdraw` (en [`rome-solidity`](https://github.com/rome-protocol/rome-solidity)) quema el activo en Roma. Luego el usuario lo reclama en la cadena de origen con su propia transacción.
* **Transporte:** Circle **CCTP** para USDC y el **Wormhole** puente de tokens para ETH. Las cadenas de origen de Solana usan transferencias SPL normales de entrada y una retirada de Roma de salida. Wormhole es la vía de entrada solo para ETH. Existe una ruta genérica de Wormhole solo para salida, y cada activo en ella debe ser habilitado primero por los operadores de Roma.
* **Orquestación:** el [`rome-bridge-api`](https://github.com/rome-protocol/rome-bridge-api) fuera de la cadena cotiza una ruta, verifica la transacción de la cadena de origen y patrocina la comisión de liquidación. No custodia fondos ni claves. Solo puede activar lo que el usuario ya firmó.

## Constrúyelo

La API es pública en devnet en `https://bridge-api.devnet.romeprotocol.xyz`. `GET /v1/routes` enumera todas las rutas activas (activo, vía, dirección, cadena de origen, cadena de Roma, velocidades). Las llamadas de abajo son las mismas cuatro que el SDK envuelve en `@rome-protocol/sdk/bridge` (`requestQuote`, `registerTransfer`, `getTransfer`, `reportStep`). La CLI ejecuta todo el flujo por ti: `rome fund` y `rome bridge` para las transferencias y `rome verify --path from-home` para un viaje de ida y vuelta, como se describe en la página de [Rome CLI](https://docs.rome.builders/es/productos/rome-cli.md) .

### Trae activos

1. **Cotiza la ruta.** Envía la cadena de origen del usuario, el activo, la cantidad y las direcciones. Las cadenas se pasan como ids CAIP-2, como `eip155:84532`; `romeChainId` es tu cadena de Roma. Los nombres antiguos `ethereum` y `solana` siguen aceptándose pero están obsoletos, y la API marca esas respuestas con un encabezado `Sunset` . La forma completa de la solicitud y la respuesta está en la [referencia de la API](https://github.com/rome-protocol/rome-bridge-api/blob/main/docs/API.md).

   ```bash
   curl -X POST https://bridge-api.devnet.romeprotocol.xyz/v1/quote \
     -H 'Content-Type: application/json' \
     -d '{
       "asset": "USDC",
       "direction": "to-rome",
       "sourceChain": "eip155:84532",
       "romeChainId": "200010",
       "amount": "1000000",
       "sender": { "ethereum": "0xUSER" },
       "recipient": "0xUSER"
     }'
   ```

   Las cantidades son enteros en unidades base en cadenas de texto (`"1000000"` es 1 USDC). Las cantidades de ETH están en wei y, al salir, deben ser un múltiplo de 10,000,000,000 wei (el envoltorio tiene 8 decimales); la API rechaza cualquier precisión mayor. La respuesta enumera los `pasos`. El usuario firma las transacciones de cada paso marcado como `userSigns: true`, en el orden de los pasos: las transacciones EVM están en `unsignedTxs`, las instrucciones de Solana en `unsignedTx`. Fírmelas exactamente como se devuelven. Los pasos sin nada que firmar los completa el patrocinador una vez que Circle o Wormhole han atestiguado la transferencia. La reclamación de salida es la excepción, descrita abajo: la construye el usuario.
2. **Haz que el usuario firme.** Para una cotización CCTP, eso es la aprobación de USDC y la quema en la cadena de origen. Si la cotización tiene una entrada en `signatureRequests`, el usuario también firma ese `SettleAuthorization` EIP-712 una vez que se conoce el hash de la quema; rellena el hash de la quema y pasa el resultado como `userSettleSig` en la siguiente llamada. Solo la ruta CCTP del token de gas tiene una. Wormhole ETH, USDC de intención envuelta y las rutas de Solana no tienen ninguna.
3. **Registra la transferencia.** `POST /v1/transfers` con el `quoteId` y `step1TxHash`, el hash de la última transacción en el primer paso (la quema), 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 rechaza un objeto de cotización completo. Comprueba que la transacción en la cadena de origen coincida con la cotización almacenada y devuelve un `id`.
4. **Consulta** `GET /v1/transfers/{id}` cada pocos segundos hasta que `resultado` es `complete`, y maneja `fallido` y `expired`. Luego el usuario recibe fondos en Roma y puede usar tu app. Una transferencia completa puede incluir una `degradación` nota con un `degradationReason`, así que revísalas antes de decirle al usuario que llegaron los fondos de gas o de envoltorio.

Las cadenas de origen de Solana siguen la misma forma con pasos distintos. El usuario envía una transferencia SPL a la cuenta de token de su cuenta de Roma. SOL llega como SOL envuelto después de esa única transferencia. En una cadena cuyo token de gas es USDC, como Hadrian, USDC necesita un segundo paso: una transacción de Roma que el usuario firma y que convierte el envoltorio recibido en gas nativo. Cualquier otro token SPL pasa por la ruta `spl-solana-to-rome` , que toma el mint en `splAsset`.

### Retira los activos de vuelta

La salida no es el flujo de entrada ejecutado al revés. Tiene más de una firma, y el usuario la completa en la cadena de origen. Cotízala con `direction` establecido en `from-rome`. `sourceChain` nombra el lado no-Roma como un id CAIP-2, y la quema va a esa cadena. `destinationChainId` es opcional y debe coincidir con él cuando lo envíes. El nombre antiguo `ethereum` sigue significando Ethereum Sepolia:

```bash
curl -X POST https://bridge-api.devnet.romeprotocol.xyz/v1/quote \
  -H 'Content-Type: application/json' \
  -d '{
    "asset": "USDC",
    "direction": "from-rome",
    "sourceChain": "eip155:84532",
    "destinationChainId": 84532,
    "romeChainId": "200010",
    "amount": "1000000",
    "sender": { "rome": "0xUSER" },
    "recipient": "0xUSER"
  }'
```

Para USDC sobre CCTP la cotización devuelve dos pasos, y el usuario firma ambos:

1. **En Roma, dos transacciones en orden.** La primera concede `RomeBridgeWithdraw` derechos de delegado sobre el wUSDC del usuario en Solana (`approve_spl`). La concesión cubre exactamente la cantidad de esta quema, así que la cotización la incluye siempre y el usuario la firma antes de cada quema. La segunda quema el wUSDC mediante `RomeBridgeWithdraw`, que inicia la transferencia CCTP. Registra la transferencia con el hash de la quema. La quema gasta wUSDC, el token que la cotización nombra como `burnToken`, no el USDC nativo de gas. Los fondos que entraron como gas no son lo que se quema, así que para un viaje de ida y vuelta trae USDC con `intent: "wrapper"`.
2. **En la cadena de destino, la reclamación.** Consulta `GET /v1/transfers/{id}` hasta que el paso 2 esté `listo`. Entonces lleva el `mensaje` y `atestación`. El usuario llama a `receiveMessage(message, attestation)` en el transmisor de mensajes de Circle en la cadena de destino (la cotización nombra el transmisor y el dominio CCTP). Aquí no hay patrocinio, así que el usuario necesita gas en esa cadena. Reporta el hash de la reclamación con `POST /v1/transfers/{id}/steps/2`.

La salida de ETH desde Roma sobre Wormhole no se ofrece hoy en Hadrian ni en Rubicon. Hadrian enumera ETH sobre Wormhole solo hacia Roma. Rubicon no enumera ninguna ruta de ETH.

Retirar a una dirección de Solana no tiene paso de reclamación. USDC es una única transacción de Roma que retira a la cuenta de Solana del usuario. SOL es un paso de Roma con tres transacciones: la misma concesión de delegado sobre wSOL, la creación opcional de la cuenta de token wSOL del destinatario en Solana (se omite cuando ya existe) y la retirada mediante `RomeBridgeWithdraw`.

**Las transferencias de salida no necesitan ningún paso de activación.** Una quema CCTP crea una cuenta de mensaje en Solana, y esa cuenta necesita rent. La propia cuenta de Solana del contrato puente paga ese rent. Justo antes de su llamada CPI, el contrato llama a `swap_gas_to_lamports`: el pagador de comisiones de Solana de la transacción adelanta los lamports, y se le cobra al usuario por ellos en gas en la misma transacción de quema. Una cartera nueva puede hacer su primera transferencia de salida sin configuración previa. `RomeBridgeWithdraw` está en la versión 13.0.0 en Hadrian y en Rubicon hoy. Las cotizaciones de salida no incluyen ningún paso de activación ni de recarga, así que tu app no necesita comprobar la cuenta del usuario antes de la primera cotización. Las transferencias de entrada tampoco necesitan activación. La CLI de `rome` (0.11.0) todavía tiene su propia comprobación. `rome bridge --to` (sin `--dry-run`) lee los lamports de la cuenta de autoridad externa del usuario en Solana. Si tiene menos de 15,000,000, el comando se detiene y te indica que ejecutes `rome activate <chain>`, que paga 2 USDC en Hadrian a través del contrato `SimpleActivator` . `rome verify --path from-home` hace la misma comprobación antes de empezar. El contrato no necesita esa activación.

## Lee el código

* [appia](https://github.com/rome-protocol/appia) — una app desde casa: los usuarios traen USDC desde su cadena de origen y usan DeFi del lado de Roma sin salir de ella.
* [rome-bridge-api](https://github.com/rome-protocol/rome-bridge-api) — el orquestador (cotizar → verificar → patrocinar).

## Qué sigue

* [Conseguir financiación](https://docs.rome.builders/es/recursos/faucets.md) — la misma ruta de puente financia una cartera de desarrollo nueva.
* [Despliega Solidity](https://docs.rome.builders/es/guias-para-desarrolladores/deploy-solidity.md) — lleva tu app a Roma.


---

# 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/guias-para-desarrolladores/from-home.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.
