文章目录
- 合约
-
- 库
-
- 库中的函数签名和选择器
- 库的调用保护
合约
库
库与合约类似,但它们的目的是仅在特定地址上部署一次,并通过 EVM 的 DELEGATECALL(在 Homestead 之前是 CALLCODE)功能重复使用其代码。这意味着如果调用库函数,它们的代码将在调用合约的上下文中执行,即 this
指向调用合约,特别是调用合约的存储可以被访问。由于库是一个独立的源代码片段,它只能在显式提供的情况下访问调用合约的状态变量(否则它没有办法命名它们)。库函数只能直接调用(即不使用 DELEGATECALL),如果它们不修改状态(即如果它们是 view
或 pure
函数),因为库被假定为无状态的。特别地,不可能销毁一个库。
注意
直到 0.4.20 版本之前,可以通过绕过 Solidity 的类型系统来销毁库。从该版本开始,库包含了一种机制,禁止直接调用修改状态的函数(即不使用 DELEGATECALL)。
库可以被看作是使用它们的合约的隐式基合约。它们不会在继承层次结构中显式可见,但调用库函数看起来就像调用显式基合约的函数(使用限定访问,如 L.f()
)。当然,调用内部函数时使用内部调用约定,这意味着所有内部类型都可以传递,并且存储在内存中的类型将按引用传递而不是复制。为了在 EVM 中实现这一点,调用合约时,所有从合约中调用的内部库函数以及从中调用的所有函数将在编译时包含在调用合约中,并且将使用常规的 JUMP 调用,而不是 DELEGATECALL。
注意
继承类比在公共函数方面不成立。调用公共库函数 L.f()
会导致外部调用(严格来说是 DELEGATECALL)。相反,当 A
是当前合约的基合约时,A.f()
是一个内部调用。
以下示例说明了如何使用库(可以使用更高级示例的 for
来实现集合)。
// SPDX-License-Identifier: GPL-3.0
pragma solidity >=0.6.0 <0.9.0;
// 我们定义一个新的结构体数据类型,用于
// 在调用合约中保存其数据。
struct Data {
mapping(uint => bool) flags;
}
library Set {
// 注意,第一个参数是 "storage 引用" 类型&