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

# 向 Solana 用户开放你的合约

在 Rome（Hadrian 测试网、Rubicon 主网）上部署一个 Solidity 合约，并向 Solana 钱包开放——合约需要什么、Solana 钱包用户如何调用它、各网络地址，以及启动 ch

一次部署，两类用户。Rome 上的一个合约可由 MetaMask 用户使用其 EVM 密钥访问，也可由 Solana 钱包用户（例如 Solflare）使用其 Solana 密钥访问——同一地址，同一状态。本页给出端到端路径：部署、使合约具备 Solana 支持、在应用中接入 Solana 车道，并部署到主网。

## 1. 在你想要的网络上部署

Rome 链是标准的 EVM 目标：Hardhat、Foundry、viem 和 ethers 可直接使用（完整演练见 [部署 Solidity 合约](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/deploy-solidity.md)).

| 网络                                                                    | 链 ID     | RPC                                         | 浏览器                                                                                   | Gas 代币  | 如何获取 gas                                                                                                                                                |
| --------------------------------------------------------------------- | -------- | ------------------------------------------- | ------------------------------------------------------------------------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [**Rubicon**](https://docs.rome.builders/zh/wang-luo/rubicon.md) （主网） | `7531`   | `https://rubicon.mainnet.romeprotocol.xyz/` | [via-rubicon.mainnet.romeprotocol.xyz](https://via-rubicon.mainnet.romeprotocol.xyz/) | USDC    | 从 Ethereum、Base、Arbitrum、Polygon、Avalanche、Monad 或 OP（CCTP）桥接 USDC，或从 Solana 使用 [Rome Bridge](https://bridge-api.mainnet.romeprotocol.xyz/)；它会作为 gas 到账 |
| **Hadrian** （测试网）                                                     | `200010` | `https://hadrian.testnet.romeprotocol.xyz/` | [via-hadrian.testnet.romeprotocol.xyz](https://via-hadrian.testnet.romeprotocol.xyz/) | 测试 USDC | 从测试网桥接测试 USDC（[水龙头](https://docs.rome.builders/zh/zi-yuan/faucets.md)）或在 [Rome App](https://app.devnet.romeprotocol.xyz)                                |

中从 Solana devnet 钱包包装。EVM 侧的 gas 是带 18 位小数的 USDC；Rubicon 或 Hadrian 上没有 Rome 水龙头。写入操作的 gas 成本比 Ethereum 的直觉更高，因为大部分成本来自创建 Solana 账户：从未使用过的接收方、新的代币账户、已部署合约。使用 gas 估算， `eth_estimateGas`标准工具链也会这样做，切勿硬编码 21,000。在 Hadrian 上测得，部署一个 10 字节合约估算并实际使用了 1,147,921 gas，而向从未使用过的地址进行原生转账则为 1,086,961，对已存在地址转账则为 21,000。Rome 按实际使用的 gas 收费，在这些测量中从未超过估算值。首次部署前先准备几枚 USDC。之后在浏览器上验证源码（[验证合约](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/verify-contracts.md)；主网验证器是 `https://verify.mainnet.romeprotocol.xyz`).

先在 Hadrian 上开发，然后将相同的构建产物、连同 chain id 和主网包装器地址替换后重新部署到 Rubicon；合约在各网络之间没有任何变化。Rubicon 自 v0.3.0 起已在公共注册表中，但 `create-rome-app` 和 `rome-cli` 仍然固定使用注册表 v0.2.0，其中没有 Rubicon 条目，因此无法针对它；对于这些工具，请手动从 [Rubicon](https://docs.rome.builders/zh/wang-luo/rubicon.md)填写这些值。Rubicon 上的 gas 以真实 USDC 计价，gas 价格约为 Hadrian 的十倍，因此在那里部署需要真实资金。

## 2. 什么让合约具备 Solana 支持

Solana 用户的 EVM 身份是他们的 **合成地址**, `keccak256(solana_pubkey)[12:]`：一个普通的 `msg.sender`EVM 地址，带普通的 nonce。大多数合约根本不需要改动。真正重要的三件事：

* **以 ERC-20 形式接收价值，而不是 `msg.value`.** Solana 用户的资金是其钱包中的 SPL 代币，在 EVM 侧表现为该代币的包装版（`wUSDC`, `wETH`, `wSOL`）。这种合成资产在静态状态下不持有任何资产，用户的资产会以包装版到达，因此请使用 `transferFrom` 在一次 `approve` 拉取，并使用 `transfer`返还。每个用户在第一次拉取前都会先授予包装器一次 SPL 代理权限（[一次性：授予包装器](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/dual-lane-app.md#one-time-grant-the-wrapper)）。 `可支付的` 入口点只有在合成资产已获得原生 gas 后才可工作（中继路径的 `rome_composeExternalDepositV1`先注资再扫除模型不会这样做。现有的 ERC-20 金库、AMM 或借贷市场已经具备正确形态。
* **使用规范包装器。** 每条链每个 mint 只有一个包装器；地址在 [合约地址](https://docs.rome.builders/zh/can-kao/contract-addresses.md) （Hadrian 的也在公共 [注册表](https://github.com/rome-protocol/rome-registry)中）。将构造函数指向这些地址；不要自行部署。
* **在钱包签名时满足原子预算限制。** Solana 钱包签名一笔 Solana 交易，因此 Solana 车道调用必须符合该限制：大约 140 万 compute units、64 个账户、4 KB（[约束](https://docs.rome.builders/zh/he-xin-gai-nian/constraints.md)使用 Solana 回执中的 `computeUnitsConsumed`，并在请求交易时使用 `maxSupportedTransactionVersion: 1` （Rome 的 leg 是 v1 交易；没有它，RPC 会拒绝该请求）。

你不需要的东西：Solana 程序、桥、第二次部署，或任何 Rome 特定的 Solidity。如果合约还通过预编译调用 Solana 程序，请参见 [从 EVM 调用 Solana](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/call-solana-from-evm.md).

## 3. 让 Solana 钱包来调用它

你的应用的 EVM 路径保持不变（MetaMask + `submitRomeTx`，或直接使用 viem/ethers）。对于 Solana 路径，有两种形态。

**SDK 车道——每次调用对应一笔 Solana v1 交易。** [`@rome-protocol/sdk`](https://github.com/rome-protocol/rome-sdk-ts) (`submitRomeTxV1`）让代理为你的 EVM 调用组合出一笔 Solana v1 交易（最多 64 个账户和 4 KB，且不使用 address lookup table；你的代码中没有 ComputeBudget 指令、treasure wallet 或账户发现）。钱包用同一把密钥签名两次：首先签署一条可读的授权消息（`Rome 授权` 第一行， `0x` 下一行是 EVM 交易哈希），链通过 Ed25519 程序对其进行校验，然后再校验交易。应用把签名后的交易发送到 Solana RPC；调用返回 EVM 交易哈希及其回执。在钱包签署交易前，SDK 会先检查它：付款人是唯一签名者，只运行 Rome 程序和 Ed25519 验证器，Rome 指令携带的正是用户授权的调用，而且没有优先费。其他任何情况都会被拒绝。

如果某次调用无法装入一笔交易，composer 会拒绝它，而 SDK 会把它交给代理去中继，并沿用同一授权签名，因此用户仍然只会看到一个授权提示。此时结果会有 `route: "relay"`。中继调用和长调用的规则见 [转发调用和长调用](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/call-evm-from-solana.md#relayed-calls-and-long-calls)。 `fundSyntheticGas(deps, amountWei)` 将链的 gas 代币（Hadrian 和 Rubicon 上为 USDC）从钱包的代币账户转入其中，作为一笔由钱包签名的 v1 交易。

资金腿（`buildFundLeg`）以及扫除前的钱包代币账户创建，都是普通的 Solana 指令； `submitSolanaInstructionsV1` 也会将它们作为 v1 交易发送，由同一个钱包签名者签名，不涉及代理。扫除本身的调用（`buildSweepLeg`, `HelperProgram.transfer_spl`）会像其他调用一样经过 `submitRomeTxV1` ，而代理会找到这些代币账户。 `submitRomeTxV1` 不会自行创建新的合成资产账户：在第一次执行价值流转调用之前，请检查 `isSyntheticProvisioned(...)` ，如果为 false，则提交 `buildCreatePdaCall(synthetic)` 通过 `submitRomeTxV1` 一次。完整的存入与提取代码演练见 [构建双通道应用](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/dual-lane-app.md)；其机制见 [从 Solana 调用 EVM](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/call-evm-from-solana.md)。较早的 `submitRomeTxSolanaLane`，它在客户端构建一笔传统 Solana 交易，仍作为旧路径保留在 SDK 中。

**每个 `依赖项` value 来源于何处。** SDK 的 `依赖项` 对象有五个必填字段（其余如 `fetchImpl` 和各类超时为可选）。其中四个来自链，一个来自钱包：

| `依赖项` 字段    | 来源                                                                   | 注册表获取器（`@rome-protocol/registry` v0.2.0                                 |
| ----------- | -------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| `proxyUrl`  | 链的 RPC URL                                                           | `getChain(chainId).rpcUrl`                                              |
| `chainId`   | 链 ID                                                                 | `getChain(chainId).chainId`                                             |
| `programId` | 链所运行的 Rome 程序 ID                                                     | `getChain(chainId).romeEvmProgramId`                                    |
| `连接`        | 用于该链集群的 Solana RPC，已签名交易会发送到这里（Hadrian 使用 devnet，Rubicon 使用 mainnet） | `getChain(chainId).solana.rpc` （Hadrian 的一个公共 devnet URL）；主网请使用你自己的 RPC |
| `signer`    | 钱包的 `LaneSigner`，或脚本中的 `Keypair` 。                                   | 无                                                                       |

这些 leg 构建器使用不在 `依赖项`中的值。它们的 `mint` （称为 `usdcMint` ，在演练中如此命名）是 gas 代币的 Solana 铸币地址，来自 `getTokens(chainId)` （其中条目为 `kind: "gas"`，字段 `mintId`）。wUSDC 包装器地址不是 leg 构建器的输入；你在 ERC-20 调用中使用它，它对应的条目是 `kind: "spl_wrapper"` 且符号为 `wUSDC` （字段 `address`）。注册表涵盖 Hadrian，并自 v0.3.0 起也涵盖 Rubicon。若要手动填写 Rubicon 值： `proxyUrl` `https://rubicon.mainnet.romeprotocol.xyz/`, `chainId` `7531`, `programId` `RomePq9X3iAoTr813HR7uRarafFDUJty6GdiEceYpzX`, `mint` `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`、下一节表中的包装器，以及 `连接`. [Rubicon](https://docs.rome.builders/zh/wang-luo/rubicon.md) 的 Solana mainnet RPC。

**代理的外部 V1 端点——无需 SDK 的同一条车道。** SDK 封装了原子组合、中继和 gas 存款（`fundSyntheticGas`）。原始 RPC 方法仍然保留给不使用 SDK 的客户端，其中包括迭代式组合，而 SDK 不会封装它。钱包针对该调用签署一条 Ed25519 消息（可读形式 `Rome authorization\n0x<hash>` 或原始哈希），然后代理要么为钱包组合出要签名的 Solana 交易（`rome_composeUnsignedAtomicV1`, `rome_composeUnsignedIterativeV1` + `rome_submitSignedV1Plan`）或者仅凭一次钱包签名自行完成整个执行（`rome_relayUnsignedV1`，在一次 `rome_composeExternalDepositV1` （SDK 的 `fundSyntheticGas`）用于为合成资产补充 gas 余额；中继调用会从中消耗，因此余额不足时请补充）。方法形态见 [JSON-RPC 支持](https://docs.rome.builders/zh/can-kao/json-rpc.md)；授权规则见 [从 Solana 调用 EVM](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/call-evm-from-solana.md#the-external-v1-endpoints)。对任何迭代式操作使用 relay，而对所有能装下的调用使用 SDK 车道。

无论哪种方式，合约看到的都是来自合成资产地址的普通交易，而用户从不持有 EVM 密钥。

## 4. 各网络的包装器地址

| 网络              | `wUSDC` 包装器                                  | 其他包装器                                                                                                    |
| --------------- | -------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Rubicon（7531）   | `0x0952d233b0c254cd375f3bfb3e5869c1a906f9b3` | `wETH` `0x01e8b3573da1d4b7b4b1ce0932cf07c8af0c92e9`, `wSOL` `0xc4e29e0f726a906e93277cbbc37bf27a9848a113` |
| Hadrian（200010） | `0xbce339ba4c3a8de3bb8af1c5539e6ac11da3112d` | `wETH` `0x02aeace038269f9961c93d04dcacd6fb3adfa55f`, `wSOL` `0x39f36444fcb79b3e691544aee2a832ebef54ca9f` |

原生 gas 代币在代币列表中显示为 `0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee` ；它不是 ERC-20 合约。包装器采用 SPL 铸币的 decimals，而不是 18：wUSDC 为 6，wETH 为 8，wSOL 为 9。

## 5. 上线检查清单

1. 已部署到 Hadrian；EVM 路径可通过 MetaMask 正常工作。
2. 每个会移动价值的入口点都基于 ERC-20，并指向该链的规范包装器。
3. 一个能够签名 v1 交易的 Solana 钱包（Solflare 目前在 devnet 上可以；Phantom 还不行）即可在 Hadrian 上完成完整往返：为合成资产建档（`create_pda`，仅一次）→ 资金腿 → 授权 → approve → 调用 → 扫除腿，使用 SDK 车道；如果该调用是迭代式的，则使用中继路径。
4. 每次 Solana 车道调用的 `computeUnitsConsumed` 由 Solana 回执读取，并处于原子预算之内，或者该调用会被路由到中继。
5. 包装器授权是你应用首次存款流程的一部分，两个车道都一样： `isEnabled(user)` 会先检查 `approve_spl` ，如果为 false 则发送一次[一次性：授予包装器](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/dual-lane-app.md#one-time-grant-the-wrapper)).
6. 源代码已在浏览器上验证。
7. 已重新部署到 Rubicon，并使用主网包装器地址。其 `依赖项` 值来自注册表（v0.3.0 或更高）或手动从 [Rubicon](https://docs.rome.builders/zh/wang-luo/rubicon.md)。同样的往返会用真实资金运行一次，使用你已经确认能在主网上签署 v1 交易的钱包。

## 下一步

* [构建双通道应用](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/dual-lane-app.md) ——金库示例，逐步讲解，两个钱包
* [从 Solana 调用 EVM](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/call-evm-from-solana.md) ——合成地址、账户发现、外部 V1 端点
* [部署 Solidity 合约](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/deploy-solidity.md) · [验证合约](https://docs.rome.builders/zh/kai-fa-zhe-zhi-nan/verify-contracts.md) · [合约地址](https://docs.rome.builders/zh/can-kao/contract-addresses.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/kai-fa-zhe-zhi-nan/open-to-solana-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.
