让你的 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.
本课
第 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。规则见 转发调用和长调用。限制汇总于一张表中: 约束.
自测
先回答这些问题,然后再查看答案。
为什么一个
可支付的存款会对 Solana 用户失败?钱包每次调用会生成多少个签名,以及每个签名涵盖什么?
已签名的交易会发送到哪里?
一次调用需要多于一笔交易。用户会看到什么,谁来付费?
下一步
最后更新于
这有帮助吗?