ethminer/libethereum/BlockChain.h

/*
	This file is part of cpp-ethereum.

	cpp-ethereum is free software: you can redistribute it and/or modify
	it under the terms of the GNU General Public License as published by
	the Free Software Foundation, either version 3 of the License, or
	(at your option) any later version.

	Foobar is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
	GNU General Public License for more details.

	You should have received a copy of the GNU General Public License
	along with Foobar.  If not, see <http://www.gnu.org/licenses/>.
*/
/** @file BlockChain.h
 * @author Gav Wood <i@gavwood.com>
 * @date 2014
 */

#pragma once

#include "Common.h"
#include <leveldb/db.h>
namespace ldb = leveldb;

namespace eth
{

struct BlockDetails
{
	uint number;
	u256 totalDifficulty;
	u256 parent;
};

static const BlockDetails NullBlockDetails({0, 0, 0});

/**
 * @brief Implements the blockchain database. All data this gives is disk-backed.
 */
class BlockChain
{
public:
	BlockChain();
	~BlockChain();

	/// (Potentially) renders invalid existing bytesConstRef returned by lastBlock.
	/// To be called from main loop every 100ms or so.
	void process();
	
	/// Attempt to import the given block.
	bool attemptImport(bytes const& _block) { try { import(_block); return true; } catch (...) { return false; } }

	/// Import block into disk-backed DB
	void import(bytes const& _block);

	/// Get the full block chain, according to the GHOST algo and the blocks available in the db.
	u256s blockChain(u256Set const& _earlyExit) const;

	/// Get the number of the last block of the longest chain.
	BlockDetails const& details(u256 _hash) const;

	/// Get a given block (RLP format).
	bytesConstRef block(u256 _hash) const;

	/// Get a given block (RLP format).
	u256 currentHash() const { return m_lastBlockHash; }

private:
	/// Get fully populated from disk DB.
	mutable std::map<u256, BlockDetails> m_details;
	mutable std::multimap<u256, u256> m_children;

	mutable std::map<u256, std::string> m_cache;

	ldb::DB* m_db;

	/// Hash of the last (valid) block on the longest chain.
	u256 m_lastBlockHash;
	u256 m_genesisHash;
	bytes m_genesisBlock;

	ldb::ReadOptions m_readOptions;
	ldb::WriteOptions m_writeOptions;
};

}