Bitcoin Core 29.99.0
P2P Digital Currency
net.h
Go to the documentation of this file.
1// Copyright (c) 2009-2010 Satoshi Nakamoto
2// Copyright (c) 2009-present 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_H
7#define BITCOIN_NET_H
8
9#include <bip324.h>
10#include <chainparams.h>
11#include <common/bloom.h>
12#include <compat/compat.h>
13#include <consensus/amount.h>
14#include <crypto/siphash.h>
15#include <hash.h>
16#include <i2p.h>
18#include <net_permissions.h>
19#include <netaddress.h>
20#include <netbase.h>
21#include <netgroup.h>
24#include <policy/feerate.h>
25#include <protocol.h>
26#include <random.h>
27#include <semaphore_grant.h>
28#include <span.h>
29#include <streams.h>
30#include <sync.h>
31#include <uint256.h>
32#include <util/check.h>
33#include <util/sock.h>
35
36#include <atomic>
37#include <condition_variable>
38#include <cstdint>
39#include <deque>
40#include <functional>
41#include <list>
42#include <map>
43#include <memory>
44#include <optional>
45#include <queue>
46#include <thread>
47#include <unordered_set>
48#include <vector>
49
50class AddrMan;
51class BanMan;
52class CChainParams;
53class CNode;
54class CScheduler;
55struct bilingual_str;
56
58static constexpr std::chrono::minutes TIMEOUT_INTERVAL{20};
60static constexpr auto FEELER_INTERVAL = 2min;
62static constexpr auto EXTRA_BLOCK_RELAY_ONLY_PEER_INTERVAL = 5min;
64static const unsigned int MAX_PROTOCOL_MESSAGE_LENGTH = 4 * 1000 * 1000;
66static const unsigned int MAX_SUBVERSION_LENGTH = 256;
70static const int MAX_ADDNODE_CONNECTIONS = 8;
74static const int MAX_FEELER_CONNECTIONS = 1;
76static const bool DEFAULT_LISTEN = true;
78static const unsigned int DEFAULT_MAX_PEER_CONNECTIONS = 125;
80static const std::string DEFAULT_MAX_UPLOAD_TARGET{"0M"};
82static const bool DEFAULT_BLOCKSONLY = false;
84static const int64_t DEFAULT_PEER_CONNECT_TIMEOUT = 60;
86static const int NUM_FDS_MESSAGE_CAPTURE = 1;
88static constexpr std::chrono::hours ASMAP_HEALTH_CHECK_INTERVAL{24};
89
90static constexpr bool DEFAULT_FORCEDNSSEED{false};
91static constexpr bool DEFAULT_DNSSEED{true};
92static constexpr bool DEFAULT_FIXEDSEEDS{true};
93static const size_t DEFAULT_MAXRECEIVEBUFFER = 5 * 1000;
94static const size_t DEFAULT_MAXSENDBUFFER = 1 * 1000;
95
96static constexpr bool DEFAULT_V2_TRANSPORT{true};
97
98typedef int64_t NodeId;
99
101 std::string m_added_node;
103};
104
110};
111
112class CNodeStats;
114
116 CSerializedNetMsg() = default;
119 // No implicit copying, only moves.
122
124 {
126 copy.data = data;
127 copy.m_type = m_type;
128 return copy;
129 }
130
131 std::vector<unsigned char> data;
132 std::string m_type;
133
135 size_t GetMemoryUsage() const noexcept;
136};
137
143void Discover();
144
145uint16_t GetListenPort();
146
147enum
148{
149 LOCAL_NONE, // unknown
150 LOCAL_IF, // address a local interface listens on
151 LOCAL_BIND, // address explicit bound to
152 LOCAL_MAPPED, // address reported by PCP
153 LOCAL_MANUAL, // address explicitly specified (-externalip=)
154
157
159std::optional<CService> GetLocalAddrForPeer(CNode& node);
160
161void ClearLocal();
162bool AddLocal(const CService& addr, int nScore = LOCAL_NONE);
163bool AddLocal(const CNetAddr& addr, int nScore = LOCAL_NONE);
164void RemoveLocal(const CService& addr);
165bool SeenLocal(const CService& addr);
166bool IsLocal(const CService& addr);
167CService GetLocalAddress(const CNode& peer);
168
169extern bool fDiscover;
170extern bool fListen;
171
173extern std::string strSubVersion;
174
177 uint16_t nPort;
178};
179
181extern std::map<CNetAddr, LocalServiceInfo> mapLocalHost GUARDED_BY(g_maplocalhost_mutex);
182
183extern const std::string NET_MESSAGE_TYPE_OTHER;
184using mapMsgTypeSize = std::map</* message type */ std::string, /* total bytes */ uint64_t>;
185
187{
188public:
190 std::chrono::seconds m_last_send;
191 std::chrono::seconds m_last_recv;
192 std::chrono::seconds m_last_tx_time;
193 std::chrono::seconds m_last_block_time;
194 std::chrono::seconds m_connected;
195 std::string m_addr_name;
197 std::string cleanSubVer;
199 // We requested high bandwidth connection to peer
201 // Peer requested high bandwidth connection
204 uint64_t nSendBytes;
206 uint64_t nRecvBytes;
209 std::chrono::microseconds m_last_ping_time;
210 std::chrono::microseconds m_min_ping_time;
211 // Our address, as reported by the peer
212 std::string addrLocal;
213 // Address of this peer
215 // Bind address of our side of the connection
217 // Network the peer connected through
219 uint32_t m_mapped_as;
224 std::string m_session_id;
225};
226
227
233{
234public:
236 std::chrono::microseconds m_time{0};
237 uint32_t m_message_size{0};
238 uint32_t m_raw_message_size{0};
239 std::string m_type;
240
241 explicit CNetMessage(DataStream&& recv_in) : m_recv(std::move(recv_in)) {}
242 // Only one CNetMessage object will exist for the same message on either
243 // the receive or processing queue. For performance reasons we therefore
244 // delete the copy constructor and assignment operator to avoid the
245 // possibility of copying CNetMessage objects.
247 CNetMessage(const CNetMessage&) = delete;
250
252 size_t GetMemoryUsage() const noexcept;
253};
254
257public:
258 virtual ~Transport() = default;
259
260 struct Info
261 {
263 std::optional<uint256> session_id;
264 };
265
267 virtual Info GetInfo() const noexcept = 0;
268
269 // 1. Receiver side functions, for decoding bytes received on the wire into transport protocol
270 // agnostic CNetMessage (message type & payload) objects.
271
273 virtual bool ReceivedMessageComplete() const = 0;
274
281 virtual bool ReceivedBytes(std::span<const uint8_t>& msg_bytes) = 0;
282
290 virtual CNetMessage GetReceivedMessage(std::chrono::microseconds time, bool& reject_message) = 0;
291
292 // 2. Sending side functions, for converting messages into bytes to be sent over the wire.
293
300 virtual bool SetMessageToSend(CSerializedNetMsg& msg) noexcept = 0;
301
309 using BytesToSend = std::tuple<
310 std::span<const uint8_t> /*to_send*/,
311 bool /*more*/,
312 const std::string& /*m_type*/
313 >;
314
350 virtual BytesToSend GetBytesToSend(bool have_next_message) const noexcept = 0;
351
358 virtual void MarkBytesSent(size_t bytes_sent) noexcept = 0;
359
361 virtual size_t GetSendMemoryUsage() const noexcept = 0;
362
363 // 3. Miscellaneous functions.
364
366 virtual bool ShouldReconnectV1() const noexcept = 0;
367};
368
369class V1Transport final : public Transport
370{
371private:
373 const NodeId m_node_id; // Only for logging
375 mutable CHash256 hasher GUARDED_BY(m_recv_mutex);
376 mutable uint256 data_hash GUARDED_BY(m_recv_mutex);
377 bool in_data GUARDED_BY(m_recv_mutex); // parsing header (false) or data (true)
378 DataStream hdrbuf GUARDED_BY(m_recv_mutex){}; // partially received header
379 CMessageHeader hdr GUARDED_BY(m_recv_mutex); // complete header
380 DataStream vRecv GUARDED_BY(m_recv_mutex){}; // received message data
381 unsigned int nHdrPos GUARDED_BY(m_recv_mutex);
382 unsigned int nDataPos GUARDED_BY(m_recv_mutex);
383
384 const uint256& GetMessageHash() const EXCLUSIVE_LOCKS_REQUIRED(m_recv_mutex);
385 int readHeader(std::span<const uint8_t> msg_bytes) EXCLUSIVE_LOCKS_REQUIRED(m_recv_mutex);
386 int readData(std::span<const uint8_t> msg_bytes) EXCLUSIVE_LOCKS_REQUIRED(m_recv_mutex);
387
388 void Reset() EXCLUSIVE_LOCKS_REQUIRED(m_recv_mutex) {
389 AssertLockHeld(m_recv_mutex);
390 vRecv.clear();
391 hdrbuf.clear();
392 hdrbuf.resize(24);
393 in_data = false;
394 nHdrPos = 0;
395 nDataPos = 0;
396 data_hash.SetNull();
397 hasher.Reset();
398 }
399
400 bool CompleteInternal() const noexcept EXCLUSIVE_LOCKS_REQUIRED(m_recv_mutex)
401 {
402 AssertLockHeld(m_recv_mutex);
403 if (!in_data) return false;
404 return hdr.nMessageSize == nDataPos;
405 }
406
410 std::vector<uint8_t> m_header_to_send GUARDED_BY(m_send_mutex);
412 CSerializedNetMsg m_message_to_send GUARDED_BY(m_send_mutex);
414 bool m_sending_header GUARDED_BY(m_send_mutex) {false};
416 size_t m_bytes_sent GUARDED_BY(m_send_mutex) {0};
417
418public:
419 explicit V1Transport(const NodeId node_id) noexcept;
420
421 bool ReceivedMessageComplete() const override EXCLUSIVE_LOCKS_REQUIRED(!m_recv_mutex)
422 {
423 AssertLockNotHeld(m_recv_mutex);
424 return WITH_LOCK(m_recv_mutex, return CompleteInternal());
425 }
426
427 Info GetInfo() const noexcept override;
428
429 bool ReceivedBytes(std::span<const uint8_t>& msg_bytes) override EXCLUSIVE_LOCKS_REQUIRED(!m_recv_mutex)
430 {
431 AssertLockNotHeld(m_recv_mutex);
432 LOCK(m_recv_mutex);
433 int ret = in_data ? readData(msg_bytes) : readHeader(msg_bytes);
434 if (ret < 0) {
435 Reset();
436 } else {
437 msg_bytes = msg_bytes.subspan(ret);
438 }
439 return ret >= 0;
440 }
441
442 CNetMessage GetReceivedMessage(std::chrono::microseconds time, bool& reject_message) override EXCLUSIVE_LOCKS_REQUIRED(!m_recv_mutex);
443
444 bool SetMessageToSend(CSerializedNetMsg& msg) noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_send_mutex);
445 BytesToSend GetBytesToSend(bool have_next_message) const noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_send_mutex);
446 void MarkBytesSent(size_t bytes_sent) noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_send_mutex);
447 size_t GetSendMemoryUsage() const noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_send_mutex);
448 bool ShouldReconnectV1() const noexcept override { return false; }
449};
450
451class V2Transport final : public Transport
452{
453private:
457 static constexpr std::array<std::byte, 0> VERSION_CONTENTS = {};
458
461 static constexpr size_t V1_PREFIX_LEN = 16;
462
463 // The sender side and receiver side of V2Transport are state machines that are transitioned
464 // through, based on what has been received. The receive state corresponds to the contents of,
465 // and bytes received to, the receive buffer. The send state controls what can be appended to
466 // the send buffer and what can be sent from it.
467
482 enum class RecvState : uint8_t {
488 KEY_MAYBE_V1,
489
495 KEY,
496
503 GARB_GARBTERM,
504
513 VERSION,
514
520 APP,
521
526 APP_READY,
527
531 V1,
532 };
533
547 enum class SendState : uint8_t {
554 MAYBE_V1,
555
561 AWAITING_KEY,
562
569 READY,
570
574 V1,
575 };
576
580 const bool m_initiating;
585
587 mutable Mutex m_recv_mutex ACQUIRED_BEFORE(m_send_mutex);
590 uint32_t m_recv_len GUARDED_BY(m_recv_mutex) {0};
592 std::vector<uint8_t> m_recv_buffer GUARDED_BY(m_recv_mutex);
594 std::vector<uint8_t> m_recv_aad GUARDED_BY(m_recv_mutex);
596 std::vector<uint8_t> m_recv_decode_buffer GUARDED_BY(m_recv_mutex);
598 RecvState m_recv_state GUARDED_BY(m_recv_mutex);
599
602 mutable Mutex m_send_mutex ACQUIRED_AFTER(m_recv_mutex);
604 std::vector<uint8_t> m_send_buffer GUARDED_BY(m_send_mutex);
606 uint32_t m_send_pos GUARDED_BY(m_send_mutex) {0};
608 std::vector<uint8_t> m_send_garbage GUARDED_BY(m_send_mutex);
610 std::string m_send_type GUARDED_BY(m_send_mutex);
612 SendState m_send_state GUARDED_BY(m_send_mutex);
614 bool m_sent_v1_header_worth GUARDED_BY(m_send_mutex) {false};
615
617 void SetReceiveState(RecvState recv_state) noexcept EXCLUSIVE_LOCKS_REQUIRED(m_recv_mutex);
619 void SetSendState(SendState send_state) noexcept EXCLUSIVE_LOCKS_REQUIRED(m_send_mutex);
621 static std::optional<std::string> GetMessageType(std::span<const uint8_t>& contents) noexcept;
623 size_t GetMaxBytesToProcess() noexcept EXCLUSIVE_LOCKS_REQUIRED(m_recv_mutex);
625 void StartSendingHandshake() noexcept EXCLUSIVE_LOCKS_REQUIRED(m_send_mutex);
627 void ProcessReceivedMaybeV1Bytes() noexcept EXCLUSIVE_LOCKS_REQUIRED(m_recv_mutex, !m_send_mutex);
629 bool ProcessReceivedKeyBytes() noexcept EXCLUSIVE_LOCKS_REQUIRED(m_recv_mutex, !m_send_mutex);
631 bool ProcessReceivedGarbageBytes() noexcept EXCLUSIVE_LOCKS_REQUIRED(m_recv_mutex);
633 bool ProcessReceivedPacketBytes() noexcept EXCLUSIVE_LOCKS_REQUIRED(m_recv_mutex);
634
635public:
636 static constexpr uint32_t MAX_GARBAGE_LEN = 4095;
637
643 V2Transport(NodeId nodeid, bool initiating) noexcept;
644
646 V2Transport(NodeId nodeid, bool initiating, const CKey& key, std::span<const std::byte> ent32, std::vector<uint8_t> garbage) noexcept;
647
648 // Receive side functions.
649 bool ReceivedMessageComplete() const noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_recv_mutex);
650 bool ReceivedBytes(std::span<const uint8_t>& msg_bytes) noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_recv_mutex, !m_send_mutex);
651 CNetMessage GetReceivedMessage(std::chrono::microseconds time, bool& reject_message) noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_recv_mutex);
652
653 // Send side functions.
654 bool SetMessageToSend(CSerializedNetMsg& msg) noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_send_mutex);
655 BytesToSend GetBytesToSend(bool have_next_message) const noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_send_mutex);
656 void MarkBytesSent(size_t bytes_sent) noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_send_mutex);
657 size_t GetSendMemoryUsage() const noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_send_mutex);
658
659 // Miscellaneous functions.
660 bool ShouldReconnectV1() const noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_recv_mutex, !m_send_mutex);
661 Info GetInfo() const noexcept override EXCLUSIVE_LOCKS_REQUIRED(!m_recv_mutex);
662};
663
665{
667 std::unique_ptr<i2p::sam::Session> i2p_sam_session = nullptr;
668 bool prefer_evict = false;
669 size_t recv_flood_size{DEFAULT_MAXRECEIVEBUFFER * 1000};
670 bool use_v2transport = false;
671};
672
674class CNode
675{
676public:
679 const std::unique_ptr<Transport> m_transport;
680
682
691 std::shared_ptr<Sock> m_sock GUARDED_BY(m_sock_mutex);
692
694 size_t m_send_memusage GUARDED_BY(cs_vSend){0};
696 uint64_t nSendBytes GUARDED_BY(cs_vSend){0};
698 std::deque<CSerializedNetMsg> vSendMsg GUARDED_BY(cs_vSend);
702
703 uint64_t nRecvBytes GUARDED_BY(cs_vRecv){0};
704
705 std::atomic<std::chrono::seconds> m_last_send{0s};
706 std::atomic<std::chrono::seconds> m_last_recv{0s};
708 const std::chrono::seconds m_connected;
709 // Address of this peer
711 // Bind address of our side of the connection
713 const std::string m_addr_name;
715 const std::string m_dest;
717 const bool m_inbound_onion;
718 std::atomic<int> nVersion{0};
724 std::string cleanSubVer GUARDED_BY(m_subver_mutex){};
725 const bool m_prefer_evict{false}; // This peer is preferred for eviction.
726 bool HasPermission(NetPermissionFlags permission) const {
727 return NetPermissions::HasFlag(m_permission_flags, permission);
728 }
730 std::atomic_bool fSuccessfullyConnected{false};
731 // Setting fDisconnect to true will cause the node to be disconnected the
732 // next time DisconnectNodes() runs
733 std::atomic_bool fDisconnect{false};
735 std::atomic<int> nRefCount{0};
736
737 const uint64_t nKeyedNetGroup;
738 std::atomic_bool fPauseRecv{false};
739 std::atomic_bool fPauseSend{false};
740
742
744 void MarkReceivedMsgsForProcessing()
745 EXCLUSIVE_LOCKS_REQUIRED(!m_msg_process_queue_mutex);
746
752 std::optional<std::pair<CNetMessage, bool>> PollMessage()
753 EXCLUSIVE_LOCKS_REQUIRED(!m_msg_process_queue_mutex);
754
756 void AccountForSentBytes(const std::string& msg_type, size_t sent_bytes)
758 {
759 mapSendBytesPerMsgType[msg_type] += sent_bytes;
760 }
761
763 switch (m_conn_type) {
766 return true;
771 return false;
772 } // no default case, so the compiler can warn about missing cases
773
774 assert(false);
775 }
776
777 bool IsFullOutboundConn() const {
778 return m_conn_type == ConnectionType::OUTBOUND_FULL_RELAY;
779 }
780
781 bool IsManualConn() const {
782 return m_conn_type == ConnectionType::MANUAL;
783 }
784
786 {
787 switch (m_conn_type) {
792 return false;
795 return true;
796 } // no default case, so the compiler can warn about missing cases
797
798 assert(false);
799 }
800
801 bool IsBlockOnlyConn() const {
802 return m_conn_type == ConnectionType::BLOCK_RELAY;
803 }
804
805 bool IsFeelerConn() const {
806 return m_conn_type == ConnectionType::FEELER;
807 }
808
809 bool IsAddrFetchConn() const {
810 return m_conn_type == ConnectionType::ADDR_FETCH;
811 }
812
813 bool IsInboundConn() const {
814 return m_conn_type == ConnectionType::INBOUND;
815 }
816
818 switch (m_conn_type) {
822 return false;
826 return true;
827 } // no default case, so the compiler can warn about missing cases
828
829 assert(false);
830 }
831
842 Network ConnectedThroughNetwork() const;
843
845 [[nodiscard]] bool IsConnectedThroughPrivacyNet() const;
846
847 // We selected peer as (compact blocks) high-bandwidth peer (BIP152)
848 std::atomic<bool> m_bip152_highbandwidth_to{false};
849 // Peer selected us as (compact blocks) high-bandwidth peer (BIP152)
850 std::atomic<bool> m_bip152_highbandwidth_from{false};
851
853 std::atomic_bool m_has_all_wanted_services{false};
854
857 std::atomic_bool m_relays_txs{false};
858
861 std::atomic_bool m_bloom_filter_loaded{false};
862
868 std::atomic<std::chrono::seconds> m_last_block_time{0s};
869
874 std::atomic<std::chrono::seconds> m_last_tx_time{0s};
875
877 std::atomic<std::chrono::microseconds> m_last_ping_time{0us};
878
881 std::atomic<std::chrono::microseconds> m_min_ping_time{std::chrono::microseconds::max()};
882
883 CNode(NodeId id,
884 std::shared_ptr<Sock> sock,
885 const CAddress& addrIn,
886 uint64_t nKeyedNetGroupIn,
887 uint64_t nLocalHostNonceIn,
888 const CService& addrBindIn,
889 const std::string& addrNameIn,
890 ConnectionType conn_type_in,
891 bool inbound_onion,
892 CNodeOptions&& node_opts = {});
893 CNode(const CNode&) = delete;
894 CNode& operator=(const CNode&) = delete;
895
896 NodeId GetId() const {
897 return id;
898 }
899
900 uint64_t GetLocalNonce() const {
901 return nLocalHostNonce;
902 }
903
904 int GetRefCount() const
905 {
906 assert(nRefCount >= 0);
907 return nRefCount;
908 }
909
919 bool ReceiveMsgBytes(std::span<const uint8_t> msg_bytes, bool& complete) EXCLUSIVE_LOCKS_REQUIRED(!cs_vRecv);
920
921 void SetCommonVersion(int greatest_common_version)
922 {
923 Assume(m_greatest_common_version == INIT_PROTO_VERSION);
924 m_greatest_common_version = greatest_common_version;
925 }
927 {
928 return m_greatest_common_version;
929 }
930
931 CService GetAddrLocal() const EXCLUSIVE_LOCKS_REQUIRED(!m_addr_local_mutex);
933 void SetAddrLocal(const CService& addrLocalIn) EXCLUSIVE_LOCKS_REQUIRED(!m_addr_local_mutex);
934
935 CNode* AddRef()
936 {
937 nRefCount++;
938 return this;
939 }
940
941 void Release()
942 {
943 nRefCount--;
944 }
945
946 void CloseSocketDisconnect() EXCLUSIVE_LOCKS_REQUIRED(!m_sock_mutex);
947
948 void CopyStats(CNodeStats& stats) EXCLUSIVE_LOCKS_REQUIRED(!m_subver_mutex, !m_addr_local_mutex, !cs_vSend, !cs_vRecv);
949
951
958 std::string LogIP(bool log_ip) const;
959
966 std::string DisconnectMsg(bool log_ip) const;
967
969 void PongReceived(std::chrono::microseconds ping_time) {
970 m_last_ping_time = ping_time;
971 m_min_ping_time = std::min(m_min_ping_time.load(), ping_time);
972 }
973
974private:
975 const NodeId id;
976 const uint64_t nLocalHostNonce;
977 std::atomic<int> m_greatest_common_version{INIT_PROTO_VERSION};
978
979 const size_t m_recv_flood_size;
980 std::list<CNetMessage> vRecvMsg; // Used only by SocketHandler thread
981
983 std::list<CNetMessage> m_msg_process_queue GUARDED_BY(m_msg_process_queue_mutex);
984 size_t m_msg_process_queue_size GUARDED_BY(m_msg_process_queue_mutex){0};
985
986 // Our address, as reported by the peer
987 CService m_addr_local GUARDED_BY(m_addr_local_mutex);
989
990 mapMsgTypeSize mapSendBytesPerMsgType GUARDED_BY(cs_vSend);
991 mapMsgTypeSize mapRecvBytesPerMsgType GUARDED_BY(cs_vRecv);
992
1003 std::unique_ptr<i2p::sam::Session> m_i2p_sam_session GUARDED_BY(m_sock_mutex);
1004};
1005
1010{
1011public:
1014
1016 virtual void InitializeNode(const CNode& node, ServiceFlags our_services) = 0;
1017
1019 virtual void FinalizeNode(const CNode& node) = 0;
1020
1025 virtual bool HasAllDesirableServiceFlags(ServiceFlags services) const = 0;
1026
1034 virtual bool ProcessMessages(CNode* pnode, std::atomic<bool>& interrupt) EXCLUSIVE_LOCKS_REQUIRED(g_msgproc_mutex) = 0;
1035
1042 virtual bool SendMessages(CNode* pnode) EXCLUSIVE_LOCKS_REQUIRED(g_msgproc_mutex) = 0;
1043
1044
1045protected:
1051};
1052
1054{
1055public:
1056
1057 struct Options
1058 {
1059 ServiceFlags m_local_services = NODE_NONE;
1060 int m_max_automatic_connections = 0;
1062 NetEventsInterface* m_msgproc = nullptr;
1063 BanMan* m_banman = nullptr;
1064 unsigned int nSendBufferMaxSize = 0;
1065 unsigned int nReceiveFloodSize = 0;
1066 uint64_t nMaxOutboundLimit = 0;
1067 int64_t m_peer_connect_timeout = DEFAULT_PEER_CONNECT_TIMEOUT;
1068 std::vector<std::string> vSeedNodes;
1069 std::vector<NetWhitelistPermissions> vWhitelistedRangeIncoming;
1070 std::vector<NetWhitelistPermissions> vWhitelistedRangeOutgoing;
1071 std::vector<NetWhitebindPermissions> vWhiteBinds;
1072 std::vector<CService> vBinds;
1073 std::vector<CService> onion_binds;
1077 bool m_use_addrman_outgoing = true;
1078 std::vector<std::string> m_specified_outgoing;
1079 std::vector<std::string> m_added_nodes;
1081 bool whitelist_forcerelay = DEFAULT_WHITELISTFORCERELAY;
1082 bool whitelist_relay = DEFAULT_WHITELISTRELAY;
1083 };
1084
1085 void Init(const Options& connOptions) EXCLUSIVE_LOCKS_REQUIRED(!m_added_nodes_mutex, !m_total_bytes_sent_mutex)
1086 {
1087 AssertLockNotHeld(m_total_bytes_sent_mutex);
1088
1089 m_local_services = connOptions.m_local_services;
1090 m_max_automatic_connections = connOptions.m_max_automatic_connections;
1091 m_max_outbound_full_relay = std::min(MAX_OUTBOUND_FULL_RELAY_CONNECTIONS, m_max_automatic_connections);
1092 m_max_outbound_block_relay = std::min(MAX_BLOCK_RELAY_ONLY_CONNECTIONS, m_max_automatic_connections - m_max_outbound_full_relay);
1093 m_max_automatic_outbound = m_max_outbound_full_relay + m_max_outbound_block_relay + m_max_feeler;
1094 m_max_inbound = std::max(0, m_max_automatic_connections - m_max_automatic_outbound);
1095 m_use_addrman_outgoing = connOptions.m_use_addrman_outgoing;
1096 m_client_interface = connOptions.uiInterface;
1097 m_banman = connOptions.m_banman;
1098 m_msgproc = connOptions.m_msgproc;
1099 nSendBufferMaxSize = connOptions.nSendBufferMaxSize;
1100 nReceiveFloodSize = connOptions.nReceiveFloodSize;
1101 m_peer_connect_timeout = std::chrono::seconds{connOptions.m_peer_connect_timeout};
1102 {
1103 LOCK(m_total_bytes_sent_mutex);
1104 nMaxOutboundLimit = connOptions.nMaxOutboundLimit;
1105 }
1106 vWhitelistedRangeIncoming = connOptions.vWhitelistedRangeIncoming;
1107 vWhitelistedRangeOutgoing = connOptions.vWhitelistedRangeOutgoing;
1108 {
1109 LOCK(m_added_nodes_mutex);
1110 // Attempt v2 connection if we support v2 - we'll reconnect with v1 if our
1111 // peer doesn't support it or immediately disconnects us for another reason.
1112 const bool use_v2transport(GetLocalServices() & NODE_P2P_V2);
1113 for (const std::string& added_node : connOptions.m_added_nodes) {
1114 m_added_node_params.push_back({added_node, use_v2transport});
1115 }
1116 }
1117 m_onion_binds = connOptions.onion_binds;
1118 whitelist_forcerelay = connOptions.whitelist_forcerelay;
1119 whitelist_relay = connOptions.whitelist_relay;
1120 }
1121
1122 CConnman(uint64_t seed0, uint64_t seed1, AddrMan& addrman, const NetGroupManager& netgroupman,
1123 const CChainParams& params, bool network_active = true);
1124
1125 ~CConnman();
1126
1127 bool Start(CScheduler& scheduler, const Options& options) EXCLUSIVE_LOCKS_REQUIRED(!m_total_bytes_sent_mutex, !m_added_nodes_mutex, !m_addr_fetches_mutex, !mutexMsgProc);
1128
1129 void StopThreads();
1130 void StopNodes();
1131 void Stop()
1132 {
1133 StopThreads();
1134 StopNodes();
1135 };
1136
1137 void Interrupt() EXCLUSIVE_LOCKS_REQUIRED(!mutexMsgProc);
1138 bool GetNetworkActive() const { return fNetworkActive; };
1139 bool GetUseAddrmanOutgoing() const { return m_use_addrman_outgoing; };
1140 void SetNetworkActive(bool active);
1141 void OpenNetworkConnection(const CAddress& addrConnect, bool fCountFailure, CountingSemaphoreGrant<>&& grant_outbound, const char* strDest, ConnectionType conn_type, bool use_v2transport) EXCLUSIVE_LOCKS_REQUIRED(!m_unused_i2p_sessions_mutex);
1142 bool CheckIncomingNonce(uint64_t nonce);
1143 void ASMapHealthCheck();
1144
1145 // alias for thread safety annotations only, not defined
1147
1148 bool ForNode(NodeId id, std::function<bool(CNode* pnode)> func);
1149
1150 void PushMessage(CNode* pnode, CSerializedNetMsg&& msg) EXCLUSIVE_LOCKS_REQUIRED(!m_total_bytes_sent_mutex);
1151
1152 using NodeFn = std::function<void(CNode*)>;
1153 void ForEachNode(const NodeFn& func)
1154 {
1155 LOCK(m_nodes_mutex);
1156 for (auto&& node : m_nodes) {
1157 if (NodeFullyConnected(node))
1158 func(node);
1159 }
1160 };
1161
1162 void ForEachNode(const NodeFn& func) const
1163 {
1164 LOCK(m_nodes_mutex);
1165 for (auto&& node : m_nodes) {
1166 if (NodeFullyConnected(node))
1167 func(node);
1168 }
1169 };
1170
1171 // Addrman functions
1183 std::vector<CAddress> GetAddressesUnsafe(size_t max_addresses, size_t max_pct, std::optional<Network> network, const bool filtered = true) const;
1198 std::vector<CAddress> GetAddresses(CNode& requestor, size_t max_addresses, size_t max_pct);
1199
1200 // This allows temporarily exceeding m_max_outbound_full_relay, with the goal of finding
1201 // a peer that is better than all our current peers.
1202 void SetTryNewOutboundPeer(bool flag);
1203 bool GetTryNewOutboundPeer() const;
1204
1205 void StartExtraBlockRelayPeers();
1206
1207 // Count the number of full-relay peer we have.
1208 int GetFullOutboundConnCount() const;
1209 // Return the number of outbound peers we have in excess of our target (eg,
1210 // if we previously called SetTryNewOutboundPeer(true), and have since set
1211 // to false, we may have extra peers that we wish to disconnect). This may
1212 // return a value less than (num_outbound_connections - num_outbound_slots)
1213 // in cases where some outbound connections are not yet fully connected, or
1214 // not yet fully disconnected.
1215 int GetExtraFullOutboundCount() const;
1216 // Count the number of block-relay-only peers we have over our limit.
1217 int GetExtraBlockRelayCount() const;
1218
1219 bool AddNode(const AddedNodeParams& add) EXCLUSIVE_LOCKS_REQUIRED(!m_added_nodes_mutex);
1220 bool RemoveAddedNode(const std::string& node) EXCLUSIVE_LOCKS_REQUIRED(!m_added_nodes_mutex);
1221 bool AddedNodesContain(const CAddress& addr) const EXCLUSIVE_LOCKS_REQUIRED(!m_added_nodes_mutex);
1222 std::vector<AddedNodeInfo> GetAddedNodeInfo(bool include_connected) const EXCLUSIVE_LOCKS_REQUIRED(!m_added_nodes_mutex);
1223
1237 bool AddConnection(const std::string& address, ConnectionType conn_type, bool use_v2transport) EXCLUSIVE_LOCKS_REQUIRED(!m_unused_i2p_sessions_mutex);
1238
1239 size_t GetNodeCount(ConnectionDirection) const;
1240 std::map<CNetAddr, LocalServiceInfo> getNetLocalAddresses() const;
1241 uint32_t GetMappedAS(const CNetAddr& addr) const;
1242 void GetNodeStats(std::vector<CNodeStats>& vstats) const;
1243 bool DisconnectNode(const std::string& node);
1244 bool DisconnectNode(const CSubNet& subnet);
1245 bool DisconnectNode(const CNetAddr& addr);
1246 bool DisconnectNode(NodeId id);
1247
1254 ServiceFlags GetLocalServices() const;
1255
1258 void AddLocalServices(ServiceFlags services) { m_local_services = ServiceFlags(m_local_services | services); };
1259 void RemoveLocalServices(ServiceFlags services) { m_local_services = ServiceFlags(m_local_services & ~services); }
1260
1261 uint64_t GetMaxOutboundTarget() const EXCLUSIVE_LOCKS_REQUIRED(!m_total_bytes_sent_mutex);
1262 std::chrono::seconds GetMaxOutboundTimeframe() const;
1263
1267 bool OutboundTargetReached(bool historicalBlockServingLimit) const EXCLUSIVE_LOCKS_REQUIRED(!m_total_bytes_sent_mutex);
1268
1271 uint64_t GetOutboundTargetBytesLeft() const EXCLUSIVE_LOCKS_REQUIRED(!m_total_bytes_sent_mutex);
1272
1273 std::chrono::seconds GetMaxOutboundTimeLeftInCycle() const EXCLUSIVE_LOCKS_REQUIRED(!m_total_bytes_sent_mutex);
1274
1275 uint64_t GetTotalBytesRecv() const;
1276 uint64_t GetTotalBytesSent() const EXCLUSIVE_LOCKS_REQUIRED(!m_total_bytes_sent_mutex);
1277
1279 CSipHasher GetDeterministicRandomizer(uint64_t id) const;
1280
1281 void WakeMessageHandler() EXCLUSIVE_LOCKS_REQUIRED(!mutexMsgProc);
1282
1284 bool ShouldRunInactivityChecks(const CNode& node, std::chrono::seconds now) const;
1285
1286 bool MultipleManualOrFullOutboundConns(Network net) const EXCLUSIVE_LOCKS_REQUIRED(m_nodes_mutex);
1287
1288private:
1290 public:
1291 std::shared_ptr<Sock> sock;
1293 ListenSocket(std::shared_ptr<Sock> sock_, NetPermissionFlags permissions_)
1294 : sock{sock_}, m_permissions{permissions_}
1295 {
1296 }
1297
1298 private:
1300 };
1301
1304 std::chrono::seconds GetMaxOutboundTimeLeftInCycle_() const EXCLUSIVE_LOCKS_REQUIRED(m_total_bytes_sent_mutex);
1305
1306 bool BindListenPort(const CService& bindAddr, bilingual_str& strError, NetPermissionFlags permissions);
1307 bool Bind(const CService& addr, unsigned int flags, NetPermissionFlags permissions);
1308 bool InitBinds(const Options& options);
1309
1310 void ThreadOpenAddedConnections() EXCLUSIVE_LOCKS_REQUIRED(!m_added_nodes_mutex, !m_unused_i2p_sessions_mutex, !m_reconnections_mutex);
1311 void AddAddrFetch(const std::string& strDest) EXCLUSIVE_LOCKS_REQUIRED(!m_addr_fetches_mutex);
1312 void ProcessAddrFetch() EXCLUSIVE_LOCKS_REQUIRED(!m_addr_fetches_mutex, !m_unused_i2p_sessions_mutex);
1313 void ThreadOpenConnections(std::vector<std::string> connect, std::span<const std::string> seed_nodes) EXCLUSIVE_LOCKS_REQUIRED(!m_addr_fetches_mutex, !m_added_nodes_mutex, !m_nodes_mutex, !m_unused_i2p_sessions_mutex, !m_reconnections_mutex);
1314 void ThreadMessageHandler() EXCLUSIVE_LOCKS_REQUIRED(!mutexMsgProc);
1315 void ThreadI2PAcceptIncoming();
1316 void AcceptConnection(const ListenSocket& hListenSocket);
1317
1326 void CreateNodeFromAcceptedSocket(std::unique_ptr<Sock>&& sock,
1327 NetPermissionFlags permission_flags,
1328 const CService& addr_bind,
1329 const CService& addr);
1330
1331 void DisconnectNodes() EXCLUSIVE_LOCKS_REQUIRED(!m_reconnections_mutex, !m_nodes_mutex);
1332 void NotifyNumConnectionsChanged();
1334 bool InactivityCheck(const CNode& node) const;
1335
1341 Sock::EventsPerSock GenerateWaitSockets(std::span<CNode* const> nodes);
1342
1346 void SocketHandler() EXCLUSIVE_LOCKS_REQUIRED(!m_total_bytes_sent_mutex, !mutexMsgProc);
1347
1353 void SocketHandlerConnected(const std::vector<CNode*>& nodes,
1354 const Sock::EventsPerSock& events_per_sock)
1355 EXCLUSIVE_LOCKS_REQUIRED(!m_total_bytes_sent_mutex, !mutexMsgProc);
1356
1361 void SocketHandlerListening(const Sock::EventsPerSock& events_per_sock);
1362
1363 void ThreadSocketHandler() EXCLUSIVE_LOCKS_REQUIRED(!m_total_bytes_sent_mutex, !mutexMsgProc, !m_nodes_mutex, !m_reconnections_mutex);
1364 void ThreadDNSAddressSeed() EXCLUSIVE_LOCKS_REQUIRED(!m_addr_fetches_mutex, !m_nodes_mutex);
1365
1366 uint64_t CalculateKeyedNetGroup(const CNetAddr& ad) const;
1367
1368 CNode* FindNode(const CNetAddr& ip);
1369 CNode* FindNode(const std::string& addrName);
1370 CNode* FindNode(const CService& addr);
1371
1376 bool AlreadyConnectedToAddress(const CAddress& addr);
1377
1378 bool AttemptToEvictConnection();
1379 CNode* ConnectNode(CAddress addrConnect, const char *pszDest, bool fCountFailure, ConnectionType conn_type, bool use_v2transport) EXCLUSIVE_LOCKS_REQUIRED(!m_unused_i2p_sessions_mutex);
1380 void AddWhitelistPermissionFlags(NetPermissionFlags& flags, const CNetAddr &addr, const std::vector<NetWhitelistPermissions>& ranges) const;
1381
1382 void DeleteNode(CNode* pnode);
1383
1384 NodeId GetNewNodeId();
1385
1387 std::pair<size_t, bool> SocketSendData(CNode& node) const EXCLUSIVE_LOCKS_REQUIRED(node.cs_vSend);
1388
1389 void DumpAddresses();
1390
1391 // Network stats
1392 void RecordBytesRecv(uint64_t bytes);
1393 void RecordBytesSent(uint64_t bytes) EXCLUSIVE_LOCKS_REQUIRED(!m_total_bytes_sent_mutex);
1394
1399 std::unordered_set<Network> GetReachableEmptyNetworks() const;
1400
1404 std::vector<CAddress> GetCurrentBlockRelayOnlyConns() const;
1405
1416 bool MaybePickPreferredNetwork(std::optional<Network>& network);
1417
1418 // Whether the node should be passed out in ForEach* callbacks
1419 static bool NodeFullyConnected(const CNode* pnode);
1420
1421 uint16_t GetDefaultPort(Network net) const;
1422 uint16_t GetDefaultPort(const std::string& addr) const;
1423
1424 // Network usage totals
1425 mutable Mutex m_total_bytes_sent_mutex;
1426 std::atomic<uint64_t> nTotalBytesRecv{0};
1427 uint64_t nTotalBytesSent GUARDED_BY(m_total_bytes_sent_mutex) {0};
1428
1429 // outbound limit & stats
1430 uint64_t nMaxOutboundTotalBytesSentInCycle GUARDED_BY(m_total_bytes_sent_mutex) {0};
1431 std::chrono::seconds nMaxOutboundCycleStartTime GUARDED_BY(m_total_bytes_sent_mutex) {0};
1432 uint64_t nMaxOutboundLimit GUARDED_BY(m_total_bytes_sent_mutex);
1433
1434 // P2P timeout in seconds
1435 std::chrono::seconds m_peer_connect_timeout;
1436
1437 // Whitelisted ranges. Any node connecting from these is automatically
1438 // whitelisted (as well as those connecting to whitelisted binds).
1439 std::vector<NetWhitelistPermissions> vWhitelistedRangeIncoming;
1440 // Whitelisted ranges for outgoing connections.
1441 std::vector<NetWhitelistPermissions> vWhitelistedRangeOutgoing;
1442
1443 unsigned int nSendBufferMaxSize{0};
1444 unsigned int nReceiveFloodSize{0};
1445
1446 std::vector<ListenSocket> vhListenSocket;
1447 std::atomic<bool> fNetworkActive{true};
1448 bool fAddressesInitialized{false};
1451 std::deque<std::string> m_addr_fetches GUARDED_BY(m_addr_fetches_mutex);
1453
1454 // connection string and whether to use v2 p2p
1455 std::vector<AddedNodeParams> m_added_node_params GUARDED_BY(m_added_nodes_mutex);
1456
1458 std::vector<CNode*> m_nodes GUARDED_BY(m_nodes_mutex);
1459 std::list<CNode*> m_nodes_disconnected;
1461 std::atomic<NodeId> nLastNodeId{0};
1462 unsigned int nPrevNodeCount{0};
1463
1464 // Stores number of full-tx connections (outbound and manual) per network
1465 std::array<unsigned int, Network::NET_MAX> m_network_conn_counts GUARDED_BY(m_nodes_mutex) = {};
1466
1474 std::vector<CAddress> m_addrs_response_cache;
1475 std::chrono::microseconds m_cache_entry_expiration{0};
1476 };
1477
1492 std::map<uint64_t, CachedAddrResponse> m_addr_response_caches;
1493
1505 std::atomic<ServiceFlags> m_local_services;
1506
1507 std::unique_ptr<std::counting_semaphore<>> semOutbound;
1508 std::unique_ptr<std::counting_semaphore<>> semAddnode;
1509
1516
1517 /*
1518 * Maximum number of peers by connection type. Might vary from defaults
1519 * based on -maxconnections init value.
1520 */
1521
1522 // How many full-relay (tx, block, addr) outbound peers we want
1524
1525 // How many block-relay only outbound peers we want
1526 // We do not relay tx or addr messages with these peers
1528
1529 int m_max_addnode{MAX_ADDNODE_CONNECTIONS};
1530 int m_max_feeler{MAX_FEELER_CONNECTIONS};
1533
1539
1544 std::vector<CAddress> m_anchors;
1545
1547 const uint64_t nSeed0, nSeed1;
1548
1550 bool fMsgProcWake GUARDED_BY(mutexMsgProc);
1551
1552 std::condition_variable condMsgProc;
1554 std::atomic<bool> flagInterruptMsgProc{false};
1555
1563
1569 std::unique_ptr<i2p::sam::Session> m_i2p_sam_session;
1570
1577
1582
1587 std::atomic_bool m_start_extra_block_relay_peers{false};
1588
1593 std::vector<CService> m_onion_binds;
1594
1600
1606
1611
1619 std::queue<std::unique_ptr<i2p::sam::Session>> m_unused_i2p_sessions GUARDED_BY(m_unused_i2p_sessions_mutex);
1620
1625
1628 {
1631 std::string destination;
1634 };
1635
1639 std::list<ReconnectionInfo> m_reconnections GUARDED_BY(m_reconnections_mutex);
1640
1642 void PerformReconnections() EXCLUSIVE_LOCKS_REQUIRED(!m_reconnections_mutex, !m_unused_i2p_sessions_mutex);
1643
1648 static constexpr size_t MAX_UNUSED_I2P_SESSIONS_SIZE{10};
1649
1655 {
1656 public:
1657 explicit NodesSnapshot(const CConnman& connman, bool shuffle)
1658 {
1659 {
1660 LOCK(connman.m_nodes_mutex);
1661 m_nodes_copy = connman.m_nodes;
1662 for (auto& node : m_nodes_copy) {
1663 node->AddRef();
1664 }
1665 }
1666 if (shuffle) {
1667 std::shuffle(m_nodes_copy.begin(), m_nodes_copy.end(), FastRandomContext{});
1668 }
1669 }
1670
1672 {
1673 for (auto& node : m_nodes_copy) {
1674 node->Release();
1675 }
1676 }
1677
1678 const std::vector<CNode*>& Nodes() const
1679 {
1680 return m_nodes_copy;
1681 }
1682
1683 private:
1684 std::vector<CNode*> m_nodes_copy;
1685 };
1686
1688
1689 friend struct ConnmanTestMsg;
1690};
1691
1693extern std::function<void(const CAddress& addr,
1694 const std::string& msg_type,
1695 std::span<const unsigned char> data,
1696 bool is_incoming)>
1698
1699#endif // BITCOIN_NET_H
int ret
int flags
Definition: bitcoin-tx.cpp:529
Interrupt(node)
#define Assume(val)
Assume is the identity function.
Definition: check.h:118
Stochastic address manager.
Definition: addrman.h:89
The BIP324 packet cipher, encapsulating its key derivation, stream cipher, and AEAD.
Definition: bip324.h:20
Definition: banman.h:64
A CService with information about it as peer.
Definition: protocol.h:367
CChainParams defines various tweakable parameters of a given instance of the Bitcoin system.
Definition: chainparams.h:69
Signals for UI communication.
Definition: interface_ui.h:26
RAII helper to atomically create a copy of m_nodes and add a reference to each of the nodes.
Definition: net.h:1655
const std::vector< CNode * > & Nodes() const
Definition: net.h:1678
NodesSnapshot(const CConnman &connman, bool shuffle)
Definition: net.h:1657
std::vector< CNode * > m_nodes_copy
Definition: net.h:1684
Definition: net.h:1054
bool whitelist_relay
flag for adding 'relay' permission to whitelisted inbound and manual peers with default permissions.
Definition: net.h:1605
std::condition_variable condMsgProc
Definition: net.h:1552
std::thread threadMessageHandler
Definition: net.h:1575
void RemoveLocalServices(ServiceFlags services)
Definition: net.h:1259
std::vector< NetWhitelistPermissions > vWhitelistedRangeIncoming
Definition: net.h:1439
CClientUIInterface * m_client_interface
Definition: net.h:1535
void ForEachNode(const NodeFn &func) const
Definition: net.h:1162
std::vector< AddedNodeParams > m_added_node_params GUARDED_BY(m_added_nodes_mutex)
int m_max_inbound
Definition: net.h:1532
const bool use_v2transport(GetLocalServices() &NODE_P2P_V2)
void Stop()
Definition: net.h:1131
int m_max_outbound_block_relay
Definition: net.h:1527
std::array< unsigned int, Network::NET_MAX > m_network_conn_counts GUARDED_BY(m_nodes_mutex)
std::thread threadI2PAcceptIncoming
Definition: net.h:1576
std::list< ReconnectionInfo > m_reconnections GUARDED_BY(m_reconnections_mutex)
List of reconnections we have to make.
int m_max_automatic_outbound
Definition: net.h:1531
uint64_t nMaxOutboundLimit GUARDED_BY(m_total_bytes_sent_mutex)
CThreadInterrupt interruptNet
This is signaled when network activity should cease.
Definition: net.h:1562
bool fMsgProcWake GUARDED_BY(mutexMsgProc)
flag for waking the message processor.
int m_max_automatic_connections
Maximum number of automatic connections permitted, excluding manual connections but including inbound...
Definition: net.h:1515
BanMan * m_banman
Pointer to this node's banman.
Definition: net.h:1538
uint64_t nMaxOutboundTotalBytesSentInCycle GUARDED_BY(m_total_bytes_sent_mutex)
Definition: net.h:1430
std::thread threadDNSAddressSeed
Definition: net.h:1571
const NetGroupManager & m_netgroupman
Definition: net.h:1450
std::vector< CAddress > m_anchors
Addresses that were saved during the previous clean shutdown.
Definition: net.h:1544
bool whitelist_forcerelay
flag for adding 'forcerelay' permission to whitelisted inbound and manual peers with default permissi...
Definition: net.h:1599
std::chrono::seconds m_peer_connect_timeout
Definition: net.h:1435
std::atomic_bool m_try_another_outbound_peer
flag for deciding to connect to an extra outbound peer, in excess of m_max_outbound_full_relay This t...
Definition: net.h:1581
std::vector< ListenSocket > vhListenSocket
Definition: net.h:1446
std::thread threadOpenConnections
Definition: net.h:1574
std::atomic< ServiceFlags > m_local_services
Services this node offers.
Definition: net.h:1505
Mutex m_addr_fetches_mutex
Definition: net.h:1452
Mutex m_reconnections_mutex
Mutex protecting m_reconnections.
Definition: net.h:1624
const uint64_t nSeed0
SipHasher seeds for deterministic randomness.
Definition: net.h:1547
RecursiveMutex m_nodes_mutex
Definition: net.h:1460
std::queue< std::unique_ptr< i2p::sam::Session > > m_unused_i2p_sessions GUARDED_BY(m_unused_i2p_sessions_mutex)
A pool of created I2P SAM transient sessions that should be used instead of creating new ones in orde...
std::unique_ptr< std::counting_semaphore<> > semOutbound
Definition: net.h:1507
const CChainParams & m_params
Definition: net.h:1687
std::deque< std::string > m_addr_fetches GUARDED_BY(m_addr_fetches_mutex)
void AddLocalServices(ServiceFlags services)
Updates the local services that this node advertises to other peers during connection handshake.
Definition: net.h:1258
AddrMan & addrman
Definition: net.h:1449
Mutex mutexMsgProc
Definition: net.h:1553
std::thread threadOpenAddedConnections
Definition: net.h:1573
Mutex m_added_nodes_mutex
Definition: net.h:1457
int m_max_outbound_full_relay
Definition: net.h:1523
Mutex m_unused_i2p_sessions_mutex
Mutex protecting m_i2p_sam_sessions.
Definition: net.h:1610
std::vector< CNode * > m_nodes GUARDED_BY(m_nodes_mutex)
std::unique_ptr< std::counting_semaphore<> > semAddnode
Definition: net.h:1508
std::chrono::seconds nMaxOutboundCycleStartTime GUARDED_BY(m_total_bytes_sent_mutex)
Definition: net.h:1431
uint64_t nTotalBytesSent GUARDED_BY(m_total_bytes_sent_mutex)
Definition: net.h:1427
bool GetUseAddrmanOutgoing() const
Definition: net.h:1139
std::list< CNode * > m_nodes_disconnected
Definition: net.h:1459
std::unique_ptr< i2p::sam::Session > m_i2p_sam_session
I2P SAM session.
Definition: net.h:1569
bool m_use_addrman_outgoing
Definition: net.h:1534
std::vector< NetWhitelistPermissions > vWhitelistedRangeOutgoing
Definition: net.h:1441
std::map< uint64_t, CachedAddrResponse > m_addr_response_caches
Addr responses stored in different caches per (network, local socket) prevent cross-network node iden...
Definition: net.h:1492
std::function< void(CNode *)> NodeFn
Definition: net.h:1152
NetEventsInterface * m_msgproc
Definition: net.h:1536
std::vector< CService > m_onion_binds
A vector of -bind=<address>:<port>=onion arguments each of which is an address and port that are desi...
Definition: net.h:1593
RecursiveMutex & GetNodesMutex() const LOCK_RETURNED(m_nodes_mutex)
std::thread threadSocketHandler
Definition: net.h:1572
A hasher class for Bitcoin's 256-bit hash (double SHA-256).
Definition: hash.h:24
An encapsulated private key.
Definition: key.h:35
Message header.
Definition: protocol.h:29
Network address.
Definition: netaddress.h:112
Transport protocol agnostic message container.
Definition: net.h:233
CNetMessage(CNetMessage &&)=default
CNetMessage(DataStream &&recv_in)
Definition: net.h:241
std::string m_type
Definition: net.h:239
DataStream m_recv
received message data
Definition: net.h:235
CNetMessage & operator=(const CNetMessage &)=delete
CNetMessage(const CNetMessage &)=delete
CNetMessage & operator=(CNetMessage &&)=default
Information about a peer.
Definition: net.h:675
bool IsFeelerConn() const
Definition: net.h:805
const std::chrono::seconds m_connected
Unix epoch time at peer connection.
Definition: net.h:708
bool ExpectServicesFromConn() const
Definition: net.h:817
const std::string m_dest
The pszDest argument provided to ConnectNode().
Definition: net.h:715
CService m_addr_local GUARDED_BY(m_addr_local_mutex)
uint64_t nRecvBytes GUARDED_BY(cs_vRecv)
Definition: net.h:703
bool IsInboundConn() const
Definition: net.h:813
bool HasPermission(NetPermissionFlags permission) const
Definition: net.h:726
CountingSemaphoreGrant grantOutbound
Definition: net.h:734
bool IsOutboundOrBlockRelayConn() const
Definition: net.h:762
NodeId GetId() const
Definition: net.h:896
bool IsManualConn() const
Definition: net.h:781
const std::string m_addr_name
Definition: net.h:713
CNode & operator=(const CNode &)=delete
const CService addrBind
Definition: net.h:712
void SetCommonVersion(int greatest_common_version)
Definition: net.h:921
std::list< CNetMessage > vRecvMsg
Definition: net.h:980
void PongReceived(std::chrono::microseconds ping_time)
A ping-pong round trip has completed successfully.
Definition: net.h:969
size_t m_msg_process_queue_size GUARDED_BY(m_msg_process_queue_mutex)
Definition: net.h:984
bool IsAddrFetchConn() const
Definition: net.h:809
uint64_t GetLocalNonce() const
Definition: net.h:900
const CAddress addr
Definition: net.h:710
mapMsgTypeSize mapSendBytesPerMsgType GUARDED_BY(cs_vSend)
const uint64_t nKeyedNetGroup
Definition: net.h:737
std::unique_ptr< i2p::sam::Session > m_i2p_sam_session GUARDED_BY(m_sock_mutex)
If an I2P session is created per connection (for outbound transient I2P connections) then it is store...
bool IsBlockOnlyConn() const
Definition: net.h:801
int GetCommonVersion() const
Definition: net.h:926
mapMsgTypeSize mapRecvBytesPerMsgType GUARDED_BY(cs_vRecv)
bool IsFullOutboundConn() const
Definition: net.h:777
Mutex m_subver_mutex
Definition: net.h:719
Mutex cs_vSend
Definition: net.h:699
int GetRefCount() const
Definition: net.h:904
Mutex m_msg_process_queue_mutex
Definition: net.h:982
const ConnectionType m_conn_type
Definition: net.h:741
const size_t m_recv_flood_size
Definition: net.h:979
const uint64_t nLocalHostNonce
Definition: net.h:976
bool IsManualOrFullOutboundConn() const
Definition: net.h:785
const std::unique_ptr< Transport > m_transport
Transport serializer/deserializer.
Definition: net.h:679
std::shared_ptr< Sock > m_sock GUARDED_BY(m_sock_mutex)
Socket used for communication with the node.
const NetPermissionFlags m_permission_flags
Definition: net.h:681
Mutex m_addr_local_mutex
Definition: net.h:988
CNode(const CNode &)=delete
size_t m_send_memusage GUARDED_BY(cs_vSend)
Sum of GetMemoryUsage of all vSendMsg entries.
Definition: net.h:694
const bool m_inbound_onion
Whether this peer is an inbound onion, i.e. connected via our Tor onion service.
Definition: net.h:717
const NodeId id
Definition: net.h:975
Mutex cs_vRecv
Definition: net.h:701
uint64_t nSendBytes GUARDED_BY(cs_vSend)
Total number of bytes sent on the wire to this peer.
Definition: net.h:696
Mutex m_sock_mutex
Definition: net.h:700
std::list< CNetMessage > m_msg_process_queue GUARDED_BY(m_msg_process_queue_mutex)
std::deque< CSerializedNetMsg > vSendMsg GUARDED_BY(cs_vSend)
Messages still to be fed to m_transport->SetMessageToSend.
void Release()
Definition: net.h:941
std::string cleanSubVer GUARDED_BY(m_subver_mutex)
cleanSubVer is a sanitized string of the user agent byte array we read from the wire.
Definition: net.h:724
std::string m_session_id
BIP324 session id string in hex, if any.
Definition: net.h:224
std::string addrLocal
Definition: net.h:212
uint64_t nRecvBytes
Definition: net.h:206
std::chrono::microseconds m_last_ping_time
Definition: net.h:209
uint32_t m_mapped_as
Definition: net.h:219
mapMsgTypeSize mapRecvBytesPerMsgType
Definition: net.h:207
bool fInbound
Definition: net.h:198
uint64_t nSendBytes
Definition: net.h:204
std::chrono::seconds m_last_recv
Definition: net.h:191
ConnectionType m_conn_type
Definition: net.h:220
std::chrono::seconds m_last_send
Definition: net.h:190
std::chrono::seconds m_last_tx_time
Definition: net.h:192
CAddress addr
Definition: net.h:214
mapMsgTypeSize mapSendBytesPerMsgType
Definition: net.h:205
std::chrono::microseconds m_min_ping_time
Definition: net.h:210
CService addrBind
Definition: net.h:216
TransportProtocolType m_transport_type
Transport protocol type.
Definition: net.h:222
std::chrono::seconds m_connected
Definition: net.h:194
bool m_bip152_highbandwidth_from
Definition: net.h:202
bool m_bip152_highbandwidth_to
Definition: net.h:200
std::string m_addr_name
Definition: net.h:195
int nVersion
Definition: net.h:196
std::chrono::seconds m_last_block_time
Definition: net.h:193
Network m_network
Definition: net.h:218
NodeId nodeid
Definition: net.h:189
std::string cleanSubVer
Definition: net.h:197
int m_starting_height
Definition: net.h:203
NetPermissionFlags m_permission_flags
Definition: net.h:208
Simple class for background tasks that should be run periodically or once "after a while".
Definition: scheduler.h:40
A combination of a network address (CNetAddr) and a (TCP) port.
Definition: netaddress.h:531
SipHash-2-4.
Definition: siphash.h:15
A helper class for interruptible sleeps.
RAII-style semaphore lock.
Double ended buffer combining vector and stream-like interfaces.
Definition: streams.h:130
Fast randomness source.
Definition: random.h:386
Different type to mark Mutex at global scope.
Definition: sync.h:135
Definition: init.h:13
Interface for message handling.
Definition: net.h:1010
static Mutex g_msgproc_mutex
Mutex for anything that is only accessed via the msg processing thread.
Definition: net.h:1013
virtual bool SendMessages(CNode *pnode) EXCLUSIVE_LOCKS_REQUIRED(g_msgproc_mutex)=0
Send queued protocol messages to a given node.
virtual void FinalizeNode(const CNode &node)=0
Handle removal of a peer (clear state)
virtual bool HasAllDesirableServiceFlags(ServiceFlags services) const =0
Callback to determine whether the given set of service flags are sufficient for a peer to be "relevan...
virtual bool ProcessMessages(CNode *pnode, std::atomic< bool > &interrupt) EXCLUSIVE_LOCKS_REQUIRED(g_msgproc_mutex)=0
Process protocol messages received from a given node.
~NetEventsInterface()=default
Protected destructor so that instances can only be deleted by derived classes.
virtual void InitializeNode(const CNode &node, ServiceFlags our_services)=0
Initialize a peer (setup state)
Netgroup manager.
Definition: netgroup.h:16
static void AddFlag(NetPermissionFlags &flags, NetPermissionFlags f)
static bool HasFlag(NetPermissionFlags flags, NetPermissionFlags f)
RAII helper class that manages a socket and closes it automatically when it goes out of scope.
Definition: sock.h:27
The Transport converts one connection's sent messages to wire bytes, and received bytes back.
Definition: net.h:256
virtual ~Transport()=default
virtual Info GetInfo() const noexcept=0
Retrieve information about this transport.
std::tuple< std::span< const uint8_t >, bool, const std::string & > BytesToSend
Return type for GetBytesToSend, consisting of:
Definition: net.h:313
CHash256 hasher GUARDED_BY(m_recv_mutex)
DataStream hdrbuf GUARDED_BY(m_recv_mutex)
Definition: net.h:378
bool m_sending_header GUARDED_BY(m_send_mutex)
Whether we're currently sending header bytes or message bytes.
Definition: net.h:414
const NodeId m_node_id
Definition: net.h:373
Mutex m_send_mutex
Lock for sending state.
Definition: net.h:408
CSerializedNetMsg m_message_to_send GUARDED_BY(m_send_mutex)
The data of the message currently being sent.
size_t m_bytes_sent GUARDED_BY(m_send_mutex)
How many bytes have been sent so far (from m_header_to_send, or from m_message_to_send....
Definition: net.h:416
unsigned int nDataPos GUARDED_BY(m_recv_mutex)
bool in_data GUARDED_BY(m_recv_mutex)
uint256 data_hash GUARDED_BY(m_recv_mutex)
std::vector< uint8_t > m_header_to_send GUARDED_BY(m_send_mutex)
The header of the message currently being sent.
const MessageStartChars m_magic_bytes
Definition: net.h:372
unsigned int nHdrPos GUARDED_BY(m_recv_mutex)
DataStream vRecv GUARDED_BY(m_recv_mutex)
Definition: net.h:380
bool CompleteInternal() const noexcept EXCLUSIVE_LOCKS_REQUIRED(m_recv_mutex)
Definition: net.h:400
CMessageHeader hdr GUARDED_BY(m_recv_mutex)
Mutex m_recv_mutex
Lock for receive state.
Definition: net.h:374
bool ReceivedMessageComplete() const override EXCLUSIVE_LOCKS_REQUIRED(!m_recv_mutex)
Returns true if the current message is complete (so GetReceivedMessage can be called).
Definition: net.h:421
std::vector< uint8_t > m_send_buffer GUARDED_BY(m_send_mutex)
The send buffer; meaning is determined by m_send_state.
bool m_sent_v1_header_worth GUARDED_BY(m_send_mutex)
Whether we've sent at least 24 bytes (which would trigger disconnect for V1 peers).
Definition: net.h:614
const NodeId m_nodeid
NodeId (for debug logging).
Definition: net.h:582
BIP324Cipher m_cipher
Cipher state.
Definition: net.h:578
SendState
State type that controls the sender side.
Definition: net.h:547
V1Transport m_v1_fallback
Encapsulate a V1Transport to fall back to.
Definition: net.h:584
Mutex m_send_mutex ACQUIRED_AFTER(m_recv_mutex)
Lock for sending-side fields.
SendState m_send_state GUARDED_BY(m_send_mutex)
Current sender state.
std::string m_send_type GUARDED_BY(m_send_mutex)
Type of the message being sent.
const bool m_initiating
Whether we are the initiator side.
Definition: net.h:580
std::vector< uint8_t > m_recv_buffer GUARDED_BY(m_recv_mutex)
Receive buffer; meaning is determined by m_recv_state.
std::vector< uint8_t > m_send_garbage GUARDED_BY(m_send_mutex)
The garbage sent, or to be sent (MAYBE_V1 and AWAITING_KEY state only).
uint32_t m_recv_len GUARDED_BY(m_recv_mutex)
In {VERSION, APP}, the decrypted packet length, if m_recv_buffer.size() >= BIP324Cipher::LENGTH_LEN.
Definition: net.h:590
uint32_t m_send_pos GUARDED_BY(m_send_mutex)
How many bytes from the send buffer have been sent so far.
Definition: net.h:606
RecvState m_recv_state GUARDED_BY(m_recv_mutex)
Current receiver state.
Mutex m_recv_mutex ACQUIRED_BEFORE(m_send_mutex)
Lock for receiver-side fields.
std::vector< uint8_t > m_recv_aad GUARDED_BY(m_recv_mutex)
AAD expected in next received packet (currently used only for garbage).
std::vector< uint8_t > m_recv_decode_buffer GUARDED_BY(m_recv_mutex)
Buffer to put decrypted contents in, for converting to CNetMessage.
RecvState
State type that defines the current contents of the receive buffer and/or how the next received bytes...
Definition: net.h:482
256-bit opaque blob.
Definition: uint256.h:196
std::string ConnectionTypeAsString(ConnectionType conn_type)
Convert ConnectionType enum to a string value.
ConnectionType
Different types of connections to a peer.
@ BLOCK_RELAY
We use block-relay-only connections to help prevent against partition attacks.
@ MANUAL
We open manual connections to addresses that users explicitly requested via the addnode RPC or the -a...
@ OUTBOUND_FULL_RELAY
These are the default connections that we use to connect with the network.
@ FEELER
Feeler connections are short-lived connections made to check that a node is alive.
@ INBOUND
Inbound connections are those initiated by a peer.
@ ADDR_FETCH
AddrFetch connections are short lived connections used to solicit addresses from peers.
TransportProtocolType
Transport layer version.
@ V1
Unencrypted, plaintext protocol.
static CService ip(uint32_t i)
CClientUIInterface uiInterface
std::array< uint8_t, 4 > MessageStartChars
unsigned int nonce
Definition: miner_tests.cpp:76
Definition: messages.h:20
static const unsigned char VERSION[]
Definition: netaddress.cpp:187
const std::string KEY
Definition: walletdb.cpp:44
uint16_t GetListenPort()
Definition: net.cpp:137
static const unsigned int DEFAULT_MAX_PEER_CONNECTIONS
The maximum number of peer connections to maintain.
Definition: net.h:78
bool IsLocal(const CService &addr)
check whether a given address is potentially local
Definition: net.cpp:328
void RemoveLocal(const CService &addr)
Definition: net.cpp:309
static const unsigned int MAX_SUBVERSION_LENGTH
Maximum length of the user agent string in version message.
Definition: net.h:66
static constexpr std::chrono::minutes TIMEOUT_INTERVAL
Time after which to disconnect, after waiting for a ping response (or inactivity).
Definition: net.h:58
static const int MAX_ADDNODE_CONNECTIONS
Maximum number of addnode outgoing nodes.
Definition: net.h:70
bool AddLocal(const CService &addr, int nScore=LOCAL_NONE)
Definition: net.cpp:276
bool fDiscover
Definition: net.cpp:115
static const size_t DEFAULT_MAXSENDBUFFER
Definition: net.h:94
static const int NUM_FDS_MESSAGE_CAPTURE
Number of file descriptors required for message capture.
Definition: net.h:86
static constexpr bool DEFAULT_FIXEDSEEDS
Definition: net.h:92
static const bool DEFAULT_BLOCKSONLY
Default for blocks only.
Definition: net.h:82
void ClearLocal()
Definition: net.cpp:269
static const unsigned int MAX_PROTOCOL_MESSAGE_LENGTH
Maximum length of incoming protocol messages (no message over 4 MB is currently acceptable).
Definition: net.h:64
bool fListen
Definition: net.cpp:116
static constexpr auto EXTRA_BLOCK_RELAY_ONLY_PEER_INTERVAL
Run the extra block-relay-only connection loop once every 5 minutes.
Definition: net.h:62
static const size_t DEFAULT_MAXRECEIVEBUFFER
Definition: net.h:93
std::string strSubVersion
Subversion as sent to the P2P network in version messages.
Definition: net.cpp:119
static const std::string DEFAULT_MAX_UPLOAD_TARGET
The default for -maxuploadtarget.
Definition: net.h:80
std::optional< CService > GetLocalAddrForPeer(CNode &node)
Returns a local address that we should advertise to this peer.
Definition: net.cpp:239
const std::string NET_MESSAGE_TYPE_OTHER
Definition: net.cpp:107
std::map< std::string, uint64_t > mapMsgTypeSize
Definition: net.h:184
static constexpr bool DEFAULT_FORCEDNSSEED
Definition: net.h:90
static constexpr bool DEFAULT_DNSSEED
Definition: net.h:91
int64_t NodeId
Definition: net.h:98
CService GetLocalAddress(const CNode &peer)
Definition: net.cpp:219
GlobalMutex g_maplocalhost_mutex
Definition: net.cpp:117
static const int MAX_FEELER_CONNECTIONS
Maximum number of feeler connections.
Definition: net.h:74
static const bool DEFAULT_LISTEN
-listen default
Definition: net.h:76
static constexpr std::chrono::hours ASMAP_HEALTH_CHECK_INTERVAL
Interval for ASMap Health Check.
Definition: net.h:88
std::map< CNetAddr, LocalServiceInfo > mapLocalHost GUARDED_BY(g_maplocalhost_mutex)
static constexpr auto FEELER_INTERVAL
Run the feeler connection loop once every 2 minutes.
Definition: net.h:60
static const int64_t DEFAULT_PEER_CONNECT_TIMEOUT
-peertimeout default
Definition: net.h:84
std::function< void(const CAddress &addr, const std::string &msg_type, std::span< const unsigned char > data, bool is_incoming)> CaptureMessage
Defaults to CaptureMessageToFile(), but can be overridden by unit tests.
Definition: net.cpp:4025
static const int MAX_OUTBOUND_FULL_RELAY_CONNECTIONS
Maximum number of automatic outgoing nodes over which we'll relay everything (blocks,...
Definition: net.h:68
@ LOCAL_NONE
Definition: net.h:149
@ LOCAL_MAPPED
Definition: net.h:152
@ LOCAL_MANUAL
Definition: net.h:153
@ LOCAL_MAX
Definition: net.h:155
@ LOCAL_BIND
Definition: net.h:151
@ LOCAL_IF
Definition: net.h:150
static constexpr bool DEFAULT_V2_TRANSPORT
Definition: net.h:96
static const int MAX_BLOCK_RELAY_ONLY_CONNECTIONS
Maximum number of block-relay-only outgoing connections.
Definition: net.h:72
void Discover()
Look up IP addresses from all interfaces on the machine and add them to the list of local addresses t...
Definition: net.cpp:3185
bool SeenLocal(const CService &addr)
vote for a local address
Definition: net.cpp:317
constexpr bool DEFAULT_WHITELISTFORCERELAY
Default for -whitelistforcerelay.
constexpr bool DEFAULT_WHITELISTRELAY
Default for -whitelistrelay.
NetPermissionFlags
Network
A network type.
Definition: netaddress.h:32
ConnectionDirection
Definition: netbase.h:33
ServiceFlags
nServices flags
Definition: protocol.h:309
@ NODE_NONE
Definition: protocol.h:312
@ NODE_P2P_V2
Definition: protocol.h:330
static const int INIT_PROTO_VERSION
initial proto version, to be increased after version/verack negotiation
bool fInbound
Definition: net.h:109
CService resolvedAddress
Definition: net.h:107
AddedNodeParams m_params
Definition: net.h:106
bool fConnected
Definition: net.h:108
std::string m_added_node
Definition: net.h:101
bool m_use_v2transport
Definition: net.h:102
Cache responses to addr requests to minimize privacy leak.
Definition: net.h:1473
std::vector< CAddress > m_addrs_response_cache
Definition: net.h:1474
void AddSocketPermissionFlags(NetPermissionFlags &flags) const
Definition: net.h:1292
ListenSocket(std::shared_ptr< Sock > sock_, NetPermissionFlags permissions_)
Definition: net.h:1293
NetPermissionFlags m_permissions
Definition: net.h:1299
std::shared_ptr< Sock > sock
Definition: net.h:1291
std::vector< NetWhitebindPermissions > vWhiteBinds
Definition: net.h:1071
std::vector< NetWhitelistPermissions > vWhitelistedRangeIncoming
Definition: net.h:1069
std::vector< CService > onion_binds
Definition: net.h:1073
std::vector< std::string > m_specified_outgoing
Definition: net.h:1078
std::vector< std::string > m_added_nodes
Definition: net.h:1079
std::vector< CService > vBinds
Definition: net.h:1072
bool m_i2p_accept_incoming
Definition: net.h:1080
std::vector< std::string > vSeedNodes
Definition: net.h:1068
bool bind_on_any
True if the user did not specify -bind= or -whitebind= and thus we should bind on 0....
Definition: net.h:1076
std::vector< NetWhitelistPermissions > vWhitelistedRangeOutgoing
Definition: net.h:1070
Struct for entries in m_reconnections.
Definition: net.h:1628
ConnectionType conn_type
Definition: net.h:1632
std::string destination
Definition: net.h:1631
CountingSemaphoreGrant grant
Definition: net.h:1630
CSerializedNetMsg(const CSerializedNetMsg &msg)=delete
CSerializedNetMsg Copy() const
Definition: net.h:123
CSerializedNetMsg & operator=(CSerializedNetMsg &&)=default
std::string m_type
Definition: net.h:132
CSerializedNetMsg & operator=(const CSerializedNetMsg &)=delete
CSerializedNetMsg()=default
CSerializedNetMsg(CSerializedNetMsg &&)=default
std::vector< unsigned char > data
Definition: net.h:131
size_t GetMemoryUsage() const noexcept
Compute total memory usage of this object (own memory + any dynamic memory).
Definition: net.cpp:121
uint16_t nPort
Definition: net.h:177
int nScore
Definition: net.h:176
std::optional< uint256 > session_id
Definition: net.h:263
TransportProtocolType transport_type
Definition: net.h:262
Bilingual messages:
Definition: translation.h:24
#define AssertLockNotHeld(cs)
Definition: sync.h:142
#define LOCK(cs)
Definition: sync.h:259
#define WITH_LOCK(cs, code)
Run code while locking a mutex.
Definition: sync.h:290
#define EXCLUSIVE_LOCKS_REQUIRED(...)
Definition: threadsafety.h:51
#define LOCK_RETURNED(x)
Definition: threadsafety.h:49
AssertLockHeld(pool.cs)
assert(!tx.IsCoinBase())