Zcash 5.5.0 版本解析:ZIP 317 手续费体系、RPC 变更与区块模板构建算法升级

原创2026-09-17 16:10:581,912 阅读
文章标签:区块链密码学隐私计算金融科技点对点网络

Zcash 5.5.0 版本解析:ZIP 317 手续费体系、RPC 变更与区块模板构建算法升级

本文基于 Zcash 5.5.0 正式版的 release notes 编写。Zcash 5.5.0 是一次以"经济模型与交易策略全面对齐 ZIP 317"为核心的里程碑版本:钱包默认采用 ZIP 317 约定手续费,区块模板构建弃用"币龄优先"的旧算法并全面切换为 ZIP 317 推荐算法,同时伴随一批 RPC 变更、旧选项移除与功能弃用。读完本文,你将掌握 getdeprecationinfo 新输出结构、ZIP 317 手续费与区块构建算法在 zcashd 源码中的具体实现,以及升级后必须注意的配置与运维要点。

一、版本概览与升级定位

Zcash 5.5.0 版本(release notes)的核心主题非常集中:将手续费选择、交易中继、区块模板构建全面切换到 ZIP 317 体系,并清理与此冲突的旧机制。从 changelog 可以看出,本轮贡献者包括 Daira Emma Hopwood(ZIP 317 计算的实现者)、Greg Pfeil(钱包 WalletTxBuilder 与 ZIP 317 手续费支持)、Kris Nuttycombe(钱包感知的交易构建器)、Jack Grigg(Rust 依赖与跨平台构建)等,属于一次横跨钱包、共识、挖矿、RPC 的大型重构。

升级到 5.5.0 后,节点运营者需要特别关注以下行为变化:

  • 钱包默认按 ZIP 317 约定手续费出交易,旧 -mintxfee、-sendfreetransactions、-txconfirmtarget、-blockprioritysize、-blockminsize 等选项被移除;
  • 内存池不再接受"免费交易",所有交易必须达到最低中继费率门槛;
  • estimatepriority RPC 及"优先级"(priority)估算体系被彻底移除;
  • getdeprecationinfo 返回值结构发生变动,新增 end_of_service 对象与弃用/禁用功能列表。

下文将按 RPC 变更、手续费选择、区块模板构建、中继策略、弃用清单五个维度展开,并辅以源码佐证。

二、RPC 变更详解

2.1 getdeprecationinfo:新增 end_of_service 与功能状态列表

getdeprecationinfo 是本次 RPC 变更中改动最大的一项。根据 release notes 与 src/rpc/net.cpp 的实现,新返回结构包含:

{
  "version": xxxxx,
  "subversion": "/MagicBean:x.y.z[-v]/",
  "deprecationheight": xxxxx,          // 已弃用(deprecated),仅当 -allowdeprecated=deprecationinfo_deprecationheight 时返回
  "end_of_service": {                  // 新增:仅 mainnet 节点返回
    "block_height": xxxxx,             // 本版本服务期结束、节点停机的区块高度
    "estimated_time": xxxxx            // 预估停机时间(Unix 秒),随实际出块速度漂移
  },
  "deprecated_features": [...],        // 已弃用但尚未禁用的功能列表
  "disabled_features": [...]           // 已弃用且当前被禁用的功能列表
}

几个关键实现细节值得注意:

  • end_of_service 替代 deprecationheight:源码中,deprecationheight 字段的返回被包在 if (fEnableDeprecationInfoDeprecationHeight) 判断中,而该开关仅当用户在 -allowdeprecated 中显式传入 deprecationinfo_deprecationheight 时才会置真(见 src/deprecation.cpp)。也就是说,升级到 5.5.0 后默认情况下该旧字段会消失,请勿再依赖它做停机告警。
  • estimated_time 的估算逻辑:源码通过 EstimatedNodeDeprecationTime(*GetNodeClock(), chainActive.Height()) 计算,基于当前链高与 DEPRECATION_HEIGHT 之间的差值,按近期平均出块时间外推。由于 Zcash 出块时间存在波动,该值只是近似,可能偏差数小时甚至数天,官方建议仅作参考信息。
  • 适用网络范围扩大:5.5.0 之前该方法仅对 mainnet 节点可用;现在 testnet 与 regtest 节点也可调用,但这两类网络没有 end-of-service 停机机制,因此 end_of_service 对象不会出现在返回结果中(源码中由 chainparams.NetworkIDString() == "main" 条件保证)。
  • 新增功能状态列表:deprecated_features 与 disabled_features 两个数组分别给出"当前已弃用但可用"与"已弃用且被禁用"的功能,帮助运维人员提前评估后续版本的破坏性变更。

2.2 z_sendmany、z_shieldcoinbase、z_mergetoaddress:同步失败改为异步失败

这三个转账类 RPC 的部分失败场景从同步错误变为异步错误。此前调用返回即可能抛出异常,现在更多错误会在后台异步操作执行阶段才暴露,因此必须持续检查异步操作状态(通过 z_getoperationstatus / z_getoperationresult 查询)。这是钱包交易构建逻辑重构(引入 WalletTxBuilder)带来的直接结果——地址解析、资金选择等环节的失败被推迟到异步执行阶段报告。

对开发者而言,迁移要点是:

  1. 不要假设 RPC 返回的 opid 一定对应成功交易;
  2. 需要处理"创建成功但执行失败"的状态分支;
  3. 从 changelog 可以看到 z_sendmany 的参数由 5 个变为 6 个(新增 fee 字段支持),调用方需同步适配。

2.3 透明找零与 AllowRevealedRecipients 隐私策略

5.5.0 起,要为交易选择透明(transparent)找零地址,必须声明 AllowRevealedRecipients 隐私策略。触发条件是该交易在不选择透明池资金的情况下无法构建——即必须动用到透明资金,此时接收方/找零方信息不可避免地被暴露在链上。因此这类交易要求用户显式指定 AllowFullyTransparent(或至少 AllowRevealedRecipients)。

源码层面,Greg Pfeil 的提交 "Require AllowRevealedRecipients for t-change" 与 GetRequiredPrivacyPolicy 的实现(见 src/wallet 下钱包交易构建器相关文件)共同保证:当 WalletTxBuilder 检测到需要透明找零时,会收紧隐私策略要求,若调用方未授权则直接报错,避免用户无意中泄漏找零地址关联性。

2.4 z_shieldcoinbase:新增可选 memo 与隐私策略参数

z_shieldcoinbase 新增两个可选参数:

  • memo:为屏蔽铸币交易附加备注(memo),对应提交 "Add memo parameter to z_shieldcoinbase"。注意 memo 字段的约定:如果传 "F6",会被当作"未提供 memo"处理(见 changelog 中 "Treat "F6" in RPC calls as if no memo were provided"),这与 Sapling/Orchard memo 编码规范保持一致。
  • privacyPolicy:z_shieldcoinbase 与 z_mergetoaddress 均支持可选的隐私策略参数,用于约束交易构建时的隐私保证级别。

2.5 z_mergetoaddress:支持合并到 UA 与跨池转账

z_mergetoaddress 的能力显著扩展:

  • 现在可以合并 到统一地址(UA);
  • 在指定 AllowRevealedAmounts 的前提下,可以在不同屏蔽池之间转账(例如 Sapling 与 Orchard 之间),对应提交 "Support UA destinations in z_mergetoaddress" 与 "Include Orchard dest in z_mergetoaddress estimation"——后者意味着金额估算与输出大小预测已纳入 Orchard 目标地址,避免低估交易体积导致手续费不足。

2.6 estimatepriority 移除与 prioritisetransaction 的 priority_delta 失效

  • estimatepriority RPC 被彻底移除(对应提交 "[rpc] Remove estimatepriority" 与 "Merge #7730: Remove priority estimation"),任何依赖它估算"多少区块内打包"的脚本都需要改用其他手段(如 fee 估算)。
  • prioritisetransaction 的 priority_delta 参数不再生效,必须传哑值 0 或 null。这是为保留 API 兼容性(提交 "RPC/Mining: Restore API compatibility for prioritisetransaction")而做的折中——参数位保留,但语义被废弃。相应地,区块打包逻辑改为依据 ZIP 317 的权重比率(weight ratio)进行优先化,而不再依据币龄优先级。

三、交易手续费选择:全面切换 ZIP 317 约定手续费

3.1 默认行为变化

5.5.0 起,zcashd 钱包默认使用按 ZIP 317 计算的"约定手续费"(conventional fee)。该默认值在以下场景被覆盖:

  • RPC 调用中显式指定了 fee(如 z_sendmany 新增的 fee 参数);
  • 钱包旧版交易创建 API(sendtoaddress、sendmany、fundrawtransaction)设置了 -paytxfee 时。

3.2 源码中的 ZIP 317 手续费实现

ZIP 317 的手续费计算集中在 src/zip317.h 与 src/zip317.cpp:

// zip317.h 中定义的常量
static const CAmount MARGINAL_FEE = 5000;          // 每"逻辑动作"的边际费用(zatoshi)
static const size_t GRACE_ACTIONS = 2;             // 宽容动作数
static const size_t P2PKH_STANDARD_INPUT_SIZE = 150;  // 标准 P2PKH 输入字节数
static const size_t P2PKH_STANDARD_OUTPUT_SIZE = 34;  // 标准 P2PKH 输出字节数

核心计算公式(src/zip317.cpp):

conventional_fee = 5000 * max(2, logical_action_count)   // 单位:zatoshi

即最低约定手续费恒为 10000 zatoshi(2 个宽容动作 × 5000),随逻辑动作数线性增长。而逻辑动作数的算法(src/zip317.cpp)为:

logical_action_count =
    max( ceil(透明输入总字节数 / 150), ceil(透明输出总字节数 / 34) )
  + 2 * joinSplit 数量
  + max(Sapling 花销数, Sapling 输出数)
  + Orchard 动作数

实现细节上,GetTxIOFieldSize 通过 GetSerializeSize 计算输入/输出向量在 SER_NETWORK 协议下的序列化体积,再减去 CompactSize 计数字段(GetSizeOfCompactSize),得到纯粹的输入/输出内容字节数参与除法取整(ceil_div)。

以典型场景估算:一个仅有 1 个透明输入、1 个透明输出的普通 P2PKH 交易,逻辑动作数为 max(150/150, 34/34) = 1,约定手续费即 5000 × max(2, 1) = 10000 zat = 0.0001 ZEC。

3.3 被移除的选项

  • -mintxfee:旧版交易创建 API 曾用它作为最低手续费下限;现在移除,若配置会触发启动警告(对应提交 "Remove -mintxfee config option")。
  • -sendfreetransactions:旧版允许对"小额、老输入"交易使用零手续费;现在移除,同样触发启动警告。
  • -txconfirmtarget:与 priority 估算配套的确认目标配置项,随 priority 体系一起废弃移除,配置会触发警告。

四、区块模板构建:ZIP 317 推荐算法上线

4.1 旧算法与相关选项的退出

5.5.0 之前,zcashd 的区块构建采用"分数制"(score-based)算法,会优先打包"币龄较长、优先级较高"的交易。与之一体的以下选项被移除:

  • -blockprioritysize:曾配置区块中预留给"高优先级"交易的字节数;现在移除,使用会触发警告;
  • -blockminsize:曾配置区块中无论手续费/优先级都要填充的部分大小;现在移除,使用会触发警告。

对应源码层面,Daira Emma Hopwood 的提交 "Remove the implementation of score-based block template construction and the -blockminsize option" 删除了整套旧实现。

4.2 新算法:按权重比率随机采样

新的 BlockAssembler::constructZIP317BlockTemplate(src/miner.cpp)工作流程如下:

  1. 遍历内存池所有交易,计算每笔交易的权重比率(weight ratio);
  2. 按权重比率是否达到 WEIGHT_RATIO_SCALE(1.0)分为"按约定手续费付费"与"未按约定手续费付费"两组候选;
  3. 先处理付费组,再处理未付费组;
  4. 在每组内,按权重比率加权的随机采样选取候选交易(candidates.takeRandom()),若某交易因依赖(其父交易尚未入块)暂时无法入块,则放入 waiting 队列,等父交易入块后再尝试(cleared 队列)。

权重比率的定义见 src/txmempool.cpp:

weight_ratio = min( (modified_fee / conventional_fee), WEIGHT_RATIO_CAP )

其中 WEIGHT_RATIO_CAP = 4,即超额付费最多把权重比率封顶为 4.0,防止个别交易垄断出块机会。这保证了:付费越充分(相对其逻辑动作数),被选中的概率越高;但未充分付费的交易也有机会入块,前提是不超过未付费动作上限。

4.3 未付费动作限制:-blockunpaidactionlimit

新选项 -blockunpaidactionlimit=<n> 控制一个区块中允许包含的"未付费动作"总数,默认值为 DEFAULT_BLOCK_UNPAID_ACTION_LIMIT。

注意:源码中该默认值定义为 0(见 src/zip317.h),即默认情况下区块不包含任何未按 ZIP 317 约定费率付费的交易(release notes 正文描述的 "defaults to 50" 与当前仓库源码默认值 0 存在差异,请以当前源码为准)。节点运营者可结合自身策略调高该值以容纳更多低费率交易。

每笔交易的未付费动作数计算(src/txmempool.cpp):

unpaid_actions = max(0, max(GRACE_ACTIONS, logical_action_count) - floor(modified_fee / 5000))

即:交易实际付费覆盖的逻辑动作数与理论需求之差,低于约定费率的交易会产生正的未付费动作数。区块构建时(src/miner.cpp),若当前累计未付费动作数加上该交易会超过 nBlockUnpaidActionLimit,则该交易被跳过。

-blockunpaidactionlimit 的校验与注册位于 src/init.cpp(帮助文本)与 src/init.cpp(负值校验)。

4.4 挖矿调试输出增强

配合新算法,-printpriority 选项的输出也得到升级(src/miner.cpp):每笔入块交易现在会记录 modified fee、conventional fee、size、logical actions、unpaid actions 五组指标,便于矿工/节点运营者核对 ZIP 317 算法的实际行为,而不再输出旧的 priority 数值。

五、交易中继策略:取消免费交易

5.5.0 移除了内存池接受与中继环节的"免费交易"(free transaction)宽限。现在所有交易必须至少达到最低中继费率门槛,当前为:

  • 每 1000 字节 100 zatoshis 起,上限 1000 zatoshis(即费率上限为 1 zat/byte)。

对应源码改动包括:

  • "sendrawtransaction no longer bypasses minRelayTxFee":sendrawtransaction 不再绕过最低中继费率检查;
  • "Remove GetMinRelayFee":清理旧的费率计算函数;
  • 提交 "Allow setting minrelaytxfee to 0" 允许将 -minrelaytxfee 显式设为 0(但实践中网络默认值必须遵守,否则交易无法被全网中继);
  • 当交易因修正后费率(modified fee)低于最低中继费率而被拒绝时,会以 mempool DEBUG 级别记录日志,便于排查。

release notes 同时提示:该中继策略仍在审议中,未来可能进一步收紧;即便收紧,ZIP 317 约定手续费也必然足够满足内存池接受与中继要求——因此按约定费率出价始终是安全选择。

六、弃用清单(Deprecations)

5.5.0 引入一项新的弃用项,默认仍可用,可通过 -allowdeprecated=none 整体禁用:

弃用 flag 受影响功能 说明
deprecationinfo_deprecationheight getdeprecationinfo 的 deprecationheight 字段 由 end_of_service 对象替代

按 release notes 的规划,该版本发布 18 周后,这些弃用项将默认禁用;届时若仍需使用,必须在 -allowdeprecated 中显式列出对应 flag。

从 src/deprecation.cpp 的解析逻辑看,-allowdeprecated 的处理规则为:

  • -allowdeprecated=none 会清空默认允许集,此时不能与其他值混用(会报错),并默认启用 DEFAULT_ALLOW_DEPRECATED 中的项目;
  • 未识别的 flag 会给出明确报错,提示可用的取值;
  • 各功能开关由 allowdeprecated.count(...) 驱动,如 fEnableDeprecationInfoDeprecationHeight = allowdeprecated.count("deprecationinfo_deprecationheight")。

当前仓库 src/deprecation.h 中定义的默认允许集(DEFAULT_ALLOW_DEPRECATED)包括节点级 createrawtransaction、signrawtransaction、getnetworkhashps 与钱包级 z_gettotalbalance、fundrawtransaction、keypoolrefill、settxfee 等,均为早期遗留 API 的兼容性开关,可作为排查"功能为何可用/不可用"的参照。

七、升级与运维注意事项汇总

综合以上变更,从 5.4.x 升级到 5.5.0 的节点运营者与钱包集成方应执行以下核对清单:

  1. 配置清理:检查并移除 -mintxfee、-sendfreetransactions、-txconfirmtarget、-blockprioritysize、-blockminsize;保留它们只会得到启动警告,且不再生效。
  2. RPC 依赖排查:任何调用 estimatepriority 的脚本必须移除;prioritisetransaction 的 priority_delta 改为传 0/null。
  3. getdeprecationinfo 消费方适配:改用 end_of_service.block_height 与 end_of_service.estimated_time 做 EoS 告警;若要临时保留 deprecationheight 字段,需加 -allowdeprecated=deprecationinfo_deprecationheight。
  4. 异步操作状态监控:z_sendmany、z_shieldcoinbase、z_mergetoaddress 的失败可能出现在异步阶段,务必轮询操作状态。
  5. 手续费策略更新:默认出价已是 ZIP 317 约定手续费;若需自定义,使用 RPC 内 fee 参数或 -paytxfee(仅限旧 API)。
  6. 隐私策略声明:涉及透明资金选择时,按需显式传入 privacyPolicy(如 AllowRevealedRecipients / AllowFullyTransparent),避免交易构建被拒。
  7. 区块模板参数:如需容纳低费率交易,按需调高 -blockunpaidactionlimit;默认值请以当前源码(0)为准,勿依赖 release notes 中的旧描述。

八、相关测试与进一步阅读

5.5.0 的 ZIP 317 与钱包行为变更均有配套测试覆盖,可作深入学习的入口:

总而言之,Zcash 5.5.0 标志着网络手续费与出块策略完成向 ZIP 317 的彻底过渡:钱包、内存池、区块构建三个层面形成了"逻辑动作计价 → 约定费率出价 → 权重比率排序 → 未付费动作限额"的完整闭环。对节点运营者而言,本次升级的关键动作是清理旧配置、适配新 RPC 返回结构,并重新审视隐私策略声明方式;对开发者而言,WalletTxBuilder 与 ZIP 317 常量实现则是理解后续版本(如进一步收紧中继策略)的最佳起点。

登录后查看全文
zcash