node_call_types.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_schema.h"
#include "ccf/node/cose_signatures_config.h"
#include "ccf/node/ledger_sign_mode.h"
#include "ccf/node_startup_state.h"
#include "ccf/service/local_sealing.h"
#include "ccf/service/node_info_network.h"
#include "ccf/service/tables/code_id.h"
#include "ccf/service/tables/host_data.h"
#include "ccf/service/tables/members.h"
#include "ccf/service/tables/self_healing_open.h"
#include "ccf/service/tables/service.h"
#include "common/configuration.h"
#include "enclave/interface.h"
#include "node/identity.h"
#include "node/ledger_secrets.h"
#include "node/uvm_endorsements.h"
 
#include <nlohmann/json.hpp>
 
namespace ccf
{
  struct GetState
  {
    using In = void;
 
    struct Out
    {
      ccf::NodeId node_id;
      ccf::NodeStartupState state{};
      ccf::kv::Version last_signed_seqno{};
      ccf::kv::Version startup_seqno{};
 
      // Only on recovery
      std::optional<ccf::kv::Version> recovery_target_seqno;
      std::optional<ccf::kv::Version> last_recovered_seqno;
 
      bool stop_notice{};
    };
  };
 
  struct GetVersion
  {
    using In = void;
 
    struct Out
    {
      std::string ccf_version;
      std::string quickjs_version;
      bool unsafe{};
    };
  };
 
  struct CreateNetworkNodeToNode
  {
    struct In
    {
      NodeId node_id;
      ccf::crypto::Pem certificate_signing_request;
      ccf::crypto::Pem node_endorsed_certificate;
      ccf::crypto::Pem public_key;
      ccf::crypto::Pem service_cert;
      QuoteInfo quote_info;
      ccf::crypto::Pem public_encryption_key;
      pal::PlatformAttestationMeasurement measurement;
      std::optional<HostDataMetadata> snp_security_policy =
        std::nullopt; // base64-encoded
      std::optional<pal::UVMEndorsements> snp_uvm_endorsements = std::nullopt;
      NodeInfoNetwork node_info_network;
      nlohmann::json node_data;
      nlohmann::json service_data;
      ccf::TxID create_txid;
      std::optional<std::pair<SealedRecoveryKey, sealing_recovery::Name>>
        sealing_recovery_data = std::nullopt;
 
      // Only set on genesis transaction, but not on recovery
      std::optional<ccf::StartupConfig::Start> genesis_info = std::nullopt;
    };
  };
 
  struct JoinNetworkNodeToNode
  {
    struct In
    {
      NodeInfoNetwork node_info_network;
      QuoteInfo quote_info;
      ccf::crypto::Pem public_encryption_key;
      std::optional<ccf::kv::Version> startup_seqno = std::nullopt;
      std::optional<ccf::crypto::Pem> certificate_signing_request =
        std::nullopt;
      nlohmann::json node_data = nullptr;
      std::optional<std::pair<SealedRecoveryKey, sealing_recovery::Name>>
        sealing_recovery_data = std::nullopt;
      std::optional<std::vector<uint8_t>> code_transparent_statement =
        std::nullopt;
      std::optional<ccf::LedgerSignMode> ledger_sign_mode = std::nullopt;
      // Incremented by the joiner each time it retries a join request after
      // receiving a StartupSeqnoIsOld response.
      std::optional<uint32_t> join_fetch_count = std::nullopt;
    };
 
    struct Out
    {
      NodeStatus node_status{};
 
      // Deprecated in 2.x
      std::optional<NodeId> node_id = std::nullopt;
 
      struct NetworkInfo
      {
        bool public_only = false;
        ccf::kv::Version last_recovered_signed_idx = ccf::kv::NoVersion;
        LedgerSecretsMap ledger_secrets;
        NetworkIdentity identity;
        std::optional<ServiceStatus> service_status = std::nullopt;
 
        std::optional<ccf::crypto::Pem> endorsed_certificate = std::nullopt;
        std::optional<ccf::COSESignaturesConfig> cose_signatures_config =
          std::nullopt;
 
        NetworkInfo() = default;
 
        NetworkInfo(
          bool public_only,
          ccf::kv::Version last_recovered_signed_idx,
          LedgerSecretsMap ledger_secrets,
          const NetworkIdentity& identity,
          ServiceStatus service_status,
          std::optional<ccf::crypto::Pem> endorsed_certificate,
          std::optional<ccf::COSESignaturesConfig> cose_signatures_config_) :
          public_only(public_only),
          last_recovered_signed_idx(last_recovered_signed_idx),
          ledger_secrets(std::move(ledger_secrets)),
          identity(identity),
          service_status(service_status),
          endorsed_certificate(std::move(endorsed_certificate)),
          cose_signatures_config(std::move(cose_signatures_config_))
        {}
 
        bool operator==(const NetworkInfo& other) const
        {
          return public_only == other.public_only &&
            last_recovered_signed_idx == other.last_recovered_signed_idx &&
            ledger_secrets == other.ledger_secrets &&
            identity == other.identity &&
            service_status == other.service_status &&
            endorsed_certificate == other.endorsed_certificate &&
            cose_signatures_config == other.cose_signatures_config;
        }
 
        bool operator!=(const NetworkInfo& other) const
        {
          return !(*this == other);
        }
      };
 
      // Only set if the caller node is trusted
      std::optional<NetworkInfo> network_info = std::nullopt;
    };
  };
 
}