Bitcoin Core v30.0 升级详解：新 bitcoin 命令、费率默认值重构与交易策略变更实战指南

Bitcoin Core v30.0 升级详解新 bitcoin 命令、费率默认值重构与交易策略变更实战指南【免费下载链接】bitcoinBitcoin Core integration/staging tree项目地址: https://gitcode.com/GitHub_Trending/bi/bitcoin本文以 Bitcoin Core v30.0 官方发布说明为主体系统梳理该版本在交易策略Policy、P2P 网络、命令入口、钱包与 GUI 等层面的全部变更并结合仓库源码给出可验证的实现依据。读者通过本文可以完整掌握从 v29.x 升级到 v30.0 需要了解的功能变化、参数迁移清单与潜在的运维注意事项可作为直接参考的版本升级与配置迁移手册。版本概况与升级方式v30.0 是一个新特性版本包含新特性、大量缺陷修复与性能改进以及更新的翻译。全部变更的权威来源见 release-notes-30.0.md本文涉及的策略默认值、启动参数与命令行为均以该文档及当前仓库源码为准。升级方式非常简单若正在运行旧版本先完整关闭节点部分情况下完全退出可能需要几分钟Windows 直接运行安装程序macOS 覆盖拷贝/Applications/Bitcoin-QtLinux 则用新版本替换bitcoind/bitcoin-qt可执行文件从已达 EOL生命周期结束的旧版本直接升级也是允许的但如果数据目录需要迁移例如 coinstatsindex 从旧格式重建见下文首次启动可能耗时较长。旧版钱包格式BDB legacy在 v30.0 中已无法加载但可通过migratewalletRPC 迁移到描述符钱包因此“老版本钱包数据仍总体被支持”。支持的操作系统官方测试支持的操作系统为Linux Kernel 3.17、macOS 13、Windows 10。绝大多数其他类 Unix 系统也能运行但测试频率较低不建议在不受支持的系统上使用 Bitcoin Core。交易策略Policy变更v30.0 在“何种交易被视为标准交易并允许转发/打包”这一层面做了多项重要调整全部体现在 policy.cpp 与 policy.h 中。每笔标准交易的 legacy 签名操作数上限收紧为 2500此前对标准交易内签章操作sigops数量的限制方式存在边界区块级 sigops 限制只统计“区块中实际存在的”脚本而 v30.0 新增了对单笔标准交易中潜在执行 legacy 签名操作的全局上限MAX_TX_LEGACY_SIGOPS 2500定义于 policy.h。其计数规则见 policy.cpp 的CheckSigopsBIP54为逐一累加所有输入 scriptsig 自身的 sigops所有被花费的前序输出 scriptPubKey 中的 sigops含 bare 与 P2SH 两类所有 P2SH redeem script 中的 sigops。只要累计值超过 2500交易即被判为bad-txns-nonstandard-inputs: non-witness sigops exceed bip54 limit。该改动用于为未来可能的 BIP54 部署做铺垫PR #32521官方评估认为该上限不会影响任何常见的标准交易形态。-datacarriersize默认值增至 100,000等价于不再单独限制v30.0 把-datacarriersizeOP_RETURN 数据载体输出的大小上限的默认值提高到 100,000即MAX_OP_RETURN_RELAY MAX_STANDARD_TX_WEIGHT / WITNESS_SCALE_FACTOR 400,000 / 4见 policy.h。由于单笔交易重量上限 400,000 Wu 会先被触发这一默认值实质上等于“取消”了单独的数据载体大小限制。如果需要恢复历史行为可显式配置bitcoind -datacarriersize83单笔交易允许多个 OP_RETURN 输出按聚合大小计费与上一条配套交易中现在可以包含多个data carrierOP_RETURN输出用于转发与挖矿。检查逻辑在 policy.cpp 的IsStandardTx中逐输出检查凡属于NULL_DATA类型即消耗剩余额度即-datacarriersize限制的是该交易内所有 OP_RETURN 输出scriptPubKey 大小的总和且每个 scriptPubKey 自身不算入消耗。具体地代码用datacarrier_bytes_left随每个 NULL_DATA 输出递减任一个输出超过剩余额度即判为不标准reason 为datacarrier。同时新增单笔交易最多 1 个临时粉尘输出ephemeral dust等配套规则在 policy.h 给出MAX_DUST_OUTPUTS_PER_TX 1。对应单元测试见 transaction_tests.cpp其中验证了“多 OP_RETURN 输出的总大小等于额度即标准、小 1 字节即不标准”的边界行为。手续费默认值全面下调矿工与中继层面v30.0 一次下调了三个费用默认值PR #33106参数v29 行为v30.0 默认值源码常量policy.h单位换算-blockmintxfee打包最低费率—0.001 sat/vBDEFAULT_BLOCK_MIN_TX_FEE{1}1 sat/kvB用于矿工对加入区块模板的 package 设定最低费率-minrelaytxfee最低中继费率—0.1 sat/vBDEFAULT_MIN_RELAY_TX_FEE{100}100 sat/kvB低于此值视为零费率不中继不打包-incrementalrelayfee增量中继费率—0.1 sat/vBDEFAULT_INCREMENTAL_RELAY_FEE{100}100 sat/kvB用于 mempool 限额与替换RBF策略它们仍可通过对应配置项自行覆盖但官方建议若要修改应将-minrelaytxfee与-incrementalrelayfee一起修改二者逻辑上关联。参数注册位置见 init.cpp。需要注意以下几点边界其余费率不受影响粉尘费率dust feerate、费率估算器返回的最低费率、以及钱包使用的全部费率均保持不变mempool 最低费率仍会随高流量区块拥堵动态上调。网络采用是前提除非全网广泛采用这些更低默认值否则以低费率创建的交易并不保证能被转发或确认。钱包需要显式设置-mintxfee钱包费率并未改变若想用钱包创建低于旧默认值的交易必须先配置-mintxfee。P2P 与网络层变更1p1c一父一子package relay 的拓扑扩展v30.0 增强了机会性 1-parent-1-child 包中继使其能够处理“子交易在 mempool 中已有未确认父交易”的情况。这意味着 1p1c 包即便附着在更复杂的拓扑上也能被接受并传播例如多父一子multi-parent-1-child仅 1 个父交易需要费用追加fee-bumping祖父-父-子grandparent-parent-child仅父交易需要费用追加等场景。实现由 PR #31385 引入同时影响了下方submitpackageRPC 的语义放宽。测试覆盖位于 policy/packages.h含MAX_PACKAGE_WEIGHT与标准交易重量的静态断言与 test 目录下的 package 相关测试。交易孤儿池orphanageDoS 防护重构-maxorphantx失效交易孤儿池用于暂存“缺少父交易输入”的交易同时节点尝试向对端拉取其父交易。v30.0 将其容量控制从“唯一交易数量上限默认 100可用-maxorphantx配置”改为双重限额PR #31829评分上限条目数按 wtxidpeer 唯一计加上每笔唯一交易输入数除以 10 后的累加值不得超过3000重量上限全部唯一交易的重量总和不得超过404,000 Wu × 对端数量。这两个常量在源码中分别对应 txorphanage.h 的DEFAULT_RESERVED_ORPHAN_WEIGHT_PER_PEER{404000}与DEFAULT_MAX_ORPHANAGE_LATENCY_SCORE{3000}实测如 bench/txorphanage.cpp围绕这两个上限验证驱逐eviction逻辑的正确性。对运维者的直接影响-maxorphantx选项已不再产生任何效果孤儿池不再以唯一交易数量为限。若配置文件里还在使用它应尽快移除因为未来版本不再识别该参数时会导致启动报错。新命令入口bitcoinv30.0 新增了统一的bitcoin命令行工具目的是让各功能更易发现、更易使用。它本身只是“调用其他可执行文件”的分发器不实现任何自身功能。其完整实现见 bitcoin.cppmain解析子命令后通过ExecCommand在bin/、libexec/、Windows 安装目录daemon/或系统 PATH 中依次查找目标可执行文件并exec。命令与现有可执行文件的对应关系源码 bitcoin.cppbitcoin子命令等价调用bitcoin node [ARGS]bitcoind [ARGS]或在-m多进程模式下为bitcoin-nodebitcoin gui [ARGS]bitcoin-qt [ARGS]或bitcoin-guibitcoin rpc [ARGS]bitcoin-cli -named [ARGS]bitcoin wallet [ARGS]bitcoin-wallet [ARGS]bitcoin tx [ARGS]bitcoin-tx [ARGS]bitcoin help输出完整帮助其他bench/chainstate/test/test-gui/util详见bitcoin help完整输出其中bitcoin rpc之所以默认启用-named命名参数是考虑到该新接口不需要向后兼容便于调用方混用命名/位置参数见源码注释bitcoin.cpp。bitcoin还支持三个顶层开关bitcoin.cppbitcoin -m, --multiprocess # 运行多进程二进制 bitcoin-node / bitcoin-gui bitcoin -M, --monolithic # 运行单体二进制 bitcoind / bitcoin-qt默认 bitcoin -v, --version # 版本信息 bitcoin -h, --help # 完整帮助一个值得一提的自动决策逻辑bitcoin.cpp 的UseMultiprocess若未显式传-m/-M只要命令行或配置文件里设置了任何-ipcbind/-ipcconnect/-ipcfd参数bitcoin就会自动选用多进程二进制因为只有它们具备 IPC 能力。新工具是既有命令的“替代入口”并不会取代既有命令官方也没有废弃现有命令的计划。外部签名与 IPC 挖矿接口Windows 外部签名重新启用此前在某些平台受限的外部签名external signer如硬件钱包支持在 Windows 上被重新启用PR #29868。实验性 IPC Mining 接口bitcoin命令支持的唯一“全新功能”是实验性的 IPC Mining 接口PR #31098允许节点与 Stratum v2 或其他挖矿客户端协同工作。用法如下bitcoin -m node -ipcbindunix该命令以多进程模式-m启动内部二进制bitcoin-node代替bitcoind并在 unix socket 上监听 IPC 客户端连接允许客户端请求区块模板block template并提交挖出的区块。其中-m目前是必需的未来配合 #33229将变为可选。IPC 连通性引入了新依赖详见 multiprocess.md 与 design/multiprocess.md。若不打算使用 IPC可在构建时关闭cmake -DENABLE_IPCOFF对应 PR #31802默认开启。安装布局变更v30.0 对安装后二进制布局做了调整PR #31679全部变更源于 “libexec/存放被调用组件、bin/存放用户入口” 的设计test_bitcoin从bin/移至libexec/仍可直接执行或通过新命令bitcoin test调用。libexec/中还新增了bitcoin-node与bitcoin-gui两个支持 IPC 的二进制供bitcoin工具调用。仅源码构建source build时test_bitcoin-qt、bench_bitcoin、bitcoin-chainstate也会安装到libexec/并可通过bitcoin命令访问细节见bitcoin help输出。Windows 安装器相关变更针对 PR #32132、#33422开始菜单条目不再附带 “(64-bit)” 后缀升级时会自动移除过时obsolete残留文件。索引Indexescoinstatsindex 溢出修复与重建coinstatsindex 的实现被修改以修复一个已能在默认 Signet 网络上观察到的溢出 bugPR #30469。升级后首次启动新版本节点时新版本索引需要从头同步。目录路径变化如下版本存储路径相对于数据目录旧版本v29 及更早/indexes/coinstats/v30.0新版本/indexes/coinstatsindex/实现见 coinstatsindex.cpp新版本构造函数以coinstatsindex/coinstatsidx命名并在indexes/coinstatsindex目录读写启动时若发现旧版目录会打印日志提示该目录“在不需要降级时可安全删除”。重要运维提示升级节点不会自动删除旧版/indexes/coinstats/以便用户在必要时降级节点若确定不会降级可自行删除/indexes/coinstats/以释放磁盘未来某版本可能自动清理旧版索引。日志系统变更无条件日志按源位置限速所谓“无条件日志”指日志级别高于 debug 的info、warning、error。v30.0 起落盘的无条件日志被按“源位置source location”限速每个源位置每小时配额 1 MiBPR #32604。逻辑在 logging.cpp 中实现should_ratelimit、内部 limiter 与抑制状态跟踪见 logging.cpp。只要存在至少一个正在被抑制的源位置所有日志行都会带上[*]前缀见 logging.cpp 附近注释与逻辑。这使运维者能一眼看出“当前有日志被限速抑制”。-logsourcelocations输出完整函数签名开启-logsourcelocations时日志输出将包含完整的函数签名而不只是函数名便于在大规模代码库中精确定位日志来源。RPC 变更盘点废弃项静态交易费率-paytxfee启动选项与settxfeeRPC 已被废弃将在 Bitcoin Core 31.0 移除PR #31278。原因设置固定费率可能导致超付或欠付。替代方案依赖费率估算fee estimation或逐笔交易通过fee_rate参数显式指定费率涉及 RPC 包括fundrawtransaction、sendtoaddress、send、sendall、sendmany。描述符白名单校验更严格任何包含描述符参数的 RPC若描述符中公钥片段首尾带空白例如pk( KEY)或pk(KEY )将直接抛出错误PR #31603。submitpackage放宽无需提供全部未确认父交易submitpackage提交“子交易及其父交易”包不再要求所有未确认父交易都在包内包中可同时含有已在 mempool 的其他祖先PR #31385与 1p1c 拓扑扩展同源。waitfor*系列 RPC 取消隐藏并增强waitfornewblock新增可选参数current_tip且不再隐藏hiddenwaitforblock与waitforblockheight不再隐藏PR #30635。手续费替换全面支持 full RBFpsbtbumpfee与bumpfee允许在 fullrbf 条件下发起替换不再要求 BIP-125 信号PR #31953。脚本校验错误文案标准化交易脚本校验错误的原因前缀由两套混乱的字符串统一为PR #33183场景旧前缀v30.0 新前缀区块错误共识级mandatory-script-verify-flag-failedblock-script-verify-flag-failedmempool 错误标准性级non-mandatory-script-verify-flagmempool-script-verify-flag-failed结果字段扩充getmininginfo新增blockmintxfee字段返回-blockmintxfee配置值PR #33189getmempoolinfo新增permitbaremultisig与maxdatacarriersize字段分别反映-permitbaremultisig与-datacarriersize配置PR #29954实现见 rpc/mempool.cpp。钱包相关 RPC 汇总详见下文 Wallet 一节新 REST 端点/rest/spenttxouts/BLOCKHASH新增 REST API 端点/rest/spenttxouts/BLOCKHASH用于借助区块的 undo 数据高效获取已花费交易输出PR #32540。路由与 URI 解析位于 rest.cpp格式为/rest/spenttxouts/hash.ext。启动参数与默认设置变更Updated settings32 位系统上的资源上限-maxmempool与-dbcache在 32 位系统上分别被限制上限为500 MB与1 GiBPR #32530用于规避 32 位地址空间不足问题。NAT-PMP 默认开启、UPnP 彻底移除-natpmp默认值改为1PR #33004。这意味着默认监听-listen默认开启且位于防火墙/家用路由器后的节点只要路由器支持PCP或NAT-PMP协议即可对外可达。-upnp已被彻底移除PR #32500请改用-natpmp。参数注册与“设置了 proxy 则自动关闭 natpmp”的联动逻辑见 init.cpp。-proxy支持按网络细分-proxy原本是所有网络共享的代理设置I2P 例外走-i2psam且只有 Tor 可单独用-onion覆盖。v30.0 扩展了-proxy语法PR #32425可按网络分别指定代理方法是在代理地址后追加网络名# 仅对 IPv6 使用该代理 -proxy127.0.0.1:5555ipv6 # 多个网络分别代理 -proxy127.0.0.1:4444ipv4 -proxy10.0.0.1:6666ipv6 # 先用全局代理再针对 CJDNS 撤销走直连 -proxy127.0.0.1:5555 -proxy0cjdns规则要点-proxy可多次使用为不同网络IPv4、IPv6、Tor、CJDNS定义不同代理同一网络后出现的设置覆盖先前的利用该覆盖规则可以把早先的“全网络代理”替换为“某网络直连”。-blockmaxweight降级为 debug-only-blockmaxweight变为调试专用选项仍可使用但不再出现在默认-help文本中仅在-help-debug中显示PR #32654。钱包Wallet变更Legacy 钱包彻底移除BDB legacy 钱包无法再创建或加载只能迁移到新版描述符descriptor钱包迁移走migratewalletRPCbitcoin-wallet工具中冗余选项-withinternalbdb、-legacy、-descriptors被移除PR #32944 等仅 legacy 钱包可用的 RPC 被整体删除addmultisigaddress、dumpprivkey、dumpwallet、importaddress、importmulti、importprivkey、importpubkey、importwallet、newkeypool、sethdseed、upgradewalletPR #28710、#32438、#31250 等。支持 TRUC 交易钱包新增对 TRUCTopologically Restricted Until Confirmedv3 交易的支持包括花费收到的 TRUC 交易与创建 TRUC 交易PR #32896具体约束钱包确保满足 TRUC 策略规则若用户试图用其他版本 UTXO 混合花费 TRUC UTXO 会报错未确认的 TRUC 兄弟交易被视为 mempool 冲突钱包会确保花费 TRUC UTXO 的交易满足尺寸限制。配套地以下 RPC 新增version参数以创建任意标准版本号1-3的交易createrawtransaction、createpsbt、send、sendall、walletcreatefundedpsbt。watchonly 相关清理由于描述符钱包不允许混合 watchonly 与非 watchonly 描述符PR #32618所有 RPC 的include_watchonly选项及其命名变体被移除返回iswatchonly字段的 RPC 一律移除该字段。若干 RPC 行为修正unloadwallet当 RPC wallet 端点和wallet_name参数都未指定时现在返回RPC_INVALID_PARAMETER此前是 JSON 解析错误PR #32845getdescriptoractivity将blockhashes与scanobjects参数标记为必填缺失时给出清晰帮助信息同样来自 #32845getwalletinfo移除balance、immature_balance、unconfirmed_balance字段PR #32721getunconfirmedbalance整个 RPC 被移除请改用getbalances并读取 JSON 响应中的[mine][untrusted_pending]条目。GUI 变更GUI 从 Qt 5 迁移至Qt 6PR #30997Windows 上支持深色模式macOS 改用Metal后端交易费用提升fee bump在 full RBF 下被允许不再要求 BIP-125 信号PR #31953Transactions 页签的自定义列宽因 legacy 钱包移除被重置PR #32459。底层变更与其他日志现在会记录是哪个对端发来的区块头同时减少了冗余的区块头日志副作用是少数非常规场景例如收到携带此前未知区块头的直接BLOCK消息、或调用submitheaderRPC不再打印新区块头日志PR #27826构建系统Build System相关改动见 v30.0 文档说明与仓库 CI 配置。升级前配置迁移速查清单针对 v30.0建议所有节点运维者在升级前检查并修改以下配置官方建议均以 v30.0 文档为准旧用法v30.0 处理方式-maxorphantxN不再生效请删除该配置未来版本会因未知参数报错-upnp1选项已移除改用-natpmp1且其默认值已为开-paytxfee...已废弃31.0 移除改用逐笔fee_rate参数settxfeeRPC已废弃31.0 移除getunconfirmedbalanceRPC已移除改用getbalances的mine.untrusted_pending依赖/indexes/coinstats/coinstatsindex 改用/indexes/coinstatsindex/并需重建legacy/BDB 钱包无法创建/加载请用migratewallet迁移为描述符钱包import*、dumpprivkey等 legacy RPC已移除设置静态钱包费率需在钱包层面配置-mintxfee并理解-minrelaytxfee/-incrementalrelayfee默认已降至 0.1 sat/vB想维持旧版 83 字节数据载体上限显式加-datacarriersize83总结Bitcoin Core v30.0 的核心主题可概括为以更灵活也更安全的交易策略2500 legacy sigops 上限、100,000 数据载体、0.1 sat/vB 中继费率默认值、全新的bitcoin统一命令入口与实验性 IPC 挖矿接口、以及legacy 钱包与 UPnP 等历史包袱的彻底清理为三大主线。升级操作并不复杂但涉及若干配置项迁移与一次 coinstatsindex 的自动重建建议对照本文速查清单逐项检查配置文件后再进行停机升级与首次启动验证。需要阅读更完整变更上下文时可直接查阅官方发布说明原文 release-notes-30.0.md。【免费下载链接】bitcoinBitcoin Core integration/staging tree项目地址: https://gitcode.com/GitHub_Trending/bi/bitcoin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考