Solidity 中的错误（关键字error）提供了一种方便且省gas的方式来向用户解释为什么一个操作会失败。它们可以被定义在合约（包括接口和库）内部和外部。
错误必须与 revert 语句 一起使用。它会还原当前调用中的发生的所有变化，并将错误数据传回给调用者。
// SPDX-License-Identifier: GPL-3.0
pragma solidity ^0.8.4;
/// 转账时，没有足够的余额。
/// @param available balance available.
/// @param required requested amount to transfer.
error InsufficientBalance(uint256 available, uint256 required);
contract TestToken {
mapping(address => uint) balance;
function transfer(address to, uint256 amount) public {
if (amount > balance[msg.sender])
revert InsufficientBalance({
available: balance[msg.sender],
required: amount
});
balance[msg.sender] -= amount;
balance[to] += amount;
}
// ...
}
错误不能被重写或覆盖，但是可以继承。只要作用域不同，同一个错误可以在多个地方定义。 只能使用 revert 语句创建错误实例。
错误产生的数据，会通过revert操作传递给调用者，可以交由链外组件处理或在 try/catch 语句 中捕获它。 注意，只有外部调用的错误才能被捕获。发生在内部调用或同一函数内的 revert 不能被捕获。
如果错误没有任何参数，错误只需要四个字节的数据，你可以使用:NatSpec ，来进一步解释错误背后的原因，NatSpec 不会存储在链上。 这个方式使得它同时也是一个非常便宜和方便的错误报告功能。
更具体地说，一个错误实例的ABI编码方式与调用相同名称和类型的函数的方式相同，它作为 revert 操作码的返回数据使用。 这意味着错误数据由一个4字节的选择器和 ABI-encoded 数据组成。 选择器是错误的签名的keccak256哈希的前四个字节组成。
- 合约有可能出现以下情况：在不同地方定义的相同名称的错误。而这些错误对调用者来说是无法区分的。 对于外部来说，如 ABI 仅关联了错误的名字，而没有定义它的合约或文件
如果你可以定义 error Error(string) 的话， require(condition, "description"); 与 if (!condition) revert Error("description") 等效。 不过， Error 是内建类型，不可以通过用户代码定义。
同样的，一个 assert 的错误或类似的失败将以 Panic(uint256) 类型的错误的方式回退。
- 错误数据应该只用于指示错误，而不是作为控制流的一种手段。原因是默认情况下内部调用的获得的错误数据可能是通过外部调用链冒泡过来。
当这意味着，一个内部调用可以 “伪造”错误数据，使它看起来像是来自被调用的合约。
网友评论