如何在新版SafeW多签钱包中追加已执行交易的链上备注？

功能定位：为什么需要“追加链上备注”

在 SafeW 多签场景里，链上备注（On-chain Note）是一段写入交易 Input Data 的 UTF-8 文本，永久跟随 TxHash，用于审计、税务、纠纷溯源。v5.3.0 之前，备注只能在发起阶段填写；交易一旦执行，补充说明只能落到链下表格，易丢失、难对齐。新版允许追加备注，实质是再发一笔 0 ETH 的 internal tx，把补充文本写入同一合约的 noteStorage 映射，逻辑上“挂”在原交易之下，既不改动原 Tx，也不触发多签阈值，仅消耗单签矿工费。

对审计方而言，追加后可在区块浏览器一次性看到两条记录：原执行 Tx + 补充 Note Tx，时间线连续，无需链外 Excel。对签名者而言，追加动作只需一位成员付费，适合事后补录发票号、合规标签或误填修正。

前置检查：你必须满足的四项硬条件

1. SafeW App 版本 ≥ 5.3.0（桌面端与移动端同步发布，可点“设置-关于”查看）。
2. 原交易必须已执行且链上确认 ≥ 1 block；Pending 或 Failed 状态不会出现“追加备注”按钮。
3. 你持有钱包中至少一个签名地址的私钥/生物识别权限，用于支付追加 Gas。
4. 合约版本 ≥ 1.3.0（Gnosis Safe 官方模板），否则 noteStorage 接口不存在，追加会 revert。

经验性观察：

若你在 2025 年及更早通过第三方分叉工厂部署的保险箱，可能使用 1.1.1 版合约，追加按钮会灰显。验证方法：在 SafeW 首页顶部点击保险箱名称→“合约信息”，若“Mastercopy 地址”结尾为f8d8即 1.1.1，需整体迁移至新保险箱后方可使用本功能。

最短操作路径（分平台）

iOS / Android

1. 打开 SafeW → 进入目标保险箱 → 底部“历史”标签。
2. 在已执行交易列表找到目标 Tx，点击右侧“⋯” → “追加链上备注”。
3. 在文本框输入 ≤ 280 字节（约 90 个汉字）内容，可插入【发票号:#12345】等结构化标签。
4. 选择付费地址 → “下一步” → 指纹/面容确认 → 等待上链。
5. 回执弹出后，点击“查看”可在区块浏览器看到两笔 Tx 前后排列，备注内容在 Input Data 尾部以 0x6e6f7465 开头。

桌面端（macOS & Windows）

1. 左侧栏点“Transactions” → 筛选“Executed”。
2. 右侧展开目标 Tx，底部出现“Add On-chain Note”按钮（若未出现，把鼠标悬停于 TxHash 行即可显示）。
3. 后续步骤与移动端一致，签名时使用 FIDO2 指纹或 Ledger 均可。

Gas 成本与性能实测

追加备注实质是一笔 0 ETH、带 calldata 的常规交易。经验性观察：在以太坊主网平均消耗21 000 基础 Gas + 约 1 200 字节 calldata × 16 gas = 40 200 gas；按 20 gwei、ETH $3 000 计，约0.0008 ETH（2.4 USD）。侧链如 Polygon 则降至 0.0003 USD 级别，成本与发一条 ERC-20 转账相当。

若备注超 280 字节，合约自动截断，不会报错，但浏览器解码会出现乱码，建议先在其他文本工具统计字节再粘贴。

例外与副作用：什么时候不该追加

• 高并发出纳场景：若每日执行 > 200 笔，逐条追加会迅速累积 Gas，性价比低于批量导出 CSV 后走 Arweave 存证。
• 隐私敏感信息：备注永久公开，切勿写“客户 A 的银行卡号后四位”。
• 合约即将升级：若团队计划 48 小时内迁移到新 Mastercopy，追加的 noteStorage 在新合约可能无解析器，导致备注“孤儿”。

提示：

如果只是想内部对齐，可用 SafeW 自带的“本地标签”功能（仅保存在设备数据库，不上链），零 Gas、可修改、可删除，适合临时草稿。

验证与回退：如何确认追加成功及撤销思路

链上验证

在 Etherscan 打开追加 Tx → Input Data → UTF-8 解码，若看到前缀note:即成功。再点“Logs”找到 NoteAdded 事件，topic0=0x9f...，data 段为原 TxHash 与备注哈希，可证明两笔关联。

回退方案

链上备注一旦确认无法删除，但可再发一条“更正备注”指向同一原 Tx，形成时间序列。审计时通常以最新备注为准，因此写错字无需慌张，追加修正即可。

与第三方审计机器人协同

经验性观察：主流会计机器人（如 Koinly、Blockpit）已识别 SafeW 的 NoteAdded 事件。操作完成后，在其“Tx 详情”面板会多出一栏“On-chain Memo”，可直接拉取，无需手动复制。若机器人未同步，可在设置里把 TxHash 重新粘贴一次，触发二次拉取。

故障排查速查表

现象	最可能原因	验证步骤	处置
“追加备注”按钮灰色	合约版本低于 1.3.0	保险箱 → 合约信息 → Mastercopy 结尾非 b7a2	迁移保险箱或放弃追加
签名后 Pending > 2 小时	主网 Gas Price 突升	钱包 → 加速 → 提高 10% 费用	重签或等待低峰
备注出现乱码	超 280 字节被截断	文本工具统计字节 > 280	缩短后重新追加