node_info_network.h

Go to the documentation of this file.

// Copyright (c) Microsoft Corporation. All rights reserved.
// Licensed under the Apache 2.0 License.
 
#pragma once
 
#include "ccf/ds/json.h"
#include "ccf/ds/nonstd.h"
#include "ccf/http_configuration.h"
#include "ccf/service/operator_feature.h"
 
#include <string>
 
namespace ccf
{
  enum class Authority : uint8_t
  {
    NODE,
    SERVICE,
    ACME, // DEPRECATED
    UNSECURED
  };
  DECLARE_JSON_ENUM(
    Authority,
    {{Authority::NODE, "Node"},
     {Authority::SERVICE, "Service"},
     {Authority::ACME, "ACME"}, // DEPRECATED
     {Authority::UNSECURED, "Unsecured"}});
 
  using ApplicationProtocol = std::string;
 
  struct Endorsement
  {
    Authority authority;
    bool operator==(const Endorsement& other) const
    {
      return authority == other.authority;
    }
  };
  DECLARE_JSON_TYPE(Endorsement);
  DECLARE_JSON_REQUIRED_FIELDS(Endorsement, authority);
 
  struct NodeInfoNetwork_v1
  {
    std::string rpchost;
    std::string pubhost;
    std::string nodehost;
    std::string nodeport;
    std::string rpcport;
    std::string pubport;
  };
  DECLARE_JSON_TYPE(NodeInfoNetwork_v1);
  DECLARE_JSON_REQUIRED_FIELDS(
    NodeInfoNetwork_v1, rpchost, pubhost, nodehost, nodeport, rpcport, pubport);
 
  static constexpr auto PRIMARY_RPC_INTERFACE = "primary_rpc_interface";
 
  enum class RedirectionResolutionKind : uint8_t
  {
    NodeByRole,
    StaticAddress
  };
  DECLARE_JSON_ENUM(
    RedirectionResolutionKind,
    {{RedirectionResolutionKind::NodeByRole, "NodeByRole"},
     {RedirectionResolutionKind::StaticAddress, "StaticAddress"}});
 
  struct RedirectionResolverConfig
  {
    RedirectionResolutionKind kind = RedirectionResolutionKind::NodeByRole;
    nlohmann::json target;
 
    bool operator==(const RedirectionResolverConfig&) const = default;
  };
  DECLARE_JSON_TYPE_WITH_OPTIONAL_FIELDS(RedirectionResolverConfig);
  DECLARE_JSON_REQUIRED_FIELDS(RedirectionResolverConfig, kind);
  DECLARE_JSON_OPTIONAL_FIELDS(RedirectionResolverConfig, target);
 
  struct NodeInfoNetwork_v2
  {
    using NetAddress = std::string;
    using RpcInterfaceID = std::string;
    using NetProtocol = std::string;
 
    struct NetInterface
    {
      NetAddress bind_address;
      NetAddress published_address;
      NetProtocol protocol;
      std::optional<ApplicationProtocol> app_protocol = std::nullopt;
 
      std::optional<size_t> max_open_sessions_soft = std::nullopt;
 
      std::optional<size_t> max_open_sessions_hard = std::nullopt;
 
      std::optional<http::ParserConfiguration> http_configuration =
        std::nullopt;
 
      std::optional<Endorsement> endorsement = std::nullopt;
 
      std::optional<std::vector<std::string>> accepted_endpoints = std::nullopt;
 
      std::optional<size_t> forwarding_timeout_ms = std::nullopt;
 
      std::set<ccf::endpoints::OperatorFeature> enabled_operator_features;
 
      struct Redirections
      {
        RedirectionResolverConfig to_primary;
        RedirectionResolverConfig to_backup;
 
        bool operator==(const Redirections& other) const = default;
      };
 
      std::optional<Redirections> redirections = std::nullopt;
 
      bool operator==(const NetInterface& other) const
      {
        return bind_address == other.bind_address &&
          published_address == other.published_address &&
          protocol == other.protocol && app_protocol == other.app_protocol &&
          max_open_sessions_soft == other.max_open_sessions_soft &&
          max_open_sessions_hard == other.max_open_sessions_hard &&
          endorsement == other.endorsement &&
          http_configuration == other.http_configuration &&
          accepted_endpoints == other.accepted_endpoints &&
          forwarding_timeout_ms == other.forwarding_timeout_ms &&
          enabled_operator_features == other.enabled_operator_features &&
          redirections == other.redirections;
      }
    };
 
    using RpcInterfaces = std::map<RpcInterfaceID, NetInterface>;
 
    NetInterface node_to_node_interface;
 
    RpcInterfaces rpc_interfaces;
 
    // Denote whether this node will locally seal the ledger secret
    bool will_locally_seal_ledger_secrets = false;
  };
 
  DECLARE_JSON_TYPE_WITH_OPTIONAL_FIELDS(
    NodeInfoNetwork_v2::NetInterface::Redirections);
  DECLARE_JSON_REQUIRED_FIELDS(NodeInfoNetwork_v2::NetInterface::Redirections);
  DECLARE_JSON_OPTIONAL_FIELDS(
    NodeInfoNetwork_v2::NetInterface::Redirections, to_primary, to_backup);
  DECLARE_JSON_TYPE_WITH_OPTIONAL_FIELDS(NodeInfoNetwork_v2::NetInterface);
  DECLARE_JSON_REQUIRED_FIELDS(NodeInfoNetwork_v2::NetInterface, bind_address);
  DECLARE_JSON_OPTIONAL_FIELDS(
    NodeInfoNetwork_v2::NetInterface,
    endorsement,
    max_open_sessions_soft,
    max_open_sessions_hard,
    published_address,
    protocol,
    app_protocol,
    http_configuration,
    accepted_endpoints,
    forwarding_timeout_ms,
    enabled_operator_features,
    redirections);
  DECLARE_JSON_TYPE_WITH_OPTIONAL_FIELDS(NodeInfoNetwork_v2);
  DECLARE_JSON_REQUIRED_FIELDS(
    NodeInfoNetwork_v2, node_to_node_interface, rpc_interfaces);
  DECLARE_JSON_OPTIONAL_FIELDS(
    NodeInfoNetwork_v2, will_locally_seal_ledger_secrets);
 
  struct NodeInfoNetwork : public NodeInfoNetwork_v2
  {
    NodeInfoNetwork() = default;
    NodeInfoNetwork(const NodeInfoNetwork_v2& other) : NodeInfoNetwork_v2(other)
    {}
 
    bool operator==(const NodeInfoNetwork& other) const
    {
      return node_to_node_interface == other.node_to_node_interface &&
        rpc_interfaces == other.rpc_interfaces;
    }
  };
 
  inline static std::pair<std::string, std::string> split_net_address(
    const NodeInfoNetwork::NetAddress& addr)
  {
    auto [host, port] = ccf::nonstd::rsplit_1(addr, ":");
    return std::make_pair(std::string(host), std::string(port));
  }
 
  inline static NodeInfoNetwork::NetAddress make_net_address(
    const std::string& host, const std::string& port)
  {
    return fmt::format("{}:{}", host, port);
  }
 
  // The JSON representation of a NodeInfoNetwork is the union of a
  // NodeInfoNetwork_v1 and a NodeInfoNetwork_v2. It contains the fields of
  // both, so can be read as (or from!) either
  inline void to_json(nlohmann::json& j, const NodeInfoNetwork& nin)
  {
    {
      NodeInfoNetwork_v1 v1;
      std::tie(v1.nodehost, v1.nodeport) =
        split_net_address(nin.node_to_node_interface.bind_address);
 
      if (!nin.rpc_interfaces.empty())
      {
        const auto& primary_interface = nin.rpc_interfaces.begin()->second;
        std::tie(v1.rpchost, v1.rpcport) =
          split_net_address(primary_interface.bind_address);
        std::tie(v1.pubhost, v1.pubport) =
          split_net_address(primary_interface.published_address);
      }
      to_json(j, v1);
    }
 
    to_json(j, (const NodeInfoNetwork_v2&)nin);
  }
 
  inline void from_json(const nlohmann::json& j, NodeInfoNetwork& nin)
  {
    try
    {
      NodeInfoNetwork_v2 v2;
      from_json(j, v2);
      nin = NodeInfoNetwork(v2);
    }
    catch (const ccf::JsonParseError& jpe)
    {
      NodeInfoNetwork_v1 v1;
      try
      {
        from_json(j, v1);
      }
      catch (const ccf::JsonParseError& _)
      {
        // If this also fails to parse as a v1, then rethrow the earlier error.
        // Configs should now be using v2, and this v1 parsing is just a
        // backwards-compatibility shim, which does not get to return errors.
        throw jpe;
      }
 
      nin.node_to_node_interface.bind_address =
        make_net_address(v1.nodehost, v1.nodeport);
 
      NodeInfoNetwork::NetInterface primary_interface;
      primary_interface.bind_address = make_net_address(v1.rpchost, v1.rpcport);
      primary_interface.published_address =
        make_net_address(v1.pubhost, v1.pubport);
 
      nin.rpc_interfaces.emplace(
        PRIMARY_RPC_INTERFACE, std::move(primary_interface));
    }
  }
}
 
FMT_BEGIN_NAMESPACE template <>
struct formatter<ccf::Authority>
{
  template <typename ParseContext>
  constexpr auto parse(ParseContext& ctx)
  {
    return ctx.begin();
  }
 
  template <typename FormatContext>
  auto format(const ccf::Authority& authority, FormatContext& ctx) const
    -> decltype(ctx.out())
  {
    switch (authority)
    {
      case (ccf::Authority::NODE):
      {
        return format_to(ctx.out(), "Node");
      }
      case (ccf::Authority::SERVICE):
      {
        return format_to(ctx.out(), "Service");
      }
      case (ccf::Authority::ACME):
      {
        return format_to(ctx.out(), "ACME");
      }
      case (ccf::Authority::UNSECURED):
      {
        return format_to(ctx.out(), "Unsecured");
      }
    }
  }
};
FMT_END_NAMESPACE