2011-08-11 18:14:53 +02:00
|
|
|
// Copyright (c) 2009-2010 Satoshi Nakamoto
|
2014-12-17 02:47:57 +01:00
|
|
|
// Copyright (c) 2009-2013 The Bitcoin Core developers
|
2014-12-13 05:09:33 +01:00
|
|
|
// Distributed under the MIT software license, see the accompanying
|
2012-05-18 16:02:28 +02:00
|
|
|
// file COPYING or http://www.opensource.org/licenses/mit-license.php.
|
2011-08-11 18:14:53 +02:00
|
|
|
|
|
|
|
#ifndef __cplusplus
|
2014-09-19 19:21:46 +02:00
|
|
|
#error This header can only be compiled as C++.
|
2011-08-11 18:14:53 +02:00
|
|
|
#endif
|
|
|
|
|
2014-11-03 16:16:40 +01:00
|
|
|
#ifndef BITCOIN_PROTOCOL_H
|
|
|
|
#define BITCOIN_PROTOCOL_H
|
2011-08-11 18:14:53 +02:00
|
|
|
|
2012-01-03 23:33:31 +01:00
|
|
|
#include "netbase.h"
|
2013-04-13 07:13:08 +02:00
|
|
|
#include "serialize.h"
|
2011-08-11 18:49:03 +02:00
|
|
|
#include "uint256.h"
|
2014-05-09 17:38:44 +02:00
|
|
|
#include "version.h"
|
2011-08-11 18:14:53 +02:00
|
|
|
|
2013-04-13 07:13:08 +02:00
|
|
|
#include <stdint.h>
|
|
|
|
#include <string>
|
|
|
|
|
2014-06-04 12:51:29 +02:00
|
|
|
#define MESSAGE_START_SIZE 4
|
|
|
|
|
2012-03-26 16:48:23 +02:00
|
|
|
/** Message header.
|
|
|
|
* (4) message start.
|
|
|
|
* (12) command.
|
|
|
|
* (4) size.
|
|
|
|
* (4) checksum.
|
|
|
|
*/
|
2011-08-11 18:14:53 +02:00
|
|
|
class CMessageHeader
|
|
|
|
{
|
2014-09-19 19:21:46 +02:00
|
|
|
public:
|
|
|
|
CMessageHeader();
|
|
|
|
CMessageHeader(const char* pszCommand, unsigned int nMessageSizeIn);
|
2011-08-11 18:14:53 +02:00
|
|
|
|
2014-09-19 19:21:46 +02:00
|
|
|
std::string GetCommand() const;
|
|
|
|
bool IsValid() const;
|
2011-08-11 18:14:53 +02:00
|
|
|
|
2014-09-19 19:21:46 +02:00
|
|
|
ADD_SERIALIZE_METHODS;
|
overhaul serialization code
The implementation of each class' serialization/deserialization is no longer
passed within a macro. The implementation now lies within a template of form:
template <typename T, typename Stream, typename Operation>
inline static size_t SerializationOp(T thisPtr, Stream& s, Operation ser_action, int nType, int nVersion) {
size_t nSerSize = 0;
/* CODE */
return nSerSize;
}
In cases when codepath should depend on whether or not we are just deserializing
(old fGetSize, fWrite, fRead flags) an additional clause can be used:
bool fRead = boost::is_same<Operation, CSerActionUnserialize>();
The IMPLEMENT_SERIALIZE macro will now be a freestanding clause added within
class' body (similiar to Qt's Q_OBJECT) to implement GetSerializeSize,
Serialize and Unserialize. These are now wrappers around
the "SerializationOp" template.
2014-08-20 08:42:31 +02:00
|
|
|
|
2014-09-19 19:21:46 +02:00
|
|
|
template <typename Stream, typename Operation>
|
|
|
|
inline void SerializationOp(Stream& s, Operation ser_action, int nType, int nVersion)
|
|
|
|
{
|
|
|
|
READWRITE(FLATDATA(pchMessageStart));
|
|
|
|
READWRITE(FLATDATA(pchCommand));
|
|
|
|
READWRITE(nMessageSize);
|
|
|
|
READWRITE(nChecksum);
|
|
|
|
}
|
2011-08-11 18:14:53 +02:00
|
|
|
|
|
|
|
// TODO: make private (improves encapsulation)
|
2014-09-19 19:21:46 +02:00
|
|
|
public:
|
|
|
|
enum {
|
|
|
|
COMMAND_SIZE = 12,
|
|
|
|
MESSAGE_SIZE_SIZE = sizeof(int),
|
|
|
|
CHECKSUM_SIZE = sizeof(int),
|
|
|
|
|
|
|
|
MESSAGE_SIZE_OFFSET = MESSAGE_START_SIZE + COMMAND_SIZE,
|
|
|
|
CHECKSUM_OFFSET = MESSAGE_SIZE_OFFSET + MESSAGE_SIZE_SIZE,
|
|
|
|
HEADER_SIZE = MESSAGE_START_SIZE + COMMAND_SIZE + MESSAGE_SIZE_SIZE + CHECKSUM_SIZE
|
|
|
|
};
|
|
|
|
char pchMessageStart[MESSAGE_START_SIZE];
|
|
|
|
char pchCommand[COMMAND_SIZE];
|
|
|
|
unsigned int nMessageSize;
|
|
|
|
unsigned int nChecksum;
|
2011-08-11 18:14:53 +02:00
|
|
|
};
|
|
|
|
|
2012-03-26 16:48:23 +02:00
|
|
|
/** nServices flags */
|
2014-09-19 19:21:46 +02:00
|
|
|
enum {
|
2011-08-11 18:40:12 +02:00
|
|
|
NODE_NETWORK = (1 << 0),
|
2014-06-21 15:05:24 +02:00
|
|
|
|
|
|
|
// Bits 24-31 are reserved for temporary experiments. Just pick a bit that
|
|
|
|
// isn't getting used, or one not being used much, and notify the
|
|
|
|
// bitcoin-development mailing list. Remember that service bits are just
|
|
|
|
// unauthenticated advertisements, so your code must be robust against
|
|
|
|
// collisions and other cases where nodes may be advertising a service they
|
|
|
|
// do not actually support. Other service bits should be allocated via the
|
|
|
|
// BIP process.
|
2011-08-11 18:40:12 +02:00
|
|
|
};
|
|
|
|
|
2012-03-26 16:48:23 +02:00
|
|
|
/** A CService with information about it as peer */
|
2012-01-03 23:33:31 +01:00
|
|
|
class CAddress : public CService
|
2011-08-11 18:40:12 +02:00
|
|
|
{
|
2014-09-19 19:21:46 +02:00
|
|
|
public:
|
|
|
|
CAddress();
|
|
|
|
explicit CAddress(CService ipIn, uint64_t nServicesIn = NODE_NETWORK);
|
|
|
|
|
|
|
|
void Init();
|
|
|
|
|
|
|
|
ADD_SERIALIZE_METHODS;
|
|
|
|
|
|
|
|
template <typename Stream, typename Operation>
|
|
|
|
inline void SerializationOp(Stream& s, Operation ser_action, int nType, int nVersion)
|
|
|
|
{
|
|
|
|
if (ser_action.ForRead())
|
|
|
|
Init();
|
|
|
|
if (nType & SER_DISK)
|
|
|
|
READWRITE(nVersion);
|
|
|
|
if ((nType & SER_DISK) ||
|
|
|
|
(nVersion >= CADDR_TIME_VERSION && !(nType & SER_GETHASH)))
|
|
|
|
READWRITE(nTime);
|
|
|
|
READWRITE(nServices);
|
|
|
|
READWRITE(*(CService*)this);
|
|
|
|
}
|
2011-08-11 18:40:12 +02:00
|
|
|
|
|
|
|
// TODO: make private (improves encapsulation)
|
2014-09-19 19:21:46 +02:00
|
|
|
public:
|
|
|
|
uint64_t nServices;
|
2011-08-11 18:40:12 +02:00
|
|
|
|
2014-09-19 19:21:46 +02:00
|
|
|
// disk and network only
|
|
|
|
unsigned int nTime;
|
2011-08-11 18:40:12 +02:00
|
|
|
|
2014-09-19 19:21:46 +02:00
|
|
|
// memory only
|
|
|
|
int64_t nLastTry;
|
2011-08-11 18:40:12 +02:00
|
|
|
};
|
|
|
|
|
2012-03-26 16:48:23 +02:00
|
|
|
/** inv message data */
|
2011-08-11 18:49:03 +02:00
|
|
|
class CInv
|
|
|
|
{
|
2014-09-19 19:21:46 +02:00
|
|
|
public:
|
|
|
|
CInv();
|
|
|
|
CInv(int typeIn, const uint256& hashIn);
|
|
|
|
CInv(const std::string& strType, const uint256& hashIn);
|
2011-08-11 18:49:03 +02:00
|
|
|
|
2014-09-19 19:21:46 +02:00
|
|
|
ADD_SERIALIZE_METHODS;
|
overhaul serialization code
The implementation of each class' serialization/deserialization is no longer
passed within a macro. The implementation now lies within a template of form:
template <typename T, typename Stream, typename Operation>
inline static size_t SerializationOp(T thisPtr, Stream& s, Operation ser_action, int nType, int nVersion) {
size_t nSerSize = 0;
/* CODE */
return nSerSize;
}
In cases when codepath should depend on whether or not we are just deserializing
(old fGetSize, fWrite, fRead flags) an additional clause can be used:
bool fRead = boost::is_same<Operation, CSerActionUnserialize>();
The IMPLEMENT_SERIALIZE macro will now be a freestanding clause added within
class' body (similiar to Qt's Q_OBJECT) to implement GetSerializeSize,
Serialize and Unserialize. These are now wrappers around
the "SerializationOp" template.
2014-08-20 08:42:31 +02:00
|
|
|
|
2014-09-19 19:21:46 +02:00
|
|
|
template <typename Stream, typename Operation>
|
|
|
|
inline void SerializationOp(Stream& s, Operation ser_action, int nType, int nVersion)
|
|
|
|
{
|
|
|
|
READWRITE(type);
|
|
|
|
READWRITE(hash);
|
|
|
|
}
|
2011-08-11 18:49:03 +02:00
|
|
|
|
2014-09-19 19:21:46 +02:00
|
|
|
friend bool operator<(const CInv& a, const CInv& b);
|
2011-08-11 18:49:03 +02:00
|
|
|
|
2014-09-19 19:21:46 +02:00
|
|
|
bool IsKnownType() const;
|
|
|
|
const char* GetCommand() const;
|
|
|
|
std::string ToString() const;
|
2011-08-11 18:49:03 +02:00
|
|
|
|
|
|
|
// TODO: make private (improves encapsulation)
|
2014-09-19 19:21:46 +02:00
|
|
|
public:
|
|
|
|
int type;
|
|
|
|
uint256 hash;
|
2011-08-11 18:49:03 +02:00
|
|
|
};
|
|
|
|
|
2014-09-19 19:21:46 +02:00
|
|
|
enum {
|
2012-08-13 09:02:44 +02:00
|
|
|
MSG_TX = 1,
|
|
|
|
MSG_BLOCK,
|
2012-08-19 05:45:19 +02:00
|
|
|
// Nodes may always request a MSG_FILTERED_BLOCK in a getdata, however,
|
|
|
|
// MSG_FILTERED_BLOCK should not appear in any invs except as a part of getdata.
|
|
|
|
MSG_FILTERED_BLOCK,
|
2012-08-13 09:02:44 +02:00
|
|
|
};
|
|
|
|
|
2014-11-03 16:16:40 +01:00
|
|
|
#endif // BITCOIN_PROTOCOL_H
|