Bitcoin Core  25.99.0
P2P Digital Currency
net_processing.h
Go to the documentation of this file.
1 // Copyright (c) 2009-2010 Satoshi Nakamoto
2 // Copyright (c) 2009-2022 The Bitcoin Core developers
3 // Distributed under the MIT software license, see the accompanying
4 // file COPYING or http://www.opensource.org/licenses/mit-license.php.
5 
6 #ifndef BITCOIN_NET_PROCESSING_H
7 #define BITCOIN_NET_PROCESSING_H
8 
9 #include <net.h>
10 #include <validationinterface.h>
11 
12 class AddrMan;
13 class CChainParams;
14 class CTxMemPool;
15 class ChainstateManager;
16 
18 static constexpr bool DEFAULT_TXRECONCILIATION_ENABLE{false};
20 static const uint32_t DEFAULT_MAX_ORPHAN_TRANSACTIONS{100};
23 static const uint32_t DEFAULT_BLOCK_RECONSTRUCTION_EXTRA_TXN{100};
24 static const bool DEFAULT_PEERBLOOMFILTERS = false;
25 static const bool DEFAULT_PEERBLOCKFILTERS = false;
27 static const int DISCOURAGEMENT_THRESHOLD{100};
29 static const unsigned int MAX_CMPCTBLOCKS_INFLIGHT_PER_BLOCK = 3;
30 
32  int nSyncHeight = -1;
33  int nCommonHeight = -1;
35  std::chrono::microseconds m_ping_wait;
36  std::vector<int> vHeightInFlight;
39  uint64_t m_addr_processed = 0;
40  uint64_t m_addr_rate_limited = 0;
41  bool m_addr_relay_enabled{false};
43  int64_t presync_height{-1};
44 };
45 
47 {
48 public:
49  struct Options {
60  bool capture_messages{false};
61  };
62 
63  static std::unique_ptr<PeerManager> make(CConnman& connman, AddrMan& addrman,
64  BanMan* banman, ChainstateManager& chainman,
65  CTxMemPool& pool, Options opts);
66  virtual ~PeerManager() { }
67 
75  virtual std::optional<std::string> FetchBlock(NodeId peer_id, const CBlockIndex& block_index) = 0;
76 
78  virtual void StartScheduledTasks(CScheduler& scheduler) = 0;
79 
81  virtual bool GetNodeStateStats(NodeId nodeid, CNodeStateStats& stats) const = 0;
82 
84  virtual bool IgnoresIncomingTxs() = 0;
85 
87  virtual void RelayTransaction(const uint256& txid, const uint256& wtxid) = 0;
88 
90  virtual void SendPings() = 0;
91 
93  virtual void SetBestHeight(int height) = 0;
94 
95  /* Public for unit testing. */
96  virtual void UnitTestMisbehaving(NodeId peer_id, int howmuch) = 0;
97 
102  virtual void CheckForStaleTipAndEvictPeers() = 0;
103 
105  virtual void ProcessMessage(CNode& pfrom, const std::string& msg_type, CDataStream& vRecv,
106  const std::chrono::microseconds time_received, const std::atomic<bool>& interruptMsgProc) EXCLUSIVE_LOCKS_REQUIRED(g_msgproc_mutex) = 0;
107 
109  virtual void UpdateLastBlockAnnounceTime(NodeId node, int64_t time_in_seconds) = 0;
110 };
111 
112 #endif // BITCOIN_NET_PROCESSING_H
int64_t CAmount
Amount in satoshis (Can be negative)
Definition: amount.h:12
Stochastic address manager.
Definition: addrman.h:87
Definition: banman.h:59
The block chain is a tree shaped structure starting with the genesis block at the root,...
Definition: chain.h:159
CChainParams defines various tweakable parameters of a given instance of the Bitcoin system.
Definition: chainparams.h:76
Definition: net.h:1023
Information about a peer.
Definition: net.h:667
Simple class for background tasks that should be run periodically or once "after a while".
Definition: scheduler.h:39
CTxMemPool stores valid-according-to-the-current-best-chain transactions that may be included in the ...
Definition: txmempool.h:302
Implement this to subscribe to events generated in validation.
Provides an interface for creating and interacting with one or two chainstates: an IBD chainstate gen...
Definition: validation.h:818
Interface for message handling.
Definition: net.h:985
static Mutex g_msgproc_mutex
Mutex for anything that is only accessed via the msg processing thread.
Definition: net.h:988
static std::unique_ptr< PeerManager > make(CConnman &connman, AddrMan &addrman, BanMan *banman, ChainstateManager &chainman, CTxMemPool &pool, Options opts)
virtual void RelayTransaction(const uint256 &txid, const uint256 &wtxid)=0
Relay transaction to all peers.
virtual void SendPings()=0
Send ping message to all peers.
virtual void ProcessMessage(CNode &pfrom, const std::string &msg_type, CDataStream &vRecv, const std::chrono::microseconds time_received, const std::atomic< bool > &interruptMsgProc) EXCLUSIVE_LOCKS_REQUIRED(g_msgproc_mutex)=0
Process a single message from a peer.
virtual std::optional< std::string > FetchBlock(NodeId peer_id, const CBlockIndex &block_index)=0
Attempt to manually fetch block from a given peer.
virtual void StartScheduledTasks(CScheduler &scheduler)=0
Begin running background tasks, should only be called once.
virtual void SetBestHeight(int height)=0
Set the best height.
virtual bool IgnoresIncomingTxs()=0
Whether this node ignores txs received over p2p.
virtual void UnitTestMisbehaving(NodeId peer_id, int howmuch)=0
virtual bool GetNodeStateStats(NodeId nodeid, CNodeStateStats &stats) const =0
Get statistics from node state.
virtual ~PeerManager()
virtual void UpdateLastBlockAnnounceTime(NodeId node, int64_t time_in_seconds)=0
This function is used for testing the stale tip eviction logic, see denialofservice_tests....
virtual void CheckForStaleTipAndEvictPeers()=0
Evict extra outbound peers.
256-bit opaque blob.
Definition: uint256.h:106
Definition: init.h:25
static const bool DEFAULT_BLOCKSONLY
Default for blocks only.
Definition: net.h:85
int64_t NodeId
Definition: net.h:97
static const uint32_t DEFAULT_BLOCK_RECONSTRUCTION_EXTRA_TXN
Default number of non-mempool transactions to keep around for block reconstruction.
static const uint32_t DEFAULT_MAX_ORPHAN_TRANSACTIONS
Default for -maxorphantx, maximum number of orphan transactions kept in memory.
static const unsigned int MAX_CMPCTBLOCKS_INFLIGHT_PER_BLOCK
Maximum number of outstanding CMPCTBLOCK requests for the same block.
static constexpr bool DEFAULT_TXRECONCILIATION_ENABLE
Whether transaction reconciliation protocol should be enabled by default.
static const int DISCOURAGEMENT_THRESHOLD
Threshold for marking a node to be discouraged, e.g.
static const bool DEFAULT_PEERBLOCKFILTERS
static const bool DEFAULT_PEERBLOOMFILTERS
ServiceFlags
nServices flags
Definition: protocol.h:274
std::chrono::microseconds m_ping_wait
std::vector< int > vHeightInFlight
CAmount m_fee_filter_received
uint64_t m_addr_rate_limited
uint64_t m_addr_processed
int64_t presync_height
ServiceFlags their_services
bool reconcile_txs
Whether transaction reconciliation protocol is enabled.
uint32_t max_extra_txs
Number of non-mempool transactions to keep around for block reconstruction.
uint32_t max_orphan_txs
Maximum number of orphan transactions kept in memory.
bool ignore_incoming_txs
Whether this node is running in -blocksonly mode.
bool capture_messages
Whether all P2P messages are captured to disk.
#define EXCLUSIVE_LOCKS_REQUIRED(...)
Definition: threadsafety.h:49