2013-01-08 12:02:51 +01: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
|
2013-01-08 12:02:51 +01:00
|
|
|
// file COPYING or http://www.opensource.org/licenses/mit-license.php.
|
2013-04-13 07:13:08 +02:00
|
|
|
|
2014-11-18 22:03:02 +01:00
|
|
|
#ifndef BITCOIN_PRIMITIVES_BLOCK_H
|
|
|
|
#define BITCOIN_PRIMITIVES_BLOCK_H
|
2013-01-08 12:02:51 +01:00
|
|
|
|
2014-11-18 22:03:02 +01:00
|
|
|
#include "primitives/transaction.h"
|
2013-04-13 07:13:08 +02:00
|
|
|
#include "serialize.h"
|
|
|
|
#include "uint256.h"
|
|
|
|
|
2014-10-30 23:50:15 +01:00
|
|
|
/** The maximum allowed size for a serialized block, in bytes (network rule) */
|
|
|
|
static const unsigned int MAX_BLOCK_SIZE = 1000000;
|
|
|
|
|
2013-01-08 23:58:06 +01:00
|
|
|
/** Nodes collect new transactions into a block, hash them into a hash tree,
|
|
|
|
* and scan through nonce values to make the block's hash satisfy proof-of-work
|
|
|
|
* requirements. When they solve the proof-of-work, they broadcast the block
|
|
|
|
* to everyone and the block is added to the block chain. The first transaction
|
|
|
|
* in the block is a special one that creates a new coin owned by the creator
|
|
|
|
* of the block.
|
|
|
|
*/
|
|
|
|
class CBlockHeader
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
// header
|
2014-08-07 15:39:49 +02:00
|
|
|
static const int32_t CURRENT_VERSION=2;
|
|
|
|
int32_t nVersion;
|
2013-01-08 23:58:06 +01:00
|
|
|
uint256 hashPrevBlock;
|
|
|
|
uint256 hashMerkleRoot;
|
2014-08-07 15:39:49 +02:00
|
|
|
uint32_t nTime;
|
|
|
|
uint32_t nBits;
|
|
|
|
uint32_t nNonce;
|
2013-01-08 23:58:06 +01:00
|
|
|
|
|
|
|
CBlockHeader()
|
|
|
|
{
|
|
|
|
SetNull();
|
|
|
|
}
|
|
|
|
|
2014-09-02 09:58:09 +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-08-20 22:44:38 +02:00
|
|
|
template <typename Stream, typename Operation>
|
2014-08-21 00:49:32 +02:00
|
|
|
inline void SerializationOp(Stream& s, Operation ser_action, int nType, int nVersion) {
|
2013-01-08 23:58:06 +01:00
|
|
|
READWRITE(this->nVersion);
|
|
|
|
nVersion = this->nVersion;
|
|
|
|
READWRITE(hashPrevBlock);
|
|
|
|
READWRITE(hashMerkleRoot);
|
|
|
|
READWRITE(nTime);
|
|
|
|
READWRITE(nBits);
|
|
|
|
READWRITE(nNonce);
|
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
|
|
|
}
|
2013-01-08 23:58:06 +01:00
|
|
|
|
|
|
|
void SetNull()
|
|
|
|
{
|
|
|
|
nVersion = CBlockHeader::CURRENT_VERSION;
|
|
|
|
hashPrevBlock = 0;
|
|
|
|
hashMerkleRoot = 0;
|
|
|
|
nTime = 0;
|
|
|
|
nBits = 0;
|
|
|
|
nNonce = 0;
|
|
|
|
}
|
|
|
|
|
|
|
|
bool IsNull() const
|
|
|
|
{
|
|
|
|
return (nBits == 0);
|
|
|
|
}
|
|
|
|
|
2013-06-25 03:03:03 +02:00
|
|
|
uint256 GetHash() const;
|
2013-01-08 23:58:06 +01:00
|
|
|
|
2013-04-13 07:13:08 +02:00
|
|
|
int64_t GetBlockTime() const
|
2013-01-08 23:58:06 +01:00
|
|
|
{
|
2013-04-13 07:13:08 +02:00
|
|
|
return (int64_t)nTime;
|
2013-01-08 23:58:06 +01:00
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2013-06-24 04:37:03 +02:00
|
|
|
|
|
|
|
class CBlock : public CBlockHeader
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
// network and disk
|
|
|
|
std::vector<CTransaction> vtx;
|
|
|
|
|
|
|
|
// memory only
|
|
|
|
mutable std::vector<uint256> vMerkleTree;
|
|
|
|
|
|
|
|
CBlock()
|
|
|
|
{
|
|
|
|
SetNull();
|
|
|
|
}
|
|
|
|
|
|
|
|
CBlock(const CBlockHeader &header)
|
|
|
|
{
|
|
|
|
SetNull();
|
|
|
|
*((CBlockHeader*)this) = header;
|
|
|
|
}
|
|
|
|
|
2014-09-02 09:58:09 +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-08-20 22:44:38 +02:00
|
|
|
template <typename Stream, typename Operation>
|
2014-08-21 00:49:32 +02:00
|
|
|
inline void SerializationOp(Stream& s, Operation ser_action, int nType, int nVersion) {
|
2013-06-24 04:37:03 +02:00
|
|
|
READWRITE(*(CBlockHeader*)this);
|
|
|
|
READWRITE(vtx);
|
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
|
|
|
}
|
2013-06-24 04:37:03 +02:00
|
|
|
|
|
|
|
void SetNull()
|
|
|
|
{
|
|
|
|
CBlockHeader::SetNull();
|
|
|
|
vtx.clear();
|
|
|
|
vMerkleTree.clear();
|
|
|
|
}
|
|
|
|
|
|
|
|
CBlockHeader GetBlockHeader() const
|
|
|
|
{
|
|
|
|
CBlockHeader block;
|
|
|
|
block.nVersion = nVersion;
|
|
|
|
block.hashPrevBlock = hashPrevBlock;
|
|
|
|
block.hashMerkleRoot = hashMerkleRoot;
|
|
|
|
block.nTime = nTime;
|
|
|
|
block.nBits = nBits;
|
|
|
|
block.nNonce = nNonce;
|
|
|
|
return block;
|
|
|
|
}
|
|
|
|
|
2014-09-16 00:30:05 +02:00
|
|
|
// Build the in-memory merkle tree for this block and return the merkle root.
|
|
|
|
// If non-NULL, *mutated is set to whether mutation was detected in the merkle
|
|
|
|
// tree (a duplication of transactions in the block leading to an identical
|
|
|
|
// merkle root).
|
|
|
|
uint256 BuildMerkleTree(bool* mutated = NULL) const;
|
2013-06-24 04:37:03 +02:00
|
|
|
|
2013-06-25 03:03:03 +02:00
|
|
|
std::vector<uint256> GetMerkleBranch(int nIndex) const;
|
|
|
|
static uint256 CheckMerkleBranch(uint256 hash, const std::vector<uint256>& vMerkleBranch, int nIndex);
|
2014-08-20 10:26:27 +02:00
|
|
|
std::string ToString() const;
|
2013-06-24 04:37:03 +02:00
|
|
|
};
|
|
|
|
|
2013-10-12 15:22:33 +02:00
|
|
|
|
|
|
|
/** Describes a place in the block chain to another node such that if the
|
|
|
|
* other node doesn't have the same branch, it can find a recent common trunk.
|
|
|
|
* The further back it is, the further before the fork it may be.
|
|
|
|
*/
|
|
|
|
struct CBlockLocator
|
|
|
|
{
|
|
|
|
std::vector<uint256> vHave;
|
|
|
|
|
|
|
|
CBlockLocator() {}
|
|
|
|
|
|
|
|
CBlockLocator(const std::vector<uint256>& vHaveIn)
|
|
|
|
{
|
|
|
|
vHave = vHaveIn;
|
|
|
|
}
|
|
|
|
|
2014-09-02 09:58:09 +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-08-20 22:44:38 +02:00
|
|
|
template <typename Stream, typename Operation>
|
2014-08-21 00:49:32 +02:00
|
|
|
inline void SerializationOp(Stream& s, Operation ser_action, int nType, int nVersion) {
|
2013-10-12 15:22:33 +02:00
|
|
|
if (!(nType & SER_GETHASH))
|
|
|
|
READWRITE(nVersion);
|
|
|
|
READWRITE(vHave);
|
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
|
|
|
}
|
2013-10-12 15:22:33 +02:00
|
|
|
|
|
|
|
void SetNull()
|
|
|
|
{
|
|
|
|
vHave.clear();
|
|
|
|
}
|
|
|
|
|
|
|
|
bool IsNull()
|
|
|
|
{
|
|
|
|
return vHave.empty();
|
|
|
|
}
|
|
|
|
};
|
|
|
|
|
2014-11-18 22:03:02 +01:00
|
|
|
#endif // BITCOIN_PRIMITIVES_BLOCK_H
|