doc: Note that generateblock does not collect transaction fees
What the developer wrote
Authored by HouseOfHufflepuff
doc: Note that generateblock does not collect transaction fees
The generateblock RPC creates blocks where the coinbase only includes
the block subsidy, omitting transaction fees. Document this behavior
in the RPC help text to avoid confusion.
refs #31684
What changed, and why it matters
This commit only updates the help text for the generateblock command in Bitcoin Core. It adds a note explaining that the command does not collect transaction fees in the block reward. There is no code behavior change, no bug fix, and no security issue.
No action needed. This is a documentation-only change with no security relevance.
Security signals we found
No strong security signals were identified.
Evidence from the diff
The change is a documentation-only edit to src/rpc/mining.cpp. It appends a sentence to the RPCHelpMan description of the generateblock RPC stating that transaction fees are not collected in the block reward. The underlying behavior of generateblock is unchanged.
Changed components
src/rpc/mining.cppInspect captured patch +2 / −1
diff --git a/src/rpc/mining.cpp b/src/rpc/mining.cpp
index 514be2e8..a935810d 100644
--- a/src/rpc/mining.cpp
+++ b/src/rpc/mining.cpp
@@ -305,7 +305,8 @@ static RPCHelpMan generatetoaddress()
static RPCHelpMan generateblock()
{
return RPCHelpMan{"generateblock",
- "Mine a set of ordered transactions to a specified address or descriptor and return the block hash.",
+ "Mine a set of ordered transactions to a specified address or descriptor and return the block hash.\n"
+ "Transaction fees are not collected in the block reward.",
{
{"output", RPCArg::Type::STR, RPCArg::Optional::NO, "The address or descriptor to send the newly generated bitcoin to."},
{"transactions", RPCArg::Type::ARR, RPCArg::Optional::NO, "An array of hex strings which are either txids or raw transactions.\n"
Why this scored 15/100
Community notes
Notes can correct, qualify, or add evidence to the AI analysis. Every note shown here has been validated by a human moderator.
The AI analysis stands alone for now. Submit a note if you can add evidence or important context.