> 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/rome-academy/10-from-other-chains.md).

# 10. Đưa người dùng và nguồn vốn từ các chain khác

Đưa người dùng và tiền của họ đến ứng dụng Rome của bạn từ các chain khác và từ Solana, bằng cầu nối, API của nó và CLI, đồng thời giữ màn hình của ứng dụng luôn hoạt động.

Ứng dụng của bạn hoạt động với cả hai loại ví. Giờ người dùng cần một cách để truy cập. Hầu hết họ có USDC trên một chuỗi khác hoặc trên Solana, và họ không nên phải tìm hiểu Rome trước. Bài học này dùng Rome Bridge API để chuyển USDC từ một chuỗi được hỗ trợ vào Rome, theo dõi giao dịch chuyển tiền và cho phép người dùng rút tiền ra, đồng thời giữ cho ứng dụng của bạn luôn cập nhật. [2. Bạn có thể xây dựng gì](https://docs.rome.builders/vi/rome-academy/02-what-you-can-build.md) cho thấy nội dung này phù hợp ở đâu.

## Bạn sẽ học được gì

* Cách người dùng trên một chuỗi khác truy cập ứng dụng Rome của bạn mà không cần rời khỏi nơi họ đang dùng.
* Cách USDC của người dùng được chuyển đến Rome từ một chuỗi EVM và từ Solana.
* Vì sao giao dịch chuyển tiền được nhận dưới dạng gas hoặc wUSDC, và cách lựa chọn.
* Bốn bước của một giao dịch chuyển tiền vào.
* Vì sao rời Rome cần nhiều bước hơn so với truy cập vào.
* Cách hiển thị trạng thái trực tiếp trong ứng dụng và kiểm tra giao dịch chuyển tiền trong trình khám phá.

## Trước khi bắt đầu

* Hoàn thành [9. Xây dựng ứng dụng hai luồng](https://docs.rome.builders/vi/rome-academy/09-build-a-dual-lane-app.md). Bạn cần vault hoặc bất kỳ ứng dụng nào mà bạn muốn người dùng truy cập.
* Cài đặt Rome CLI ([Rome CLI + MCP](https://docs.rome.builders/vi/san-pham/rome-cli.md)).
* Có USDC thử nghiệm trên một chuỗi nguồn và token gốc của chuỗi nguồn đó để trả phí, lấy từ [Vòi cấp token](https://docs.rome.builders/vi/tai-nguyen/faucets.md).

## Bài học

### Bước 1. Tìm hiểu hai cách chuyển vào

Với Rome Bridge, người dùng của bạn đến từ một trong hai nơi. Một chuỗi EVM gửi USDC qua CCTP của Circle. Một ví Solana gửi SOL hoặc USDC qua các giao dịch chuyển SPL thông thường. Dù theo cách nào, bridge cũng hoạt động trên chuỗi và giao dịch được xác nhận bằng chữ ký của chính người dùng. Bridge API ngoài chuỗi báo giá tuyến chuyển, kiểm tra giao dịch nguồn và tài trợ phí xác nhận. API không giữ tiền hay khóa, vì vậy chỉ có thể kích hoạt những gì người dùng đã ký.

Các chuỗi và tài sản được hỗ trợ khác nhau giữa testnet và mainnet, vì vậy hãy đọc danh sách thay vì tự suy đoán. Danh sách nằm trên [Rome Bridge](https://docs.rome.builders/vi/ung-dung-tren-rome/bridge-api.md), còn danh sách trực tiếp là từ API tại `/v1/routes`. Mẫu để người dùng truy cập ứng dụng của bạn từ chuỗi họ đang sử dụng được trình bày trong bài [Từ nơi người dùng đang sử dụng](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/from-home.md).

### Bước 2. Chọn gas hoặc wUSDC

Theo mặc định, USDC đến qua bridge sẽ được nhận dưới dạng gas. Người dùng MetaMask dùng gas để trả phí. Token mà vault của bạn nhận là wUSDC. Đây là hai dạng của cùng một loại USDC và người dùng có thể chuyển đổi qua lại.

Đặt ý định trong báo giá. Ứng dụng nhận wUSDC, chẳng hạn như vault của bạn, muốn người dùng đến dưới dạng wUSDC. Người dùng đến dưới dạng gas sẽ bọc một phần gas trước, như trong bài 9. Người dùng dự định rời đi cần wUSDC, vì khi bridge ra, wUSDC bị đốt chứ không phải gas. Họ có thể đến dưới dạng wUSDC hoặc bọc một phần gas sau bằng `withdraw_to_ata`.

### Bước 3. Thực hiện giao dịch chuyển tiền vào

Một giao dịch chuyển tiền vào gồm bốn bước. SDK's `/bridge` subpath đóng gói các lệnh gọi API thành `requestQuote`, `registerTransfer`, `getTransfer` và `reportStep`. Phiên bản `registerTransfer` (v0.4.0) vẫn gửi toàn bộ báo giá, việc mà API trực tiếp từ chối, vì vậy hãy tự đăng ký bằng `quoteId` như Rome CLI thực hiện.

1. Báo giá tuyến chuyển. Gửi chuỗi nguồn, tài sản, số lượng, người gửi và người nhận. Chuỗi được gửi dưới dạng ID CAIP-2, còn số lượng là số nguyên theo đơn vị cơ sở, biểu diễn bằng chuỗi.
2. Người dùng ký các giao dịch của bước đầu tiên theo đúng thứ tự được trả về. Với giao dịch CCTP, đó là lệnh phê duyệt USDC và lệnh đốt. Trên tuyến gas, sau khi bạn điền mã băm giao dịch đốt, người dùng còn ký một ủy quyền xác nhận EIP-712.
3. Đăng ký giao dịch chuyển tiền. Gửi `quoteId` của báo giá và mã băm giao dịch đốt dưới dạng `step1TxHash` đến `POST /v1/transfers` trong vòng 15 phút kể từ khi nhận báo giá. Với tuyến gas, thêm chữ ký quyết toán dưới dạng `userSettleSig`. API kiểm tra giao dịch có khớp với báo giá đã lưu hay không và trả về ID chuyển tiền.
4. Thăm dò trạng thái chuyển tiền cho đến khi `outcome` là `complete`, đồng thời xử lý các trạng thái `failed` và `expired`. Một giao dịch chuyển tiền hoàn tất có thể kèm theo ghi chú `degradation` ; hãy kiểm tra ghi chú này trước khi thông báo cho người dùng rằng gas hoặc wUSDC đã đến.

Các giao dịch nhận trên Solana có cấu trúc tương tự nhưng các bước khác nhau. Người dùng gửi một giao dịch chuyển SPL đến tài khoản Rome của họ. Với ý định gas, USDC trên một chuỗi có token gas là USDC cần thêm một giao dịch từ người dùng để chuyển token bọc thành gas. Báo giá liệt kê mọi chữ ký mà tuyến cần. Cấu trúc yêu cầu và phản hồi: [Từ máy tính](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/from-home.md#bring-assets-in).

### Bước 4. Chạy thử bằng CLI trước

Trước khi viết bất kỳ mã bridge nào, hãy chạy quy trình bằng CLI. `rome fund` đưa USDC vào làm gas, `rome bridge` thực hiện một ý định chuyển gas hoặc token bọc, còn `rome verify --path from-home` xác minh một hành trình khứ hồi hoàn chỉnh: chuyển vào, thực hiện thao tác trên Rome, rồi chuyển ra. Nhờ đó, bạn có một ví dụ tham chiếu hoạt động để đối chiếu với phần tích hợp của mình. Lệnh và cờ: [Rome CLI + MCP](https://docs.rome.builders/vi/san-pham/rome-cli.md).

### Bước 5. Xử lý chiều chuyển ra

Chuyển tài sản ra không phải là quy trình chuyển vào theo chiều ngược lại. Với USDC qua CCTP, người dùng ký hai bước. Bước 1 gồm hai giao dịch Rome: một giao dịch cấp quyền cho phép hợp đồng bridge di chuyển chính xác số lượng của lần đốt này, sau đó là giao dịch đốt. Đăng ký giao dịch chuyển tiền bằng hàm băm của giao dịch đốt. Bước 2 là nhận tài sản. Khi bước 2 của giao dịch chuyển tiền có trạng thái `ready`, trạng thái này đi kèm thông điệp và chứng thực; người dùng gọi `receiveMessage` kèm theo chúng trên chuỗi đích. Phí gas cho bước nhận tài sản không được tài trợ, vì vậy người dùng cần có gas trên chuỗi đó. Gửi hàm băm của giao dịch nhận cho API (`reportStep`  trong SDK). Các lệnh gọi và cấu trúc: [Rút tài sản về](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/from-home.md#take-assets-back-out).

Rút về một địa chỉ Solana không cần bước nhận tài sản. Với USDC, đây là một giao dịch Rome duy nhất để rút tiền vào tài khoản Solana của người dùng.

Việc cấp quyền ảnh hưởng đến ứng dụng của bạn. Một tài khoản token chỉ có một đại diện được ủy quyền, vì vậy quyền cấp cho bridge sẽ thay thế quyền của token bọc cho đến khi người dùng cấp lại quyền cho token bọc. Hãy kiểm tra `isEnabled` trước lần nạp tiếp theo, như đã học trong bài 9.

### Bước 6. Duy trì ứng dụng hoạt động

Các endpoint của Rome hỗ trợ `eth_subscribe` cho `newHeads` và `logs`, trên cùng máy chủ với RPC HTTPS. Với ethers, `provider.on("block")` và `contract.on(event)` hoạt động như ở bất kỳ nơi nào khác. Với viem, `webSocket` transport loại bỏ các ID đăng ký dạng số của Rome, vì vậy hãy truyền `poll: true` cho `watchBlocks` và `watchEvent`, hoặc dùng ethers để nhận cập nhật đẩy. `newPendingTransactions` không bao giờ phát dữ liệu vì Rome không có mempool công khai. Mã: [Đăng ký WebSocket](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/websocket-subscriptions.md).

Khi đọc lịch sử, hãy giới hạn mọi lệnh gọi `eth_getLogs` theo phạm vi khối. RPC của Rome từ chối phạm vi rộng hơn khoảng 12.000 khối. Với giao dịch có liên quan đến Solana, hàng "Đã thanh toán lúc" của Via liên kết đến giao dịch Solana đã thanh toán giao dịch đó; trình khám phá Solana hiển thị các chỉ thị và đơn vị tính toán của giao dịch. Đây là cách bạn trả lời người dùng hỏi khoản chuyển của họ đã đi đâu. Xem [Via](https://docs.rome.builders/vi/ung-dung-tren-rome/via.md) và [Hỗ trợ JSON-RPC](https://docs.rome.builders/vi/tai-lieu-tham-khao/json-rpc.md).

## Solgate: tài sản Solana và các chuỗi EVM AggLayer

[Solgate](https://docs.rome.builders/vi/ung-dung-tren-rome/solgate.md) kết nối tài sản Solana với các chuỗi EVM AggLayer theo cả hai chiều, trên mạng chính và mạng thử nghiệm. USDC sử dụng CCTP. Các bước trên dùng API Rome Bridge.

Để chuyển các token khác hoặc gửi tin nhắn, hãy đọc [13. Xây dựng trên Solgate](https://docs.rome.builders/vi/rome-academy/13-build-on-solgate.md).

## Tự kiểm tra

Thực hiện một giao dịch chuyển tiền thật và quan sát nó.

1. Nạp một ít USDC làm phí gas vào ví Hadrian mới, sau đó chuyển thêm USDC vào bằng `rome bridge` và ý định wrapper. Hãy giữ đủ phí gas cho các lần phê duyệt, lệnh gọi vault và giao dịch đốt khi chuyển ra.
2. Đọc số dư wUSDC của ví trên Hadrian, chẳng hạn bằng `rome call` trên `balanceOf`của wrapper. Với ý định wrapper, giao dịch đến là giao dịch Solana của cầu nối (thông điệp nhận của Circle), chứ không phải giao dịch Rome, vì vậy đừng mong đợi có giao dịch đến trong trình khám phá Hadrian.
3. Lặp lại giao dịch chuyển tiền qua API: lấy báo giá, ký, đăng ký, rồi thăm dò `GET /v1/transfers/{id}` cho đến khi `outcome` có giá trị `complete`.
4. Chạy `rome verify hadrian --path from-home` với `--from` (chuỗi nguồn của bạn) và `--amount` (một lượng nhỏ, chẳng hạn 0.2), rồi đọc kết quả. Quá trình này mất khoảng 20 phút.

Sau đó, hãy trả lời:

* Việc đốt USDC khi chuyển ra sử dụng số dư nào, và người dùng có thể nhận được số dư đó bằng cách nào?
* Ai trả phí yêu cầu nhận trên chuỗi đích?

<details>

<summary>Đáp án</summary>

* wUSDC. USDC nhận được dưới dạng phí gas là một số dư khác. Người dùng nhận wUSDC thông qua ý định wrapper, hoặc bằng cách bọc một phần USDC làm phí gas với `withdraw_to_ata`.
* Người dùng. Yêu cầu nhận tiền là một giao dịch trên chuỗi đích, vì vậy người dùng cần có gas trên chuỗi đó.

</details>

## Tiếp theo

[11. Gửi đến Rubicon](https://docs.rome.builders/vi/rome-academy/11-ship-to-rubicon.md)


---

# 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/rome-academy/10-from-other-chains.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.
