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

# Rome Bridge

Rome Bridge — uma bridge independente e uma API integrável, sem chaves de custódia.

O Rome Bridge é duas coisas: uma **ponte independente** entre Rome e sete redes EVM mais Solana, e uma **API da ponte** qualquer app se integra para incorporar a ponte em sua própria UX. Ele movimenta ativos via CCTP v2 (USDC), rotas nativas da Solana (SOL e USDC) e, na testnet, Wormhole (ETH para Rome).

Ele mantém **nenhuma chave de custódia** — a liquidação sempre exige a assinatura do próprio usuário, nunca a do serviço. A API orquestra e pode patrocinar as taxas; a ponte de verdade está on-chain.

## Redes e ativos suportados

A ponte roda na Rubicon (mainnet) e na Hadrian (a testnet pública). Cada uma tem sua própria página da ponte e host de API. O tempo esperado de uma transferência aparece na cotação.

Em ambas as redes, além de SOL e USDC, `POST /v1/quote` com `asset: "SPL"` e `splAsset: {mint, decimals}` retorna a transferência para qualquer token SPL entre uma carteira Solana e Rome, e sua carteira assina as transações que ele retorna. O token chega a Rome como sua versão encapsulada. Esta rota não está listada em `/v1/routes`.

### Rubicon (mainnet)

| Ativo             | Via     | Direção                       | Redes                                                   |
| ----------------- | ------- | ----------------------------- | ------------------------------------------------------- |
| **USDC**          | CCTP v2 | Para Rome e para fora de Rome | Ethereum, Base, Arbitrum, Polygon, Avalanche, Monad, OP |
| **SOL**, **USDC** | Solana  | Para Rome e para fora de Rome | Uma carteira Solana                                     |

Não há rota de ETH na mainnet. O modo sem gas da MetaMask funciona para depósitos via CCTP. Quando o relayer da MetaMask envia seu depósito, a ponte o aceita se o depositante for o remetente nomeado na cotação e a queima corresponder à cotação. Uma transação retransmitida pode conter apenas uma queima.

Mover USDC para fora de Rome com CCTP gasta o token wUSDC, não o USDC de gas, e a transferência termina com uma transação de claim na rede de destino. A aba Wrap da página da ponte converte gas em wUSDC em uma única assinatura.

A lista de rotas é [`/v1/routes`](https://bridge-api.mainnet.romeprotocol.xyz/v1/routes). [`/v1/chains`](https://bridge-api.mainnet.romeprotocol.xyz/v1/chains) lista a chain Rome com seus ativos e capacidades registrados no registry. Na mainnet, essa lista ainda menciona Wormhole e ETH, embora não exista rota ETH.

### Hadrian (testnet)

| Ativo             | Via      | Direção                       | Redes                                                                                                     |
| ----------------- | -------- | ----------------------------- | --------------------------------------------------------------------------------------------------------- |
| **USDC**          | CCTP v2  | Para Rome e para fora de Rome | Ethereum Sepolia, Arbitrum Sepolia, Base Sepolia, Polygon Amoy, Avalanche Fuji, Monad Testnet, OP Sepolia |
| **ETH**           | Wormhole | Para Rome                     | Ethereum Sepolia                                                                                          |
| **SOL**, **USDC** | Solana   | Para Rome e para fora de Rome | Uma carteira Solana                                                                                       |

O conjunto ao vivo está sempre em [`/v1/routes`](https://bridge-api.devnet.romeprotocol.xyz/v1/routes) e [`/v1/chains`](https://bridge-api.devnet.romeprotocol.xyz/v1/chains). Precisa de tokens de teste? Veja [Faucets](https://docs.rome.builders/pt-br/recursos/faucets.md).

## Use-o de forma independente

Abra a interface da ponte para a rede que você quiser:

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

O `?chain=` o parâmetro seleciona a chain Rome.

## Integre a API

A API é pública. Liste as chains e vias suportadas:

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

`POST /v1/quote` lida com o lado não Rome da transferência em `sourceChain`, em ambas as direções: CAIP-2 (`eip155:8453`, `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`) ou os nomes mais antigos `ethereum` / `solana`, que ainda são aceitos com um `Sunset` cabeçalho (use CAIP-2). `GET /v1/routes` não recebe parâmetros e lista as transferências disponíveis. Uma solicitação de cotação:

```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` é uma string de unidades base. O USDC tem 6 casas decimais, então `"1000000"` é 1 USDC. A resposta traz o tempo esperado em `etaSeconds`. Veja as respostas do endpoint para o conjunto de vias e os outros campos.

## Como a liquidação funciona

A API off-chain é apenas uma orquestradora e patrocinadora de taxas. Transferências de entrada são liquidadas on-chain por meio de uma autorização assinada pelo usuário; saques de saída passam pelo contrato da ponte on-chain. Nenhuma etapa debita fundos do usuário sem a assinatura do usuário.


---

# 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/pt-br/apps-na-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.
