{"content":{"title":"Solidity Gas剩余量","body":"## 介绍\r\n\r\n本文的目的是描述 Solidity 的 `gasleft()` 函数的行为及其用途。\r\n\r\n它是一个内置函数，用于检查合约调用过程中剩余的 Gas。它是始终存在于全局命名空间中的特殊变量和函数，因此无需导入。`gasleft()` 在 [Solidity](https://learnblockchain.cn/openspace/1) 版本 0.4.21 之前被称为 `msg.gas` ([msg.gas](https://learnblockchain.cn/docs/solidity/units-and-global-variables.html#block-and-transaction-properties:~:text=%3A%20complete%20calldata-,msg.gas,-\\(uint\\)%3A%20remaining))。\r\n\r\n### 作者\r\n\r\n本文由 Jesse Raymond 合著 ([LinkedIn](https://www.linkedin.com/in/jesse-raymond4/), [Twitter](https://twitter.com/Jesserc_))，作为 RareSkills 技术写作计划的一部分。\r\n\r\n### 为什么 gasleft() 重要\r\n\r\n智能合约所使用的 Gas 量取决于正在运行的代码的复杂性以及在合约调用期间处理的数据量。\r\n\r\n如果提供的 Gas 不足，交易将因 **“Gas 不足”** 错误而回滚。正确使用 gasleft() 函数可以防止合约交易耗尽 Gas 的情况。让我们在下一部分看一个例子。\r\n\r\n## 防止 Gas 不足错误的示例\r\n\r\n### 在分发以太币时不耗尽 Gas\r\n\r\n通过循环将以太币发送到多个地址的智能合约可能会非常昂贵，特别是处理大型地址数组时。\r\n\r\n如果执行交易所使用的 Gas 量不足，函数将如前所述，以 **“Gas 不足”** 错误失败。\r\n\r\n然而，`gasleft()` 函数可以用来确保剩余的 Gas 足以进行下一个转账，否则提前退出。\r\n\r\n以下代码演示了这一点：\r\n\r\n```solidity\r\n// SPDX-License-Identifier: MIT\r\npragma solidity ^0.8.7;\r\ncontract GasConsumer{\r\n    uint constant MINIMUM_AMOUNT = 10_000;\r\n  \r\n    // 此代码仅用于说明目的，非生产用途\r\n    function distributeEther(address[] calldata receivers) external {\r\n        for (uint i = 0; i < receivers.length; i++) {\r\n            \r\n            payable(receivers[i]).transfer(1 ether);\r\n            \r\n            if (gasleft() < MINIMUM_AMOUNT) {\r\n                return;\r\n            }\r\n        }\r\n    }\r\n    \r\n    receive() external payable {}\r\n}\r\n```\r\n\r\n上面合约中的“`distributeEther`”函数接受一个地址数组，使用 for 循环遍历该数组，向每个地址发送 1 ether，使用 “transfer” 函数。\r\n\r\n“if 语句”检查每次以太转账后的剩余 Gas 是否足以进行下一次转账，方法是检查转账后“剩余 Gas”是否小于 10,000（其中 9,000 用于转移 Eth，额外 1,000 用于其他小的操作码）。如果少于 这些，交易将结束而不会回滚之前的转账。\r\n\r\n（请注意，除非地址是可信的，否则不应该随意发送以太币。恶意接收者可能会提交一个会在接收以太币时回滚的智能合约地址）。\r\n\r\n## 基准测试代码\r\n\r\n### 使用 gasleft() 函数测量执行成本\r\n\r\n另一个例子是使用 `gasleft()` 函数测量一段代码所使用的总 Gas 量。\r\n\r\n以下是在 remix 中的一个示例：\r\n\r\n![benchmark solidity code with gasleft](https://img.learnblockchain.cn/2025/02/26/935a00_de045fe5189949abb25929501429661b~mv2.png)  \r\n基准测试 Solidity 代码与 gasleft\r\n\r\n在这种情况下，`gasleft()` 函数用于找出当通过 “`updateArray`” 函数向 “`numArr`” 数组追加一个数字时，使用了多少 Gas。这并不是该函数使用的 Gas 的总量，而是在代码 `numArr.push(_num)` 第 30 行追加一个数字之前和之后所使用的 Gas 量。\r\n\r\n### 解释高亮的数字\r\n\r\n我们将“`gasUsed`”设为公共变量，以便在函数执行后能够轻松看到其内容。通过部署“`GasCalc`”合约并调用“`updateArray`”函数进行测试。\r\n\r\n该函数返回一个元组，第一项的结果是 **80,348**，即“`initialGas`”。\r\n\r\n元组中的第二项是“`finalGas`”，值为 **35,923，这包括`gasleft()`函数本身的 Gas 成本**。\r\n\r\n通过将最终的 Gas 从初始 Gas 中相减，我们确定第 30 行的执行费用是 **44,425**。\r\n\r\n### gasleft 后面的操作码需要“2 Gas”来执行\r\n\r\nSolidity 是一种高级语言，它被编译为在以太坊虚拟机（EVM）上执行的字节码。\r\n\r\n`gasleft()` 函数的操作码是 GAS（字节码 0x5A），根据 [以太坊文档](https://ethereum.org/en/developers/docs/evm/opcodes/) 其成本为 **“2 Gas”** 。\r\n\r\n## 现实世界应用\r\n\r\n### OpenZeppelin 代理 – 用于将所有 Gas 转发到实现合约\r\n\r\n**在 yul 中使用 gasleft**\r\n\r\n`gasleft()` 函数也可以通过 yul（内联汇编）在 Solidity 智能合约中访问，作为 `gas()`。\r\n\r\nOpenZeppelin 代理合约是这方面的一个优秀示例。它用于代理用来调用实现合约的 “[delegatecall](https://learnblockchain.cn/article/11227)” 函数。`gas()` 是指定使用最大可用 Gas 的便利方法。\r\n\r\n![forward all gas in delegate call with gasleft solidity](https://img.learnblockchain.cn/2025/02/26/935a00_86d5e55ebba74b2b9fd38ad973133d53~mv2.png)  \r\n在 delegate call 中转发所有 Gas 与 gasleft Solidity\r\n\r\n链接：[OpenZeppelin 代理合约](https://github.com/OpenZeppelin/openzeppelin-contracts/blob/18691d1a6f56dd906c175072a97dc5ed93ab968c/contracts/proxy/Proxy.sol#L31)\r\n\r\n### OpenZeppelin 最小转发器 – 用于验证中继者发送的 Gas 是否足以执行交易\r\n\r\n“中继者”是一个链外实体，支付其他用户交易的 Gas，交易被发送到“转发器”合约以执行该交易。\r\n\r\n当用户向中继者发送请求时，用户指定要包含在交易中的 Gas 数量，并数字签名其请求。\r\n\r\n然而，中继者可能不遵守用户请求的 Gas 限制，并发送更低的金额。这种攻击在 [SWC 注册表](https://swcregistry.io/docs/SWC-126) 中被记录为 SWC-126。\r\n\r\n这导致了一种 Gas 干扰攻击。如果中继者对转发合约的调用成功，但用户想要的子调用失败，那么中继者可以“指责”用户发送了一个因为真实原因是子调用因 Gas 不足而回滚的交易。\r\n\r\n子调用因为回滚或 Gas 不足而失败，但通常不会给出失败原因，只是布尔变量成功返回 false。基于此，我们无法知道子调用是因为 Gas 不足还是原发送者传递了错误指令而失败。\r\n\r\n我们可以使用“gasleft”来判断是哪种情况。\r\n\r\n当执行到“call” 时，只有 63/64 的 Gas 被转发。这个 [63/64 限制是在 EIP 150 中引入的](https://learnblockchain.cn/article/11230)。\r\n\r\n当子调用完成后，剩余的 Gas 应该至少是用户指定原始限制的 1/64。\r\n\r\n如果子调用后剩余的 Gas 少于 1/64，那么我们就知道中继者没有发送他们应该发送的所有 Gas。\r\n\r\n这里的转发合约检查剩下至少 1/63 的原始限制作为安全边际。\r\n\r\n无效代码被用于让中继者的交易失败，从而明确交易是由于中继者失败，而不是子调用失败。你可以在 [这里](https://consensys.github.io/smart-contract-best-practices/attacks/griefing/) 了解更多关于 Gas 干扰攻击的信息。\r\n\r\n![prevent relayer gas griefing with gasleft solidity](https://img.learnblockchain.cn/2025/02/26/935a00_14803d4ff8834b3fa7d9d1b1aa2a2c35~mv2.png)\r\n\r\n链接：[OpenZeppelin 最小转发器合约](https://github.com/OpenZeppelin/openzeppelin-contracts/blob/18691d1a6f56dd906c175072a97dc5ed93ab968c/contracts/metatx/MinimalForwarder.sol#L60)\r\n\r\n### Chainlink EthBalance 监控合约 – 用于防止 Gas 不足错误阻碍以太币发放\r\n\r\n这是本文第一个示例的一个实际应用，即在循环中分发以太币。该代码相比之前有更多的业务逻辑，但如果我们突出“`gasleft()`” 检查，该检查导致提早退出循环，我们会发现其基本设计是相同的。\r\n\r\n![chainlink using gasleft](https://img.learnblockchain.cn/2025/02/26/935a00_d626be1bc52f457c9e41de9c441208a8~mv2.png)\r\n\r\n### Chainlink VRFCoordinatorV2 合约 – 用于获取 Chainlink VRFCoordinatorV2 实现的 Gas 使用量\r\n\r\nChainlink 的 “VRFCoordinatorV2” 智能合约是一个“可验证随机函数”协调器，用于在区块链上生成密码学 [安全的随机数](https://www.rareskills.io/post/generate-a-random-number-with-solidity-on-the-blockchain)。\r\n\r\n该智能合约是智能合约请求和接收随机性的预言机。（见这里：[VRFCoordinatorV2](https://docs.chain.link/vrf/v2/introduction/)）。\r\n\r\n在合约的“`calculatePaymentAmount`” 函数中使用 `gasleft()` 函数，以便在节点需支付更多 Gas 以满足随机性时向用户收取更高的费用。\r\n\r\n在这种情况下，`gasleft()` 越低，费用就会越高，因为（`startGas` - `gasleft()`）随着 Gas 使用的增加而增加。\r\n\r\n![chainlink using gasleft for calculating oracle fees](https://img.learnblockchain.cn/2025/02/26/935a00_ec68943f66be490bad6099664feeebf5~mv2.png)\r\n\r\n链接：[Chainlink VRFCoordinatorV2 合约](https://github.com/smartcontractkit/chainlink/blob/e1e78865d4f3e609e7977777d7fb0604913b63ed/contracts/src/v0.8/VRFCoordinatorV2.sol#L617)\r\n\r\n## 结论\r\n\r\n在本文中，我们讨论了 `gasleft()` 的各种用例。这些用例包括防止 Gas 不足错误、基准测试 Solidity 代码执行成本、将所有 Gas 转发到实现合约以及防止中继者 DOS。\r\n\r\n## RareSkills 区块链训练营\r\n\r\n请查看我们的高级 [区块链训练营](https://www.rareskills.io/web3-blockchain-bootcamps) 产品，以了解有关我们提供的专家级开发者培训的更多信息。\r\n\r\n**最初发布于 2023 年 2 月 4 日**\r\n\r\n>- 原文链接： [rareskills.io/post/solid...](https://www.rareskills.io/post/solidity-gasleft)\r\n>- 登链社区 AI 助手，为大家转译优秀英文文章，如有翻译不通的地方，还请包涵～"},"author":{"user":"https://learnblockchain.cn/people/20722","address":null},"history":null,"timestamp":1740546474,"version":1}