> 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/13-build-on-solgate.md).

# 13. 基于 Solgate 构建

基于 Solgate 构建应用。Solgate 是连接 Solana、Ethereum 和 AggLayer 链的桥接与消息路由，本文将介绍可跨链传输的内容、消息流转方式、相关费用，以及如何从 Hadrian 迁移到 Rubicon。

Rome 将 EVM 和 Solana 连接成一个市场。Solgate 是两者之间的桥和消息路由。它将 Solana 代币转移到 Ethereum 和 AggLayer 链上，也将 EVM 代币转移到 Solana。它还支持合约间消息传递，接收消息的 Rome 合约可以在同一笔交易中调用 Solana 程序。本课将介绍哪些内容可以跨链、消息如何流转、接收合约需要检查什么，以及如何立即在 Hadrian 上构建并在 Rubicon 上发布。 [第 10 课](https://docs.rome.builders/zh/rome-xue-yuan/10-from-other-chains.md) 介绍 Rome Bridge，它支持转入 USDC。其他代币和消息则通过 Solgate 路由。

## 你将学到

* 哪些代币可以双向跨链，以及尚无 Solana mint 的代币如何变得可跨链。
* Verified 和 Unverified 分别是什么意思，以及用户如何将代币添加到钱包。
* 消息如何从 Ethereum 流转到 Rome，再到 Solana 程序，以及如何反向流转。
* 在 Hadrian 和 Sepolia 上测得的时间和成本。
* 接收合约必须遵守的规则，以及哪些消息不适合通过这种方式处理。
* 为什么选择 Solgate，以及你在各个方向上依赖的组件。
* 如何在 Hadrian 上开始，以及迁移到 Rubicon 时有哪些变化。

## 开始之前

* 完成 [10. 从其他链引入用户和资金](https://docs.rome.builders/zh/rome-xue-yuan/10-from-other-chains.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 的接收端会使用 CPI 预编译合约，而 Rome 上的 Solana 代币本身就是 mint。
* 准备一个已注资的 Hadrian 钱包、一个持有 Sepolia ETH 的 EVM 钱包，以及一个持有 devnet SOL 的 Solana 钱包。第 7 步列出了水龙头。

## 课程内容

### 步骤 1：了解哪些内容可以跨链

Solgate 在每条链上只传输每种代币的一种形式，即链上记录的形式。先确定方向。

**从 Solana 转至 Ethereum 和 AggLayer 链**

| 代币                                                           | 是否可跨链？                             |
| ------------------------------------------------------------ | ---------------------------------- |
| SOL                                                          | 可以，形式为 "Wrapped SOL (Rome)"        |
| 经典 SPL 代币，包括 meme 币                                          | 可以。在测试网上，选择或粘贴 mint；首次发送时会将其列出     |
| 唯一附加功能为冻结的 Token-2022                                        | 可在测试网上跨链，主网上暂不支持                   |
| 带转账手续费的 Token-2022                                           | 不支持转移                              |
| 其他 Token-2022（转账钩子、永久委托）                                     | 留在 Solana 和 Rome 上，Rome 的 EVM 仍可使用 |
| 不可转让的 mint、NFT                                               | 不可以                                |
| 由其他桥接到 Solana 的代币，前提是 AggLayer 已连接其源链（例如通过 Wormhole 桥接的 ETH） | 不要重复桥接。请从其源链桥接原始代币                 |
| USDC                                                         | 通过 Circle 的 CCTP 转移，而非 Solgate     |

**从 Ethereum 和 AggLayer 链转至 Solana**

| 代币                                        | 是否可跨链？                                          |
| ----------------------------------------- | ----------------------------------------------- |
| ETH                                       | 可以，形式为 "Ether (Rome)"，在 Solana 上为 9 位小数         |
| 标准 ERC-20                                 | 可以，形式为 "\<name> (Rome)"，即经典 SPL mint。测试网上可免许可设置 |
| 转账时收取手续费的 ERC-20                          | 可以。桥会记录实际收到的数量                                  |
| 发行方自行运行通往 Solana 的路由的代币（例如 Circle 的 CCTP） | 使用发行方的路由                                        |
| 许可型代币（ERC-3643 等）                         | 仅使用发行方自己的路由                                     |
| 弹性供应代币                                    | 不可以。请桥接其非弹性供应包装代币                               |
| AggLayer 到达其原生链时，复制其他桥接器已创建的代币            | 不会重复桥接                                          |

每种代币都遵循以下规则：

* Solgate 在每条链上仅承载每种代币的一种形式。其他桥接器创建的形式会保持独立，绝不会合并。
* Rome 创建的每种代币都会命名为“\<origin name> (Rome)”，并保留其原生代币的符号。
* Solana 使用 64 位数值表示供应量，因此小数位数超过 9 的代币在 Solana 上会采用 9 位小数。金额以 Solana 的整数单位转移。低于一个单位的零头会留在桥接器中作为储备。
* Rome 创建的 Solana 铸币账户没有冻结权限。其唯一的铸币权限属于该代币在 Rome 上的合约。
* 在 Rome 上，Solana 代币本身就是铸币账户。钱包在 Rome 上的余额就是其自己的 Solana 代币账户，不会再有第二份包装代币。
* 目前，Solgate 不承载在 Rome 链上诞生的代币。

尚无 Solana 铸币账户的代币，只需经过几个签名步骤即可进行桥接。在测试网上，任何人都可以操作，可使用 EVM 钱包或 Solana 钱包。在主网上，Rome 会列出这些代币。

1. **在 EVM 上诞生的代币。** 先将其发送到 Hadrian。该代币在此处首次被领取时，会创建其 Rome 版本。然后打开 **添加代币** 并粘贴任意一种形式：名称、原生链地址、Rome 地址或 Solana 铸币账户地址。
2. **按编号步骤签名。** 这些步骤包括设置、可选的徽标和完成操作。Solana 钱包只需支付 SOL，无需 Rome Gas，因为 Rome 的中继器会代为发送完成操作。卡片会在签名前显示全部费用。Hadrian 的设置费为 1 USDC 或 0.06 SOL，另加网络费用。
3. **在 Solana 上诞生的代币。** 在 Bridge 中选择或粘贴铸币账户地址。首次发送时会将其添加到桥接器并列出，作为一次性步骤完成。

徽标为可选项，免费添加，但需要额外签名。文件大小须低于 256 KB，并使用 PNG 格式，因为 Solana 钱包可能无法渲染 SVG。之后也可以在“我的代币”中添加徽标。

### 第 2 步：向用户说明“已验证”的含义，并让他们添加代币

已验证的代币会列在 Rome 的已验证列表中。通过开放流程设置的其他代币会显示 **未验证**。 **“代币”** 标签页会列出所有代币。用户可以按名称、符号或任意地址搜索。每一行都会显示徽标、标签和路由；展开后可查看各链上的地址，并提供复制和区块浏览器链接、 **添加到钱包** 和 **桥接**。“仅显示已验证”默认处于开启状态。

“已验证”标准：代币在其原生链上拥有真实合约，并且可通过 CoinGecko 或 CoinMarketCap 收录信息，或发行方网站进行佐证；拥有徽标；且不会冒充已验证的代币。

钱包和区块浏览器会自行进行检查。在 Solana 主网上，通常的流程是先获得 CoinGecko 或 CoinMarketCap 收录，再等待 Solscan 更新信誉信息并由 Jupiter 验证。Solflare 会自动设置自己的标签。

EVM 钱包可通过一键操作 **添加到钱包** （EIP-747），在“代币”列表行、“我的代币”页面和到账页面中添加代币。Solana 钱包会从代币的链上元数据中读取其名称、符号和徽标。

### 第 3 步：了解消息传递

Ethereum 或 AggLayer 链上的任何合约都可以向 Rome 上的合约发送消息，反之亦然。Rome 的状态存储在 Solana 上，因此接收消息的 Rome 合约可以在同一笔交易中调用任意 Solana 程序；该交易由合约自己的 PDA 签名，这是一种只有该合约才能代表其签名的 Solana 账户。Solana 程序也可以用同样的方式通过 Rome 向外发送消息。

当发起方是合约（DAO、治理执行器、金库、托管合约或 Safe）时，或者需要让 Solana 在 EVM 链上执行操作时，就需要使用消息传递。持有 EVM 钱包的用户无需使用此功能，因为同一地址可直接在 Rome 上使用。

```
Ethereum / AggLayer 链               Rome（EVM，状态存储在 Solana 上）                  Solana
发送方 ─ bridgeMessage(rome, rcvr, …, data) ─► Rome 委员会发布退出根
                                          任何人：claimMessage(proof, data)
                                          └► rcvr.onMessageReceived(origin, net, data)
                                               └► 可选 CPI，通过 0xFF..08，
                                                  由接收方的 PDA 签名 ──────► 任意程序

Solana 程序 ─ CPI 调用 Rome 的 EVM 程序，由其 PDA 签名 ─► bridgeMessage(dest, rcvr, data)
                                          Rome 的证书在 Ethereum 上完成结算 ─► 任何人都可以在目标链上领取
```

入站时，发送方调用 `bridgeMessage`。Rome 委员会将 Ethereum 的退出根发布到 Rome。随后，任何人都可以调用 `claimMessage` 并提供证明，桥接合约会调用 `onMessageReceived` 在你的接收合约上执行。出站时，Solana 程序调用 Rome 的 EVM 程序，该程序会调用 `bridgeMessage`。Rome 的证书在 Ethereum 上完成结算，任何人都可以在目标链上领取。

### 步骤 4：查看实测时间

这些流程在 Hadrian 和 Sepolia 上运行。

| 流程                                      | 结果                                 | 可领取所需时间         | Hadrian 上的成本                           |
| --------------------------------------- | ---------------------------------- | --------------- | -------------------------------------- |
| Sepolia 合约 → Rome 合约                    | 已送达                                | 133–158 秒       | 转入新接收合约需 $0.096，此后每次需 $0.0007          |
| Sepolia → Rome 合约 → Solana Memo 程序，一次领取 | Memo 已运行，接收方的 PDA 已签名              | 158 秒           | 转入新接收合约需 $0.096                        |
| 将 ETH 及消息发送到 Rome                       | 以普通的包装 ETH 余额形式到账                  | 396 秒（测试流量突增期间） | $0.19                                  |
| 在一笔 Sepolia 交易中发送代币和消息                  | 5 笔全部送达，代币先被领取                     | 未记录             | $0.175 + $0.119                        |
| 接收方先拒绝，随后接受                             | API 的模拟检查拒绝了此次领取，因此未发送任何内容；之后才成功送达 | 412 秒           | 成功领取需 $0.0007                          |
| Rome 合约 → Sepolia 合约                    | 已送达并领取                             | 317 秒           | 发送需 $0.0007；在 Sepolia 上领取需 446,636 gas |
| Solana 程序 → Rome → 出站                   | 通过一笔 Solana 交易发送；尚未在 Sepolia 上领取   | 不适用             | 5,000 lamports + Rome 费用（未记录）          |

一次 Sepolia `bridgeMessage` 使用强制退出根更新时消耗了 395K 至 400K gas。源链 gas 费不包含在上述 Hadrian 成本中。

尚未测试：主网、AggLayer L2 消息、以 Solana 钱包作为发送方、从 Rome 转出的资产、资产加 Solana 调用、实际治理接收合约，以及迭代式领取。

### 步骤 5：编写安全的接收合约

* **检查调用方和来源。** `msg.sender` 必须是桥接合约。 `(originNetwork, originAddress)` 必须是你信任的发送方。
* **只能由你领取一次。** 已回滚的领取仍可领取，并且可以重试；桥的退出根移除角色可以取消某项领取。请自行管理 nonce。
* **不会自动领取。** 由你的应用运行领取程序，或由用户自行领取。领取程序支付接收方的 Gas 费。
* **转入的价值** 会以封装 ETH 的形式到达 Rome。 **转出的价值** 只能以封装 ETH（`bridgeMessageWETH`，以 1e9 wei 为单位的倍数）转出，而且这条路径尚未运行。Rome 的 Gas USDC 通过 CCTP 转移，绝不会经过 AggLayer。
* **调用 Solana 的接收方会接收零价值消息。** 在同一笔源链交易中单独发送价值，并在接收方检查其是否到账。
* **测量你的计算量。** 一笔 Solana 交易大约允许 1.35M CU，Gas 估算值超过约 1.25M 时会拒绝。使用 Memo-CPI 的领取消耗了 813,199 CU，还剩约 0.44 至 0.54M CU 可用于更多 Solana 操作。目前尚未测量更大的指令和账户数量。对于 DEX 兑换或借款等更繁重的操作，可先暂存消息，然后在第二笔交易中执行。
* **保持消息简短。** 领取一条 16 字节的消息，调用数据就已约有 2.4 KB。
* **限制一条来自 Rome 的消息在目标链上** 所能解锁的内容，可设置限额或延迟。出站消息仅依赖 Rome 的签名者。

消息不适用于意图、快速成交、清算和价格馈送。Sepolia 到 Rome 耗时 133 至 412 秒，而经 AggLayer 的 L2 路由还要加上该链自身的结算时间。消息也不适合在单次领取中执行繁重的 Solana 操作，或通过消息购买 Solana 代币。

### 第 6 步：了解为什么选择 Solgate，以及你所依赖的保障

* **它通过 Polygon 的 AggLayer 在 Ethereum 上完成结算。** Rome 原样运行 Polygon 的 AggLayer 桥接合约。Rome 的出站证书通过 AggLayer 的悲观证明在 Ethereum 上结算。
* **它没有独立的桥接验证者网络。** 涉及的各方是 Ethereum、AggLayer 和 Rome 自身的密钥：入站由 2-of-3 委员会负责，出站由 Rome 的 AggLayer 签名者负责。
* **它是一个统一市场。** 在 Rome 上，Solana 代币就是同一个 mint，并非其封装版本。Solana 钱包在 Rome 上的余额就是它自己的代币账户，Rome 合约转移的也是相同的 SPL 代币。
* **它可以在两端编程。** EVM 消息可以在其落地的交易中驱动 Solana 程序。Solana 程序也可以通过 Rome 向外发送消息。
* **在测试网上，可从任一钱包免许可地完成设置。** Solana 钱包只需支付 SOL。EVM 代币会成为经典 SPL mint，没有冻结权限，只能由其在 Rome 上的合约铸造。
* **每条链只有一种形式，不会再封装封装代币。** Rome 会将其创建的代币标记为“(Rome)”，保留带有发行方路由的代币并沿用该路由，绝不会再次桥接其他桥的副本。
* **它与 AggLayer 只有一个连接。** 同一座统一桥可以连接到 Ethereum，以及应用列出的所有 AggLayer 链。
* **比较信任模型。** Wormhole、LayerZero、CCIP 等也能连接 Solana 和 EVM 链，各自采用不同的信任模型。请根据你的用途，将下表与它们的信任模型进行比较。

| 方向                           | 依赖的保障                                                                                             |
| ---------------------------- | ------------------------------------------------------------------------------------------------- |
| Ethereum → Rome              | Ethereum，以及一个将 Ethereum 的退出根提交到 Rome 的 2-of-3 委员会。该委员会由 Rome 的 Safe 管理，并受时间锁保护                    |
| AggLayer 链 → Rome            | 上述保障，以及该链在 Ethereum 上结算的证书                                                                        |
| Rome → Ethereum 或 AggLayer 链 | Rome 的 AggLayer 签名者。悲观证明会将每种来自其他链的代币上限设为其转入数量。消息以及 AggLayer 来源为 Rome 的代币（SOL 和其他 Solana 代币）则依赖签名者 |

### 第 7 步：在 Hadrian 上开始使用

应用地址为 [solgate.testnet.romeprotocol.xyz](https://solgate.testnet.romeprotocol.xyz)。其中包含 Bridge、添加代币、代币、领取、活动和工作原理等页面。实时链列表见 `GET /v1/chains`.

| 链             | AggLayer 网络 | 链 ID     | 备注                                                                                                              |
| ------------- | ----------- | -------- | --------------------------------------------------------------------------------------------------------------- |
| Rome Hadrian  | 74          | 200010   | RPC `https://hadrian.testnet.romeprotocol.xyz/`，区块浏览器 `via-hadrian.testnet.romeprotocol.xyz`；状态位于 Solana devnet |
| 以太坊 Sepolia   | 0           | 11155111 | 您可以为自己申领                                                                                                        |
| Katana Bokuto | 37          | 737373   | 您可以为自己申领                                                                                                        |
| Billions 测试网  | 32          | 6913     | 您可以为自己申领                                                                                                        |

测试代币：

* **Solana devnet SOL。** faucet.solana.com。Solana 钱包在 Solgate 中无需其他配置。
* **Hadrian Gas（USDC）。** 从 Circle 水龙头（faucet.circle.com）获取测试网 USDC，并通过 Rome Bridge 测试网（bridge-api.devnet.romeprotocol.xyz）将其转入您的 EVM 地址，作为 Hadrian Gas。请选择 Rome Bridge 列出的源测试网。
* **Sepolia ETH。** 任意公开的 Sepolia 水龙头。
* **已在 Hadrian 上验证的 Sepolia ERC-20 代币。** Aave 的 Sepolia 水龙头代币（DAI、USDT、WBTC、AAVE、EURS）。或者自行部署并完成设置。

可供查阅的合约和代码：

* Rome Hadrian 桥： `0x5366e5864cb9dba587a706d8dd48cfdc40b961af` （网络 74）。Sepolia 桥： `0x528e26b25a34a4A5d0dbDa1d57D318153d2ED582` （网络 0）。
* Polygon 的桥： `github.com/agglayer/agglayer-contracts`。请阅读 `AgglayerBridge.sol` 和 `AgglayerBridgeL2.sol` (`bridgeMessage`, `bridgeMessageWETH`, `claimMessage`）以及 `IBridgeMessageReceiver` 接口（`onMessageReceived`).
* Rome 的 Solana 预编译合约： `github.com/rome-protocol/rome-solidity`, `contracts/interface.sol`。对任意程序执行 CPI 的地址为 `0xFF00…0008`，SPL 代币预编译合约的地址为 `0xff00…0005`.
* 各链上的代币地址： `GET /v1/tokens`。链列表： `GET /v1/chains`。实时开关： `GET /v1/switches`.

消息 API 已在 Hadrian 上线。

| 调用                                           | 使用                                                                           |
| -------------------------------------------- | ---------------------------------------------------------------------------- |
| `POST /v1/transfers` `{ networkId, txHash }` | 记录一笔由你挖出的发送交易。 `networkId` 表示它从哪个网络发出                                        |
| `GET /v1/transfers?wallet=<address>`         | 你的记录                                                                         |
| `GET /v1/transfers?tx=<hash>`                | 某笔发送交易的记录，代币记录排在最前                                                           |
| `GET /v1/transfers/:id`                      | 单条记录及其阶段：已发送 → 已认证 → 已结算 → 可领取 → 已领取 → 已到账                                   |
| `GET /v1/transfers/:id/claim`                | 先模拟领取交易。如果接收方会导致交易回滚，返回结果为 `message_would_fail`。模拟不会检测领取操作是否超出 Solana 的计算量限制 |

### 第 8 步：从 Hadrian 迁移到 Rubicon

Rubicon 是 Rome 的主网链，其状态位于 Solana 主网上，并在 Ethereum 主网上通过 AggLayer 完成结算。Solgate 已在 Rubicon 上线，网址为 [solgate.romeprotocol.xyz](https://solgate.romeprotocol.xyz)，支持 Ethereum、X Layer 和 Katana；Rome 也在该处列出了相关代币。在 Hadrian 上构建的内容迁移过去时，链 ID 和地址会发生变化。请在主网上重新测量耗时和成本，因为 Hadrian 上的数据属于测试网数据。迁移的一般流程见 [11. 部署到 Rubicon](https://docs.rome.builders/zh/rome-xue-yuan/11-ship-to-rubicon.md).

主网上支持：双向发送，以及 SOL、ETH、USDT、WBTC 和 OKB 在 Solana 上的领取；将 ETH 从 Ethereum 存入 Rubicon 上的 EVM 钱包时自动领取；Tokens 标签页、Activity 筛选器和 Arrived 卡片。消息追踪、从任一钱包进行的免许可代币设置，以及 Solana 原生代币的上架流程目前仅在测试网上运行，主网上尚不可用。请参阅 [使用 Solgate](https://docs.rome.builders/zh/rome-shang-de-ying-yong/solgate/using.md).

主网上的变化：

* 实际 Gas 费用：Rubicon 上使用 USDC（可通过 Rome Bridge 转入），Ethereum 上使用 ETH。
* 到账时间取决于主网结算：Ethereum 到 Solana 约 120 秒，Solana 到 Ethereum 约 6 分钟，Solana 到 X Layer 约 18 分钟，Solana 到 Katana 约 4 分钟，Katana 到 Solana 约 65 分钟。 [使用 Solgate](https://docs.rome.builders/zh/rome-shang-de-ying-yong/solgate/using.md#times) 列出了这些代币。
* 主网上的 Phantom 和 Solflare 会为交易附加各自的说明。
* 钱包和区块浏览器会自行检查代币（第 2 步）。
* 信任模型不变，仍由 Rome 的主网委员会和签名者集合负责。

现在在 Hadrian 上构建，准备就绪后部署到 Rubicon。

## 自我检查

在 Hadrian 上完成一次小规模往返测试。

1. 在 Sepolia 上部署一个测试 ERC-20，将部分代币桥接到 Hadrian，然后使用 **添加代币** 并通过 EVM 钱包完成操作。签名前先查看卡片上显示的总额。
2. 在 Solana devnet 上创建一个 SPL mint，使用 Solana 钱包在 Bridge 中选中它，发送到 Ethereum Sepolia，然后在那里领取。
3. 编写一个包含两项检查和一个 nonce 的接收方合约。从 Sepolia 合约向其发送一条消息，并使用 `GET /v1/transfers/:id/claim`.

然后回答：

* 接收方在信任一条消息之前会检查哪两个值？
* 接收方会调用 Solana，而且还必须收到价值。该如何发送？
* 为什么消息不适用于清算？

<details>

<summary>答案</summary>

* `msg.sender`，它必须是桥接合约，并且 `(originNetwork, originAddress)`，它必须是你信任的发送方。
* 发送消息时不附带任何价值。将价值作为单独的代币，在同一笔源链交易中发送，并在接收方检查它是否已到账。
* 从 Sepolia 到 Rome 耗时 133 到 412 秒，而 AggLayer L2 路径还要加上该链自身的结算时间。清算无法等待这么久。

</details>

## 下一步

可构建的创意及其起点，见 [Solgate 创意](https://docs.rome.builders/zh/rome-shang-de-ying-yong/solgate/ideas.md)。参考页面包括 [在 Solgate 上构建](https://docs.rome.builders/zh/rome-shang-de-ying-yong/solgate/builders.md) （代币）和 [在 Solgate 上发送消息](https://docs.rome.builders/zh/rome-shang-de-ying-yong/solgate/messaging.md) （消息）。

[返回课程地图](https://docs.rome.builders/zh/rome-xue-yuan/academy.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/13-build-on-solgate.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.
