//------------------------------------------------------------------------------ /* 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 #include #include #include #include #include #include namespace ripple { // Validation flags const std::uint32_t vfFullyCanonicalSig = 0x80000000; // signature is fully canonical class STValidation final : public STObject, public CountedObject { public: static char const* getCountedObjectName() { return "STValidation"; } using pointer = std::shared_ptr; using ref = const std::shared_ptr&; enum { kFullFlag = 0x1 }; /** Construct a STValidation from a peer. Construct a STValidation from serialized data previously shared by a peer. @param sit Iterator over serialized data @param lookupNodeID Invocable with signature NodeID(PublicKey const&) used to find the Node ID based on the public key that signed the validation. For manifest based validators, this should be the NodeID of the master public key. @param checkSignature Whether to verify the data was signed properly @note Throws if the object is not valid */ template STValidation( SerialIter& sit, LookupNodeID&& lookupNodeID, bool checkSignature) : STObject(getFormat(), sit, sfValidation) { mNodeID = lookupNodeID(PublicKey(makeSlice(getFieldVL(sfSigningPubKey)))); assert(mNodeID.isNonZero()); if (checkSignature && !isValid()) { JLOG(debugLog().error()) << "Invalid validation" << getJson(0); Throw("Invalid validation"); } } /** Construct a new STValidation Constructs a new STValidation issued by a node. The instance should be signed before sharing with other nodes. @param ledgerHash The hash of the validated ledger @param signTime When the validation is signed @param publicKey The current signing public key @param nodeID ID corresponding to node's public master key @param isFull Whether the validation is full or partial */ STValidation( uint256 const& ledgerHash, NetClock::time_point signTime, PublicKey const& publicKey, NodeID const& nodeID, 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 setUntrusted() { mTrusted = false; } 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); private: static SOTemplate const& getFormat(); NodeID mNodeID; bool mTrusted = false; NetClock::time_point mSeen = {}; }; } // ripple #endif