> 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/rome-xue-yuan/08-open-your-solana-program-to-evm-users.md).

# 8. 向 EVM 用户开放你的 Solana 程序

通过一个轻量的 Solidity 合约和 CPI 预编译合约，让 MetaMask 用户调用你已经在 Solana 上运行的程序，无需迁移，也无需再复制一份状态。

你有一个可运行的 Solana 程序。它的用户持有 Solana 钱包。Rome 让第二类受众也能使用它——那些持有 EVM 钱包（如 MetaMask）的人，而无需你将程序重写为 Solidity。

## 你将学到什么

* 为什么要向 EVM 用户开放 Solana 程序，以及你能保留什么。
* EVM 调用如何到达你的程序：一个薄层 Solidity 合约和 CPI 预编译。
* 你的程序会看到什么作为签名者和账户。
* EVM 用户的代币如何到达你的程序并返回。
* 设计时需要围绕的限制：一个轨道、一个原子交易、账户上限。

## 用例

本课对应一个来自 [你可以构建什么](https://docs.rome.builders/zh/rome-xue-yuan/02-what-you-can-build.md)的用例：一个希望吸引更多用户的现有 Solana 应用。借贷市场、AMM、金库、预测市场或隐私程序都适合。

EVM 受众规模庞大，而且已经具备钱包、工具和使用习惯。如果你把程序移植到 Solidity，就需要维护两套代码库并拆分状态。在 Rome 上，你只保留一个程序和一份状态。EVM 用户通过一个小型 Solidity 合约访问它，而 Solana 用户仍可原生调用它。双方都基于同一组账户和同一流动性进行交易。 [选择你的核心](https://docs.rome.builders/zh/he-xin-gai-nian/choose-your-core.md) 将这种形态称为 (b)：一个原生 Solana 核心配合一个薄层 CPI 路由器。

[rome-dex](https://github.com/rome-protocol/rome-dex) 是参考示例：一个原生 Solana 池，前面加一个 EVM 路由器。

## 开始之前

* 完成 [7. 向 Solana 钱包开放你的 EVM 应用](https://docs.rome.builders/zh/rome-xue-yuan/07-open-to-solana-wallets.md)，从另一侧看也是同样的思路。
* 了解 [5. 从 Solidity 调用 Solana](https://docs.rome.builders/zh/rome-xue-yuan/05-call-solana-from-solidity.md) 和 [6. 双边代币](https://docs.rome.builders/zh/rome-xue-yuan/06-tokens-on-both-sides.md)。本课将它们整合起来。
* 将你的程序部署到 Solana devnet。Hadrian 在那里结算，因此程序必须存在于该集群上。参见 [Hadrian](https://docs.rome.builders/zh/wang-luo/hadrian.md).

## 简要路径

### 步骤 1：在你的程序前放置一个薄层合约

该合约是一个适配器。它不包含业务逻辑。它会检查调用者，构造你的指令，并使用 `invoke_signed`。其他一切都保留在你的 Solana 程序中。调用机制见 [从 EVM 调用 Solana](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/call-solana-from-evm.md#calling-custom-solana-programs)，而接口位于 `contracts/interface.sol` 公开的 [rome-solidity](https://github.com/rome-protocol/rome-solidity) 代码仓库中介绍。

你的适配器有三种方式来持有用户仓位。指南在其中进行比较 [持有用户仓位的三种方式](https://docs.rome.builders/pages/6d3e31686e4cb73ec09bc01c61a81b4e07583fbf#id-2.-three-ways-to-hold-a-users-position):

| 形态      | 它是什么                  | 适用场景              |
| ------- | --------------------- | ----------------- |
| 适配器合约   | 将用户的代币拉入，并以自身身份调用你的程序 | 面向带有存款功能的程序的可复用前端 |
| 用户调用预编译 | 由用户自身权限签名，无需合约        | 一次性授权和简单程序        |
| 无托管路由器  | 从不持有代币，使用用户的授权额度      | 交换和其他一次性操作        |

金库或借贷程序选适配器，兑换选路由器。

### 步骤 2：了解你的程序会看到谁

每个 EVM 地址都有一个 Solana 身份，即其 external-authority PDA，由 Rome 程序派生而来。当合约调用预编译时，Rome 会使用该合约的权限进行签名。你的程序看到的是一个被标记为签名者的 32 字节公钥。它既看不到 20 字节的 EVM 地址，也看不到用户。

因此，用户并不是签名者。为了区分不同用户，适配器会在指令数据中传递一个按用户区分的值，或者要求 Rome 还使用一个由用户地址派生、带盐的子 PDA 进行签名。然后你的程序为每个子 PDA 维护一个仓位。签名者规则见 [每个 EVM 地址都有一个 Solana 身份](https://docs.rome.builders/pages/6d3e31686e4cb73ec09bc01c61a81b4e07583fbf#id-1.-every-evm-address-has-one-solana-identity).

编写你的程序，使其对任意签名的权限都能执行操作。这样它既能服务 Solana 钱包，也能服务适配器。

### 步骤 3：转移用户的代币

在 Rome 上，正如第 6 课所示，用户的 USDC 从两个角度看是同一个 SPL 代币。用户余额存放在其权限拥有的代币账户中。要让适配器支出这些代币，用户需要在存款前授予适配器一个 SPL 委托。适配器将代币提取到自己拥有的代币账户中，然后调用你的程序。退出时，你的程序将资金支付到用户自己的代币账户，用户会立即把它看作 ERC-20 余额。

这里有两个陷阱需要注意：

* 一个 ERC-20 `transferFrom` 向合约转入 ERC-20 只会记入包装器的托管账本。合约不会获得可供支出的代币账户。要使用委托，而不是包装器。
* 一个代币账户只有一个委托方。你的授权会取代包装器的授权，用户的常规代币转账会停止，直到他们再次向包装器授权。检查 `isEnabled` 在你的流程之后。

完整流程见 [代币进，代币出](https://docs.rome.builders/pages/6d3e31686e4cb73ec09bc01c61a81b4e07583fbf#id-3.-tokens-in-tokens-out).

### 步骤 4：保持在限制之内

* **一个轨道。** 自定义程序调用是旧轨道 CPI。一个交易不能将其与缓存轨道调用混用，因此不要让缓存包装器出现在该交易中。
* **仅限原子执行。** 旧轨道 CPI 不能在迭代式交易中运行。整个调用必须装入一笔 Solana 交易中，约 140 万计算单元、64 个地址和 4 KB。你的程序要与 Rome 程序共享这部分计算预算。
* **账户预先列出。** Rome 会模拟该调用，并将它触及的每个账户放入 Solana 交易中。每个账户都必须能从适配器已有的输入中推导出来。即使是新账户，也必须事先命名。
* **调用深度较浅。** 你的程序运行在 Rome 下方一层。它调用的每个程序都会再增加一层。
* **租金由用户承担。** 你的指令创建的账户通过用户的 gas 支付费用。

将每个操作限制为一次代币移动和一次对你程序的 CPI。任何更大的操作都拆分为两笔用户交易。限制列在……中的一张表里 [约束](https://docs.rome.builders/zh/he-xin-gai-nian/constraints.md).

## 一个完整示例

假设你的程序是一个金库。Solana 用户先存入 USDC，之后再提取。你希望 MetaMask 用户也能这样做。

1. 你部署一个适配器，其中包含你的程序 ID 和 USDC 铸币地址。在构造函数中，它会创建自己的 Solana 身份以及对应的代币账户。
2. MetaMask 用户发送一笔交易，为其 USDC 向适配器授予 SPL 委托。
3. 用户调用 `存款`。适配器将 USDC 提取到自己的代币账户中，然后以自身权限以及为该用户派生的带盐子 PDA 作为签名者调用你的程序。
4. 你的程序将 USDC 转入其金库，并在该子 PDA 下记录仓位。
5. 适配器的授权替代了包装器的授权，因此你的应用读取 `isEnabled` 包装器中用户的。它返回 `false`，然后用户发送 `approve_spl` 再次向包装器授权。下一次存款需要重新向适配器授权。
6. 用户调用 `withdraw`。适配器让你的程序直接从金库向用户的代币账户支付。余额会在 MetaMask 中显示为 ERC-20 代币。

你的 Solana 用户从未接触过该适配器。他们直接调用金库，并看到相同的总额。对应的 Solidity 示例见 [用 Solidity 实现的存入与提取](https://docs.rome.builders/pages/6d3e31686e4cb73ec09bc01c61a81b4e07583fbf#id-7.-a-deposit-and-a-withdraw-in-solidity).

先在 Hadrian 上测试。 `eth_call` 和 `eth_estimateGas` 运行与代理发送时相同的模拟，因此在那里失败的 CPI 也会因相同原因在链上失败，并且回滚会携带你程序的错误。发送后，使用 `rome_solanaTxForEvmTx`。参见 [测试](https://docs.rome.builders/pages/6d3e31686e4cb73ec09bc01c61a81b4e07583fbf#id-8.-testing).

## 自测

拿你自己的一个小程序，或者 rome-dex 中的那个，先不写代码，记录下：

1. 适配器调用你的程序时，你的程序看到的签名者。
2. 一次存款所指定的账户。
3. 该存款中的代币移动次数和 CPI 次数。

然后在 Hadrian 上部署你的适配器，为用户的代币账户注资，向适配器发送 SPL 授权，并通过 `eth_estimateGas` 以用户地址作为 `由`。估算应该成功。如果失败，回滚数据会指出 Solana 错误。

<details>

<summary>1. MetaMask 用户通过你的适配器存款。谁为你的程序签名？</summary>

适配器的 external-authority PDA，以及适配器列出的任何带盐子 PDA。不是用户。用户的权限来自其授予的 SPL 委托。

</details>

<details>

<summary>2. 为什么不使用包装器的授权来提取用户的 USDC？ <code>transferFrom</code>?</summary>

这些代币会进入包装器的托管账户，并记入其账本。适配器将没有属于自己的代币账户可传给你的程序。

</details>

<details>

<summary>3. 你的存款操作增长到包含十次 CPI，而 Rome 以迭代方式运行它。会发生什么？</summary>

它会失败。迭代式交易不接受旧轨道 CPI。将该操作缩减为一次代币移动和一次 CPI，或者把它拆成两笔交易。

</details>

## 下一步

[9. 构建双通道应用](https://docs.rome.builders/zh/rome-xue-yuan/09-build-a-dual-lane-app.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/zh/rome-xue-yuan/08-open-your-solana-program-to-evm-users.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.
