> 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/07-open-to-solana-wallets.md).

# 7. Mở ứng dụng EVM của bạn cho ví Solana

Làm cho hợp đồng của bạn có thể được dùng từ một ví Solana không có khóa EVM, bao gồm địa chỉ tổng hợp, giá trị ERC-20, hai chữ ký và ngân sách nguyên tử.

Hợp đồng của bạn đã hoạt động với MetaMask. Giờ đây bạn cho phép một ví Solana gọi nó bằng khóa mà nó đã có, để người dùng không bao giờ tạo tài khoản EVM. Họ gọi cùng một hợp đồng, tại cùng một địa chỉ, trên cùng trạng thái.

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

* Cách một ví Solana trở thành một `msg.sender` trên Rome.
* Vì sao khóa học này nhận giá trị dưới dạng khoản nạp ERC-20, và `msg.value` cần gì từ một người dùng Solana.
* Người dùng Solana ký gì cho mỗi lần gọi, và giao dịch đi đâu.
* Cái gì vừa trong một giao dịch Solana, và điều gì xảy ra với một lời gọi không vừa.
* Cái nào `deps` SDK cần và mỗi thứ đến từ đâu.

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

* Hoàn thành [6. Token ở cả hai phía](https://docs.rome.builders/vi/rome-academy/06-tokens-on-both-sides.md). Bài học này giả định bạn biết wrapper là gì và vì sao người dùng cấp quyền cho nó một lần.
* Có `HelloRome` đã được triển khai trên Hadrian từ [3. Hợp đồng đầu tiên của bạn trên Hadrian](https://docs.rome.builders/vi/rome-academy/03-first-contract-on-hadrian.md).
* Cài đặt TypeScript SDK, như trong [Rome SDK](https://docs.rome.builders/vi/san-pham/rome-sdk.md#typescript-sdk-rome-protocol-sdk).
* Hãy có một ví Solana ký các giao dịch Solana v1, với một ít SOL devnet và USDC devnet. Các faucet được liệt kê trong [Vòi cấp tiền](https://docs.rome.builders/vi/tai-nguyen/faucets.md). Hỗ trợ cho giao dịch v1 khác nhau giữa các ví, vì vậy hãy kiểm tra ví của bạn trước. [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) liệt kê các ví đã được kiểm tra cho đến nay.

## Bài học

### Bước 1. Làm quen với địa chỉ tổng hợp

Một ví Solana không có địa chỉ EVM, nên Rome suy ra một địa chỉ từ public key của nó. Kết quả là địa chỉ tổng hợp của ví. Nó là `msg.sender` mà hợp đồng của bạn nhìn thấy, và nó mang nonce và storage riêng như bất kỳ tài khoản nào khác. Cùng một ví luôn ánh xạ tới cùng một địa chỉ.

```javascript
import { syntheticAddress } from "@rome-protocol/sdk";
const from = syntheticAddress(solanaPubkey); // một địa chỉ 20 byte thông thường
```

Trong luồng của khóa học này, synthetic không giữ token nào khi nhàn rỗi. Chúng bắt đầu trong ví Solana của người dùng. Nhánh nạp chuyển chúng vào tài khoản token của synthetic trước khi nạp, và chỉ khi đó balanceOf(synthetic) của wrapper `balanceOf(synthetic)` hiển thị chúng. Nhánh rút chuyển chúng trở lại ví sau khi rút. Đọc mô hình đầy đủ trong [Gọi EVM từ Solana](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/call-evm-from-solana.md#synthetic-addresses).

### Bước 2. Làm cho hợp đồng sẵn sàng cho Solana

Hầu hết hợp đồng không cần thay đổi. Ba quy tắc quyết định liệu hợp đồng của bạn có thuộc nhóm đó hay không:

* Nhận giá trị dưới dạng ERC-20. Kéo bằng `transferFrom` sau một lần `approve`, và trả lại bằng `transfer`.
* Trỏ tới wrapper chuẩn cho từng token. Đừng tự triển khai wrapper riêng.
* Giữ mỗi lời gọi trên Solana-lane trong một giao dịch Solana.

Quy tắc đầu tiên là quy tắc dễ vấp nhất. Điểm vào này hoạt động cho người dùng MetaMask. Nó thất bại với người dùng Solana trong mô hình nạp và rút, vì synthetic của họ không giữ số dư gốc trừ khi bạn nạp cho nó bằng `fundSyntheticGas`:

```solidity
function deposit() external payable { balanceOf[msg.sender] += msg.value; }
```

Cái này hoạt động cho cả hai, vì cả hai luồng đều có thể nạp một `transferFrom`:

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

Địa chỉ wrapper nằm trên [Địa chỉ hợp đồng](https://docs.rome.builders/vi/tai-lieu-tham-khao/contract-addresses.md). Các kiểm tra cho một hợp đồng sẵn sàng với Solana nằm trong [Mở hợp đồng Solidity của bạn cho người dùng Solana](https://docs.rome.builders/pages/78cdb3ade0fe940d802a76a2d3627b611d3c55bf#id-2.-what-makes-a-contract-solana-ready).

### Bước 3. Biết ví ký cái gì

Lời gọi SDK là `submitRomeTxV1`. Với mỗi lần gọi, proxy ghép thành một giao dịch Solana v1. Ví ký hai lần bằng cùng một khóa. Trước tiên, nó ký một thông điệp ủy quyền có thể đọc được, nêu hash giao dịch EVM. Sau đó nó ký chính giao dịch.

Ứng dụng gửi giao dịch đã ký tới Solana RPC, chứ không phải tới Rome proxy. Chuỗi kiểm tra quyền ủy quyền thông qua chương trình Ed25519 và chạy lời gọi của bạn dưới dạng địa chỉ tổng hợp. Người dùng không bao giờ nắm giữ khóa EVM.

Trước khi ví ký giao dịch, SDK kiểm tra rằng nó chứa đúng lời gọi mà người dùng đã ủy quyền. Bất cứ điều gì khác đều bị từ chối. Chi tiết nằm trong [Mở hợp đồng Solidity của bạn cho người dùng Solana](https://docs.rome.builders/pages/78cdb3ade0fe940d802a76a2d3627b611d3c55bf#id-3.-let-a-solana-wallet-call-it).

### Bước 4. Kết nối luồng

SDK cần năm giá trị: một URL proxy, một chain ID, một Rome program ID, một kết nối Solana RPC và một signer. Bốn giá trị mô tả chuỗi. Một giá trị đến từ ví.

```javascript
const deps = { connection, proxyUrl, chainId, programId, signer };
const res = await submitRomeTxV1(deps, { to: helloRome, data }); // helloRome: hợp đồng ở bài học 3 của bạn; data: lệnh gọi greet() đã được mã hóa ABI
```

Với Hadrian, đọc bốn giá trị chuỗi từ registry. Ánh xạ nằm trong `deps` bảng của hướng dẫn được liên kết ở bước 3, và các giá trị nằm trên [Hadrian](https://docs.rome.builders/vi/mang/hadrian.md). Bài học 11 bao quát cùng cách nối dây này cho Rubicon.

Hai bước thực hiện một lần diễn ra trước lời gọi chuyển giá trị đầu tiên của người dùng mới. Cấp phát synthetic với `buildCreatePdaCall`, và cấp quyền cho wrapper nếu `isEnabled` là false. `submitRomeTxV1` không cấp phát cho bạn. Bài học 9 thực hiện cả hai theo đúng thứ tự.

### Bước 5. Ở trong một giao dịch

Một lời gọi trên Solana-lane phải vừa trong một giao dịch Solana: khoảng 1,4 triệu đơn vị tính toán, 64 tài khoản và 4 KB. Đo bằng `computeUnitsConsumed` từ biên nhận Solana, không phải EVM `gasUsed`. Yêu cầu giao dịch với `maxSupportedTransactionVersion: 1`; không có nó RPC sẽ từ chối yêu cầu.

Khi một lời gọi không vừa, composer sẽ từ chối nó và SDK chuyển nó cho proxy để chuyển tiếp với cùng chữ ký ủy quyền. Người dùng vẫn chỉ thấy một lời nhắc. Kết quả mang `route: "relay"`. Một lời gọi được chuyển tiếp sẽ tiêu tốn gas gốc của synthetic, nên hãy nạp thêm cho nó trước bằng `fundSyntheticGas`. Một lời gọi được chuyển tiếp mà bị revert sẽ không ném lỗi. Kiểm tra `receipt.status`. Các quy tắc nằm trong [Lời gọi được chuyển tiếp và lời gọi dài](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/call-evm-from-solana.md#relayed-calls-and-long-calls). Giới hạn trong một bảng: [Ràng buộc](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/constraints.md).

## Tự kiểm tra

Trả lời các câu hỏi này, rồi mở phần đáp án.

1. Tại sao một `payable` lời nạp tiền thất bại đối với người dùng Solana?
2. Ví tạo ra bao nhiêu chữ ký cho mỗi lần gọi, và mỗi chữ ký bao phủ điều gì?
3. Giao dịch đã ký đi đâu?
4. Một lời gọi cần nhiều hơn một giao dịch. Người dùng sẽ thấy gì, và ai trả tiền?

<details>

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

1. Tiền của người dùng là một token SPL trong ví của họ, được hiển thị trên Rome như wrapper. Synthetic không giữ số dư gốc trong mô hình nạp và rút trừ khi bạn nạp cho nó, nên không có `msg.value` để gửi.
2. Hai. Chữ ký đầu tiên bao trùm một thông điệp ủy quyền có thể đọc được với hash giao dịch EVM. Chữ ký thứ hai bao trùm giao dịch Solana.
3. Tới Solana RPC, được ứng dụng gửi đi. Proxy ghép giao dịch và không nhận nó, ngoại trừ một lời gọi được chuyển tiếp.
4. Một lời nhắc ủy quyền. Proxy chuyển tiếp lời gọi và số dư gas gốc của synthetic sẽ trả cho nó.

</details>

## Tiếp theo

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


---

# 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/07-open-to-solana-wallets.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.
