This guide explains Bitcoin Core importmempool 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 importmempool to read a mempool.dat file without replacing the data directory or restarting the node. Each transaction is still attempted against current consensus and mempool policy.
- Why it matters: importmempool can restore useful transient state, but the file and its metadata are policy inputs. A safe import minimises inherited metadata, validates on an isolated node and measures the actual resulting mempool.
- 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 importmempool RPC in simple English
Bitcoin Core importmempool RPC: An empty JSON object indicates the import call completed, not that every entry was accepted. Compare mempool counts, selected txids, rejection logs and fee-delta state.
Simple example
A miner is checking Bitcoin Core importmempool RPC. Supply a readable mempool file through a controlled local path. Reject user-controlled traversal, symlinks, public upload locations and files from unknown nodes.
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.
File boundary
Supply a readable mempool file through a controlled local path. Reject user-controlled traversal, symlinks, public upload locations and files from unknown nodes.
Current time
use_current_time defaults true, avoiding reliance on imported entry-time metadata. Setting false preserves source times and expands the trust placed in the file.
Fee deltas
apply_fee_delta_priority defaults false. Enabling it adds imported deltas to existing ones and can double-prioritise transactions unless reconciled with getprioritisedtransactions.
Unbroadcast set
apply_unbroadcast_set defaults false. Imported unbroadcast metadata can alter rebroadcast behaviour and should be enabled only under a documented recovery case.
Validation
Transactions are attempted under the receiving node’s current policy and chain state. Expect rejection, expiry, conflicts and dependency differences between source and target.
Result semantics
An empty JSON object indicates the import call completed, not that every entry was accepted. Compare mempool counts, selected txids, rejection logs and fee-delta state.
How specialists test it
Operators test the command on a non-production node first. They check a normal reply, an invalid request, a timeout and a restart. This shows what the response means and prevents one local result from being mistaken for a network-wide outcome.
Frequently asked questions
What is the main point of Bitcoin Core importmempool RPC?
Bitcoin Core importmempool RPC: An empty JSON object indicates the import call completed, not that every entry was accepted.
For Bitcoin Core importmempool RPC, what should a beginner know about file boundary?
Supply a readable mempool file through a controlled local path. Reject user-controlled traversal, symlinks, public upload locations and files from unknown nodes.
For Bitcoin Core importmempool RPC, what should a beginner know about current time?
use_current_time defaults true, avoiding reliance on imported entry-time metadata. Setting false preserves source times and expands the trust placed in the file.
For Bitcoin Core importmempool RPC, what should a beginner know about fee deltas?
apply_fee_delta_priority defaults false. Enabling it adds imported deltas to existing ones and can double-prioritise transactions unless reconciled with getprioritisedtransactions.
Conclusion
importmempool can restore useful transient state, but the file and its metadata are policy inputs. A safe import minimises inherited metadata, validates on an isolated node and measures the actual resulting mempool.
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.