> 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/zh/rome-shang-de-ying-yong/bridge-api.md).

# Rome Bridge

Rome Bridge——一个独立的跨链桥和可集成 API，不涉及托管密钥。

Rome Bridge 有两种形式：一个 **独立桥** 在 Rome 与七条 EVM 链以及 Solana 之间的，以及一个 **Bridge API** 任何应用都可以集成，以便在自身 UX 中嵌入跨链桥接。它通过 CCTP v2（USDC）、Solana 原生通道（SOL 和 USDC），以及在测试网上通过 Wormhole（将 ETH 转入 Rome）转移资产。

它持有 **不持有托管密钥** ——结算始终需要用户自己的签名，而不是服务方的签名。API 负责协调，并且可以代付手续费；真正的桥接在链上完成。

## 支持的链和资产

该桥运行于 Rubicon（主网）和 Hadrian（公共测试网）上。每个网络都有自己的桥接页面和 API 主机。转账的预计时间会显示在报价中。

在两个网络上，除了 SOL 和 USDC 之外， `POST /v1/quote` 外 `asset: "SPL"` 和 `splAsset: {mint, decimals}` 返回 Solana 钱包与 Rome 之间任意 SPL 代币的转账信息，并且你的钱包会对其返回的交易进行签名。该代币到达 Rome 后会以其包装版本的形式出现。此路由未列在 `/v1/routes`.

### Rubicon（主网）

| 资产                | 通道      | 方向               | 链                                            |
| ----------------- | ------- | ---------------- | -------------------------------------------- |
| **USDC**          | CCTP v2 | 转入 Rome 和转出 Rome | 以太坊、Base、Arbitrum、Polygon、Avalanche、Monad、OP |
| **SOL**, **USDC** | Solana  | 转入 Rome 和转出 Rome | 一个 Solana 钱包                                 |

主网上没有 ETH 路由。MetaMask 的免 Gas 模式适用于 CCTP 存入。当 MetaMask 的中继器提交你的存款时，如果存款人是报价中指定的发送方且销毁记录与报价一致，桥接会接受该存款。一次经由中继提交的交易只能包含一次销毁。

通过 CCTP 将 USDC 从 Rome 转出时，消耗的是 wUSDC 代币，而不是用于 gas 的 USDC，转账最终会在目标链上通过一笔领取交易完成。桥接页面的 Wrap 选项卡可在一次签名中将 gas 转换为 wUSDC。

路由列表位于 [`/v1/routes`](https://bridge-api.mainnet.romeprotocol.xyz/v1/routes). [`/v1/chains`](https://bridge-api.mainnet.romeprotocol.xyz/v1/chains) 列出了 Rome 链及其注册资产和功能。在主网上，该列表仍然包含 Wormhole 和 ETH，尽管实际上并不存在 ETH 路由。

### Hadrian（测试网）

| 资产                | 通道       | 方向               | 链                                                                                              |
| ----------------- | -------- | ---------------- | ---------------------------------------------------------------------------------------------- |
| **USDC**          | CCTP v2  | 转入 Rome 和转出 Rome | 以太坊 Sepolia、Arbitrum Sepolia、Base Sepolia、Polygon Amoy、Avalanche Fuji、Monad Testnet、OP Sepolia |
| **ETH**           | Wormhole | 转入 Rome          | Ethereum Sepolia                                                                               |
| **SOL**, **USDC** | Solana   | 转入 Rome 和转出 Rome | 一个 Solana 钱包                                                                                   |

实时集合始终在 [`/v1/routes`](https://bridge-api.devnet.romeprotocol.xyz/v1/routes) 和 [`/v1/chains`](https://bridge-api.devnet.romeprotocol.xyz/v1/chains)。需要测试代币？请参阅 [水龙头](https://docs.rome.builders/zh/zi-yuan/faucets.md).

## 单独使用

打开所需网络的桥接 UI：

* Rubicon（主网）： [bridge-api.mainnet.romeprotocol.xyz](https://bridge-api.mainnet.romeprotocol.xyz/?chain=7531)
* Hadrian（测试网）： [bridge-api.devnet.romeprotocol.xyz](https://bridge-api.devnet.romeprotocol.xyz/?chain=200010)

这些 `?chain=` 该参数用于选择 Rome 链。

## 集成 API

该 API 为公开接口。列出支持的链和通道：

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

`POST /v1/quote` 接收转账中非 Rome 一侧的信息格式 `sourceChain`，双向均适用：CAIP-2（`eip155:8453`, `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`）或旧名称 `ethereum` / `solana`，这些名称目前仍可通过一个 `Sunset` 请求头接受（请使用 CAIP-2）。 `GET /v1/routes` 不接受任何参数，并列出可用的转账。报价请求：

```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` 是以最小单位表示的字符串。USDC 有 6 位小数，因此 `"1000000"` 即 1 USDC。响应中会包含预计时间，字段为 `etaSeconds`。有关通道集合和其他字段，请参见端点响应。

## 结算如何运作

链下 API 仅充当协调器和手续费赞助方。入站转账通过用户签名的授权在链上完成结算；出站提现则通过链上桥接合约完成。任何步骤都不会在没有用户签名的情况下扣减用户资金。


---

# 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/zh/rome-shang-de-ying-yong/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.
