> 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/vi/ung-dung-tren-rome/bridge-api.md).

# Cầu Rome

Rome Bridge — một cầu nối độc lập và một API có thể tích hợp, không có khóa lưu ký.

Rome Bridge là hai thứ: một **cầu nối độc lập** giữa Rome và bảy chuỗi EVM cộng thêm Solana, và một **API cầu nối** bất kỳ ứng dụng nào tích hợp để nhúng chức năng cầu nối vào UX của riêng nó. Nó di chuyển tài sản qua CCTP v2 (USDC), các đường ray gốc của Solana (SOL và USDC), và, trên testnet, Wormhole (ETH vào Rome).

Nó không giữ **khóa lưu ký** — việc thanh toán bù trừ luôn đòi hỏi chính chữ ký của người dùng, không bao giờ của dịch vụ. API điều phối và có thể tài trợ phí; cầu nối thực sự nằm trên chuỗi.

## Các chuỗi và tài sản được hỗ trợ

Cầu nối chạy trên Rubicon (mainnet) và trên Hadrian (testnet công khai). Mỗi bên có trang cầu nối và máy chủ API riêng. Thời gian dự kiến cho một lần chuyển nằm trong báo giá.

Trên cả hai mạng, ngoài SOL và USDC, `POST /v1/quote` với `asset: "SPL"` và `splAsset: {mint, decimals}` trả về giao dịch chuyển cho bất kỳ token SPL nào giữa một ví Solana và Rome, và ví của bạn ký các giao dịch mà nó trả về. Token đến Rome dưới dạng phiên bản bọc của nó. Tuyến này không được liệt kê trong `/v1/routes`.

### Rubicon (mainnet)

| Tài sản           | Đường ray | Hướng                    | Các chuỗi                                               |
| ----------------- | --------- | ------------------------ | ------------------------------------------------------- |
| **USDC**          | CCTP v2   | Vào Rome và ra khỏi Rome | Ethereum, Base, Arbitrum, Polygon, Avalanche, Monad, OP |
| **SOL**, **USDC** | Solana    | Vào Rome và ra khỏi Rome | Một ví Solana                                           |

Không có tuyến ETH trên mainnet. Chế độ không phí gas của MetaMask hoạt động cho các khoản nạp CCTP. Khi bộ chuyển tiếp của MetaMask gửi khoản nạp của bạn, cầu nối chấp nhận nếu người nạp là người gửi được nêu trong báo giá và lệnh đốt khớp với báo giá. Một giao dịch được chuyển tiếp chỉ có thể chứa một lệnh đốt.

Di chuyển USDC ra khỏi Rome bằng CCTP sẽ dùng token wUSDC, không phải USDC phí gas, và giao dịch chuyển kết thúc bằng một giao dịch claim trên chuỗi đích. Tab Wrap trên trang cầu nối chuyển gas thành wUSDC chỉ với một chữ ký.

Danh sách các tuyến là [`/v1/routes`](https://bridge-api.mainnet.romeprotocol.xyz/v1/routes). [`/v1/chains`](https://bridge-api.mainnet.romeprotocol.xyz/v1/chains) liệt kê chuỗi Rome cùng các tài sản và khả năng trong registry của nó. Trên mainnet, danh sách đó vẫn nêu Wormhole và ETH, dù không có tuyến ETH nào tồn tại.

### Hadrian (testnet)

| Tài sản           | Đường ray | Hướng                    | Các chuỗi                                                                                                 |
| ----------------- | --------- | ------------------------ | --------------------------------------------------------------------------------------------------------- |
| **USDC**          | CCTP v2   | Vào Rome và ra khỏi Rome | Ethereum Sepolia, Arbitrum Sepolia, Base Sepolia, Polygon Amoy, Avalanche Fuji, Monad Testnet, OP Sepolia |
| **ETH**           | Wormhole  | Vào Rome                 | Ethereum Sepolia                                                                                          |
| **SOL**, **USDC** | Solana    | Vào Rome và ra khỏi Rome | Một ví Solana                                                                                             |

Bộ đang hoạt động luôn nằm trong [`/v1/routes`](https://bridge-api.devnet.romeprotocol.xyz/v1/routes) và [`/v1/chains`](https://bridge-api.devnet.romeprotocol.xyz/v1/chains). Cần token thử nghiệm? Xem [Vòi cấp tiền](https://docs.rome.builders/vi/tai-nguyen/faucets.md).

## Dùng độc lập

Mở giao diện cầu nối cho mạng bạn muốn:

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

Các `?chain=` tham số này chọn chuỗi Rome.

## Tích hợp API

API là công khai. Liệt kê các chuỗi và đường ray được hỗ trợ:

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

`POST /v1/quote` lấy bên không phải Rome của giao dịch chuyển trong `sourceChain`, theo cả hai hướng: CAIP-2 (`eip155:8453`, `solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`) hoặc các tên cũ `ethereum` / `solana`, vốn vẫn được chấp nhận với một `Sunset` header (hãy dùng CAIP-2). `GET /v1/routes` không nhận tham số nào và liệt kê các giao dịch chuyển khả dụng. Một yêu cầu báo giá:

```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` là một chuỗi đơn vị cơ sở. USDC có 6 chữ số thập phân, nên `"1000000"` là 1 USDC. Phản hồi chứa thời gian dự kiến tính bằng `etaSeconds`. Xem các phản hồi của endpoint để biết bộ đường ray và các trường khác.

## Cách thức thanh toán bù trừ hoạt động

API ngoài chuỗi chỉ là bộ điều phối và nhà tài trợ phí. Các giao dịch chuyển vào được thanh toán bù trừ trên chuỗi thông qua một ủy quyền do người dùng ký; các khoản rút ra đi qua hợp đồng cầu nối trên chuỗi. Không bước nào ghi nợ tiền của người dùng mà không có chữ ký của người dùng.


---

# 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/vi/ung-dung-tren-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.
