dag_node.h

#ifndef IPFS_DAG_NODE_H_
#define IPFS_DAG_NODE_H_
 
#include "link.h"
#include "resolution_state.h"
 
#include <ipfs_client/gw/gateway_request.h>
#include <ipfs_client/ipld/block_source.h>
 
#include <ipfs_client/cid.h>
#include <ipfs_client/response.h>
#include <vocab/slash_delimited.h>
 
#include <cstdint>
 
#include <functional>
#include <memory>
#include <string>
#include <string_view>
#include <variant>
#include <vector>
 
namespace ipfs {
class PbDag;
class Client;
struct ValidatedIpns;
}  // namespace ipfs
namespace libp2p::multi {
struct ContentIdentifier;
}
namespace ipfs::ipld {
 
using NodePtr = std::shared_ptr<DagNode>;
class DirShard;
class DnsLinkName;
class IpnsName;
 
struct MoreDataNeeded {
  explicit MoreDataNeeded(std::string one) : ipfs_abs_paths_{{one}} {}
  template <class Range>
  explicit MoreDataNeeded(Range const& many)
      : ipfs_abs_paths_(many.begin(), many.end()) {}
  std::vector<std::string> ipfs_abs_paths_;
};
enum class ProvenAbsent {};
struct PathChange {
  std::string new_path;
};
 
using ResolveResult =
    std::variant<MoreDataNeeded, Response, ProvenAbsent, PathChange>;
class DagNode : public std::enable_shared_from_this<DagNode> {
  Link* FindChild(std::string_view);
  BlockSource source_;
 
  virtual ResolveResult resolve(ResolutionState& params) = 0;
 
 protected:
  std::vector<std::pair<std::string, Link>> links_;
  std::shared_ptr<Client> api_;
 
  ResolveResult CallChild(ResolutionState&);
 
  ResolveResult CallChild(ResolutionState&,
                          std::function<NodePtr(std::string_view)> gen_child);
 
  ResolveResult CallChild(ResolutionState&, std::string_view link_key);
 
  ResolveResult CallChild(ResolutionState&,
                          std::string_view link_key,
                          std::string_view block_key);
  
 public:
  ResolveResult Resolve(ResolutionState& params);
 
  static NodePtr fromBytes(std::shared_ptr<Client> const& api,
                           Cid const&,
                           ByteView bytes);
  static NodePtr fromBytes(std::shared_ptr<Client> const& api,
                           Cid const&,
                           std::string_view bytes);
  static NodePtr fromBlock(PbDag const&);
 
  virtual ~DagNode() noexcept;
 
  virtual NodePtr rooted();
  virtual NodePtr deroot();
 
  virtual DnsLinkName const* as_dnslink() const { return nullptr; }
  virtual DirShard* as_hamt() { return nullptr; }
  virtual IpnsName const* as_ipns() const { return nullptr; }
 
  virtual bool expired() const;
  virtual bool PreferOver(DagNode const& another) const;
 
  void set_api(std::shared_ptr<Client> api);
  void source(BlockSource src) { source_ = src; }
};
}  // namespace ipfs::ipld
 
std::ostream& operator<<(std::ostream&, ipfs::ipld::PathChange const&);
 
#endif  // IPFS_DAG_NODE_H_