Bitcoin Core  26.1.0
P2P Digital Currency
protocol.cpp
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 #include <protocol.h>
7 
8 #include <common/system.h>
9 
10 #include <atomic>
11 
12 static std::atomic<bool> g_initial_block_download_completed(false);
13 
14 namespace NetMsgType {
15 const char* VERSION = "version";
16 const char* VERACK = "verack";
17 const char* ADDR = "addr";
18 const char* ADDRV2 = "addrv2";
19 const char* SENDADDRV2 = "sendaddrv2";
20 const char* INV = "inv";
21 const char* GETDATA = "getdata";
22 const char* MERKLEBLOCK = "merkleblock";
23 const char* GETBLOCKS = "getblocks";
24 const char* GETHEADERS = "getheaders";
25 const char* TX = "tx";
26 const char* HEADERS = "headers";
27 const char* BLOCK = "block";
28 const char* GETADDR = "getaddr";
29 const char* MEMPOOL = "mempool";
30 const char* PING = "ping";
31 const char* PONG = "pong";
32 const char* NOTFOUND = "notfound";
33 const char* FILTERLOAD = "filterload";
34 const char* FILTERADD = "filteradd";
35 const char* FILTERCLEAR = "filterclear";
36 const char* SENDHEADERS = "sendheaders";
37 const char* FEEFILTER = "feefilter";
38 const char* SENDCMPCT = "sendcmpct";
39 const char* CMPCTBLOCK = "cmpctblock";
40 const char* GETBLOCKTXN = "getblocktxn";
41 const char* BLOCKTXN = "blocktxn";
42 const char* GETCFILTERS = "getcfilters";
43 const char* CFILTER = "cfilter";
44 const char* GETCFHEADERS = "getcfheaders";
45 const char* CFHEADERS = "cfheaders";
46 const char* GETCFCHECKPT = "getcfcheckpt";
47 const char* CFCHECKPT = "cfcheckpt";
48 const char* WTXIDRELAY = "wtxidrelay";
49 const char* SENDTXRCNCL = "sendtxrcncl";
50 } // namespace NetMsgType
51 
55 const static std::vector<std::string> g_all_net_message_types{
91 };
92 
93 CMessageHeader::CMessageHeader(const MessageStartChars& pchMessageStartIn, const char* pszCommand, unsigned int nMessageSizeIn)
94 {
95  pchMessageStart = pchMessageStartIn;
96 
97  // Copy the command name
98  size_t i = 0;
99  for (; i < COMMAND_SIZE && pszCommand[i] != 0; ++i) pchCommand[i] = pszCommand[i];
100  assert(pszCommand[i] == 0); // Assert that the command name passed in is not longer than COMMAND_SIZE
101 
102  nMessageSize = nMessageSizeIn;
103 }
104 
105 std::string CMessageHeader::GetCommand() const
106 {
107  return std::string(pchCommand, pchCommand + strnlen(pchCommand, COMMAND_SIZE));
108 }
109 
111 {
112  // Check the command string for errors
113  for (const char* p1 = pchCommand; p1 < pchCommand + COMMAND_SIZE; ++p1) {
114  if (*p1 == 0) {
115  // Must be all zeros after the first zero
116  for (; p1 < pchCommand + COMMAND_SIZE; ++p1) {
117  if (*p1 != 0) {
118  return false;
119  }
120  }
121  } else if (*p1 < ' ' || *p1 > 0x7E) {
122  return false;
123  }
124  }
125 
126  return true;
127 }
128 
129 
133  }
135 }
136 
137 void SetServiceFlagsIBDCache(bool state) {
139 }
140 
142 {
143  type = 0;
144  hash.SetNull();
145 }
146 
147 CInv::CInv(uint32_t typeIn, const uint256& hashIn) : type(typeIn), hash(hashIn) {}
148 
149 bool operator<(const CInv& a, const CInv& b)
150 {
151  return (a.type < b.type || (a.type == b.type && a.hash < b.hash));
152 }
153 
154 std::string CInv::GetCommand() const
155 {
156  std::string cmd;
157  if (type & MSG_WITNESS_FLAG)
158  cmd.append("witness-");
159  int masked = type & MSG_TYPE_MASK;
160  switch (masked)
161  {
162  case MSG_TX: return cmd.append(NetMsgType::TX);
163  // WTX is not a message type, just an inv type
164  case MSG_WTX: return cmd.append("wtx");
165  case MSG_BLOCK: return cmd.append(NetMsgType::BLOCK);
166  case MSG_FILTERED_BLOCK: return cmd.append(NetMsgType::MERKLEBLOCK);
167  case MSG_CMPCT_BLOCK: return cmd.append(NetMsgType::CMPCTBLOCK);
168  default:
169  throw std::out_of_range(strprintf("CInv::GetCommand(): type=%d unknown type", type));
170  }
171 }
172 
173 std::string CInv::ToString() const
174 {
175  try {
176  return strprintf("%s %s", GetCommand(), hash.ToString());
177  } catch(const std::out_of_range &) {
178  return strprintf("0x%08x %s", type, hash.ToString());
179  }
180 }
181 
182 const std::vector<std::string> &getAllNetMessageTypes()
183 {
185 }
186 
192 static std::string serviceFlagToStr(size_t bit)
193 {
194  const uint64_t service_flag = 1ULL << bit;
195  switch ((ServiceFlags)service_flag) {
196  case NODE_NONE: abort(); // impossible
197  case NODE_NETWORK: return "NETWORK";
198  case NODE_BLOOM: return "BLOOM";
199  case NODE_WITNESS: return "WITNESS";
200  case NODE_COMPACT_FILTERS: return "COMPACT_FILTERS";
201  case NODE_NETWORK_LIMITED: return "NETWORK_LIMITED";
202  case NODE_P2P_V2: return "P2P_V2";
203  // Not using default, so we get warned when a case is missing
204  }
205 
206  return strprintf("UNKNOWN[2^%u]", bit);
207 }
208 
209 std::vector<std::string> serviceFlagsToStr(uint64_t flags)
210 {
211  std::vector<std::string> str_flags;
212 
213  for (size_t i = 0; i < sizeof(flags) * 8; ++i) {
214  if (flags & (1ULL << i)) {
215  str_flags.emplace_back(serviceFlagToStr(i));
216  }
217  }
218 
219  return str_flags;
220 }
221 
222 GenTxid ToGenTxid(const CInv& inv)
223 {
224  assert(inv.IsGenTxMsg());
225  return inv.IsMsgWtx() ? GenTxid::Wtxid(inv.hash) : GenTxid::Txid(inv.hash);
226 }
const char * GETCFILTERS
getcfilters requests compact filters for a range of blocks.
Definition: protocol.cpp:42
bool IsMsgWtx() const
Definition: protocol.h:504
const char * PING
The ping message is sent periodically to help confirm that the receiving peer is still connected...
Definition: protocol.cpp:30
const char * FILTERLOAD
The filterload message tells the receiving peer to filter all relayed transactions and requested merk...
Definition: protocol.cpp:33
const char * MERKLEBLOCK
The merkleblock message is a reply to a getdata message which requested a block using the inventory t...
Definition: protocol.cpp:22
const char * BLOCKTXN
Contains a BlockTransactions.
Definition: protocol.cpp:41
static GenTxid Wtxid(const uint256 &hash)
Definition: transaction.h:433
const char * SENDADDRV2
The sendaddrv2 message signals support for receiving ADDRV2 messages (BIP155).
Definition: protocol.cpp:19
ServiceFlags
nServices flags
Definition: protocol.h:274
assert(!tx.IsCoinBase())
std::string GetCommand() const
Definition: protocol.cpp:154
std::string ToString() const
Definition: protocol.cpp:173
const char * GETADDR
The getaddr message requests an addr message from the receiving node, preferably one with lots of IP ...
Definition: protocol.cpp:28
#define strprintf
Format arguments and return the string or write to given std::ostream (see tinyformat::format doc for...
Definition: tinyformat.h:1162
inv message data
Definition: protocol.h:488
const char * SENDCMPCT
Contains a 1-byte bool and 8-byte LE version number.
Definition: protocol.cpp:38
char pchCommand[COMMAND_SIZE]
Definition: protocol.h:51
const char * CFHEADERS
cfheaders is a response to a getcfheaders request containing a filter header and a vector of filter h...
Definition: protocol.cpp:45
Defined in BIP152.
Definition: protocol.h:479
const auto cmd
void SetServiceFlagsIBDCache(bool state)
Set the current IBD status in order to figure out the desirable service flags.
Definition: protocol.cpp:137
std::vector< std::string > serviceFlagsToStr(uint64_t flags)
Convert service flags (a bitmask of NODE_*) to human readable strings.
Definition: protocol.cpp:209
const uint32_t MSG_WITNESS_FLAG
getdata message type flags
Definition: protocol.h:465
uint32_t nMessageSize
Definition: protocol.h:52
const char * CFILTER
cfilter is a response to a getcfilters request containing a single compact filter.
Definition: protocol.cpp:43
const uint32_t MSG_TYPE_MASK
Definition: protocol.h:466
std::string GetCommand() const
Definition: protocol.cpp:105
const char * PONG
The pong message replies to a ping message, proving to the pinging node that the ponging node is stil...
Definition: protocol.cpp:31
const char * WTXIDRELAY
Indicates that a node prefers to relay transactions via wtxid, rather than txid.
Definition: protocol.cpp:48
const char * HEADERS
The headers message sends one or more block headers to a node which previously requested certain head...
Definition: protocol.cpp:26
const char * GETCFCHECKPT
getcfcheckpt requests evenly spaced compact filter headers, enabling parallelized download and valida...
Definition: protocol.cpp:46
const char * INV
The inv message (inventory message) transmits one or more inventories of objects known to the transmi...
Definition: protocol.cpp:20
bool IsCommandValid() const
Definition: protocol.cpp:110
std::array< uint8_t, 4 > MessageStartChars
static std::atomic< bool > g_initial_block_download_completed(false)
GenTxid ToGenTxid(const CInv &inv)
Convert a TX/WITNESS_TX/WTX CInv to a GenTxid.
Definition: protocol.cpp:222
const char * GETHEADERS
The getheaders message requests a headers message that provides block headers starting from a particu...
Definition: protocol.cpp:24
CMessageHeader()=default
const char * SENDTXRCNCL
Contains a 4-byte version number and an 8-byte salt.
Definition: protocol.cpp:49
static constexpr size_t COMMAND_SIZE
Definition: protocol.h:31
Bitcoin protocol message types.
Definition: protocol.cpp:14
const char * ADDRV2
The addrv2 message relays connection information for peers on the network just like the addr message...
Definition: protocol.cpp:18
const char * SENDHEADERS
Indicates that a node prefers to receive new block announcements via a "headers" message rather than ...
Definition: protocol.cpp:36
const char * MEMPOOL
The mempool message requests the TXIDs of transactions that the receiving node has verified as valid ...
Definition: protocol.cpp:29
bool IsGenTxMsg() const
Definition: protocol.h:510
bool operator<(const CInv &a, const CInv &b)
Definition: protocol.cpp:149
const std::vector< std::string > & getAllNetMessageTypes()
Definition: protocol.cpp:182
uint256 hash
Definition: protocol.h:520
const char * ADDR
The addr (IP address) message relays connection information for peers on the network.
Definition: protocol.cpp:17
const char * FILTERCLEAR
The filterclear message tells the receiving peer to remove a previously-set bloom filter...
Definition: protocol.cpp:35
std::string ToString() const
Definition: uint256.cpp:55
const char * NOTFOUND
The notfound message is a reply to a getdata message which requested an object the receiving node doe...
Definition: protocol.cpp:32
const char * BLOCK
The block message transmits a single serialized block.
Definition: protocol.cpp:27
const char * FEEFILTER
The feefilter message tells the receiving peer not to inv us any txs which do not meet the specified ...
Definition: protocol.cpp:37
const char * GETCFHEADERS
getcfheaders requests a compact filter header and the filter hashes for a range of blocks...
Definition: protocol.cpp:44
const char * GETBLOCKS
The getblocks message requests an inv message that provides block header hashes starting from a parti...
Definition: protocol.cpp:23
int flags
Definition: bitcoin-tx.cpp:528
static std::string serviceFlagToStr(size_t bit)
Convert a service flag (NODE_*) to a human readable string.
Definition: protocol.cpp:192
const char * VERACK
The verack message acknowledges a previously-received version message, informing the connecting node ...
Definition: protocol.cpp:16
256-bit opaque blob.
Definition: uint256.h:106
MessageStartChars pchMessageStart
Definition: protocol.h:50
const char * CMPCTBLOCK
Contains a CBlockHeaderAndShortTxIDs object - providing a header and list of "short txids"...
Definition: protocol.cpp:39
constexpr void SetNull()
Definition: uint256.h:49
const char * VERSION
The version message provides information about the transmitting node to the receiving node at the beg...
Definition: protocol.cpp:15
ServiceFlags GetDesirableServiceFlags(ServiceFlags services)
Gets the set of service flags which are "desirable" for a given peer.
Definition: protocol.cpp:130
uint32_t type
Definition: protocol.h:519
const char * GETDATA
The getdata message requests one or more data objects from another node.
Definition: protocol.cpp:21
const char * CFCHECKPT
cfcheckpt is a response to a getcfcheckpt request containing a vector of evenly spaced filter headers...
Definition: protocol.cpp:47
CInv()
Definition: protocol.cpp:141
const char * TX
The tx message transmits a single transaction.
Definition: protocol.cpp:25
Defined in BIP37.
Definition: protocol.h:478
Defined in BIP 339.
Definition: protocol.h:476
A generic txid reference (txid or wtxid).
Definition: transaction.h:425
static GenTxid Txid(const uint256 &hash)
Definition: transaction.h:432
const char * FILTERADD
The filteradd message tells the receiving peer to add a single element to a previously-set bloom filt...
Definition: protocol.cpp:34
static const std::vector< std::string > g_all_net_message_types
All known message types.
Definition: protocol.cpp:55
const char * GETBLOCKTXN
Contains a BlockTransactionsRequest Peer should respond with "blocktxn" message.
Definition: protocol.cpp:40