This guide explains Bitcoin Core getprioritisedtransactions RPC in plain English. It shows what the command does, what its result means and what it cannot prove.
TL;DR
- What it is: Bitcoin Core 26.0 introduced getprioritisedtransactions to list every fee delta created by prioritisetransaction. The result is keyed by transaction ID and reports the delta in satoshis plus whether that transaction is currently in the local mempool.
- Why it matters: getprioritisedtransactions gives operators the missing inventory for local fee policy. Safe use treats each delta as a controlled, reversible intervention and never confuses local prioritisation with propagation or confirmation.
- Current position: Require a second reviewer and explicit rollback or expiry, and pause payments, signing or network-dependent services until post-change evidence is complete.
Bitcoin Core getprioritisedtransactions RPC in simple English
Bitcoin Core getprioritisedtransactions RPC: Record requester, reason, txid, before and after delta, time, expiry condition and current mempool state without copying unrelated transaction data.
Simple example
A miner is checking Bitcoin Core getprioritisedtransactions RPC. The command accepts no parameters and returns the full map. Pin the Core version and restrict access because the output exposes local mining-policy interventions.
Key terms in plain English
- Bitcoin Core:
- Widely used software that validates Bitcoin and can provide wallet, network and operator tools.
- RPC:
- A command that software sends to a node to request information or a local action.
- Consensus:
- The shared rules full nodes use to decide whether blocks and transactions are valid.
- Mempool:
- A node’s changing local collection of valid, unconfirmed transactions.
- Node:
- A computer running Bitcoin software that checks data and communicates with other peers.
No arguments
The command accepts no parameters and returns the full map. Pin the Core version and restrict access because the output exposes local mining-policy interventions.
Fee delta
fee_delta is denominated in satoshis and modifies local fee treatment. It does not change the transaction’s serialized fee, recipient amounts or consensus validity.
Mempool flag
in_mempool states whether the transaction is present now. False can mean it was never accepted, was evicted, replaced, confirmed or otherwise left the mempool.
Persistence
Prioritisation state may outlive mempool presence and can be persisted. Reconcile entries after restart and remove obsolete deltas deliberately using prioritisetransaction.
Mining boundary
A positive delta can influence local template selection; a negative one can lower effective priority. Other miners and relays do not inherit the node’s local adjustment.
Audit trail
Record requester, reason, txid, before and after delta, time, expiry condition and current mempool state without copying unrelated transaction data.
Monitoring
Alert on unexpected entries, large deltas, stale absent transactions and divergence between policy records and RPC output. Cross-check with getmempoolentry and templates where relevant. Build a revision-pinned evidence pack on an isolated node, wallet or protocol harness.
Frequently asked questions
What is the main point of Bitcoin Core getprioritisedtransactions RPC?
Bitcoin Core getprioritisedtransactions RPC: Record requester, reason, txid, before and after delta, time, expiry condition and current mempool state without copying unrelated transaction data.
For Bitcoin Core getprioritisedtransactions RPC, what should a beginner know about no arguments?
The command accepts no parameters and returns the full map. Pin the Core version and restrict access because the output exposes local mining-policy interventions.
For Bitcoin Core getprioritisedtransactions RPC, what should a beginner know about fee delta?
fee_delta is denominated in satoshis and modifies local fee treatment. It does not change the transaction’s serialized fee, recipient amounts or consensus validity.
For Bitcoin Core getprioritisedtransactions RPC, what should a beginner know about mempool flag?
in_mempool states whether the transaction is present now. False can mean it was never accepted, was evicted, replaced, confirmed or otherwise left the mempool.
Conclusion
getprioritisedtransactions gives operators the missing inventory for local fee policy. Safe use treats each delta as a controlled, reversible intervention and never confuses local prioritisation with propagation or confirmation.
Primary sources
Check the current specification status and the documentation for the exact implementation you operate before moving production funds or changing a mining node.
Join the ASIC Mining Discussion
Members can read and join the discussion
Log in to read comments from other miners. Create a free account if you would like to ask a question or share your experience.
Membership helps us protect the discussion from spam and keep answers useful.