> 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/06-tokens-on-both-sides.md).

# 6. Token ở cả hai phía

Cách một token SPL xuất hiện như một lớp bao bọc ERC-20 cho ví EVM và như một tài khoản token cho ví Solana, cùng quyền cấp một lần cho phép các hợp đồng di chuyển nó.

Token là nền tảng của mọi trường hợp sử dụng trong [2. Bạn có thể xây dựng những gì](https://docs.rome.builders/vi/rome-academy/02-what-you-can-build.md): pool, vault hay thị trường cho vay đều chuyển cùng một tài sản mà ví Solana nắm giữ. Một wrapper SPL cung cấp mint SPL thông qua giao diện ERC-20. Với token do ví nắm giữ, wrapper đọc số dư trong tài khoản token được dẫn xuất từ Rome của ví, nhờ đó Solana và Solidity thấy cùng một số dư. Bài học này giải thích cách hoạt động và khoản cấp quyền duy nhất mà mọi người dùng phải cấp trước khi hợp đồng của bạn có thể chuyển token của họ.

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

* Cách wrapper SPL cung cấp số dư token Solana của ví thông qua các phương thức ERC-20.
* Factory và wrapper làm gì, cũng như nên dùng wrapper nào.
* Token do hợp đồng nắm giữ khác với token do ví nắm giữ như thế nào.
* Khoản cấp quyền `approve_spl` một lần, cách kiểm tra và cách khoản cấp quyền này bị mất hiệu lực.

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

* Hoàn tất [5. Gọi Solana từ Solidity](https://docs.rome.builders/vi/rome-academy/05-call-solana-from-solidity.md). Bạn cần nắm khái niệm PDA có thẩm quyền bên ngoài và precompile Helper.
* Hãy chuẩn bị một ví Hadrian có đủ tiền và một hợp đồng đã triển khai. Địa chỉ wrapper chuẩn nằm trong `tokens.json` của registry trên chuỗi: mục có `kind: "spl_wrapper"` và ký hiệu `wUSDC`. [Hadrian](https://docs.rome.builders/vi/mang/hadrian.md) liên kết đến thư mục registry của chuỗi.
* Tài khoản token USDC mà bạn đã tạo bằng `createMyAta` trong bài học 5. Tài khoản này cần tồn tại để cấp quyền.

## Một số dư, hai cách nhìn

Mỗi địa chỉ EVM có một PDA có thẩm quyền bên ngoài trên Solana, và PDA đó sở hữu các tài khoản token của địa chỉ. Phương thức `balanceOf` của wrapper ERC-20 đọc trực tiếp tài khoản token của ví. `totalSupply` đọc mint.

Trong Rome, token SPL của ví và wrapper ERC-20 tương ứng đọc cùng một tài khoản token. Ví Solana nắm giữ USDC và địa chỉ EVM nắm giữ USDC đều nắm giữ cùng một mint, đồng thời giao dịch với cùng các tài khoản pool. Nhờ vậy, thanh khoản luôn tập trung tại một nơi trên Rome. Hình minh họa và thông tin chi tiết có trong [Khả năng tương tác của token](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/token-interop.md#the-shared-state-model).

## Ví và hợp đồng nắm giữ token theo những cách khác nhau

Số dư được chia sẻ áp dụng cho ví. Hợp đồng thì khác. Hợp đồng không thể thay người dùng gửi khoản cấp quyền một lần được mô tả bên dưới, vì vậy các wrapper thông thường giữ token của hợp đồng trong một tài khoản token ký quỹ và theo dõi số dư sở hữu của từng hợp đồng. Các wrapper Token-2022 có hook không lưu sổ cái và sử dụng chính tài khoản token của hợp đồng.

Có hai hệ quả:

* Hai wrapper cho cùng một mint hiển thị cùng số dư ví. Chúng có thể hiển thị số dư hợp đồng khác nhau, vì mỗi wrapper duy trì sổ cái riêng.
* Với pool, vault và thị trường cho vay, hãy dùng wrapper chuẩn được registry chỉ định cho từng mint trên mỗi chuỗi. Đừng chọn wrapper chỉ dựa vào tên.

Một giao dịch chuyển đến hợp đồng thông qua wrapper sẽ ghi có vào sổ cái đó. Giao dịch này không cấp cho hợp đồng một tài khoản token mà nó có thể dùng để chi tiêu. Các luồng cần hợp đồng thao tác trên Solana sử dụng cách thức trong [Tích hợp chương trình Solana](https://docs.rome.builders/pages/9977036da749fab59b01f5cb71897a69a3cf777c#id-3.-tokens-in-tokens-out).

## Factory và wrapper

`ERC20SPLFactory` triển khai wrapper cho một mint SPL. Mỗi factory chỉ cho phép một wrapper trên mỗi mint. Wrapper cung cấp giao diện ERC-20 đầy đủ:

* `balanceOf` và `totalSupply` đọc trạng thái Solana.
* `transfer` và `transferFrom` chuyển token trên Solana.
* `approve` và `allowance` giữ các hạn mức ERC-20 thông thường trong bộ nhớ EVM, vì tài khoản token không có khái niệm này.

Bạn hiếm khi phải triển khai wrapper. Rome và registry đã có sẵn các wrapper chuẩn cho USDC, ETH và SOL. Bạn chỉ triển khai wrapper khi đưa vào một mint mới. Cả hai lời gọi factory đều nằm trong [Factory](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/token-interop.md#the-factory). Factory cũng xử lý các mint Token-2022, nhưng những phần mở rộng của chúng làm thay đổi cách tích hợp: wrapper có hook sẽ revert với lệnh `transfer` và `transferFrom`, còn mint có phí chuyển khoản có thể chuyển đến ít hơn số lượng bạn gửi. Hãy đọc [Các mint Token-2022](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/token-interop.md#token-2022-mints) trước khi sử dụng chúng trong vault của bạn.

Số lượng phải vừa với `uint64`, vì số lượng SPL có kiểu này và wrapper từ chối mọi giá trị lớn hơn. Token gas có số chữ số thập phân riêng, còn số dư gas gốc dùng 18 chữ số. Việc chuyển đổi giữa hai loại phải chính xác. Token gas trên Hadrian và Rubicon là USDC.

## Cấp quyền một lần

Wrapper chuyển token của người dùng với tư cách là delegate SPL của tài khoản token đó. Tài khoản token phải chỉ định delegate này trước khi wrapper có thể chuyển bất kỳ thứ gì. Người dùng thực hiện việc này một lần cho mỗi wrapper bằng một lời gọi, với số lượng tối đa:

`approve_spl(wrapper, type(uint64).max, mint)` trên precompile Helper.

Trên thực tế, cần lưu ý bốn điểm:

* **Người dùng phải gửi giao dịch.** Việc cấp quyền phải được ký bằng chính tài khoản của người dùng và gửi thẳng đến precompile Helper. Hợp đồng của bạn không thể gửi thay họ. Hãy thêm bước “Bật” vào giao diện người dùng.
* **Áp dụng cho tất cả mọi người.** Ví MetaMask và các địa chỉ tổng hợp của ví Solana đều cần cấp quyền này cho từng wrapper có token mà họ muốn chuyển.
* **Kiểm tra trước.** Hàm `isEnabled(user)` của wrapper trả về `true` khi đã cấp quyền. Hãy đọc giá trị này trước khi chuyển token thay vì mặc định rằng quyền đã được cấp.
* **Cấp quyền tối đa.** `isEnabled` vẫn giữ giá trị `true` khi vẫn còn bất kỳ phần nào của hạn mức đã cấp. Hạn mức có giới hạn sẽ làm các giao dịch chuyển thông thường thất bại khi sắp cạn, và ứng dụng của bạn sẽ không biết để yêu cầu cấp quyền lại.

Mint cần truyền vào là `mint_id()` trên wrapper. Có ví dụ hoàn chỉnh về cách triển khai ở giao diện người dùng cho cả hai loại ví trong [Một lần: cấp quyền cho wrapper](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/dual-lane-app.md#one-time-grant-the-wrapper).

### Cách xảy ra lỗi

Một tài khoản token chỉ có một delegate. Nếu người dùng cấp quyền cho bridge hoặc router, quyền đó sẽ thay thế quyền của wrapper, khiến wrapper ngừng hoạt động với người dùng đó. Dấu hiệu là giao dịch revert với lỗi SPL `0x4`, tức không khớp chủ sở hữu. Cách khắc phục là cấp quyền lại cho wrapper. Vì vậy, hãy kiểm tra `isEnabled` trước quy trình phụ thuộc vào wrapper, chứ không chỉ kiểm tra một lần khi đăng ký.

Phiên bản factory mới sẽ tạo ra wrapper mới, và mỗi ví cần cấp quyền cho wrapper mới theo cách tương tự.

## Chuyển token ra ngoài

Vì số dư của wrapper vốn đã là số dư SPL, chuyển token ra Solana là một giao dịch SPL.

* Đến một ví Solana khác từ ví EVM: `transfer_spl` gửi thẳng từ ví đến precompile Helper, hoặc `RomeBridgeWithdraw.bridgeOutToSolana`, phương thức này cũng cần được cấp quyền cho hợp đồng bridge. Cả hai cách đều yêu cầu tài khoản token của người nhận phải tồn tại.
* Đến ví đã ký giao dịch: `transfer_spl_to_signer`. Tài sản chỉ về đến ví của chính người dùng khi dùng luồng Solana có chữ ký của ví. Khi dùng MetaMask, bên ký là bên thanh toán proxy của Rome, nên hãy dùng một trong hai cách còn lại.
* Đối với token gas, `withdraw_to_ata` và `deposit_from_ata` chuyển đổi giữa gas gốc và token trong tài khoản token.

Solgate kết nối tài sản Solana với các chuỗi EVM AggLayer theo cả hai chiều, trên mainnet và testnet. Trên testnet, việc đăng ký token SPL không cần cấp quyền. USDC sử dụng CCTP. [Bài học 10](https://docs.rome.builders/vi/rome-academy/10-from-other-chains.md) quay lại các luồng nạp vào và bridge. Danh sách phương thức có trong [Nạp và rút](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/token-interop.md#deposit-and-withdraw).

## Tự kiểm tra

Trên Hadrian, dùng ví bạn đã nạp tiền:

1. Đọc `isEnabled` cho địa chỉ của bạn trên trình bao bọc wUSDC chuẩn tắc trong registry.
2. Đảm bảo tài khoản token USDC của bạn tồn tại. Lệnh gọi `createMyAta` trong bài học 5 đã tạo tài khoản này. Nếu bạn bỏ qua bước đó, hãy chuyển một ít gas thành wUSDC bằng `withdraw_to_ata`, như trong [Cùng ứng dụng đó với MetaMask](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/dual-lane-app.md#the-same-app-from-metamask).
3. Nếu `isEnabled` là `false`, hãy gửi khoản cấp quyền `approve_spl` đến precompile Helper. Dùng mã trong hướng dẫn hai luồng được liên kết ở trên.
4. Đọc lại `isEnabled` Một lần nữa. Giá trị lúc này phải là `true`.
5. Tìm giao dịch cấp quyền của bạn trên [Qua trình khám phá](https://docs.rome.builders/vi/ung-dung-tren-rome/via.md). Tìm lệnh `ApproveChecked` của SPL Token.

<details>

<summary>1. Vì sao hai trình bao bọc của cùng một mint lại hiển thị cùng số dư ví?</summary>

Cả hai đều đọc tài khoản token của ví trên Solana. Trình bao bọc là một cách hiển thị token SPL, không phải một sổ cái riêng. Chỉ số dư do hợp đồng nắm giữ mới được theo dõi riêng theo từng trình bao bọc.

</details>

<details>

<summary>2. Người dùng nạp tài sản vào vault của bạn, sau đó dùng một router yêu cầu cấp cho chính nó quyền <code>approve_spl</code>. Lệnh <code>transferFrom</code> tiếp theo của bạn bị hoàn tác với lỗi SPL 0x4. Vì sao?</summary>

Tài khoản token chỉ có một delegate. Khoản cấp quyền cho router đã thay thế khoản cấp quyền cho trình bao bọc. Người dùng phải cấp quyền lại cho trình bao bọc, và ứng dụng của bạn nên kiểm tra `isEnabled` trước khi chuyển.

</details>

<details>

<summary>3. Bạn sử dụng trình bao bọc pool nào cho một pool thanh khoản mới?</summary>

Trình bao bọc chính thức mà registry chỉ định cho mint đó trên chuỗi đó. Số dư được nắm giữ trong hợp đồng khác nhau giữa các trình bao bọc.

</details>

## Tiếp theo

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


---

# 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/06-tokens-on-both-sides.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.
