Bitcoin Core  0.18.99
P2P Digital Currency
protocol.h
Go to the documentation of this file.
1 // Copyright (c) 2009-2010 Satoshi Nakamoto
2 // Copyright (c) 2009-2018 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 __cplusplus
7 #error This header can only be compiled as C++.
8 #endif
9 
10 #ifndef BITCOIN_PROTOCOL_H
11 #define BITCOIN_PROTOCOL_H
12 
13 #include <netaddress.h>
14 #include <serialize.h>
15 #include <uint256.h>
16 #include <version.h>
17 
18 #include <atomic>
19 #include <stdint.h>
20 #include <string>
21 
29 {
30 public:
31  static constexpr size_t MESSAGE_START_SIZE = 4;
32  static constexpr size_t COMMAND_SIZE = 12;
33  static constexpr size_t MESSAGE_SIZE_SIZE = 4;
34  static constexpr size_t CHECKSUM_SIZE = 4;
35  static constexpr size_t MESSAGE_SIZE_OFFSET = MESSAGE_START_SIZE + COMMAND_SIZE;
36  static constexpr size_t CHECKSUM_OFFSET = MESSAGE_SIZE_OFFSET + MESSAGE_SIZE_SIZE;
37  static constexpr size_t HEADER_SIZE = MESSAGE_START_SIZE + COMMAND_SIZE + MESSAGE_SIZE_SIZE + CHECKSUM_SIZE;
38  typedef unsigned char MessageStartChars[MESSAGE_START_SIZE];
39 
40  explicit CMessageHeader(const MessageStartChars& pchMessageStartIn);
41  CMessageHeader(const MessageStartChars& pchMessageStartIn, const char* pszCommand, unsigned int nMessageSizeIn);
42 
43  std::string GetCommand() const;
44  bool IsValid(const MessageStartChars& messageStart) const;
45 
47 
48  template <typename Stream, typename Operation>
49  inline void SerializationOp(Stream& s, Operation ser_action)
50  {
55  }
56 
59  uint32_t nMessageSize;
61 };
62 
67 namespace NetMsgType {
68 
74 extern const char *VERSION;
80 extern const char *VERACK;
86 extern const char *ADDR;
92 extern const char *INV;
97 extern const char *GETDATA;
104 extern const char *MERKLEBLOCK;
110 extern const char *GETBLOCKS;
117 extern const char *GETHEADERS;
122 extern const char *TX;
129 extern const char *HEADERS;
134 extern const char *BLOCK;
140 extern const char *GETADDR;
147 extern const char *MEMPOOL;
153 extern const char *PING;
160 extern const char *PONG;
167 extern const char *NOTFOUND;
176 extern const char *FILTERLOAD;
185 extern const char *FILTERADD;
194 extern const char *FILTERCLEAR;
201 extern const char *REJECT;
208 extern const char *SENDHEADERS;
214 extern const char *FEEFILTER;
222 extern const char *SENDCMPCT;
228 extern const char *CMPCTBLOCK;
234 extern const char *GETBLOCKTXN;
240 extern const char *BLOCKTXN;
241 };
242 
243 /* Get a vector of all valid message types (see above) */
244 const std::vector<std::string> &getAllNetMessageTypes();
245 
247 enum ServiceFlags : uint64_t {
248  // Nothing
250  // NODE_NETWORK means that the node is capable of serving the complete block chain. It is currently
251  // set by all Bitcoin Core non pruned nodes, and is unset by SPV clients or other light clients.
252  NODE_NETWORK = (1 << 0),
253  // NODE_GETUTXO means the node is capable of responding to the getutxo protocol request.
254  // Bitcoin Core does not support this but a patch set called Bitcoin XT does.
255  // See BIP 64 for details on how this is implemented.
256  NODE_GETUTXO = (1 << 1),
257  // NODE_BLOOM means the node is capable and willing to handle bloom-filtered connections.
258  // Bitcoin Core nodes used to support this by default, without advertising this bit,
259  // but no longer do as of protocol version 70011 (= NO_BLOOM_VERSION)
260  NODE_BLOOM = (1 << 2),
261  // NODE_WITNESS indicates that a node can be asked for blocks and transactions including
262  // witness data.
263  NODE_WITNESS = (1 << 3),
264  // NODE_XTHIN means the node supports Xtreme Thinblocks
265  // If this is turned off then the node will not service nor make xthin requests
266  NODE_XTHIN = (1 << 4),
267  // NODE_NETWORK_LIMITED means the same as NODE_NETWORK with the limitation of only
268  // serving the last 288 (2 day) blocks
269  // See BIP159 for details on how this is implemented.
270  NODE_NETWORK_LIMITED = (1 << 10),
271 
272  // Bits 24-31 are reserved for temporary experiments. Just pick a bit that
273  // isn't getting used, or one not being used much, and notify the
274  // bitcoin-development mailing list. Remember that service bits are just
275  // unauthenticated advertisements, so your code must be robust against
276  // collisions and other cases where nodes may be advertising a service they
277  // do not actually support. Other service bits should be allocated via the
278  // BIP process.
279 };
280 
306 
308 void SetServiceFlagsIBDCache(bool status);
309 
315 static inline bool HasAllDesirableServiceFlags(ServiceFlags services) {
316  return !(GetDesirableServiceFlags(services) & (~services));
317 }
318 
323 static inline bool MayHaveUsefulAddressDB(ServiceFlags services) {
324  return (services & NODE_NETWORK) || (services & NODE_NETWORK_LIMITED);
325 }
326 
328 class CAddress : public CService
329 {
330 public:
331  CAddress();
332  explicit CAddress(CService ipIn, ServiceFlags nServicesIn);
333 
334  void Init();
335 
337 
338  template <typename Stream, typename Operation>
339  inline void SerializationOp(Stream& s, Operation ser_action)
340  {
341  if (ser_action.ForRead())
342  Init();
343  int nVersion = s.GetVersion();
344  if (s.GetType() & SER_DISK)
345  READWRITE(nVersion);
346  if ((s.GetType() & SER_DISK) ||
347  (nVersion >= CADDR_TIME_VERSION && !(s.GetType() & SER_GETHASH)))
348  READWRITE(nTime);
349  uint64_t nServicesInt = nServices;
350  READWRITE(nServicesInt);
351  nServices = static_cast<ServiceFlags>(nServicesInt);
352  READWRITEAS(CService, *this);
353  }
354 
355  // TODO: make private (improves encapsulation)
356 public:
358 
359  // disk and network only
360  unsigned int nTime;
361 };
362 
364 const uint32_t MSG_WITNESS_FLAG = 1 << 30;
365 const uint32_t MSG_TYPE_MASK = 0xffffffff >> 2;
366 
372 {
374  MSG_TX = 1,
376  // The following can only occur in getdata. Invs always use TX or BLOCK.
382 };
383 
385 class CInv
386 {
387 public:
388  CInv();
389  CInv(int typeIn, const uint256& hashIn);
390 
392 
393  template <typename Stream, typename Operation>
394  inline void SerializationOp(Stream& s, Operation ser_action)
395  {
396  READWRITE(type);
397  READWRITE(hash);
398  }
399 
400  friend bool operator<(const CInv& a, const CInv& b);
401 
402  std::string GetCommand() const;
403  std::string ToString() const;
404 
405 public:
406  int type;
408 };
409 
410 #endif // BITCOIN_PROTOCOL_H
const char * PING
The ping message is sent periodically to help confirm that the receiving peer is still connected...
Definition: protocol.cpp:31
const char * FILTERLOAD
The filterload message tells the receiving peer to filter all relayed transactions and requested merk...
Definition: protocol.cpp:34
const char * MERKLEBLOCK
The merkleblock message is a reply to a getdata message which requested a block using the inventory t...
Definition: protocol.cpp:23
uint8_t pchChecksum[CHECKSUM_SIZE]
Definition: protocol.h:60
const char * BLOCKTXN
Contains a BlockTransactions.
Definition: protocol.cpp:43
ServiceFlags
nServices flags
Definition: protocol.h:247
static constexpr size_t MESSAGE_SIZE_SIZE
Definition: protocol.h:33
Defined in BIP144.
Definition: protocol.h:380
const std::vector< std::string > & getAllNetMessageTypes()
Definition: protocol.cpp:200
const char * GETADDR
The getaddr message requests an addr message from the receiving node, preferably one with lots of IP ...
Definition: protocol.cpp:29
Defined in BIP152.
Definition: protocol.h:378
inv message data
Definition: protocol.h:385
const char * SENDCMPCT
Contains a 1-byte bool and 8-byte LE version number.
Definition: protocol.cpp:40
char pchCommand[COMMAND_SIZE]
Definition: protocol.h:58
void SerializationOp(Stream &s, Operation ser_action)
Definition: protocol.h:339
Defined in BIP144.
Definition: protocol.h:379
ADD_SERIALIZE_METHODS
Definition: protocol.h:336
CMessageHeader(const MessageStartChars &pchMessageStartIn)
Definition: protocol.cpp:79
void SerializationOp(Stream &s, Operation ser_action)
Definition: protocol.h:49
GetDataMsg
getdata / inv message types.
Definition: protocol.h:371
const uint32_t MSG_WITNESS_FLAG
getdata message type flags
Definition: protocol.h:364
uint32_t nMessageSize
Definition: protocol.h:59
const uint32_t MSG_TYPE_MASK
Definition: protocol.h:365
std::string GetCommand() const
Definition: protocol.cpp:96
#define READWRITEAS(type, obj)
Definition: serialize.h:185
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:32
bool IsValid(const MessageStartChars &messageStart) const
Definition: protocol.cpp:101
const char * HEADERS
The headers message sends one or more block headers to a node which previously requested certain head...
Definition: protocol.cpp:27
const char * INV
The inv message (inventory message) transmits one or more inventories of objects known to the transmi...
Definition: protocol.cpp:21
ServiceFlags GetDesirableServiceFlags(ServiceFlags services)
Gets the set of service flags which are "desirable" for a given peer.
Definition: protocol.cpp:132
const char * GETHEADERS
The getheaders message requests a headers message that provides block headers starting from a particu...
Definition: protocol.cpp:25
static constexpr size_t COMMAND_SIZE
Definition: protocol.h:32
Bitcoin protocol message types.
Definition: protocol.cpp:17
int type
Definition: protocol.h:406
A combination of a network address (CNetAddr) and a (TCP) port.
Definition: netaddress.h:139
Removed for block.
const char * SENDHEADERS
Indicates that a node prefers to receive new block announcements via a "headers" message rather than ...
Definition: protocol.cpp:38
A CService with information about it as peer.
Definition: protocol.h:328
uint256 hash
Definition: protocol.h:407
const char * ADDR
The addr (IP address) message relays connection information for peers on the network.
Definition: protocol.cpp:20
const char * FILTERCLEAR
The filterclear message tells the receiving peer to remove a previously-set bloom filter...
Definition: protocol.cpp:36
static constexpr size_t CHECKSUM_SIZE
Definition: protocol.h:34
const char * NOTFOUND
The notfound message is a reply to a getdata message which requested an object the receiving node doe...
Definition: protocol.cpp:33
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:39
unsigned char MessageStartChars[MESSAGE_START_SIZE]
Definition: protocol.h:38
const char * REJECT
The reject message informs the receiving node that one of its previous messages has been rejected...
Definition: protocol.cpp:37
static constexpr size_t MESSAGE_SIZE_OFFSET
Definition: protocol.h:35
static constexpr size_t MESSAGE_START_SIZE
Definition: protocol.h:31
const char * GETBLOCKS
The getblocks message requests an inv message that provides block header hashes starting from a parti...
Definition: protocol.cpp:24
void SetServiceFlagsIBDCache(bool status)
Set the current IBD status in order to figure out the desirable service flags.
Definition: protocol.cpp:139
ADD_SERIALIZE_METHODS
Definition: protocol.h:391
bool operator<(const CNetAddr &a, const CNetAddr &b)
Definition: netaddress.cpp:356
const char * VERACK
The verack message acknowledges a previously-received version message, informing the connecting node ...
Definition: protocol.cpp:19
256-bit opaque blob.
Definition: uint256.h:121
unsigned int nTime
Definition: protocol.h:360
ServiceFlags nServices
Definition: protocol.h:357
const char * GETDATA
The getdata message requests one or more data objects from another node.
Definition: protocol.cpp:22
static constexpr size_t HEADER_SIZE
Definition: protocol.h:37
void SerializationOp(Stream &s, Operation ser_action)
Definition: protocol.h:394
const char * TX
The tx message transmits a single transaction.
Definition: protocol.cpp:26
#define VERSION
#define READWRITE(...)
Definition: serialize.h:184
char pchMessageStart[MESSAGE_START_SIZE]
Definition: protocol.h:57
Defined in BIP37.
Definition: protocol.h:377
static constexpr size_t CHECKSUM_OFFSET
Definition: protocol.h:36
const char * FILTERADD
The filteradd message tells the receiving peer to add a single element to a previously-set bloom filt...
Definition: protocol.cpp:35
const char * GETBLOCKTXN
Contains a BlockTransactionsRequest Peer should respond with "blocktxn" message.
Definition: protocol.cpp:42
Message header.
Definition: protocol.h:28