Safe(早期称 Gnosis Safe)是以太坊上常见的智能合约多签钱包。公开技术文档在解释其合约时,会反复出现两组参数:部署初始化时的 setup 参数,以及执行交易时的 execTransaction 参数。理解这些字段各自管什么,比记住函数名更有用。
setup 参数:决定谁签、几人签
Safe 通过代理合约部署,构造器几乎不承担初始化工作,真正设定钱包规则的是 setUp 函数。文档给出的参数表包括 owners、threshold、to、data、fallbackHandler、payment、paymentToken、paymentReceiver 等。
其中最关键的是前两个。owners 是签名人地址列表,threshold 是单笔交易需要多少个签名。文档举过一个实际初始化例子:owners 为两个地址,threshold 设为 2,即两人都签名才能执行。如果多签钱包只用于保管资金,文档认为仅初始化这两个参数就够了。
其余参数各有用途。to 和 data 用于初始化模块,模块可以给钱包增加额外逻辑,例如限制某个地址每日可批准的金额。fallbackHandler 指定处理回退调用的合约地址。payment、paymentToken 和 paymentReceiver 则是为中继商设计的:用户创建钱包后可以先转入资产,再由中继商代为初始化,中继商通过这几个参数收回垫付的 gas 成本。文档也提醒,这部分功能对普通用户并不重要。
execTransaction 参数:描述一笔实际调用
execTransaction 的参数可以分成两类。第一类描述交易本身:to 是目标地址,value 是附带的 ETH 数量,data 是调用目标合约的 calldata,operation 区分普通调用和委托调用。第二类与 gas 和中继补偿有关:safeTxGas 设定内部交易可用的 gas,baseGas 是与执行无关的固定开销,gasPrice 用于计算补偿,refundReceiver 是接收补偿的地址,signature 则是打包后的多签签名。
文档特别解释了 gas 检查条件。合约要求剩余 gas 至少满足 (safeTxGas * 64) / 63 与 safeTxGas + 2500 中的较大值,再加 500。前一项来自 EIP-150 对调用转发 gas 的限制,2500 用于保证事件能够抛出,500 留给后续代码运行。如果 gasPrice 为 0,实际传给内部调用的是 gasleft() - 2500;如果设置了 gasPrice,则严格按 safeTxGas 传递。文档的解释是,gasPrice 通常由中继商设置,严格限制 gas 有助于控制其补偿成本。
签名校验:阈值之外还有格式规则
checkSignatures 的核心是 checkNSignatures,后者先检查签名数据长度是否不少于 threshold × 65 字节,因为一个最简 ECDSA 签名由 v、r、s 三部分共 65 字节组成。Safe 还支持多种签名类型,通过 v 值区分:0 表示合约签名,1 表示预认证签名,大于 30 表示 eth_sign 签名,27 到 30 之间为普通 ECDSA 签名。
文档对合约签名的格式说明较细:静态部分用 r 存放签名验证合约地址,用 s 存放动态签名数据在打包数据中的位置,v 为 0;动态部分则是长度加签名数据。校验时会检查 s 指向的位置是否落在静态签名区之后、动态数据是否完整位于打包签名内,最后调用验证合约的 isValidSignature,要求返回 EIP-1271 规定的魔数。预认证签名则依赖 approvedHashes 映射,签名人可事先对某个哈希调用 approveHash 登记,之后校验时只要该登记存在即可。
参数之间的实际约束
这些字段不是孤立的。threshold 决定签名数量下限,签名打包顺序要求地址升序,否则校验会失败。gasPrice 是否为零,会改变内部调用实际获得的 gas 数量。payment 相关参数只在初始化或执行时 gasPrice 大于零才触发补偿逻辑。文档还提到,如果交易失败但 safeTxGas 和 gasPrice 都为零,合约会直接回退,这是为了让 estimateGas 能正常估算。
需要说明的是,上述内容来自对 Safe 合约某一版本代码的解析,文档本身也指出部分为中继商设计的功能在链上很少见到实际交易,相关描述可能存在与实际情况不符之处。参数含义应以对应版本的合约源码为准,不同版本之间可能有差异。
总体来看,Safe 多签的参数设计围绕两条线展开:owners 和 threshold 定义控制权结构,to、value、data、operation 定义交易内容,gas 与 payment 字段则服务于中继补偿。读懂这些字段,就能判断一笔多签交易为什么需要这么多人签名、gas 为什么这样限制,以及签名数据为什么要按特定格式拼接。