> 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/zh/kai-fa-zhe-zhi-nan/call-evm-from-solana.md).

# 从 Solana 调用 EVM

让 Solana 钱包直接驱动 Rome 上的 EVM 合约——无需以太坊密钥。钱包签名后，其交易会发送到 Solana。

与……相反 [从 EVM 调用 Solana](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/call-solana-from-evm.md)：一个 Solana 钱包（例如 Solflare）直接调用 Rome 上的任何 EVM 合约，并且 **不需要以太坊密钥**。这就是 [Aerarium](https://docs.rome.builders/zh/rome-shang-de-ying-yong/apps.md) 使原生 Solana 用户能够与 EVM 用户共享相同合约的方式。

单次调用方式是 SDK 的 `submitRomeTxV1`，由代理为该调用组装一笔 Solana v1 交易；本页解释其工作机制。

## 合成地址

Solana 钱包的 EVM 身份是其 **合成地址** ——即以下内容的最后 20 个字节： `keccak256` ，其 32 字节 Solana 公钥的哈希：

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

这就是 `msg.sender` 钱包调用合约时所使用的地址，也是其 nonce 和存储所依附的稳定身份。该派生方式写入了协议，因此钱包始终映射到同一个地址。

```javascript
import { syntheticAddress } from "@rome-protocol/sdk";
const from = syntheticAddress(solanaPubkey); // 0x… 20 bytes
```

## 合成账户只是一个透传层——静置时不持有任何代币

原生 Solana 用户可支配余额保存在其 **Solana 钱包** （以 SPL 代币形式），在 EVM 侧按 1:1 映射为该代币的 **ERC20SPL 包装器** （例如 `wUSDC`）。合成账户静置时不持有任何资产，因此价值会 *通过* 它流转——每一步都由 Solana 钱包签名：

1. **创建（仅一次）。** 全新的合成账户的 external-auth PDA 在以下之前并不存在： `create_pda` 运行——而下述转账由该 PDA 签名。 `submitRomeTxSolanaLane` 在首次使用时自动创建它（或调用 `provisionSynthetic` 以执行显式“Activate”步骤；可通过以下方式检查： `isSyntheticProvisioned`）。使用 `submitRomeTxV1`，先检查 `isSyntheticProvisioned` 并提交 `buildCreatePdaCall` 一次通过它。
2. **注资步骤（钱包 → 合成账户）。** 将代币从钱包的 ATA 转入合成账户的 ATA——该 `ActivateAta` 步骤由 `buildFundLeg`构建。 `wrapper.balanceOf(synthetic)` 读取该余额，因此合成账户将其作为普通 ERC-20（`transfer` / `transferFrom`）进行支出—— **不** 作为原生 `msg.value`，而它并不持有原生资产。
3. **调用（`DoTxUnsigned`).** 合成账户执行这些 EVM 交易——例如 `approve` 然后一个金库 `存款` 通过以下方式拉取： `transferFrom`.
4. **清扫步骤（合成账户 → 钱包）。** 当提取 / 借入 / 领取使代币进入合成账户后， `buildSweepLeg` 会将其推回用户自己的钱包 ATA（`HelperProgram.transfer_spl`），使合成账户的净额归零。

下一节介绍较早的 `submitRomeTxSolanaLane` 在客户端构建。 `submitRomeTxV1` 则让代理改为组装一笔 v1 交易，而无需在你的代码中进行账户发现、ComputeBudget 或 treasure wallet；请参见 [external-V1 端点](#the-external-v1-endpoints) 下方。

## 调用是如何构建的

`submitRomeTxSolanaLane` 完成这一切。机制如下：

1. **构建一笔未签名的 EIP-1559 交易** 外 `由` = 合成地址——无需 secp256k1 签名。
2. **发现账户** ——调用 [`rome_emulateCallAccounts`](https://docs.rome.builders/zh/can-kao/json-rpc.md) 并携带调用的 `由`, `到`, `data`, **和 `value`** （当调用是 payable 时）。传入 `value` 很重要：代理会模拟 *真实的* 调用，因此任何依赖 value 的存储写入——例如新的映射槽——都会被分配，并返回其 Solana 账户。若省略它，则该账户缺失，交易会以以下错误失败： *"instruction modified data of a read-only account."*
3. **组装 Solana 交易：** 两条 **ComputeBudget** 指令（Rome 的 EVM 需要提高 CU 限制，约 1.35M，以及较大的堆帧，约 250 KB——Solana 的默认值会报错）+ **`DoTxUnsigned`** 指令（未签名的 RLP + 已发现的账户）+ 每条链的 **金库钱包** （执行会向其支付一笔小额费用；发现阶段不包含它，因此 SDK 会将其追加上去）。
4. **钱包签名并提交。** 这些 **Solana 钱包对该 Solana 交易（Ed25519）签名，并将其发送到 Solana RPC——而不是发送到代理。** Solana 运行时验证签名；在链上，程序会从该签名者派生 `msg.sender` 。授权依据是 Solana 签名，而不是以太坊签名。（代理仅用于第 2 步中的模拟/发现。）

用户的 PDA（`["EXTERNAL_AUTHORITY", synthetic_address]`）拥有其代币账户，并代表其签署 SPL CPI——因此 Solana 用户可以完全通过其 Solana 钱包进行供给、借贷、兑换和提供 LP。

## external-V1 端点

`submitRomeTxV1` 是单次调用方式：它向代理请求一笔已组装的 v1 交易，进行检查，让钱包签名并发送到 Solana RPC；当调用不适配时，则通过代理转发。代理以 RPC 方法的形式暴露同一路径，因此任何客户端都可以无需 SDK 使用它（完整列表见 [JSON-RPC 支持](https://docs.rome.builders/zh/can-kao/json-rpc.md)):

* `rome_composeUnsignedAtomicV1(rlp, pubkey, signature)` ——一笔 Solana v1 交易；钱包对其签名，应用将其广播到 Solana RPC。当调用无法装入一笔原子交易时会被拒绝。
* `rome_composeUnsignedIterativeV1(rlp, pubkey, signature)` ——执行的每一段（若能装入则为原子式，否则为迭代式各段）；钱包分别对每一段签名， `rome_submitSignedV1Plan` 并将其广播。长计划的限制见 [转发调用和长调用](#relayed-calls-and-long-calls).
* `rome_relayUnsignedV1(rlp, pubkey, signature)` ——只需一次钱包签名，代理的 payer 驱动各个步骤并返回 EVM 交易哈希；合成账户支付 Rome gas，因此先用以下方式为其一次性注资： `rome_composeExternalDepositV1`.

**授权签名。** `rlp` 是一个仅含 9 个字段的未签名 EIP-1559 载荷。钱包使用其 Ed25519 密钥签名，签名对象可以是原始 32 字节 `keccak256(0x02 ‖ rlp)` ，也可以是可读消息

```
Rome authorization\n0x<该哈希的 64 个小写十六进制字符>
```

两种形式都可接受；可读形式是钱包在其 `signMessage` 提示中清晰展示的内容。程序会根据其执行的载荷重新计算哈希，并要求签名消息必须严格符合这两种形式之一，因此针对一个载荷的签名绝不会授权另一个载荷，而载荷中的 nonce 可防止重放。

## 转发调用和长调用

有些调用无法装入一笔 Solana 交易。本节说明在这种情况下会发生什么，以及适用哪些限制。

### 当原子组装器拒绝时

`rome_composeUnsignedAtomicV1` 会拒绝无法装入一笔原子交易的调用。 `submitRomeTxV1` 随后通过代理转发该调用，并使用 **相同的** 授权签名，因此不会再次询问钱包。结果具有 `route: "relay"` 且没有 Solana `签名`。 `relayOnRefusal: false` 即可将拒绝作为错误返回，或者调用 `relayV1` 自行主动转发。

关于转发调用，有三点需要了解：

* **由合成账户支付 gas。** 在转发路径中，代理会提交并支付 Solana 交易费用，而该调用则从合成账户余额中以链的原生 gas 代币支付。余额至少必须为 `gasLimit × maxFeePerGas`. `fundSyntheticGas(deps, amountWei)` 从钱包自身持有的该链 gas 代币账户中补足（在 Hadrian 和 Rubicon 上为 USDC）；钱包只需签署一笔普通 v1 交易，并需要少量 SOL 用于支付 Solana 手续费。 `amountWei` 以该链 18 位小数的 wei 计价，且必须是 10^12 的整数倍，否则代理会拒绝。没有 SDK 时， `rome_composeExternalDepositV1` 会构建相同的交易。
* **回滚不会抛出异常。** 在 EVM 侧回滚的转发调用会正常返回，并带有 `receipt.status === "0x0"`。 `receipt?.status === "0x1"` 后，再将该调用视为完成。 `receipt` 为 `null` 如果 receipt 未能及时出现。
* **`relayOnRefusal: false` 是 SDK 中作出的选择，而不是强制约束。** 代理已经持有该载荷的授权签名，并且可以通过任一路径执行它，最多可达 `gasLimit × maxFeePerGas`.

```javascript
const res = await submitRomeTxV1(deps, { to, data, value });
if (res.route === "relay" && res.receipt?.status !== "0x1") {
  // 发生回滚的转发调用会正常返回；不会抛出异常
}
```

### 长调用

需要多于一笔交易的调用会作为迭代会话运行：程序会在每笔 Solana 交易中执行尽可能多的 EVM 步骤，并在各笔交易之间保存其状态。使用 Solana 钱包驱动它有两种方式：

* **转发它。** `rome_relayUnsignedV1` 只需一次钱包签名，代理的 payer 发送每个步骤。如上所述，gas 由合成账户支付。
* **自行签署各个步骤。** `rome_composeUnsignedIterativeV1` 会返回每个步骤，并留空签名槽，钱包逐一签名，然后 `rome_submitSignedV1Plan` 按顺序广播它们。每个步骤都是一笔独立的 Solana 交易，需要钱包签名，因此一次只签一笔交易的钱包除了授权签名之外，还会在每个步骤各提示一次。钱包需为每个步骤支付 Solana 手续费。

限制如下：

| 限制                                   | 值           | 来源                                                                     |
| ------------------------------------ | ----------- | ---------------------------------------------------------------------- |
| 单次中的交易数 `rome_submitSignedV1Plan` 调用 | 64          | 代理会拒绝更长的计划                                                             |
| 迭代组装器将规划的步骤数                         | 128         | Rust Rome SDK 迭代组装器中的上限，该上限也限制了计划 `rome_composeUnsignedIterativeV1` 返回 |
| 单次会话中的迭代次数                           | 160         | Rome EVM 程序；超过该上限后，会话将停止恢复、释放其账户锁并结束                                   |
| Solana 交易大小与账户                       | 4 KB，64 个地址 | 每个步骤都是一笔 Solana v1 交易                                                  |

大多数真实调用所需的步骤数远少于这些上限。钱包签名计划的 64 交易限制是你首先会遇到的。一旦调用所需步骤数超过该限制，就无法通过以下方式广播： `rome_submitSignedV1Plan`.

长调用不能发起 legacy-track CPI。对 legacy 预编译的变更调用（`0xff…08`, `0xff…09` 和 `0x42…16`）在迭代会话中会被拒绝，并伴随 `CpiProhibitedInIterativeTx`。对 Solana 状态的读取以及对 cached-track 预编译（`0xff…04`, `0xff…05`, `0xff…06`, `0xff…0b`）的调用可正常工作。凡是会发起 legacy-track CPI 的调用，无论通过哪条路径发送，都必须装入一笔原子交易。参见 [约束](https://docs.rome.builders/zh/he-xin-gai-nian/constraints.md) 和 [计算预算](https://docs.rome.builders/zh/he-xin-gai-nian/compute-budget.md).

## 参考实现

* **Aerarium** ——通过以下方式从 Solana 钱包驱动 Compound v3（供给 / 借入）： `DoTxUnsigned`。它是上述较旧的 legacy-transaction 路径的参考实现，而不是用于 `submitRomeTxV1`.
* **Rome DEX** 不是本页的示例：其 Solana 侧是一个原生 Solana 程序，由钱包直接签名；其 EVM 侧共享同一个资金池。

Aerarium 不需要第二个钱包——合成地址使一个 Solana 密钥成为一等公民的 EVM 账户。对于 v1 模式，请参见 [构建双通道应用](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/dual-lane-app.md).

## 下一步

* [从 EVM 调用 Solana](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/call-solana-from-evm.md) ——另一方向，经由 CPI
* [代币互操作](https://docs.rome.builders/zh/he-xin-gai-nian/token-interop.md) ——余额如何在 EVM 与 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/zh/kai-fa-zhe-zhi-nan/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.
