Bitcoin Core  27.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};
63  bool deterministic_rng{false};
64  };
65 
66  static std::unique_ptr<PeerManager> make(CConnman& connman, AddrMan& addrman,
67  BanMan* banman, ChainstateManager& chainman,
68  CTxMemPool& pool, Options opts);
69  virtual ~PeerManager() { }
70 
78  virtual std::optional<std::string> FetchBlock(NodeId peer_id, const CBlockIndex& block_index) = 0;
79 
81  virtual void StartScheduledTasks(CScheduler& scheduler) = 0;
82 
84  virtual bool GetNodeStateStats(NodeId nodeid, CNodeStateStats& stats) const = 0;
85 
87  virtual bool IgnoresIncomingTxs() = 0;
88 
90  virtual void RelayTransaction(const uint256& txid, const uint256& wtxid) = 0;
91 
93  virtual void SendPings() = 0;
94 
96  virtual void SetBestBlock(int height, std::chrono::seconds time) = 0;
97 
98  /* Public for unit testing. */
99  virtual void UnitTestMisbehaving(NodeId peer_id, int howmuch) = 0;
100 
105  virtual void CheckForStaleTipAndEvictPeers() = 0;
106 
108  virtual void ProcessMessage(CNode& pfrom, const std::string& msg_type, DataStream& vRecv,
109  const std::chrono::microseconds time_received, const std::atomic<bool>& interruptMsgProc) EXCLUSIVE_LOCKS_REQUIRED(g_msgproc_mutex) = 0;
110 
112  virtual void UpdateLastBlockAnnounceTime(NodeId node, int64_t time_in_seconds) = 0;
113 
136 };
137 
138 #endif // BITCOIN_NET_PROCESSING_H
int64_t CAmount
Amount in satoshis (Can be negative)
Definition: amount.h:12
Stochastic address manager.
Definition: addrman.h:88
Definition: banman.h:59
The block chain is a tree shaped structure starting with the genesis block at the root,...
Definition: chain.h:141
CChainParams defines various tweakable parameters of a given instance of the Bitcoin system.
Definition: chainparams.h:81
Definition: net.h:1036
Information about a peer.
Definition: net.h:672
Simple class for background tasks that should be run periodically or once "after a while".
Definition: scheduler.h:40
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 and mempool.
Provides an interface for creating and interacting with one or two chainstates: an IBD chainstate gen...
Definition: validation.h:850
Double ended buffer combining vector and stream-like interfaces.
Definition: streams.h:147
Interface for message handling.
Definition: net.h:992
static Mutex g_msgproc_mutex
Mutex for anything that is only accessed via the msg processing thread.
Definition: net.h:995
virtual void ProcessMessage(CNode &pfrom, const std::string &msg_type, DataStream &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.
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 std::optional< std::string > FetchBlock(NodeId peer_id, const CBlockIndex &block_index)=0
Attempt to manually fetch block from a given peer.
virtual ServiceFlags GetDesirableServiceFlags(ServiceFlags services) const =0
Gets the set of service flags which are "desirable" for a given peer.
virtual void SetBestBlock(int height, std::chrono::seconds time)=0
Set the height of the best block and its time (seconds since epoch).
virtual void StartScheduledTasks(CScheduler &scheduler)=0
Begin running background tasks, should only be called once.
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:81
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 deterministic_rng
Whether or not the internal RNG behaves deterministically (this is a test-only option).
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