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

# Rome Bridge

Rome Bridge — eine eigenständige Bridge und eine integrierbare API, ohne Verwahrungsschlüssel.

Rome Bridge ist zweierlei: ein **eigenständige Bridge** zwischen Rome und sieben EVM-Chains plus Solana sowie eine **Bridge-API** jede App integriert wird, um Bridging in ihre eigene UX einzubetten. Sie bewegt Assets über CCTP v2 (USDC), Solana-native Rails (SOL und USDC) und, im Testnet, Wormhole (ETH nach Rome).

Es hält **keine Verwahrungsschlüssel** — der Settlement-Vorgang erfordert immer die eigene Signatur des Nutzers, niemals die des Dienstes. Die API orchestriert und kann Gebühren sponsern; die eigentliche Bridge ist on-chain.

## Unterstützte Chains und Assets

Die Bridge läuft auf Rubicon (Mainnet) und auf Hadrian (dem öffentlichen Testnet). Jede hat ihre eigene Bridge-Seite und ihren eigenen API-Host. Die erwartete Dauer für einen Transfer steht im Quote.

Auf beiden Netzwerken gibt es neben SOL und USDC, `POST /v1/quote` mit `asset: "SPL"` und `splAsset: {mint, decimals}` liefert den Transfer für jedes SPL-Token zwischen einer Solana-Wallet und Rome, und deine Wallet signiert die Transaktionen, die es zurückgibt. Das Token kommt auf Rome als sein Wrapper an. Diese Route ist nicht aufgeführt in `/v1/routes`.

### Rubicon (Mainnet)

| Asset             | Schiene | Richtung                      | Blockchains                                             |
| ----------------- | ------- | ----------------------------- | ------------------------------------------------------- |
| **USDC**          | CCTP v2 | Nach Rome und aus Rome heraus | Ethereum, Base, Arbitrum, Polygon, Avalanche, Monad, OP |
| **SOL**, **USDC** | Solana  | Nach Rome und aus Rome heraus | Eine Solana-Wallet                                      |

Es gibt keine ETH-Route auf dem Mainnet. Der gasfreie Modus von MetaMask funktioniert für CCTP-Einzahlungen. Wenn Metamasks Relayer deine Einzahlung einreicht, akzeptiert die Bridge sie, wenn der Einzahler der im Quote genannte Sender ist und der Burn dem Quote entspricht. Eine weitergeleitete Transaktion darf nur einen Burn enthalten.

Beim Bewegen von USDC aus Rome heraus mit CCTP wird das wUSDC-Token verbraucht, nicht das Gas-USDC, und der Transfer endet mit einer Claim-Transaktion auf der Ziel-Chain. Der Wrap-Tab der Bridge-Seite verwandelt Gas mit einer einzigen Signatur in wUSDC.

Die Liste der Routen ist [`/v1/routes`](https://bridge-api.mainnet.romeprotocol.xyz/v1/routes). [`/v1/chains`](https://bridge-api.mainnet.romeprotocol.xyz/v1/chains) listet die Rome-Chain mit ihren Registry-Assets und Fähigkeiten auf. Auf dem Mainnet nennt diese Liste weiterhin Wormhole und ETH, obwohl keine ETH-Route existiert.

### Hadrian (Testnetz)

| Asset             | Schiene  | Richtung                      | Blockchains                                                                                               |
| ----------------- | -------- | ----------------------------- | --------------------------------------------------------------------------------------------------------- |
| **USDC**          | CCTP v2  | Nach Rome und aus Rome heraus | Ethereum Sepolia, Arbitrum Sepolia, Base Sepolia, Polygon Amoy, Avalanche Fuji, Monad Testnet, OP Sepolia |
| **ETH**           | Wormhole | Nach Rome                     | Ethereum Sepolia                                                                                          |
| **SOL**, **USDC** | Solana   | Nach Rome und aus Rome heraus | Eine Solana-Wallet                                                                                        |

Der Live-Satz ist immer in [`/v1/routes`](https://bridge-api.devnet.romeprotocol.xyz/v1/routes) und [`/v1/chains`](https://bridge-api.devnet.romeprotocol.xyz/v1/chains). Benötigst du Test-Token? Siehe [Faucets](https://docs.rome.builders/de/ressourcen/faucets.md).

## Allein verwenden

Öffne die Bridge-UI für das gewünschte Netzwerk:

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

Die `?chain=` Der Parameter wählt die Rome-Chain aus.

## API integrieren

Die API ist öffentlich. Liste die unterstützten Chains und Rails auf:

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

`POST /v1/quote` nimmt die nicht-Rome-Seite des Transfers in `sourceChain`, in beide Richtungen: CAIP-2 (`eip155:8453`, `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`) oder die älteren Namen `ethereum` / `solana`, die weiterhin mit einem `Sunset` Header akzeptiert werden (verwende CAIP-2). `GET /v1/routes` nimmt keine Parameter an und listet die verfügbaren Transfers auf. Eine Quote-Anfrage:

```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>"}'
```

`Betrag` ist eine Zeichenfolge aus Basiseinheiten. USDC hat 6 Dezimalstellen, also `"1000000"` ist 1 USDC. Die Antwort enthält die erwartete Zeit in `etaSeconds`. Sieh dir die Endpunkt-Antworten für den Rail-Satz und die anderen Felder an.

## Wie Settlement funktioniert

Die Off-Chain-API ist nur ein Orchestrator und Gebührensponsor. Eingehende Transfers werden on-chain durch eine vom Nutzer signierte Autorisierung abgewickelt; ausgehende Auszahlungen laufen über den on-chain Bridge-Contract. Kein Schritt belastet Nutzergelder ohne die Signatur des Nutzers.


---

# 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/de/apps-auf-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.
