> 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/huong-dan-cho-nha-phat-trien/call-evm-from-solana.md).

# Gọi EVM từ Solana

Cho phép một ví Solana điều khiển các hợp đồng EVM trên Rome — không cần khóa Ethereum. Ví ký, và giao dịch của nó đi lên Solana.

Ngược lại với [Gọi Solana từ EVM](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/call-solana-from-evm.md): một ví Solana (ví dụ Solflare) gọi trực tiếp bất kỳ hợp đồng EVM nào trên Rome, với **không cần khóa Ethereum**. Đây là cách [Aerarium](https://docs.rome.builders/vi/ung-dung-tren-rome/apps.md) cho phép người dùng thuần Solana dùng chung các hợp đồng với người dùng EVM.

Cách gọi một lần là `submitRomeTxV1`, trong đó proxy tạo một giao dịch Solana v1 cho lệnh gọi; trang này giải thích cơ chế.

## Địa chỉ tổng hợp

Danh tính EVM của một ví Solana là **địa chỉ tổng hợp** — 20 byte cuối của `keccak256` của khóa công khai Solana 32 byte của nó:

```
synthetic_evm_address = keccak256(solana_pubkey)[12:]
```

Đây là `msg.sender` khi ví gọi một hợp đồng, và là danh tính ổn định nơi nonce và bộ nhớ lưu trữ của nó tồn tại. Cách suy ra này được cố định trong giao thức, nên 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); // 0x… 20 byte
```

## Synthetic chỉ là lớp chuyển tiếp — nó không giữ token khi ở trạng thái nghỉ

Số dư có thể chi tiêu của người dùng thuần Solana nằm trong **ví Solana** (dưới dạng token SPL), được hiển thị 1:1 ở phía EVM dưới dạng **wrapper ERC20SPL** (ví dụ: `wUSDC`). Synthetic không giữ gì khi ở trạng thái nghỉ, nên giá trị chảy *qua* nó — mọi bước đều được ví Solana ký:

1. **Cấp phát (một lần).** PDA xác thực ngoài của một synthetic mới hoàn toàn sẽ chưa tồn tại cho đến khi `create_pda` chạy — và các chuyển khoản bên dưới được ký bởi PDA đó. `submitRomeTxSolanaLane` tự động cấp phát nó khi dùng lần đầu (hoặc gọi `provisionSynthetic` cho bước "Kích hoạt" rõ ràng; kiểm tra bằng `isSyntheticProvisioned`). Với `submitRomeTxV1`, hãy kiểm tra `isSyntheticProvisioned` và gửi `buildCreatePdaCall` qua nó một lần.
2. **Chặng nạp tiền (ví → synthetic).** Chuyển token từ ATA của ví vào của synthetic — bước `ActivateAta` , được tạo bởi `buildFundLeg`. Bây giờ `wrapper.balanceOf(synthetic)` đọc số dư đó, nên synthetic chi tiêu nó như một ERC-20 thông thường (`transfer` / `transferFrom`) — **không phải** như native `msg.value`, mà nó không nắm giữ.
3. **Các lệnh gọi (`DoTxUnsigned`).** Synthetic thực thi (các) giao dịch EVM — ví dụ `approve` rồi đến một vault `nạp` kéo thông qua `transferFrom`.
4. **Chặng quét (synthetic → ví).** Sau khi rút / vay / nhận thưởng đưa token vào synthetic, `buildSweepLeg` đẩy chúng trở lại ATA của chính ví người dùng (`HelperProgram.transfer_spl`), để synthetic ròng về 0.

Phần tiếp theo mô tả cách mà phiên bản cũ hơn `submitRomeTxSolanaLane` được dựng ở phía client. `submitRomeTxV1` bảo proxy tạo một giao dịch v1 thay vào đó, không cần khám phá tài khoản, ComputeBudget hay ví kho báu trong mã của bạn; xem [các endpoint external-V1](#the-external-v1-endpoints) bên dưới.

## Cách lệnh gọi được dựng

`submitRomeTxSolanaLane` làm tất cả việc này. Cơ chế như sau:

1. **Xây dựng một giao dịch EIP-1559 chưa ký** với `từ` = địa chỉ synthetic — không có chữ ký secp256k1.
2. **Khám phá tài khoản** — gọi [`rome_emulateCallAccounts`](https://docs.rome.builders/vi/tai-lieu-tham-khao/json-rpc.md) với `từ`, `vào`, `data`, **và `value`** (khi lệnh gọi có thể nhận giá trị). Việc truyền `value` là quan trọng: proxy mô phỏng *thực* lệnh gọi, nên mọi ghi bộ nhớ phụ thuộc vào giá trị — ví dụ một ô mapping mới — đều được cấp phát và tài khoản Solana tương ứng được trả về. Bỏ qua nó thì tài khoản đó sẽ thiếu, và giao dịch thất bại với *"instruction modified data of a read-only account."*
3. **Ghép giao dịch Solana:** hai **ComputeBudget** chỉ thị (EVM của Rome cần mức giới hạn CU cao hơn ≈1,35M và heap frame lớn ≈250 KB — mặc định của Solana sẽ lỗi) + **`DoTxUnsigned`** chỉ thị (RLP chưa ký + các tài khoản đã khám phá) + **ví kho báu** (thực thi trả cho nó một khoản phí nhỏ; bước khám phá bỏ qua nó, nên SDK sẽ thêm nó vào).
4. **Ví ký và gửi.** Các **Ví Solana ký giao dịch Solana (Ed25519) và gửi nó tới Solana RPC — không phải tới proxy.** Runtime của Solana xác minh chữ ký; trên chuỗi, chương trình suy ra `msg.sender` từ người ký đó. Thẩm quyền là chữ ký Solana, không phải chữ ký Ethereum. (Proxy chỉ được dùng cho bước mô phỏng/khám phá ở bước 2.)

PDA của người dùng (`["EXTERNAL_AUTHORITY", synthetic_address]`) sở hữu các tài khoản token của họ và ký các CPI SPL thay mặt họ — vì vậy một người dùng Solana có thể cung cấp, vay, hoán đổi và làm LP hoàn toàn từ ví Solana của họ.

## Các endpoint external-V1

`submitRomeTxV1` là cách gọi một lần: nó yêu cầu proxy tạo một giao dịch v1 đã ghép sẵn, kiểm tra nó, để ví ký rồi gửi nó tới Solana RPC, đồng thời chuyển tiếp qua proxy khi lệnh gọi không vừa. Proxy cung cấp cùng một lộ trình như các phương thức RPC, nên bất kỳ client nào cũng có thể dùng nó mà không cần SDK (danh sách đầy đủ trong [Hỗ trợ JSON-RPC](https://docs.rome.builders/vi/tai-lieu-tham-khao/json-rpc.md)):

* `rome_composeUnsignedAtomicV1(rlp, pubkey, signature)` — một giao dịch Solana v1; ví ký nó và ứng dụng phát nó lên Solana RPC. Bị từ chối khi lệnh gọi không vừa trong một giao dịch nguyên tử.
* `rome_composeUnsignedIterativeV1(rlp, pubkey, signature)` — mọi chặng của quá trình thực thi (nguyên tử nếu vừa, nếu không thì các chặng lặp); ví ký từng chặng, `rome_submitSignedV1Plan` phát chúng. Các giới hạn của một kế hoạch dài nằm trong [Các lệnh được chuyển tiếp và các lệnh dài](#relayed-calls-and-long-calls).
* `rome_relayUnsignedV1(rlp, pubkey, signature)` — một chữ ký ví, payer của proxy điều khiển các chặng và trả về hash giao dịch EVM; synthetic trả gas Rome, nên hãy nạp cho nó một lần bằng `rome_composeExternalDepositV1`.

**Chữ ký ủy quyền.** `rlp` là phần thân EIP-1559 chưa ký gồm 9 trường ở dạng thô. Ví ký, bằng khóa Ed25519 của nó, hoặc chuỗi 32 byte thô `keccak256(0x02 ‖ rlp)` hoặc thông điệp dễ đọc

```
Rome authorization\n0x<64 ký tự hex thường của hash đó>
```

Cả hai đều được chấp nhận; dạng dễ đọc là thứ ví hiển thị rõ ràng trong `signMessage` hộp thoại. Chương trình tính lại hash từ phần thân mà nó thực thi và yêu cầu thông điệp đã ký phải đúng một trong hai dạng, vì vậy một chữ ký trên một phần thân không bao giờ có thể ủy quyền cho phần thân khác, và nonce của phần thân ngăn chặn phát lại.

## Các lệnh được chuyển tiếp và các lệnh dài

Một số lệnh gọi không vừa trong một giao dịch Solana. Phần này trình bày điều gì xảy ra khi đó, và những giới hạn nào áp dụng.

### Khi trình ghép nguyên tử từ chối

`rome_composeUnsignedAtomicV1` từ chối một lệnh gọi không vừa trong một giao dịch nguyên tử. `submitRomeTxV1` rồi chuyển tiếp lệnh gọi qua proxy với **cùng** chữ ký ủy quyền, nên ví không bị hỏi lần thứ hai. Kết quả có `route: "relay"` và không có `chữ ký`. Đặt `relayOnRefusal: false` để nhận sự từ chối như một lỗi, hoặc gọi `relayV1` bạn tự mình để chuyển tiếp có chủ đích.

Ba điều cần biết về một lệnh gọi được chuyển tiếp:

* **Synthetic trả gas.** Trên tuyến chuyển tiếp, proxy gửi và trả phí cho các giao dịch Solana, còn lệnh gọi được thanh toán bằng token gas gốc của chain từ số dư của synthetic. Số dư phải ít nhất là `gasLimit × maxFeePerGas`. `fundSyntheticGas(deps, amountWei)` nạp thêm từ tài khoản token gas của chính ví trên chain (USDC trên Hadrian và Rubicon); ví ký một giao dịch v1 thông thường, và cần một ít SOL để trả phí Solana. `amountWei` nằm trong đơn vị wei 18 chữ số thập phân của chain và phải là bội số của 10^12, nếu không proxy sẽ từ chối. Không dùng SDK, `rome_composeExternalDepositV1` xây dựng cùng một giao dịch.
* **Một revert không ném lỗi.** Một lệnh gọi được chuyển tiếp nhưng revert ở phía EVM vẫn được phân giải bình thường, với `receipt.status === "0x0"`. Kiểm tra `receipt?.status === "0x1"` trước khi coi lệnh gọi là đã hoàn tất. `receipt` là `null` nếu receipt không xuất hiện kịp thời.
* **`relayOnRefusal: false` là một lựa chọn được thực hiện trong SDK, không phải một khóa cứng.** Proxy đã giữ chữ ký ủy quyền cho payload đó và có thể chạy nó theo cả hai tuyến, tối đa đến `gasLimit × maxFeePerGas`.

```javascript
const res = await submitRomeTxV1(deps, { to, data, value });
if (res.route === "relay" && res.receipt?.status !== "0x1") {
  // một lệnh gọi được chuyển tiếp nhưng revert vẫn được giải quyết; nó không ném lỗi
}
```

### Các lệnh gọi dài

Một lệnh gọi cần nhiều hơn một giao dịch sẽ chạy như một phiên lặp: chương trình thực thi số bước EVM vừa trong mỗi giao dịch Solana và lưu trạng thái giữa các lần. Có hai cách điều khiển nó từ một ví Solana:

* **Chuyển tiếp nó.** `rome_relayUnsignedV1` chỉ cần một chữ ký ví và payer của proxy gửi mọi chặng. Synthetic trả gas, như trên.
* **Tự ký các chặng.** `rome_composeUnsignedIterativeV1` trả về mọi chặng với một ô chữ ký trống, ví ký từng chặng, và `rome_submitSignedV1Plan` phát chúng theo thứ tự. Mỗi chặng là một giao dịch Solana riêng để ví ký, nên một ví chỉ ký từng giao dịch một sẽ hỏi một lần cho mỗi chặng, ngoài chữ ký ủy quyền. Ví trả phí Solana cho mọi chặng.

Các giới hạn:

| Giới hạn                                                   | Giá trị          | Nguồn gốc                                                                                                                     |
| ---------------------------------------------------------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Các giao dịch trong một `rome_submitSignedV1Plan` lệnh gọi | 64               | Proxy từ chối một kế hoạch dài hơn                                                                                            |
| Số chặng mà trình ghép lặp sẽ lập kế hoạch                 | 128              | Giới hạn trong trình ghép lặp của Rust Rome SDK, cũng chính là giới hạn của kế hoạch `rome_composeUnsignedIterativeV1` trả về |
| Số vòng lặp trong một phiên                                | 160              | Chương trình Rome EVM; vượt quá nó thì phiên ngừng tiếp tục, nhả khóa tài khoản và kết thúc                                   |
| Kích thước giao dịch Solana và tài khoản                   | 4 KB, 64 địa chỉ | Mỗi chặng là một giao dịch Solana v1                                                                                          |

Phần lớn các lệnh gọi thực tế hoàn tất với ít chặng hơn nhiều so với các giới hạn này. Giới hạn 64 giao dịch trên một kế hoạch do ví ký là thứ bạn sẽ gặp trước tiên. Một lệnh gọi cần nhiều chặng hơn thế không thể được phát qua `rome_submitSignedV1Plan`.

Một lệnh gọi dài không thể thực hiện CPI trên legacy-track. Các lệnh gọi thay đổi trạng thái trên các precompile legacy (`0xff…08`, `0xff…09` và `0x42…16`) sẽ bị từ chối trong một phiên lặp với `CpiProhibitedInIterativeTx`. Các lệnh đọc trạng thái Solana và các precompile cached-track (`0xff…04`, `0xff…05`, `0xff…06`, `0xff…0b`) thì hoạt động. Một lệnh gọi thực hiện CPI trên legacy-track phải vừa trong một giao dịch nguyên tử, bất kể tuyến nào gửi 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).

## Các triển khai tham chiếu

* **Aerarium** — điều khiển Compound v3 (cung cấp / vay) từ một ví Solana qua `DoTxUnsigned`. Đây là tham chiếu cho tuyến giao dịch legacy cũ được mô tả ở trên, không phải cho `submitRomeTxV1`.
* **Rome DEX** không phải là một ví dụ của trang này: phía Solana của nó là một chương trình Solana gốc mà ví ký trực tiếp, và phía EVM của nó dùng chung cùng một pool.

Aerarium không cần ví thứ hai — địa chỉ synthetic biến một khóa Solana thành một tài khoản EVM hạng nhất. Với mẫu v1, hãy theo [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).

## Tiếp theo là gì

* [Gọi Solana từ EVM](https://docs.rome.builders/vi/huong-dan-cho-nha-phat-trien/call-solana-from-evm.md) — theo chiều ngược lại, qua CPI
* [Tương tác token](https://docs.rome.builders/vi/cac-khai-niem-cot-loi/token-interop.md) — cách số dư được chia sẻ giữa EVM và Solana


---

# 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/huong-dan-cho-nha-phat-trien/call-evm-from-solana.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.
