> 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/apps-en-rome/bridge-api.md).

# Rome Bridge

Rome Bridge — un puente independiente y una API integrable, sin claves de custodia.

Rome Bridge es dos cosas: un **puente independiente** entre Rome y siete cadenas EVM además de Solana, y una **API de Bridge** cualquier app se integra para incorporar el puente en su propia UX. Mueve activos a través de CCTP v2 (USDC), vías nativas de Solana (SOL y USDC) y, en la testnet, Wormhole (ETH hacia Rome).

No contiene **claves de custodia** — la liquidación siempre requiere la firma del propio usuario, nunca la del servicio. La API orquesta y puede patrocinar comisiones; el puente real está en cadena.

## Cadenas y activos compatibles

El puente funciona en Rubicon (mainnet) y en Hadrian (la testnet pública). Cada uno tiene su propia página de puente y host de API. El tiempo esperado para una transferencia aparece en la cotización.

En ambas redes, además de SOL y USDC, `POST /v1/quote` con `asset: "SPL"` y `splAsset: {mint, decimals}` devuelve la transferencia de cualquier token SPL entre una wallet de Solana y Rome, y tu wallet firma las transacciones que devuelve. El token llega a Rome como su versión envuelta. Esta ruta no aparece en `/v1/routes`.

### Rubicon (mainnet)

| Activo            | Vía     | Dirección               | Cadenas                                                 |
| ----------------- | ------- | ----------------------- | ------------------------------------------------------- |
| **USDC**          | CCTP v2 | Hacia Rome y desde Rome | Ethereum, Base, Arbitrum, Polygon, Avalanche, Monad, OP |
| **SOL**, **USDC** | Solana  | Hacia Rome y desde Rome | Una wallet de Solana                                    |

No existe una ruta de ETH en mainnet. El modo sin gas de MetaMask funciona para depósitos CCTP. Cuando el relayer de MetaMask envía tu depósito, el puente lo acepta si el depositante es el remitente indicado en la cotización y el burn coincide con la cotización. Una transacción reenviada puede contener solo un burn.

Mover USDC fuera de Rome con CCTP gasta el token wUSDC, no el USDC del gas, y la transferencia termina con una transacción de claim en la cadena de destino. La pestaña Wrap de la página del puente convierte el gas en wUSDC con una sola firma.

La lista de rutas es [`/v1/routes`](https://bridge-api.mainnet.romeprotocol.xyz/v1/routes). [`/v1/chains`](https://bridge-api.mainnet.romeprotocol.xyz/v1/chains) enumera la cadena Rome con sus activos y capacidades del registro. En mainnet, esa lista sigue mencionando Wormhole y ETH, aunque no existe ninguna ruta de ETH.

### Hadrian (testnet)

| Activo            | Vía      | Dirección               | Cadenas                                                                                                   |
| ----------------- | -------- | ----------------------- | --------------------------------------------------------------------------------------------------------- |
| **USDC**          | CCTP v2  | Hacia Rome y desde Rome | Ethereum Sepolia, Arbitrum Sepolia, Base Sepolia, Polygon Amoy, Avalanche Fuji, Monad Testnet, OP Sepolia |
| **ETH**           | Wormhole | Hacia Rome              | Ethereum Sepolia                                                                                          |
| **SOL**, **USDC** | Solana   | Hacia Rome y desde Rome | Una wallet de Solana                                                                                      |

El conjunto activo siempre está en [`/v1/routes`](https://bridge-api.devnet.romeprotocol.xyz/v1/routes) y [`/v1/chains`](https://bridge-api.devnet.romeprotocol.xyz/v1/chains). ¿Necesitas tokens de prueba? Consulta [Faucets](https://docs.rome.builders/es/recursos/faucets.md).

## Úsalo de forma independiente

Abre la interfaz del puente para la red que quieras:

* Rubicon (mainnet): [bridge-api.mainnet.romeprotocol.xyz](https://bridge-api.mainnet.romeprotocol.xyz/?chain=7531)
* Hadrian (testnet): [bridge-api.devnet.romeprotocol.xyz](https://bridge-api.devnet.romeprotocol.xyz/?chain=200010)

Los `?chain=` el parámetro selecciona la cadena Rome.

## Integra la API

La API es pública. Enumera las cadenas y vías compatibles:

```bash
curl https://bridge-api.mainnet.romeprotocol.xyz/v1/chains   # Rubicon
curl https://bridge-api.devnet.romeprotocol.xyz/v1/chains    # Hadrian
```

`POST /v1/quote` toma el lado no-Rome de la transferencia en `sourceChain`, en ambos sentidos: CAIP-2 (`eip155:8453`, `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`) o los nombres anteriores `ethereum` / `solana`, que aún se aceptan con un `Sunset` encabezado (usa CAIP-2). `GET /v1/routes` no toma parámetros y enumera las transferencias disponibles. Una solicitud de cotización:

```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":"<your 0x address>"},"recipient":"<recipient on Rome>"}'
```

`amount` es una cadena de unidades base. USDC tiene 6 decimales, así que `"1000000"` es 1 USDC. La respuesta incluye el tiempo esperado en `etaSeconds`. Consulta las respuestas del endpoint para el conjunto de vías y los demás campos.

## Cómo funciona la liquidación

La API fuera de cadena es solo un orquestador y patrocinador de comisiones. Las transferencias entrantes se liquidan en cadena mediante una autorización firmada por el usuario; las retiradas salientes pasan por el contrato de puente en cadena. Ningún paso debita fondos del usuario sin su firma.


---

# 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/apps-en-rome/bridge-api.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.
