inputHistory.hpp

Go to the documentation of this file.

#pragma once
 
#include "../inputSet.hpp"
#include <jaffarCommon/deserializers/base.hpp>
#include <jaffarCommon/json.hpp>
#include <jaffarCommon/serializers/base.hpp>
#include <map>
#include <memory>
#include <string>
 
namespace jaffarPlus
{
 
class InputHistory
{
public:
  virtual ~InputHistory() = default;
 
  // ---- per-runner cursor ---------------------------------------------------------------------------
  //
  // NOTE: the step counter is NOT owned here. The Runner owns the count (it is what implements Hash Step
  // Tolerance) and is the sole party that serializes/deserializes it, prepending it to the cold/full blob.
  // Strategies that need the current step (raw's write position, the trie's reconstruction length) receive
  // it as a parameter; they never store or serialize it themselves.
 
  virtual void reset() = 0;
 
  virtual void pushInput(const size_t stepCount, const InputSet::inputIndex_t input) = 0;
 
  virtual void serializeCold(jaffarCommon::serializer::Base& s) const = 0;
  virtual void deserializeCold(jaffarCommon::deserializer::Base& d) = 0;
 
  virtual void serializeFull(jaffarCommon::serializer::Base& s) const = 0;
  virtual void deserializeFull(jaffarCommon::deserializer::Base& d, const size_t stepCount) = 0;
 
  virtual std::string toString(const std::map<InputSet::inputIndex_t, std::string>& inputStringMap, const size_t stepCount) const = 0;
 
  // ---- manager ops on stored bytes (use the shared backing only) -----------------------------------
 
  virtual size_t getColdSize() const = 0;
  virtual size_t getFullSize() const = 0;
 
  virtual void initColdSlot(void* cold) const { (void)cold; }
  virtual void releaseColdSlot(void* cold, const size_t shard) const
  {
    (void)cold;
    (void)shard;
  }
  virtual void captureColdToFull(const void* cold, void* full) const = 0;
 
  virtual size_t getApproxMemoryBytes() const { return 0; }
};
 
} // namespace jaffarPlus