[29.x] bump to v29.0rc1

glozow commented at 6:28 pm on March 12, 2025: member

“backport” #32041
bump version to v29.0rc1
generate manpages
add example bitcoin.conf
add release-notes.md pointing to wiki

[build] bump CLIENT_VERSION_MAJOR to 29

Github-Pull: #32041
Rebased-From: a3f0e9a

153bd443ec

[build] bump version to 29.0rc1 95c21b1fdd

glozow added the label Backport on Mar 12, 2025

DrahtBot commented at 6:28 pm on March 12, 2025: contributor

The following sections might be updated with supplementary metadata relevant to reviewers and maintainers.

Code Coverage & Benchmarks

For details see: https://corecheck.dev/bitcoin/bitcoin/pulls/32046.

Reviews

See the guideline for information on the review process.

Type	Reviewers
ACK	hebasto, achow101, davidgumberg

If your review is incorrectly listed, please react with 👎 to this comment and the bot will ignore it on the next update.

hebasto approved

hebasto commented at 6:31 pm on March 12, 2025: member

ACK 628e4f59b8784fcde2de176fb98260e71def18ec, I have reviewed the code and it looks OK.

hebasto commented at 6:51 pm on March 12, 2025: member

ACK 628e4f5, I have reviewed the code and it looks OK.

Revoked. Man pages for bitcoind and bitcoin-qt miss “ZeroMQ notification options”

[doc] update man pages for 29.0rc1 86a3ce6209

glozow force-pushed on Mar 12, 2025

glozow commented at 7:02 pm on March 12, 2025: member

Great, fixed.

hebasto commented at 7:08 pm on March 12, 2025: member

ACK 628e4f5, I have reviewed the code and it looks OK.

Revoked. Man pages for bitcoind and bitcoin-qt miss “ZeroMQ notification options”

My apologies for not checking all stuff at once, but examples/bitcoin.conf also lacks “ZeroMQ notification options”.

[examples] generate example bitcoin.conf 21f423939e

[doc] release notes link for 29.0 47e2fa86dc

glozow force-pushed on Mar 12, 2025

glozow commented at 7:09 pm on March 12, 2025: member

Thanks @hebasto!

hebasto approved

hebasto commented at 7:12 pm on March 12, 2025: member

ACK 47e2fa86dc5433852fd9e5050a23de2accfdca8d.

davidgumberg commented at 10:22 pm on March 12, 2025: contributor

It appears that gen-bitcoin-conf.sh became broken after #31118 changed the --help output format, all options above -help in the --help output are missing, I’ve opened a fix in #32049.

bitcoin.conf diff between 28.1 and #32046

0$ git diff v28.1/share/examples/bitcoin.conf 32046/share/examples/bitcoin.conf

  0diff --git a/v28.1/share/examples/bitcoin.conf b/32046/share/examples/bitcoin.conf
  1index a8dfc27..5b0003b 100644
  2--- a/v28.1/share/examples/bitcoin.conf
  3+++ b/32046/share/examples/bitcoin.conf
  4@@ -12,82 +12,6 @@
  5 ### Options
  6 
  7 
  8-# Execute command when an alert is raised (%s in cmd is replaced by
  9-# message)
 10-#alertnotify=<cmd>
 11-
 12-# For backwards compatibility, treat an unused bitcoin.conf file in the
 13-# datadir as a warning, not an error.
 14-#allowignoredconf=1
 15-
 16-# If this block is in the chain assume that it and its ancestors are valid
 17-# and potentially skip their script verification (0 to verify all,
 18-# default:
 19-# 000000000000000000011c5890365bdbe5d25b97ce0057589acaef4f1a57263f,
 20-# testnet3:
 21-# 000000000000000465b1a66c9f386308e8c75acef9201f3f577811da09fc90ad,
 22-# testnet4:
 23-# 000000005be348057db991fa5d89fe7c4695b667cfb311391a8db374b6f681fd,
 24-# signet:
 25-# 0000014aad1d58dddcb964dd749b073374c6306e716b22f573a2efe68d414539)
 26-#assumevalid=<hex>
 27-
 28-# Maintain an index of compact filters by block (default: 0, values:
 29-# basic). If <type> is not supplied or if <type> = 1, indexes for
 30-# all known types are enabled.
 31-#blockfilterindex=<type>
 32-
 33-# Execute command when the best block changes (%s in cmd is replaced by
 34-# block hash)
 35-#blocknotify=<cmd>
 36-
 37-# Extra transactions to keep in memory for compact block reconstructions
 38-# (default: 100)
 39-#blockreconstructionextratxn=<n>
 40-
 41-# Specify directory to hold blocks subdirectory for *.dat files (default:
 42-# <datadir>)
 43-#blocksdir=<dir>
 44-
 45-# Whether to reject transactions from network peers. Disables automatic
 46-# broadcast and rebroadcast of transactions, unless the source peer
 47-# has the 'forcerelay' permission. RPC transactions are not
 48-# affected. (default: 0)
 49-#blocksonly=1
 50-
 51-# Whether an XOR-key applies to blocksdir *.dat files. The created XOR-key
 52-# will be zeros for an existing blocksdir or when `-blocksxor=0` is
 53-# set, and random for a freshly initialized blocksdir. (default: 1)
 54-#blocksxor=1
 55-
 56-# Maintain coinstats index used by the gettxoutsetinfo RPC (default: 0)
 57-#coinstatsindex=1
 58-
 59-# Specify path to read-only configuration file. Relative paths will be
 60-# prefixed by datadir location (only useable from command line, not
 61-# configuration file) (default: bitcoin.conf)
 62-#conf=<file>
 63-
 64-# Run in the background as a daemon and accept commands (default: 0)
 65-#daemon=1
 66-
 67-# Wait for initialization to be finished before exiting. This implies
 68-# -daemon (default: 0)
 69-#daemonwait=1
 70-
 71-# Specify data directory
 72-#datadir=<dir>
 73-
 74-# Maximum database cache size <n> MiB (4 to 16384, default: 450). In
 75-# addition, unused mempool memory is shared for this cache (see
 76-# -maxmempool).
 77-#dbcache=<n>
 78-
 79-# Specify location of debug log file (default: debug.log). Relative paths
 80-# will be prefixed by a net-specific datadir location. Pass
 81-# -nodebuglogfile to disable writing the log to a file.
 82-#debuglogfile=<file>
 83-
 84 # Specify additional configuration file, relative to the -datadir path
 85 # (only useable from configuration file, not command line)
 86 #includeconf=<file>
 87@@ -263,7 +187,7 @@
 88 # base while uppercase is 1024 base
 89 #maxuploadtarget=<n>
 90 
 91-# Use NAT-PMP to map the listening port (default: 0)
 92+# Use PCP or NAT-PMP to map the listening port (default: 0)
 93 #natpmp=1
 94 
 95 # Enable all P2P network activity (default: 1). Can be changed by the
 96@@ -321,9 +245,6 @@
 97 # Tor control port password (default: empty)
 98 #torpassword=<pass>
 99 
100-# Use UPnP to map the listening port (default: 0)
101-#upnp=1
102-
103 # Support v2 transport (default: 1)
104 #v2transport=1
105 
106@@ -586,10 +507,6 @@
107 # this size or less (default: 83)
108 #datacarriersize=1
109 
110-# (DEPRECATED) Accept transaction replace-by-fee without requiring
111-# replaceability signaling (default: 1)
112-#mempoolfullrbf=1
113-
114 # Fees (in BTC/kvB) smaller than this are considered zero fee for
115 # relaying, mining and transaction creation (default: 0.00001)
116 #minrelaytxfee=<amt>
117@@ -611,13 +528,18 @@
118 ### Block creation options
119 
120 
121-# Set maximum BIP141 block weight (default: 3996000)
122+# Set maximum BIP141 block weight (default: 4000000)
123 #blockmaxweight=<n>
124 
125 # Set lowest fee rate (in BTC/kvB) for transactions to be included in
126 # block creation. (default: 0.00001)
127 #blockmintxfee=<amt>
128 
129+# Reserve space for the fixed-size block header plus the largest coinbase
130+# transaction the mining software may add to the block. (default:
131+# 8000).
132+#blockreservedweight=<n>
133+
134 
135 ### RPC server options
136 
137@@ -663,7 +585,7 @@
138 # 18332, testnet4: 48332, signet: 38332, regtest: 18443)
139 #rpcport=<port>
140 
141-# Set the number of threads to service RPC calls (default: 4)
142+# Set the number of threads to service RPC calls (default: 16)
143 #rpcthreads=<n>
144 
145 # Username for JSON-RPC connections

Otherwise, I compared this PR to the instructions in doc/release-process.md and the v28.0rc1 bump (#30726) and the same changes are made here plus the #32041 backport. I lightly reviewed the diff between the manpages generated here and in v28.1, and didn’t see anything unexpected.

manpages diff between 28.1 and #32046

0$ git diff v28.1/doc/man/ 32046/doc/man

  0diff --git a/v28.1/doc/man/Makefile.am b/v28.1/doc/man/Makefile.am
  1deleted file mode 100644
  2index 8f890da..0000000
  3--- a/v28.1/doc/man/Makefile.am
  4+++ /dev/null
  5@@ -1,27 +0,0 @@
  6-dist_man1_MANS=
  7-
  8-if BUILD_BITCOIND
  9-  dist_man1_MANS+=bitcoind.1
 10-endif
 11-
 12-if ENABLE_QT
 13-  dist_man1_MANS+=bitcoin-qt.1
 14-endif
 15-
 16-if BUILD_BITCOIN_CLI
 17-  dist_man1_MANS+=bitcoin-cli.1
 18-endif
 19-
 20-if BUILD_BITCOIN_TX
 21-  dist_man1_MANS+=bitcoin-tx.1
 22-endif
 23-
 24-if BUILD_BITCOIN_UTIL
 25-  dist_man1_MANS+=bitcoin-util.1
 26-endif
 27-
 28-if ENABLE_WALLET
 29-if BUILD_BITCOIN_WALLET
 30-  dist_man1_MANS+=bitcoin-wallet.1
 31-endif
 32-endif
 33diff --git a/v28.1/doc/man/bitcoin-cli.1 b/32046/doc/man/bitcoin-cli.1
 34index d355289..2eb89ff 100644
 35--- a/v28.1/doc/man/bitcoin-cli.1
 36+++ b/32046/doc/man/bitcoin-cli.1
 37@@ -1,38 +1,36 @@
 38 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
 39-.TH BITCOIN-CLI "1" "December 2024" "bitcoin-cli v28.1.0" "User Commands"
 40+.TH BITCOIN-CLI "1" "March 2025" "bitcoin-cli v29.0.0rc1" "User Commands"
 41 .SH NAME
 42-bitcoin-cli \- manual page for bitcoin-cli v28.1.0
 43+bitcoin-cli \- manual page for bitcoin-cli v29.0.0rc1
 44 .SH SYNOPSIS
 45 .B bitcoin-cli
 46-[\fI\,options\/\fR] \fI\,<command> \/\fR[\fI\,params\/\fR]  \fI\,Send command to Bitcoin Core\/\fR
 47+[\fI\,options\/\fR] \fI\,<command> \/\fR[\fI\,params\/\fR]
 48 .br
 49 .B bitcoin-cli
 50-[\fI\,options\/\fR] \fI\,-named <command> \/\fR[\fI\,name=value\/\fR]...  \fI\,Send command to Bitcoin Core (with named arguments)\/\fR
 51+[\fI\,options\/\fR] \fI\,-named <command> \/\fR[\fI\,name=value\/\fR]...
 52 .br
 53 .B bitcoin-cli
 54-[\fI\,options\/\fR] \fI\,help                List commands\/\fR
 55+[\fI\,options\/\fR] \fI\,help\/\fR
 56 .br
 57 .B bitcoin-cli
 58-[\fI\,options\/\fR] \fI\,help <command>      Get help for a command\/\fR
 59+[\fI\,options\/\fR] \fI\,help <command>\/\fR
 60 .SH DESCRIPTION
 61-Bitcoin Core RPC client version v28.1.0
 62+Bitcoin Core RPC client version v29.0.0rc1
 63+.PP
 64+The bitcoin\-cli utility provides a command line interface to interact with a Bitcoin Core RPC server.
 65+.PP
 66+It can be used to query network information, manage wallets, create or broadcast transactions, and control the Bitcoin Core server.
 67+.PP
 68+Use the "help" command to list all commands. Use "help <command>" to show help for that command.
 69+The \fB\-named\fR option allows you to specify parameters using the key=value format, eliminating the need to pass unused positional parameters.
 70 .SH OPTIONS
 71 .HP
 72-\-?
 73-.IP
 74-Print this help message and exit
 75-.HP
 76-\fB\-addrinfo\fR
 77-.IP
 78-Get the number of addresses known to the node, per network and total,
 79-after filtering for quality and recency. The total number of
 80-addresses known to the node may be higher.
 81-.HP
 82 \fB\-color=\fR<when>
 83 .IP
 84 Color setting for CLI output (default: auto). Valid values: always, auto
 85 (add color codes when standard output is connected to a terminal
 86-and OS is not WIN32), never.
 87+and OS is not WIN32), never. Only applies to the output of
 88+\fB\-getinfo\fR.
 89 .HP
 90 \fB\-conf=\fR<file>
 91 .IP
 92@@ -43,34 +41,14 @@ location. (default: bitcoin.conf)
 93 .IP
 94 Specify data directory
 95 .HP
 96-\fB\-generate\fR
 97-.IP
 98-Generate blocks, equivalent to RPC getnewaddress followed by RPC
 99-generatetoaddress. Optional positional integer arguments are
100-number of blocks to generate (default: 1) and maximum iterations
101-to try (default: 1000000), equivalent to RPC generatetoaddress
102-nblocks and maxtries arguments. Example: bitcoin\-cli \fB\-generate\fR 4
103-1000
104-.HP
105-\fB\-getinfo\fR
106+\fB\-help\fR
107 .IP
108-Get general information from the remote server. Note that unlike
109-server\-side RPC calls, the output of \fB\-getinfo\fR is the result of
110-multiple non\-atomic requests. Some entries in the output may
111-represent results from different states (e.g. wallet balance may
112-be as of a different block from the chain state reported)
113+Print this help message and exit (also \fB\-h\fR or \-?)
114 .HP
115 \fB\-named\fR
116 .IP
117 Pass named instead of positional arguments (default: false)
118 .HP
119-\fB\-netinfo\fR
120-.IP
121-Get network peer connection information from the remote server. An
122-optional integer argument from 0 to 4 can be passed for different
123-peers listings (default: 0). Pass "help" for detailed help
124-documentation.
125-.HP
126 \fB\-rpcclienttimeout=\fR<n>
127 .IP
128 Timeout in seconds during HTTP requests, or 0 for no timeout. (default:
129@@ -175,8 +153,42 @@ Consider moving to testnet4 now by using \fB\-testnet4\fR.
130 \fB\-testnet4\fR
131 .IP
132 Use the testnet4 chain. Equivalent to \fB\-chain\fR=\fI\,testnet4\/\fR.
133+.PP
134+CLI Commands:
135+.HP
136+\fB\-addrinfo\fR
137+.IP
138+Get the number of addresses known to the node, per network and total,
139+after filtering for quality and recency. The total number of
140+addresses known to the node may be higher.
141+.HP
142+\fB\-generate\fR
143+.IP
144+Generate blocks, equivalent to RPC getnewaddress followed by RPC
145+generatetoaddress. Optional positional integer arguments are
146+number of blocks to generate (default: 1) and maximum iterations
147+to try (default: 1000000), equivalent to RPC generatetoaddress
148+nblocks and maxtries arguments. Example: bitcoin\-cli \fB\-generate\fR 4
149+1000
150+.HP
151+\fB\-getinfo\fR
152+.IP
153+Get general information from the remote server. Note that unlike
154+server\-side RPC calls, the output of \fB\-getinfo\fR is the result of
155+multiple non\-atomic requests. Some entries in the output may
156+represent results from different states (e.g. wallet balance may
157+be as of a different block from the chain state reported)
158+.HP
159+\fB\-netinfo\fR
160+.IP
161+Get network peer connection information from the remote server. An
162+optional argument from 0 to 4 can be passed for different peers
163+listings (default: 0). If a non\-zero value is passed, an
164+additional "outonly" (or "o") argument can be passed to see
165+outbound peers only. Pass "help" (or "h") for detailed help
166+documentation.
167 .SH COPYRIGHT
168-Copyright (C) 2009-2024 The Bitcoin Core developers
169+Copyright (C) 2009-2025 The Bitcoin Core developers
170 
171 Please contribute if you find Bitcoin Core useful. Visit
172 <https://bitcoincore.org/> for further information about the software.
173diff --git a/v28.1/doc/man/bitcoin-qt.1 b/32046/doc/man/bitcoin-qt.1
174index fe76cd9..20b7b96 100644
175--- a/v28.1/doc/man/bitcoin-qt.1
176+++ b/32046/doc/man/bitcoin-qt.1
177@@ -1,20 +1,22 @@
178 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
179-.TH BITCOIN-QT "1" "December 2024" "bitcoin-qt v28.1.0" "User Commands"
180+.TH BITCOIN-QT "1" "March 2025" "bitcoin-qt v29.0.0rc1" "User Commands"
181 .SH NAME
182-bitcoin-qt \- manual page for bitcoin-qt v28.1.0
183+bitcoin-qt \- manual page for bitcoin-qt v29.0.0rc1
184 .SH SYNOPSIS
185 .B bitcoin-qt
186-[\fI\,command-line options\/\fR] [\fI\,URI\/\fR]
187+[\fI\,options\/\fR] [\fI\,URI\/\fR]
188 .SH DESCRIPTION
189-Bitcoin Core version v28.1.0
190+Bitcoin Core version v29.0.0rc1
191 .PP
192-Optional URI is a Bitcoin address in BIP21 URI format.
193+The bitcoin\-qt application provides a graphical interface for interacting with Bitcoin Core.
194+.PP
195+It combines the core functionalities of bitcoind with a user\-friendly interface for wallet management, transaction history, and network statistics.
196+.PP
197+It is suitable for users who prefer a graphical over a command\-line interface.
198+.PP
199+You can optionally specify a payment [URI], in e.g. the BIP21 URI format.
200 .SH OPTIONS
201 .HP
202-\-?
203-.IP
204-Print this help message and exit
205-.HP
206 \fB\-alertnotify=\fR<cmd>
207 .IP
208 Execute command when an alert is raised (%s in cmd is replaced by
209@@ -30,13 +32,13 @@ datadir as a warning, not an error.
210 If this block is in the chain assume that it and its ancestors are valid
211 and potentially skip their script verification (0 to verify all,
212 default:
213-000000000000000000011c5890365bdbe5d25b97ce0057589acaef4f1a57263f,
214+00000000000000000001b658dd1120e82e66d2790811f89ede9742ada3ed6d77,
215 testnet3:
216-000000000000000465b1a66c9f386308e8c75acef9201f3f577811da09fc90ad,
217+00000000000003fc7967410ba2d0a8a8d50daedc318d43e8baf1a9782c236a57,
218 testnet4:
219-000000005be348057db991fa5d89fe7c4695b667cfb311391a8db374b6f681fd,
220+0000000000003ed4f08dbdf6f7d6b271a6bcffce25675cb40aa9fa43179a89f3,
221 signet:
222-0000014aad1d58dddcb964dd749b073374c6306e716b22f573a2efe68d414539)
223+000000895a110f46e59eb82bbc5bfb67fa314656009c295509c21b4999f5180a)
224 .HP
225 \fB\-blockfilterindex=\fR<type>
226 .IP
227@@ -97,9 +99,9 @@ Specify data directory
228 .HP
229 \fB\-dbcache=\fR<n>
230 .IP
231-Maximum database cache size <n> MiB (4 to 16384, default: 450). In
232-addition, unused mempool memory is shared for this cache (see
233-\fB\-maxmempool\fR).
234+Maximum database cache size <n> MiB (minimum 4, default: 450). Make sure
235+you have enough RAM. In addition, unused memory allocated to the
236+mempool is shared with this cache (see \fB\-maxmempool\fR).
237 .HP
238 \fB\-debuglogfile=\fR<file>
239 .IP
240@@ -107,6 +109,10 @@ Specify location of debug log file (default: debug.log). Relative paths
241 will be prefixed by a net\-specific datadir location. Pass
242 \fB\-nodebuglogfile\fR to disable writing the log to a file.
243 .HP
244+\fB\-help\fR
245+.IP
246+Print this help message and exit (also \fB\-h\fR or \-?)
247+.HP
248 \fB\-includeconf=\fR<file>
249 .IP
250 Specify additional configuration file, relative to the \fB\-datadir\fR path
251@@ -319,7 +325,7 @@ base while uppercase is 1024 base
252 .HP
253 \fB\-natpmp\fR
254 .IP
255-Use NAT\-PMP to map the listening port (default: 0)
256+Use PCP or NAT\-PMP to map the listening port (default: 0)
257 .HP
258 \fB\-networkactive\fR
259 .IP
260@@ -388,10 +394,6 @@ Tor control host and port to use if onion listening enabled (default:
261 .IP
262 Tor control port password (default: empty)
263 .HP
264-\fB\-upnp\fR
265-.IP
266-Use UPnP to map the listening port (default: 0)
267-.HP
268 \fB\-v2transport\fR
269 .IP
270 Support v2 transport (default: 1)
271@@ -697,11 +699,6 @@ Relay and mine data carrier transactions (default: 1)
272 Relay and mine transactions whose data\-carrying raw scriptPubKey is of
273 this size or less (default: 83)
274 .HP
275-\fB\-mempoolfullrbf\fR
276-.IP
277-(DEPRECATED) Accept transaction replace\-by\-fee without requiring
278-replaceability signaling (default: 1)
279-.HP
280 \fB\-minrelaytxfee=\fR<amt>
281 .IP
282 Fees (in BTC/kvB) smaller than this are considered zero fee for
283@@ -727,12 +724,18 @@ Block creation options:
284 .HP
285 \fB\-blockmaxweight=\fR<n>
286 .IP
287-Set maximum BIP141 block weight (default: 3996000)
288+Set maximum BIP141 block weight (default: 4000000)
289 .HP
290 \fB\-blockmintxfee=\fR<amt>
291 .IP
292 Set lowest fee rate (in BTC/kvB) for transactions to be included in
293 block creation. (default: 0.00001)
294+.HP
295+\fB\-blockreservedweight=\fR<n>
296+.IP
297+Reserve space for the fixed\-size block header plus the largest coinbase
298+transaction the mining software may add to the block. (default:
299+8000).
300 .PP
301 RPC server options:
302 .HP
303@@ -787,7 +790,7 @@ Listen for JSON\-RPC connections on <port> (default: 8332, testnet3:
304 .HP
305 \fB\-rpcthreads=\fR<n>
306 .IP
307-Set the number of threads to service RPC calls (default: 4)
308+Set the number of threads to service RPC calls (default: 16)
309 .HP
310 \fB\-rpcuser=\fR<user>
311 .IP
312@@ -836,7 +839,7 @@ Reset all settings changed in the GUI
313 .IP
314 Show splash screen on startup (default: 1)
315 .SH COPYRIGHT
316-Copyright (C) 2009-2024 The Bitcoin Core developers
317+Copyright (C) 2009-2025 The Bitcoin Core developers
318 
319 Please contribute if you find Bitcoin Core useful. Visit
320 <https://bitcoincore.org/> for further information about the software.
321diff --git a/v28.1/doc/man/bitcoin-tx.1 b/32046/doc/man/bitcoin-tx.1
322index 26cbd9b..b493f91 100644
323--- a/v28.1/doc/man/bitcoin-tx.1
324+++ b/32046/doc/man/bitcoin-tx.1
325@@ -1,25 +1,29 @@
326 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
327-.TH BITCOIN-TX "1" "December 2024" "bitcoin-tx v28.1.0" "User Commands"
328+.TH BITCOIN-TX "1" "March 2025" "bitcoin-tx v29.0.0rc1" "User Commands"
329 .SH NAME
330-bitcoin-tx \- manual page for bitcoin-tx v28.1.0
331+bitcoin-tx \- manual page for bitcoin-tx v29.0.0rc1
332 .SH SYNOPSIS
333 .B bitcoin-tx
334-[\fI\,options\/\fR] \fI\,<hex-tx> \/\fR[\fI\,commands\/\fR]  \fI\,Update hex-encoded bitcoin transaction\/\fR
335+[\fI\,options\/\fR] \fI\,<hex-tx> \/\fR[\fI\,commands\/\fR]
336 .br
337 .B bitcoin-tx
338-[\fI\,options\/\fR] \fI\,-create \/\fR[\fI\,commands\/\fR]   \fI\,Create hex-encoded bitcoin transaction\/\fR
339+[\fI\,options\/\fR] \fI\,-create \/\fR[\fI\,commands\/\fR]
340 .SH DESCRIPTION
341-Bitcoin Core bitcoin\-tx utility version v28.1.0
342+Bitcoin Core bitcoin\-tx utility version v29.0.0rc1
343+.PP
344+The bitcoin\-tx tool is used for creating and modifying bitcoin transactions.
345+.PP
346+bitcoin\-tx can be used with "<hex\-tx> [commands]" to update a hex\-encoded bitcoin transaction, or with "\-create [commands]" to create a hex\-encoded bitcoin transaction.
347 .SH OPTIONS
348 .HP
349-\-?
350-.IP
351-Print this help message and exit
352-.HP
353 \fB\-create\fR
354 .IP
355 Create new, empty TX.
356 .HP
357+\fB\-help\fR
358+.IP
359+Print this help message and exit (also \fB\-h\fR or \-?)
360+.HP
361 \fB\-json\fR
362 .IP
363 Select JSON output
364@@ -142,7 +146,7 @@ set=NAME:JSON\-STRING
365 .IP
366 Set register NAME to given JSON\-STRING
367 .SH COPYRIGHT
368-Copyright (C) 2009-2024 The Bitcoin Core developers
369+Copyright (C) 2009-2025 The Bitcoin Core developers
370 
371 Please contribute if you find Bitcoin Core useful. Visit
372 <https://bitcoincore.org/> for further information about the software.
373diff --git a/v28.1/doc/man/bitcoin-util.1 b/32046/doc/man/bitcoin-util.1
374index 415e6d0..74cf232 100644
375--- a/v28.1/doc/man/bitcoin-util.1
376+++ b/32046/doc/man/bitcoin-util.1
377@@ -1,17 +1,22 @@
378 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
379-.TH BITCOIN-UTIL "1" "December 2024" "bitcoin-util v28.1.0" "User Commands"
380+.TH BITCOIN-UTIL "1" "March 2025" "bitcoin-util v29.0.0rc1" "User Commands"
381 .SH NAME
382-bitcoin-util \- manual page for bitcoin-util v28.1.0
383+bitcoin-util \- manual page for bitcoin-util v29.0.0rc1
384 .SH SYNOPSIS
385 .B bitcoin-util
386-[\fI\,options\/\fR] [\fI\,commands\/\fR]  \fI\,Do stuff\/\fR
387+[\fI\,options\/\fR] [\fI\,command\/\fR]
388+.br
389+.B bitcoin-util
390+[\fI\,options\/\fR] \fI\,grind <hex-block-header>\/\fR
391 .SH DESCRIPTION
392-Bitcoin Core bitcoin\-util utility version v28.1.0
393+Bitcoin Core bitcoin\-util utility version v29.0.0rc1
394+.PP
395+The bitcoin\-util tool provides bitcoin related functionality that does not rely on the ability to access a running node. Available [commands] are listed below.
396 .SH OPTIONS
397 .HP
398-\-?
399+\fB\-help\fR
400 .IP
401-Print this help message and exit
402+Print this help message and exit (also \fB\-h\fR or \-?)
403 .HP
404 \fB\-version\fR
405 .IP
406@@ -60,7 +65,7 @@ grind
407 .IP
408 Perform proof of work on hex header string
409 .SH COPYRIGHT
410-Copyright (C) 2009-2024 The Bitcoin Core developers
411+Copyright (C) 2009-2025 The Bitcoin Core developers
412 
413 Please contribute if you find Bitcoin Core useful. Visit
414 <https://bitcoincore.org/> for further information about the software.
415diff --git a/v28.1/doc/man/bitcoin-wallet.1 b/32046/doc/man/bitcoin-wallet.1
416index a043129..dbf3010 100644
417--- a/v28.1/doc/man/bitcoin-wallet.1
418+++ b/32046/doc/man/bitcoin-wallet.1
419@@ -1,22 +1,20 @@
420 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
421-.TH BITCOIN-WALLET "1" "December 2024" "bitcoin-wallet v28.1.0" "User Commands"
422+.TH BITCOIN-WALLET "1" "March 2025" "bitcoin-wallet v29.0.0rc1" "User Commands"
423 .SH NAME
424-bitcoin-wallet \- manual page for bitcoin-wallet v28.1.0
425+bitcoin-wallet \- manual page for bitcoin-wallet v29.0.0rc1
426+.SH SYNOPSIS
427+.B bitcoin-wallet
428+[\fI\,options\/\fR] \fI\,<command>\/\fR
429 .SH DESCRIPTION
430-Bitcoin Core bitcoin\-wallet version v28.1.0
431+Bitcoin Core bitcoin\-wallet utility version v29.0.0rc1
432 .PP
433 bitcoin\-wallet is an offline tool for creating and interacting with Bitcoin Core wallet files.
434+.PP
435 By default bitcoin\-wallet will act on wallets in the default mainnet wallet directory in the datadir.
436-To change the target wallet, use the \fB\-datadir\fR, \fB\-wallet\fR and \fB\-regtest\fR/\-signet/\-testnet/\-testnet4 arguments.
437-.SS "Usage:"
438-.IP
439-bitcoin\-wallet [options] <command>
440+.PP
441+To change the target wallet, use the \fB\-datadir\fR, \fB\-wallet\fR and (test)chain selection arguments.
442 .SH OPTIONS
443 .HP
444-\-?
445-.IP
446-Print this help message and exit
447-.HP
448 \fB\-datadir=\fR<dir>
449 .IP
450 Specify data directory
451@@ -35,6 +33,10 @@ with 'createfromdump', loads the records into a new wallet.
452 The format of the wallet file to create. Either "bdb" or "sqlite". Only
453 used with 'createfromdump'
454 .HP
455+\fB\-help\fR
456+.IP
457+Print this help message and exit (also \fB\-h\fR or \-?)
458+.HP
459 \fB\-legacy\fR
460 .IP
461 Create legacy wallet. Only for 'create'
462@@ -121,7 +123,7 @@ salvage
463 Attempt to recover private keys from a corrupt wallet. Warning:
464 \&'salvage' is experimental.
465 .SH COPYRIGHT
466-Copyright (C) 2009-2024 The Bitcoin Core developers
467+Copyright (C) 2009-2025 The Bitcoin Core developers
468 
469 Please contribute if you find Bitcoin Core useful. Visit
470 <https://bitcoincore.org/> for further information about the software.
471diff --git a/v28.1/doc/man/bitcoind.1 b/32046/doc/man/bitcoind.1
472index 1acb2df..865a59e 100644
473--- a/v28.1/doc/man/bitcoind.1
474+++ b/32046/doc/man/bitcoind.1
475@@ -1,18 +1,22 @@
476 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.3.
477-.TH BITCOIND "1" "December 2024" "bitcoind v28.1.0" "User Commands"
478+.TH BITCOIND "1" "March 2025" "bitcoind v29.0.0rc1" "User Commands"
479 .SH NAME
480-bitcoind \- manual page for bitcoind v28.1.0
481+bitcoind \- manual page for bitcoind v29.0.0rc1
482 .SH SYNOPSIS
483 .B bitcoind
484-[\fI\,options\/\fR]                     \fI\,Start Bitcoin Core\/\fR
485+[\fI\,options\/\fR]
486 .SH DESCRIPTION
487-Bitcoin Core version v28.1.0
488+Bitcoin Core daemon version v29.0.0rc1
489+.PP
490+The Bitcoin Core daemon (bitcoind) is a headless program that connects to the Bitcoin network to validate and relay transactions and blocks, as well as relaying addresses.
491+.PP
492+It provides the backbone of the Bitcoin network and its RPC, REST and ZMQ services can provide various transaction, block and address\-related services.
493+.PP
494+There is an optional wallet component which provides transaction services.
495+.PP
496+It can be used in a headless environment or as part of a server setup.
497 .SH OPTIONS
498 .HP
499-\-?
500-.IP
501-Print this help message and exit
502-.HP
503 \fB\-alertnotify=\fR<cmd>
504 .IP
505 Execute command when an alert is raised (%s in cmd is replaced by
506@@ -28,13 +32,13 @@ datadir as a warning, not an error.
507 If this block is in the chain assume that it and its ancestors are valid
508 and potentially skip their script verification (0 to verify all,
509 default:
510-000000000000000000011c5890365bdbe5d25b97ce0057589acaef4f1a57263f,
511+00000000000000000001b658dd1120e82e66d2790811f89ede9742ada3ed6d77,
512 testnet3:
513-000000000000000465b1a66c9f386308e8c75acef9201f3f577811da09fc90ad,
514+00000000000003fc7967410ba2d0a8a8d50daedc318d43e8baf1a9782c236a57,
515 testnet4:
516-000000005be348057db991fa5d89fe7c4695b667cfb311391a8db374b6f681fd,
517+0000000000003ed4f08dbdf6f7d6b271a6bcffce25675cb40aa9fa43179a89f3,
518 signet:
519-0000014aad1d58dddcb964dd749b073374c6306e716b22f573a2efe68d414539)
520+000000895a110f46e59eb82bbc5bfb67fa314656009c295509c21b4999f5180a)
521 .HP
522 \fB\-blockfilterindex=\fR<type>
523 .IP
524@@ -95,9 +99,9 @@ Specify data directory
525 .HP
526 \fB\-dbcache=\fR<n>
527 .IP
528-Maximum database cache size <n> MiB (4 to 16384, default: 450). In
529-addition, unused mempool memory is shared for this cache (see
530-\fB\-maxmempool\fR).
531+Maximum database cache size <n> MiB (minimum 4, default: 450). Make sure
532+you have enough RAM. In addition, unused memory allocated to the
533+mempool is shared with this cache (see \fB\-maxmempool\fR).
534 .HP
535 \fB\-debuglogfile=\fR<file>
536 .IP
537@@ -105,6 +109,10 @@ Specify location of debug log file (default: debug.log). Relative paths
538 will be prefixed by a net\-specific datadir location. Pass
539 \fB\-nodebuglogfile\fR to disable writing the log to a file.
540 .HP
541+\fB\-help\fR
542+.IP
543+Print this help message and exit (also \fB\-h\fR or \-?)
544+.HP
545 \fB\-includeconf=\fR<file>
546 .IP
547 Specify additional configuration file, relative to the \fB\-datadir\fR path
548@@ -317,7 +325,7 @@ base while uppercase is 1024 base
549 .HP
550 \fB\-natpmp\fR
551 .IP
552-Use NAT\-PMP to map the listening port (default: 0)
553+Use PCP or NAT\-PMP to map the listening port (default: 0)
554 .HP
555 \fB\-networkactive\fR
556 .IP
557@@ -386,10 +394,6 @@ Tor control host and port to use if onion listening enabled (default:
558 .IP
559 Tor control port password (default: empty)
560 .HP
561-\fB\-upnp\fR
562-.IP
563-Use UPnP to map the listening port (default: 0)
564-.HP
565 \fB\-v2transport\fR
566 .IP
567 Support v2 transport (default: 1)
568@@ -695,11 +699,6 @@ Relay and mine data carrier transactions (default: 1)
569 Relay and mine transactions whose data\-carrying raw scriptPubKey is of
570 this size or less (default: 83)
571 .HP
572-\fB\-mempoolfullrbf\fR
573-.IP
574-(DEPRECATED) Accept transaction replace\-by\-fee without requiring
575-replaceability signaling (default: 1)
576-.HP
577 \fB\-minrelaytxfee=\fR<amt>
578 .IP
579 Fees (in BTC/kvB) smaller than this are considered zero fee for
580@@ -725,12 +724,18 @@ Block creation options:
581 .HP
582 \fB\-blockmaxweight=\fR<n>
583 .IP
584-Set maximum BIP141 block weight (default: 3996000)
585+Set maximum BIP141 block weight (default: 4000000)
586 .HP
587 \fB\-blockmintxfee=\fR<amt>
588 .IP
589 Set lowest fee rate (in BTC/kvB) for transactions to be included in
590 block creation. (default: 0.00001)
591+.HP
592+\fB\-blockreservedweight=\fR<n>
593+.IP
594+Reserve space for the fixed\-size block header plus the largest coinbase
595+transaction the mining software may add to the block. (default:
596+8000).
597 .PP
598 RPC server options:
599 .HP
600@@ -785,7 +790,7 @@ Listen for JSON\-RPC connections on <port> (default: 8332, testnet3:
601 .HP
602 \fB\-rpcthreads=\fR<n>
603 .IP
604-Set the number of threads to service RPC calls (default: 4)
605+Set the number of threads to service RPC calls (default: 16)
606 .HP
607 \fB\-rpcuser=\fR<user>
608 .IP
609@@ -812,7 +817,7 @@ subject to empty whitelists.
610 .IP
611 Accept command line and JSON\-RPC commands
612 .SH COPYRIGHT
613-Copyright (C) 2009-2024 The Bitcoin Core developers
614+Copyright (C) 2009-2025 The Bitcoin Core developers
615 
616 Please contribute if you find Bitcoin Core useful. Visit
617 <https://bitcoincore.org/> for further information about the software.

achow101 commented at 11:48 pm on March 12, 2025: member

ACK 47e2fa86dc5433852fd9e5050a23de2accfdca8

Other than the issue with the example bitcoin.conf, everything seems correct. I think we can move forward with rc1 and just backport the gen-bitcoin-conf.sh fixes for rc2 (or final). The script has to be rerun for every rc anyways.

davidgumberg commented at 1:00 am on March 13, 2025: contributor

ACK https://github.com/bitcoin/bitcoin/commit/47e2fa86dc5433852fd9e5050a23de2accfdca8d

I’m ~0 on whether or not the release candidate should be held up by the example bitcoin.conf, but everything else looks good to me.

fanquake added this to the milestone 29.0 on Mar 13, 2025

fanquake commented at 3:47 am on March 13, 2025: member

There’s likely going to be more rcs than usual, so just getting this out for testing with the incomplete example .conf is fine.

fanquake merged this on Mar 13, 2025

fanquake closed this on Mar 13, 2025

glozow deleted the branch on Mar 13, 2025

[29.x] bump to v29.0rc1 #32046

Code Coverage & Benchmarks

Reviews

bitcoin.conf diff between 28.1 and #32046

manpages diff between 28.1 and #32046