For the complete documentation index, see llms.txt. This page is also available as Markdown.

让你的 EVM 应用支持 Solana 钱包

让你的合约无需 EVM 密钥即可被 Solana 钱包使用,涵盖合成地址、ERC-20 余额、双重签名以及原子预算。

你的合约已经可以与 MetaMask 一起使用。现在你让 Solana 钱包用它已经拥有的密钥来调用它,因此用户无需创建 EVM 账户。他们在同一地址上、针对同一状态调用同一个合约。

你将学到什么

  • Solana 钱包如何变成一个普通的 msg.sender 在 Rome 上。

  • 为什么本课程将价值作为 ERC-20 存款来处理,以及 msg.value 它需要 Solana 用户提供什么。

  • Solana 用户为每次调用签署什么,以及交易会发送到哪里。

  • 什么内容可以装进一笔 Solana 交易,以及无法容纳的调用会发生什么。

  • 哪些 依赖项 SDK 需要这些依赖项以及它们各自来自哪里。

开始之前

  • 完成 6. 双边代币. 本课假定你知道什么是 wrapper,以及为什么用户只需授权一次。

  • 拥有 HelloRome 已部署到 Hadrian,来自 3. 你在 Hadrian 上的第一个合约.

  • 安装 TypeScript SDK,如 Rome SDK.

  • 准备一个能够签署 Solana v1 交易的 Solana 钱包,并持有少量 devnet SOL 和 devnet USDC。水龙头列在 水龙头。不同钱包对 v1 交易的支持各不相同,因此请先测试你的钱包。 构建双通道应用 列出目前已检查的钱包名称。

本课

第 1 步。认识合成地址

Solana 钱包没有 EVM 地址,因此 Rome 会从其公钥推导出一个地址。结果就是该钱包的合成地址。这是 msg.sender 你的合约所看到的地址,它像其他账户一样拥有自己的 nonce 和存储。同一个钱包始终映射到同一个地址。

在本课程的流程中,合成地址在静态状态下不持有代币。它们起初位于用户的 Solana 钱包中。资金注入这一步会在存款前将它们转入合成地址的代币账户,只有到那时包装器的 balanceOf(synthetic) 才会显示它们。清扫这一步会在取款后将它们移回钱包。完整模型见 从 Solana 调用 EVM.

第 2 步。让合约为 Solana 做好准备

大多数合约无需更改。三条规则决定你的合约是否属于其中之一:

  • 以 ERC-20 形式收取价值。使用以下方式拉取 transferFrom 在一次 approve授权之后,并使用 transfer.

  • 为每种代币指向标准包装器。不要自行部署。

  • 将每次 Solana 通道调用都限制在一笔 Solana 交易内。

第一条规则最关键。这个入口点对 MetaMask 用户有效。但在资金注入与清扫模型下,它对 Solana 用户无效,因为除非你用以下方式为其注资,否则他们的合成地址没有原生余额: fundSyntheticGas:

这个对两者都有效,因为两个通道都可以为一个 transferFrom:

包装器地址位于 合约地址。适用于 Solana 的合约检查位于 向 Solana 用户开放你的 Solidity 合约.

第 3 步。了解钱包签署的内容

SDK 调用是 submitRomeTxV1。对于每次调用,代理都会组装一笔 Solana v1 交易。钱包会使用同一个密钥签名两次。首先,它签署一条可读的授权消息,其中包含 EVM 交易哈希。然后,它再签署交易本身。

应用会将已签名的交易发送到 Solana RPC,而不是 Rome 代理。链通过 Ed25519 程序检查授权,并以合成地址执行你的调用。用户从未持有 EVM 密钥。

在钱包签署交易之前,SDK 会检查其中是否严格包含用户授权的那次调用。任何其他内容都会被拒绝。详情见 向 Solana 用户开放你的 Solidity 合约.

第 4 步。连接通道

SDK 需要五个值:一个代理 URL、一个链 ID、Rome 程序 ID、一个 Solana RPC 连接以及一个签名者。其中四个用于描述链,一个来自钱包。

对于 Hadrian,请从注册表中读取这四个链值。映射位于 依赖项 第 3 步链接的指南表中,而这些值位于 Hadrian。第 11 课介绍了 Rubicon 的相同连接方式。

在新用户首次移动价值的调用之前,需要先完成两个一次性步骤。使用以下方式为合成地址配置 buildCreatePdaCall,并在以下情况下为包装器授权: isEnabled 为 false。 submitRomeTxV1 不会替你完成配置。第 9 课会按顺序执行这两步。

第 5 步。保持在一笔交易内

Solana 通道调用必须装进一笔 Solana 交易:大约 140 万 compute units、64 个账户和 4 KB。使用以下方式测量 computeUnitsConsumed 来自 Solana 回执,而不是 EVM gasUsed。使用以下参数请求交易: maxSupportedTransactionVersion: 1;没有它,RPC 会拒绝该请求。

当一次调用无法容纳时,组合器会拒绝它,SDK 会将其交给代理,使用相同的授权签名进行转发。用户仍然只会看到一个提示。结果带有 route: "relay"。转发的调用会消耗合成地址的原生 gas,因此请先使用以下方式为其充值: fundSyntheticGas。回退的转发调用不会抛出异常。检查 receipt.status。规则见 转发调用和长调用。限制汇总于一张表中: 约束.

自测

先回答这些问题,然后再查看答案。

  1. 为什么一个 可支付的 存款会对 Solana 用户失败?

  2. 钱包每次调用会生成多少个签名,以及每个签名涵盖什么?

  3. 已签名的交易会发送到哪里?

  4. 一次调用需要多于一笔交易。用户会看到什么,谁来付费?

答案
  1. 用户的资金是钱包中的 SPL 代币,在 Rome 中显示为包装器。在资金注入与清扫模型下,除非你为其注资,否则合成地址没有原生余额,因此没有 msg.value 可发送的余额。

  2. 两个。第一个覆盖包含 EVM 交易哈希的可读授权消息。第二个覆盖 Solana 交易。

  3. 发送到 Solana RPC,由应用程序发送。代理会组装交易而不会收到它,转发调用除外。

  4. 一个授权提示。代理转发该调用,并由合成地址的原生 gas 余额支付费用。

下一步

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

最后更新于

这有帮助吗?