Bitcoin.org is a community funded project, donations are appreciated and used to improve the website.

Bitcoin Improvement Proposal 35

mempool message

Deployed Specification Peer Services
About this mirror. A BIP is a proposal or technical document. Publication here does not imply adoption, Bitcoin community consensus, or endorsement by Bitcoin.org. For authoritative text and history, use the canonical bitcoin/bips source.

Abstract

Make a network node's transaction memory pool accessible via a new "mempool" message. Extend the existing "getdata" message behavior to permit accessing the transaction memory pool.

Motivation

Several use cases make it desirable to expose a network node's transaction memory pool:

  1. SPV clients, wishing to obtain zero-confirmation transactions sent or received.
  2. Miners, to avoid missing lucrative fees, downloading existing network transactions after a restart.
  3. Remote network diagnostics.

Specification

  1. The mempool message is defined as an empty message where pchCommand == "mempool"
  2. Upon receipt of a "mempool" message, the node will respond with an "inv" message containing MSG_TX hashes of all the transactions in the node's transaction memory pool, if any.
  3. The typical node behavior in response to an "inv" is "getdata". However, the reference Satoshi implementation ignores requests for transaction hashes outside that which is recently relayed. To support "mempool", an implementation must extend its "getdata" message support to querying the memory pool.
  4. Feature discovery is enabled by checking two "version" message attributes:
    1. Protocol version >= 60002
    2. NODE_NETWORK bit set in nServices

Note that existing implementations drop "inv" messages with a vector size > 50000.

Backward compatibility

Older clients remain 100% compatible and interoperable after this change.

Implementation

https://github.com/bitcoin/bitcoin/pull/1641

Rendered from bitcoin/bips revision 60f5b33b0a7b. The document is distributed under its declared Not specified licence.