用途:Safe(原 Gnosis Safe)是 EVM 链上广泛使用的智能账户基础设施,提供可编程多签钱包,并通过模块(modules)与守卫(guards)扩展。本技能面向使用 Safe{Core} SDK 创建、管理、执行多签交易的开发场景。
主要能力:protocol-kit 负责链上交互(部署、签名、执行);api-kit 对接 Safe Transaction Service REST API(提议、确认、查询待处理交易);relay-kit 通过 Gelato/relay 代付 gas。三者是独立 npm 包。支持连接已有 Safe、读取 owners/threshold/nonce、反事实预测地址、部署新 Safe、创建并提议交易、多签确认、达到阈值后执行、MultiSend 批量交易、拒绝交易、启用/禁用模块与 Guard、EIP-1271 消息与 EIP-712 类型数据签名、owner 与阈值管理,以及直接调用交易服务 REST API。
使用方式:安装 npm install @safe-global/protocol-kit @safe-global/api-kit @safe-global/types-kit。用 Safe.init 传入 provider、signer 与 safeAddress(或 predictedSafe)初始化;api-kit 传 chainId(bigint)自动解析各链交易服务 URL。注意旧包名 @gnosis.pm/safe-* 与 @safe-global/safe-* 已弃用,EthersAdapter/Web3Adapter 已移除,v4+ 直接接收 provider 与 signer。
限制与注意:模块可绕过 owner 签名阈值代为执行交易,风险高;Guard 是执行前后校验钩子,二者不可混淆。EIP-1271 验证需针对 Safe 合约的 isValidSignature,而非单个 owner 地址。nonce 顺序递增,跳号会阻塞后续交易。链上函数为 execTransaction,直接调用时签名编码错误是常见回滚原因。合约地址与交易服务 URL 随链不同,资料中列出的地址最后验证于 2025-05-15。其余未在资料中说明的收费、平台或效果暂未提供。