mirror of
https://github.com/XRPLF/rippled.git
synced 2025-12-06 17:27:55 +00:00
bc5a74057d
This is a substantial refactor of the consensus code and also introduces a basic consensus simulation and testing framework. The new generic/templated version is in src/ripple/consensus and documents the current type requirements. The version adapted for the RCL is in src/ripple/app/consensus. The testing framework is in src/test/csf. Minor behavioral changes/fixes include: * Adjust close time offset even when not validating. * Remove spurious proposing_ = false call at end of handleLCL. * Remove unused functionality provided by checkLastValidation. * Separate open and converge time * Don't send a bow out if we're not proposing * Prevent consensus stopping if NetworkOPs switches to disconnect mode while consensus accepts a ledger * Prevent a corner case in which Consensus::gotTxSet or Consensus::peerProposal has the potential to update internal state while an dispatched accept job is running. * Distinguish external and internal calls to startNewRound. Only external calls can reset the proposing_ state of consensus
131 lines
3.7 KiB
C++
131 lines
3.7 KiB
C++
//------------------------------------------------------------------------------
|
|
/*
|
|
This file is part of rippled: https://github.com/ripple/rippled
|
|
Copyright (c) 2012, 2013 Ripple Labs Inc.
|
|
|
|
Permission to use, copy, modify, and/or distribute this software for any
|
|
purpose with or without fee is hereby granted, provided that the above
|
|
copyright notice and this permission notice appear in all copies.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
*/
|
|
//==============================================================================
|
|
|
|
#ifndef RIPPLE_PROTOCOL_STVALIDATION_H_INCLUDED
|
|
#define RIPPLE_PROTOCOL_STVALIDATION_H_INCLUDED
|
|
|
|
#include <ripple/protocol/PublicKey.h>
|
|
#include <ripple/protocol/SecretKey.h>
|
|
#include <ripple/protocol/STObject.h>
|
|
#include <cstdint>
|
|
#include <memory>
|
|
|
|
namespace ripple {
|
|
|
|
// Validation flags
|
|
const std::uint32_t vfFullyCanonicalSig = 0x80000000; // signature is fully canonical
|
|
|
|
class STValidation final
|
|
: public STObject
|
|
, public CountedObject <STValidation>
|
|
{
|
|
public:
|
|
static char const* getCountedObjectName () { return "STValidation"; }
|
|
|
|
using pointer = std::shared_ptr<STValidation>;
|
|
using ref = const std::shared_ptr<STValidation>&;
|
|
|
|
enum
|
|
{
|
|
kFullFlag = 0x1
|
|
};
|
|
|
|
// These throw if the object is not valid
|
|
STValidation (SerialIter & sit, bool checkSignature = true);
|
|
|
|
// Does not sign the validation
|
|
STValidation (
|
|
uint256 const& ledgerHash,
|
|
NetClock::time_point signTime,
|
|
PublicKey const& raPub,
|
|
bool isFull);
|
|
|
|
STBase*
|
|
copy (std::size_t n, void* buf) const override
|
|
{
|
|
return emplace(n, buf, *this);
|
|
}
|
|
|
|
STBase*
|
|
move (std::size_t n, void* buf) override
|
|
{
|
|
return emplace(n, buf, std::move(*this));
|
|
}
|
|
|
|
uint256 getLedgerHash () const;
|
|
NetClock::time_point getSignTime () const;
|
|
NetClock::time_point getSeenTime () const;
|
|
std::uint32_t getFlags () const;
|
|
PublicKey getSignerPublic () const;
|
|
NodeID getNodeID () const
|
|
{
|
|
return mNodeID;
|
|
}
|
|
bool isValid () const;
|
|
bool isFull () const;
|
|
bool isTrusted () const
|
|
{
|
|
return mTrusted;
|
|
}
|
|
uint256 getSigningHash () const;
|
|
bool isValid (uint256 const& ) const;
|
|
|
|
void setTrusted ()
|
|
{
|
|
mTrusted = true;
|
|
}
|
|
void setSeen (NetClock::time_point s)
|
|
{
|
|
mSeen = s;
|
|
}
|
|
Blob getSerialized () const;
|
|
Blob getSignature () const;
|
|
|
|
// Signs the validation and returns the signing hash
|
|
uint256 sign (SecretKey const& secretKey);
|
|
|
|
// The validation this replaced
|
|
uint256 const& getPreviousHash ()
|
|
{
|
|
return mPreviousHash;
|
|
}
|
|
bool isPreviousHash (uint256 const& h) const
|
|
{
|
|
return mPreviousHash == h;
|
|
}
|
|
void setPreviousHash (uint256 const& h)
|
|
{
|
|
mPreviousHash = h;
|
|
}
|
|
|
|
private:
|
|
static SOTemplate const& getFormat ();
|
|
|
|
void setNode ();
|
|
|
|
uint256 mPreviousHash;
|
|
NodeID mNodeID;
|
|
bool mTrusted = false;
|
|
NetClock::time_point mSeen = {};
|
|
};
|
|
|
|
} // ripple
|
|
|
|
#endif
|