> 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/05-call-solana-from-solidity.md).

# 5. Gọi Solana từ Solidity

Sử dụng các precompile CPI và Helper của Rome để đọc các tài khoản Solana, tạo tài khoản token và gọi các chương trình Solana từ một hợp đồng Solidity.

Trên Rome, một hợp đồng Solidity có thể đọc các tài khoản Solana và gọi các chương trình Solana trong cùng một giao dịch. Bạn sẽ đọc số dư token Solana, tạo một tài khoản token và học cách xây dựng một lệnh gọi chương trình.

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

* Precompile là gì trên Rome và ba precompile nào bạn sẽ dùng nhiều nhất.
* Chữ ký mà một chương trình Solana nhìn thấy khi hợp đồng của bạn gọi nó.
* Cách đọc trạng thái Solana và tạo một tài khoản token từ Solidity.
* Các quy tắc quyết định một lệnh gọi Solana có hoạt động hay không: khai báo tài khoản, chỉ một track, chỉ nguyên tử.

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

* Hoàn thành [4. Rome chạy mã của bạn như thế nào](https://docs.rome.builders/vi/rome-academy/04-how-rome-runs-your-code.md). Ngân sách nguyên tử và giới hạn 64 tài khoản đều quan trọng ở đây.
* Hãy nạp tiền cho ví Hadrian của bạn và đảm bảo phần thiết lập triển khai từ bài 3 hoạt động. Các faucet được liệt kê trong [Vòi cấp tiền](https://docs.rome.builders/vi/tai-nguyen/faucets.md).
* Cài đặt các giao diện Rome Solidity từ `rome-solidity` repo, như mô tả trong [Triển khai Solidity](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/deploy-solidity.md#using-the-rome-solidity-sdk).

## Precompile là cánh cửa

Precompile là một địa chỉ cố định chạy mã native thay vì bytecode. Ethereum có một vài cái, chẳng hạn như `ecrecover`. Rome bổ sung các precompile có nhiệm vụ kết nối đến Solana. Bạn gọi chúng như bất kỳ hợp đồng nào, thông qua một interface.

Bạn sẽ dùng ba cái:

| Precompile    | Nó cung cấp cho bạn                                                                                                     |
| ------------- | ----------------------------------------------------------------------------------------------------------------------- |
| CpiProgram    | `invoke` và `invoke_signed` để gọi bất kỳ chương trình Solana nào, cùng các chế độ xem chỉ đọc của các tài khoản Solana |
| HelperProgram | Các thao tác token và tài khoản có sẵn: tạo tài khoản token, chuyển SPL token, suy ra địa chỉ                           |
| System        | Suy ra PDA và chuyển đổi base58                                                                                         |

Các địa chỉ nằm trong [Tham chiếu precompile](https://docs.rome.builders/vi/tai-lieu-tham-khao/precompiles.md) và [Địa chỉ hợp đồng](https://docs.rome.builders/vi/tai-lieu-tham-khao/contract-addresses.md). Bạn không cần nhập chúng. Khi import `interface.sol` từ `rome-solidity` bạn sẽ có các hằng số dựng sẵn tên là `CpiProgram`, `HelperProgram` và `SystemProgram`.

## Ai ký

Khi hợp đồng của bạn gọi một precompile, Solana nhìn thấy danh tính riêng của chính hợp đồng bạn, chứ không phải của người dùng. Mỗi địa chỉ EVM đều có một địa chỉ suy ra từ chương trình Solana, tức PDA thẩm quyền ngoài của nó. Nó sở hữu các tài khoản token của địa chỉ đó và ký thay cho địa chỉ đó.

Đây là cùng một quy tắc bạn đã biết từ ERC-20: một hợp đồng không thể di chuyển tài sản của người dùng nếu người dùng chưa cho phép. Bài 6 sẽ cho thấy cách người dùng cho phép điều đó trên Rome. Quy tắc này và ba cách để nắm giữ vị thế của người dùng nằm trong [Tích hợp một chương trình Solana](https://docs.rome.builders/pages/9977036da749fab59b01f5cb71897a69a3cf777c#id-1.-every-evm-address-has-one-solana-identity).

## Bước 1: đọc trước khi ghi

Bắt đầu bằng các lệnh đọc. Chúng không thay đổi trạng thái và hoạt động trong cả thực thi nguyên tử lẫn lặp. Hãy đọc trước khi bạn sửa đổi: một khi một lệnh gọi cached đã chạy, các lệnh đọc trên legacy track sẽ bị từ chối trong phần còn lại của giao dịch.

```solidity
import "@rome-protocol/rome-solidity/contracts/interface.sol";

contract SolanaPeek {
    // Tài khoản token mà Rome dùng cho người gọi và mint gas của chuỗi
    function myTokenAccount() external view returns (bytes32) {
        return HelperProgram.ata(msg.sender, SystemProgram.mint_id());
    }

    // Số dư của người gọi trong tài khoản đó
    function myBalance() external view returns (uint64) {
        return HelperProgram.user_balance(msg.sender, SystemProgram.mint_id());
    }
}
```

Địa chỉ Solana là `bytes32` ở đây, không phải các địa chỉ 20 byte. Các lệnh đọc khác, `account_info`, `account_data_at` và `account_u64_at`, cho phép bạn kiểm tra bất kỳ tài khoản Solana nào. Xem [Đọc dữ liệu tài khoản](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/call-solana-from-evm.md#reading-account-data).

## Bước 2: dùng một helper

Với các tác vụ phổ biến, bạn không cần tự tạo instruction. Helper tạo tài khoản token, chuyển SPL token và lamport, và chuyển đổi giữa gas và lamport. Các chữ ký nằm trong `contracts/interface.sol`, và một hợp đồng hoàn chỉnh nằm trong [Chuyển lamport](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/call-solana-from-evm.md#transfer-lamports).

```solidity
function createMyAta() external {
    HelperProgram.create_ata(msg.sender, SystemProgram.mint_id());
}
```

Một hợp đồng gọi Helper sẽ hoạt động với chính danh tính của nó. Các token mà nó di chuyển là của chính nó, không phải của người dùng.

## Bước 3: gọi bất kỳ chương trình Solana nào

Với một chương trình mà các helper không hỗ trợ, hãy tự xây dựng danh sách tài khoản và các byte instruction rồi gọi `invoke`. Mỗi tài khoản là một pubkey cộng với hai cờ, signer và writable. Dữ liệu instruction là bất cứ thứ gì chương trình đích mong đợi, thường là Borsh.

Hợp đồng đầy đủ nằm trong [Gọi các chương trình Solana tùy chỉnh](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/call-solana-from-evm.md#calling-custom-solana-programs). `invoke_signed` thêm các sub-PDA có muối khi đích cần nhiều hơn một signer từ hợp đồng của bạn. Để lấy địa chỉ của một PDA trong Solidity, hãy dùng `find_program_address` trên precompile System; xem [Suy ra PDA](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/call-solana-from-evm.md#pda-derivation).

## Các quy tắc quyết định liệu nó có hoạt động hay không

* **Khai báo mọi tài khoản.** Solana cần danh sách tài khoản đầy đủ trước khi lệnh gọi chạy. Proxy tìm ra nó bằng cách mô phỏng giao dịch của bạn trước, vì vậy mỗi tài khoản phải có thể suy ra từ các đầu vào mà hợp đồng có. Tổng số phải nằm trong giới hạn 64 địa chỉ.
* **Hãy giữ nguyên tính nguyên tử.** Một lệnh gọi tạo ra CPI trên legacy track không thể chạy theo kiểu lặp. Nó phải nằm gọn trong một giao dịch nguyên tử, vì vậy hãy giữ mỗi hành động ở một lần di chuyển token và một CPI.
* **Chọn một track.** Rome có hai họ precompile thay đổi trạng thái Solana: legacy (`CpiProgram`, `HelperProgram`, `Withdraw`) và cached ( `...Cached` set). Một giao dịch chỉ dùng một họ. Chỉ legacy track mới có thể gọi một chương trình tùy chỉnh. Đọc bảng trong [Tích hợp một chương trình Solana](https://docs.rome.builders/pages/9977036da749fab59b01f5cb71897a69a3cf777c#id-4.-one-track-per-contract-and-per-transaction).
* **Giữ độ sâu thấp.** Lệnh gọi của bạn tới một chương trình Solana sử dụng các cấp CPI, và mọi chương trình mà nó gọi tiếp theo cũng vậy. Giới hạn độ sâu của Solana khá thấp. [Ràng buộc](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/constraints.md#cpi-constraints) giải thích các cấp độ.
* **Không gọi ngược lại vào Rome.** Một CPI không thể nêu tên hoặc gọi chương trình Rome. Nó cũng không thể nêu tên người trả phí Solana, trừ trong một instruction chuyển System thông thường.

## Tự kiểm tra

Thêm `createMyAta` vào `SolanaPeek` và triển khai nó lên Hadrian. Sau đó:

1. Gọi `myTokenAccount` và `myBalance` bằng một lệnh gọi đọc từ địa chỉ ví của bạn.
2. Gửi một giao dịch gọi `createMyAta`.
3. Mở giao dịch trên trình khám phá Hadrian. Xem [Qua trình khám phá](https://docs.rome.builders/vi/ung-dung-tren-rome/via.md).

Bạn sẽ thấy instruction Solana đằng sau lệnh gọi của mình và các đơn vị tính toán của nó. Một lệnh gọi chạm tới Solana sẽ hiển thị một chương trình Solana trong trình khám phá, chứ không chỉ một lệnh gọi EVM.

<details>

<summary>1. Một hợp đồng gọi <code>HelperProgram.transfer_spl</code>. Token của ai được di chuyển?</summary>

Của chính hợp đồng. Signer là PDA thẩm quyền ngoài của hợp đồng. Để chuyển token của người dùng, trước tiên người dùng phải cấp quyền.

</details>

<details>

<summary>2. Tại sao một lệnh gọi sử dụng <code>invoke</code> phải nằm gọn trong một giao dịch nguyên tử?</summary>

Các CPI trên legacy track bị từ chối trong một giao dịch lặp. Nếu lệnh gọi cần hơn một giao dịch Solana, nó sẽ thất bại.

</details>

<details>

<summary>3. Bạn có thể tin cậy vào những lệnh đọc nào trong mọi chế độ thực thi?</summary>

Các chế độ xem chỉ đọc: `account_info`, `account_data_at`, `account_u64_at`, `account_lamports`, `pdas_batch_derive` và các lệnh đọc Helper như `user_balance`. Chúng không có tác dụng phụ. Hãy chạy chúng trước bất kỳ phép biến đổi cached nào trong cùng giao dịch.

</details>

## Tiếp theo

[6. Token ở cả hai phía](https://docs.rome.builders/vi/rome-academy/06-tokens-on-both-sides.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/05-call-solana-from-solidity.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.
