与批量预编译合约交互¶

概览¶

Moonbeam上的批量预编译合约允许开发者同时执行多个EVM调用。

目前来说，要让用户与多个合约进行交互，需要在用户的钱包中执行多个交易确认。举个简单的例子，需要先批准智能合约使用特定Token，然后再进行转账。但预编译合约能够使开发者优化使用者体验，因其可以将用户需要确认的交易数量减少为一个。此外，由于批量执行无需多次支付Gas费（每个交易的起始Gas费为21000单位），还能够节省用户所需的Gas费用。

此预编译合约直接与Substrate EVM pallet交互。批量函数的调用者将会在其地址为所有子交易执行msg.sender，但与委托调用（Delegate Call）不同的是，目标合约的存储仍然被影响。实际上是用户签署了多笔交易，但只需要一次确认。

此预编译合约位于以下地址：

0x0000000000000000000000000000000000000808

0x0000000000000000000000000000000000000808

0x0000000000000000000000000000000000000808

批量Solidity接口¶

Batch.sol为允许开发者与预编译合约三个函数交互的Solidity接口。

该接口包括以下功能：

• batchSome(address[] to, uint256[] value, bytes[] callData, uint64[] gasLimit) — 执行多个调用，其中每个数组的相同索引合并到单个子调用所需的信息。如果某一子调用回滚状态，仍将尝试执行其余子调用
• batchSomeUntilFailure(address[] to, uint256[] value, bytes[] callData, uint64[] gasLimit) — 执行多次调用，其中每个数组的相同索引合并到单个子调用所需的信息。如果某一子调用回滚状态，则不会尝试执行后续子调用
• batchAll(address[] to, uint256[] value, bytes[] callData, uint64[] gasLimit) — 以原子方式执行多个子调用，其中每个数组的相同索引组合成单个子调用所需的信息。如果任何子调用执行失败，所有子调用都将回滚状态

这些函数中每个都具有以下参数：

• address[] to - 与子调用数组对应的地址数组，每个地址对应一个子调用
• uint256[] value - 与子调用数组对应的原生代币数额组，其中索引对应于to数组中相同索引的子调用。如果此数组比to数组短，则后面所有子调用数额将默认为0
• bytes[] callData - 与子调用数组对应的的callData数组，其中索引对应于to数组中相同索引的子调用。如果此数组比to数组短，则以下所有子事务都将不包含callData
• uint64[] gasLimit - 与子调用数组对应的gas上限数组，其中索引对应于to数组中相同索引的子调用。 0值被默认为无限制，并将转发批量交易的所有剩余给gas。如果此数组比to数组短，则以下所有子调用都将转发所有剩余的gas

该界面还包括以下必需的事件：

• SubcallSucceeded(uint256 index) - 当给定索引的子调用成功时发出
• SubcallFailed(uint256 index) - 当给定索引的子调用失败时发出

与Solidity接口交互¶

查看先决条件¶

要跟随此教程操作，您需要准备以下内容：

• 安装MetaMask并连接至Moonbase Alpha
• 在Moonbase Alpha上创建或是拥有两个账户以测试批量预编译合约的不同功能
• 至少拥有一个具有DEV的账户。 您可以每24小时一次从Moonbase Alpha水龙头上获取DEV代币以在Moonbase Alpha上进行测试

范例合约¶

此SimpleContract.sol合约将会作为批量合约交互的范例，但在实际操作上所有合约皆可以进行交互。

// SPDX-License-Identifier: GPL-3.0-only
pragma solidity >=0.8.0;

contract SimpleContract {
    mapping(uint256 => string) public messages;

    function setMessage(uint256 id, string calldata message) external {
        messages[id] = message;
    }
}

设置Remix¶

您可以使用Remix与批量预编译合约交互。您将需要Batch.sol和SimpleContract.sol的拷贝。您可以将预编译合约加入至Remix并遵循以下教程：

1. 点击File explorer标签
2. 粘贴Batch.sol合约至Remix文件内并命名为Batch.sol
3. 粘贴SimpleContract.sol合约至Remix文件内并命名为SimpleContract.sol

编译合约¶

接着您需要在Remix中编译上述的两个文件：

1. 确保您打开Batch.sol文件
2. 点击Compile标签（从上到下第二个）
3. 点击Compile Batch.sol以编译合约

如果接口编译成功，您将会在Compile标签旁看到绿色的打勾图示。

使用预编译合约¶

您将会使用预编译合约的地址访问接口，而非部署批量预编译合约：

1. 在Remix中的Compile标签下方点击Deploy and Run标签，请确保预编译合约已部署成功
2. 确保ENVIRONMENT下拉菜单中已选取Injected Provider - Metamask。当您选取Injected Provider - Metamask后，MetaMask将会跳出弹窗要求将您的账户与Remix连接
3. 确保ACCOUNT下方显示的是正确的账户地址
4. 确保CONTRACT下拉菜单中Batch - Batch.sol已被选取。由于此为预编译合约，因此您不需要部署任何代码，但我们仍需要在At Address输入栏中提供预编译合约的地址
5. 提供批量预编译合约的地址：0x0000000000000000000000000000000000000808并点击At Address

BATCH预编译合约将会出现在Deployed Contract的菜单当中。

部署范例合约¶

另一方面，SimpleContract.sol将会作为一个新合约被部署。在开始本部分教程前，请为SimpleContract.sol档案重复编译步骤。

1. 在Remix中的Compile标签下方点击Deploy and Run
2. 确保ENVIRONMENT下拉菜单中已选取Injected Provider - Metamask，当您选取Injected Provider - Metamask时，您或许将会见到MetaMask与Remix连接的弹窗
3. 确保ACCOUNT下方显示的是正确的账户地址
4. 确保CONTRACT下拉菜单中SimpleContract - SimpleContract.sol已被选取
5. 点击Deploy
6. 在MetaMask跳出的弹窗中点击Confirm以确认交易

SIMPLECONTRACT合约将会出现在Deployed Contracts当中。

通过预编译合约传送原生资产¶

使用批量预编译合约传送原生资产相较于在Remix或是MetaMask点击按钮更加的复杂。在本示例中，您将会使用batchAll函数传送原生资产。

在交易时将会出现数量输入栏，需要填写特定数量的原生资产进行传送。在Remix中，这将会在DEPLOY & RUN TRANSACTIONS标签中的VALUE中显示。然而，在批量预编译合约中，此数据将会在批量函数中的value数组输入中被提供。

您可以尝试在Moonbase Alpha上转移原生资产至您指定的两个钱包：

1. 确保您连接的钱包中至少有0.5个DEV
2. 在Deployed Contracts中展开批量预编译合约
3. 展开batchAll函数
4. 在to输入栏中，根据以下格式输入您的地址：["INSERT_ADDRESS_1", "INSERT_ADDRESS_2"]，其中第一个地址代表您希望传送资产的第一个地址，而第二个地址为您希望传送资产的第二个地址
5. 在value输入栏中，输入您希望转移至个别地址以Wei为单位的数量。举例而言，["100000000000000000", "200000000000000000"]将会转移0.1 DEV至第一个地址和0.2 DEV至第二个地址
6. 在剩下的callData和gasLimit输入栏中输入[]，调用数据和Gas限制在传送原生资产时不需要考虑
7. 点击transact
8. 在MetaMask跳出的弹窗中点击Confirm以确认交易

当交易完成后，确保您查看两个地址的余额，不论是通过MetaMask或是区块浏览器皆可。恭喜您！您已经成功通过批量预编译合约传送批量交易。

查看合约交易调用数据¶

如Remix般的可视化接口和如Ethers.js般顺手的库隐藏了以太坊交易与Solidity智能合约之间的交互。函数的名称和输入数值被储存在函数选择器中{target=_blank}，且输入数值将会被编码，两者将会被整合并以交易的调用数据传送。如果您希望在批量交易中传送子交易，您需要事先了解调用数据。

您可以尝试使用Remix查询交易的调用数据：

1. 在Deployed Contracts下方展开SimpleContract.sol合约
2. 展开setMessage函数
3. 输入函数的数值，在本示例中id为1，而message为"moonbeam"
4. 点击transact按钮旁的复制按钮以复制调用数据而非传送交易

现在您已经拥有该交易的调用数据！根据范例数据的1 和"moonbeam"，我们可以在调用数据中查找这些被编码的数据：

0x648345c8                                                        // function selector
0000000000000000000000000000000000000000000000000000000000000001  // 1 id
0000000000000000000000000000000000000000000000000000000000000040  // 64 string offset
0000000000000000000000000000000000000000000000000000000000000008  // 8 length in bytes
6d6f6f6e6265616d000000000000000000000000000000000000000000000000  // "moonbeam" in bytes

调用数据可以被拆分为五行：

• 第一行为函数选择器
• 第二行为1，也就是id获得的数值
• 接下来为message的输入值。此最后三行相对抽象，因字串属于长度能够变动的动态种类。第三行是一个偏移量，用于定义字符串数据的开始位置。第四行指的是字符串的长度，在本示例中为8，因为“moonbeam”是8个字符串长度。最后，第五行是向左对齐的”moonbeam“的十六进制格式（8个ASCII字符为16进制字符）并余留0个填充空间

通过预编译与函数交互¶

此部分教程范例将会使用batchAll函数以确保交易能够快速解决。请记得仍然有另外两个批量函数能够在无视错误情况下执行子交易或是停止衍生的子交易但却不收回先前执行的交易。

函数交互与传送原生资产非常相似，因两者皆为执行交易。然而，调用数据需要为函数提供适当的数值输入，且传送者有可能需要在每个子交易中限制花费的Gas费用。

callData与gasLimit输入栏与那些和合约交互的子交易更加相关。对于在批量预编译合约接口的函数，callData输入的是一个数组，其中每个索引对应每个子事务接受者的调用数据，也就是，to所需要的数值。如果callData数组的数值小于to数组，剩余的子交易将会缺少调用数据（也就是没有输入的函数）。至于gasLimit则为在每个子交易中花费Gas数量有关的数组，如果其长度小于to数组，先前子交易剩余的Gas将会被转用。

您可以根据以下步骤传送一个批量交易：

1. 在SimpleContract.sol标题右方的复制按钮复制其合约地址，请确保您拥有来自先前部分教程的调用数据
2. 在Deployed Contracts下方展开批量预编译合约
3. 展开batchAll函数
4. 在to输入栏中，以下述格式插入您先前复制的SimpleContract.sol合约地址：["INSERT_SIMPLE_CONTRACT_ADDRESS"]
5. 在数值输入栏中，由于["INSERT_SIMPLE_CONTRACT_ADDRESS"]并不需要支付任何原生资产，输入["0"]代表0 Wei
6. 在callData输入栏位中，以下格式插入您在先前部分教程获得的函数数据：["INSERT_CALL_DATA"]
7. 在gasLimit输入栏中，插入[]。您也可以输入Gas限制的数据，依据您的需求决定
8. 点击transact
9. 在MetaMask跳出的弹窗中点击Confirm以确认交易

如果您使用与教程中相同的函数数据，请确认交易是否为成功状态：

1. 在Deployed Contracts下方展开SimpleContract.sol合约
2. 在messages按钮右方输入1
3. 点击蓝色的messages按钮

"moonbeam"这个单词应当显示在下方。恭喜！您已成功使用批量预编译合约与函数交互。

整合子交易¶

目前为止，传送原生资产和与函数交互为分开的状态，但实际上两者可以整合在一起。

以下字符串可以整合在一起作为一个批量交易的输入数值，他们将传送1 DEV至公共Gerald账户（0x6Be02d1d3665660d22FF9624b7BE0551ee1Ac91b）并与预先部署的SimpleContract.sol交互两次，以下为详细步骤：

此处将会有三个子交易，所有将会三个地址被输入在to输入数组中。第一个为公共Gerald账户，其次为预先部署的SimpleContract.sol合约。您可以使用您自身的SimpleContract.sol实例来取代，或是仅取代其中之一，您可以在单一信息中与多个合约交互。

[
  "0x6Be02d1d3665660d22FF9624b7BE0551ee1Ac91b",
  "0xd14b70a55F6cBAc06d4FA49b99be0370D0e1BD39", 
  "0xd14b70a55F6cBAc06d4FA49b99be0370D0e1BD39"
]

同样地， value数组需要三个数值。to输入数组中的第一个地址需要执行的动作为传送1 DEV，因此1 DEV将会以Wei为单位输入在数组之中，接续的两个数值为0以为其子交易并不接受或是需要原生资产。

["1000000000000000000", "0", "0"]

如上， callData数组也需要三个数值。由于传送原生资产并不需要调用数据，字符串可以以空白显示。而数组中的第二和第三个数值与setMessage的调用有关，将会把id设置为5和6。

[
  "0x", 
  "0x648345c8000000000000000000000000000000000000000000000000000000000000000500000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000009796f752061726520610000000000000000000000000000000000000000000000", 
  "0x648345c800000000000000000000000000000000000000000000000000000000000000060000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000e61206d6f6f6e6265616d2070726f000000000000000000000000000000000000"
]

最后一个输入数值为gas_input，此数组可以为空白以将剩余的Gas用于其他子交易之中。

[]

您可以在Remix中使用这些输入数值传送一个批量交易，如同您批量一个调用函数。

恭喜！您已成功使用MetaMask和Remix与ERC-20预编译合约交互。

以太坊开发者库¶

如果您跟随的是Moonbeam上的Ethers.js教程，您或许会发现难以为单一函数找到其调用数据。其答案则被藏于Ether的Interface对象之中，而encodeFunctionData函数将能允许您输入函数名称以及获得调用数据的结果。Web3.js也具有类似的函数encodeFunctionCall。

// Import the contract ABI
const { abi } = require('./INSERT_ABI_PATH');

// Use ABI to create an interface
const yourContractInterface = new ethers.Interface(abi);

// Find call data for the setMessage function
const callData = yourContractInterface.encodeFunctionData(
  'INSERT_FUNCTION_NAME',
  [
    'INSERT_INPUT_1',
    'INSERT_INPUT_2',
    // ...
  ]
);

// Import the contract ABI
const { abi } = require('./INSERT_ABI_PATH');

// Find call data for the setMessage function
const callData = web3.eth.abi.encodeFunctionCall(abi, [
  'INSERT_INPUT_1',
  'INSERT_INPUT_2',
  // ...
]);

# Import the ABI and bytecode
from compile import abi, bytecode

# Create contract instance
your_contract = web3.eth.contract(abi=abi, bytecode=bytecode)

# Encode the contract call
call_data = your_contract.encodeABI(
    fn_name="INSERT_FUNCTION_NAME", args=["INSERT_INPUT_1", "INSERT_INPUT_2", ...]
)

最后，您应当已经了解如何与批量预编译进行交互，如同您与Ethers中的合约进行交互一样。