> 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/09-build-a-dual-lane-app.md).

# 9. Xây dựng một ứng dụng hai làn

Xây dựng một hợp đồng kho tiền mà cả người dùng MetaMask và người dùng ví Solana đều có thể nạp vào và rút ra, và nhìn thấy cùng một số dư từ cả hai phía.

Đây là bài học xây dựng ([2. Bạn có thể xây dựng gì](https://docs.rome.builders/vi/rome-academy/02-what-you-can-build.md) liệt kê trường hợp sử dụng). Bạn viết một vault USDC nhỏ, triển khai nó một lần, và dùng nó từ hai ví: MetaMask và một ví Solana. Cuối cùng cả hai người dùng đều có số dư trong cùng một trạng thái hợp đồng.

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

* Hình dạng của một hợp đồng hai làn: một vault ERC-20 thuần túy.
* Các bước theo thứ tự mà mỗi làn thực hiện để nạp và rút.
* Vì sao làn Solana có bước nạp vốn và bước quét, còn làn EVM thì không.
* Cách chọn giữa lõi Solidity và lõi chương trình Solana.
* Cách đo chi phí của từng bước.

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

* Hoàn thành [8. Mở chương trình Solana của bạn cho người dùng EVM](https://docs.rome.builders/vi/rome-academy/08-open-your-solana-program-to-evm-users.md). Bài học 7 bao quát làn Solana mà bản dựng này dùng, vì vậy hãy đọc [7. Mở ứng dụng EVM của bạn cho ví Solana](https://docs.rome.builders/vi/rome-academy/07-open-to-solana-wallets.md) trước nếu bạn đã bỏ qua nó.
* Có MetaMask trên Hadrian và một ví Solana trên devnet Solana có thể ký các giao dịch v1, cả hai đều được nạp tiền như trong bài học 3 và [Vòi cấp tiền](https://docs.rome.builders/vi/tai-nguyen/faucets.md).
* Đã cài đặt TypeScript SDK ([Rome SDK](https://docs.rome.builders/vi/san-pham/rome-sdk.md#typescript-sdk-rome-protocol-sdk)) và Foundry hoặc Hardhat ([Triển khai Hợp đồng Solidity](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/deploy-solidity.md)).

## Bài học

### Bước 1. Chọn lõi của bạn

Một ứng dụng hai làn giữ logic lõi ở một phía. Hoặc lõi là Solidity và người dùng Solana truy cập nó thông qua địa chỉ synthetic của họ, hoặc lõi là một chương trình Solana gốc và người dùng EVM truy cập nó qua một router mỏng. Không có cách nào là bắt buộc. Hãy chọn dựa trên code bạn đã có, đội ngũ của bạn và ứng dụng làm gì. [Chọn lõi của bạn](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/choose-your-core.md) liệt kê các đánh đổi.

Khóa học này xây dựng hình dạng đầu tiên. Đây là con đường ngắn hơn và dùng bộ công cụ EVM tiêu chuẩn. Nếu thay vào đó bạn đang giữ một chương trình Solana, bài học 8 và [Tích hợp một chương trình Solana](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/integrate-solana-program.md) bao quát ai ký, token di chuyển như thế nào và quy tắc một lối đi. Điểm chính của nó cũng áp dụng cho bài học này: một hợp đồng không thể tự mình di chuyển token của người dùng, nên người dùng phải cấp quyền trước.

### Bước 2. Viết vault

Vault lấy token bằng `transferFrom` và trả lại nó bằng `transfer`. Không có gì trong đó dành riêng cho Rome.

```solidity
function deposit(uint256 amount) external {
    require(token.transferFrom(msg.sender, address(this), amount));
    balanceOf[msg.sender] += amount;
}
function withdraw(uint256 amount) external {
    balanceOf[msg.sender] -= amount;
    require(token.transfer(msg.sender, amount));
}
```

Hàm tạo nhận địa chỉ wrapper wUSDC. Triển khai nó lên Hadrian như bạn đã làm ở bài học 3, rồi xác minh mã nguồn ([Xác minh hợp đồng](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/verify-contracts.md)). Hợp đồng hoàn chỉnh nằm trong [Xây dựng một ứng dụng hai làn](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/dual-lane-app.md).

### Bước 3. Chạy làn EVM

Người dùng MetaMask nắm giữ USDC dưới dạng gas gốc, còn vault nhận wUSDC. Vì vậy làn này có bốn bước, mỗi bước là một giao dịch bình thường:

1. Bọc một phần gas thành wUSDC bằng `withdraw_to_ata` trên precompile Withdraw.
2. Cấp quyền cho wrapper một lần, nếu `isEnabled(user)` là false.
3. `approve` vault trên wUSDC.
4. `nạp` vào vault.

Không có bước nạp vốn hay bước quét. Các token đã được bọc vốn đã nằm tại địa chỉ EVM của người dùng. Mã nguồn nằm trong [Ứng dụng tương tự từ MetaMask](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/dual-lane-app.md#the-same-app-from-metamask). Địa chỉ precompile nằm ở [Precompiles](https://docs.rome.builders/vi/tai-lieu-tham-khao/precompiles.md).

### Bước 4. Chạy làn Solana

Người dùng Solana nắm giữ SOL và SPL USDC. Mỗi bước là một giao dịch v1 được ví đó ký:

1. Cấp phát synthetic bằng `create_pda`, một lần.
2. Bước nạp vốn: chuyển USDC từ tài khoản token của ví vào tài khoản của synthetic.
3. Cấp quyền cho wrapper, nếu `isEnabled` là false.
4. `approve` vault.
5. `nạp`.

Rút tiền diễn ra theo chiều ngược lại. `withdraw` trả token về synthetic, và bước quét chuyển chúng về ví riêng của người dùng. Sau một lần rút và quét đầy đủ, số dư token đã nạp của synthetic trở về 0. Đây là các giao dịch tách biệt, nên nếu một lần nạp hoặc một lần quét thất bại, hãy đọc số dư token của synthetic và để người dùng thử lại hoặc quét phần còn lại về. Mã từng bước nằm trong [Giá trị VÀO](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/dual-lane-app.md#value-in-deposit-step-by-step) và [Giá trị RA](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/dual-lane-app.md#value-out-withdraw-step-by-step).

Giữ bước kiểm tra cấp quyền trong luồng nạp đầu tiên của ứng dụng cho cả hai làn. Một tài khoản token chỉ có một delegate, nên việc cấp quyền sau đó cho một chương trình khác, chẳng hạn một bridge hoặc một router, sẽ thay thế quyền của wrapper. Hãy kiểm tra `isEnabled` trước mỗi lần nạp thay vì giả định quyền cấp trước đó vẫn còn đó ([cần mỗi người dùng đã thực hiện việc này. Xem](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/token-interop.md#one-time-grant-per-wallet)).

### Bước 5. Đo từng bước

Đọc `computeUnitsConsumed` từ biên lai Solana của từng bước trong làn Solana, như ở bài học 7. Hướng dẫn liệt kê các compute units, byte và tài khoản mà mỗi bước đã dùng trên Hadrian. Mọi bước trong bảng đó đều nằm khá xa dưới ngân sách atomic. Hãy dùng những con số đó làm mốc chuẩn, rồi so sánh với của bạn.

Nếu một bước chạm gần 1,4 triệu compute units hoặc 64 tài khoản, hãy chuyển nó qua relay hoặc đơn giản hóa nó. Xem [Ràng buộc](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/constraints.md) và [Ngân sách tính toán](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/compute-budget.md).

## Tự kiểm tra

Làm việc này trên Hadrian và lưu lại các liên kết.

1. Nạp từ MetaMask. Nạp từ ví Solana.
2. Đọc `balanceOf` trên vault cho cả hai địa chỉ. Mỗi địa chỉ hiển thị khoản nạp của riêng nó. Với người dùng Solana, hãy đọc tại địa chỉ synthetic.
3. Mở từng giao dịch trên trình khám phá Hadrian ([Hadrian](https://docs.rome.builders/vi/mang/hadrian.md) có liên kết; [Via](https://docs.rome.builders/vi/ung-dung-tren-rome/via.md) giải thích nó hiển thị gì). Với lần nạp ở làn Solana, hãy theo liên kết "Settled in" của Via đến giao dịch Solana; trình khám phá Solana sẽ hiển thị các instruction và compute units của nó.
4. Rút từ cả hai. USDC của người dùng Solana đã trở lại ví của chính họ.

Nếu một lần nạp ở làn Solana bị hoàn tác với lỗi SPL `0x4`, thì quyền cấp cho wrapper bị thiếu.

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

* Phía nào của ứng dụng cần bước nạp vốn, và vì sao?
* Synthetic của người dùng Solana giữ gì sau một vòng đi-về đầy đủ?

<details>

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

* Là làn Solana. USDC của người dùng bắt đầu trong tài khoản token của ví họ. Bước nạp vốn chuyển nó sang tài khoản token của synthetic, nên số dư wrapper hiển thị nó. Token của người dùng MetaMask đã ở sẵn địa chỉ EVM của họ.
* Không có token nào được nạp. Bước quét trả chúng về ví của người dùng.

</details>

## Tiếp theo

[10. Đưa người dùng và tiền từ các chuỗi khác vào](https://docs.rome.builders/vi/rome-academy/10-from-other-chains.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/09-build-a-dual-lane-app.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.
