extended.hpp

//
// MIT License
//
// Copyright (c) 2017-2018 Thibault Martinez and Simon Ninon
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
// SOFTWARE.
//
//

#pragma once

#include <iota/api/core.hpp>
#include <iota/models/fwd.hpp>
#include <iota/utils/stop_watch.hpp>

namespace IOTA {

namespace API {

class Extended : public Core {
public:
  Extended(const std::string& host, const uint16_t& port, bool localPow = true, int timeout = 60);
  virtual ~Extended() = default;

public:
  Responses::GetBalancesAndFormat getInputs(const Models::Seed& seed, const int32_t& start = 0,
                                            const int32_t& end       = 0,
                                            const int64_t& threshold = 0) const;

  Responses::GetBalancesAndFormat getBalancesAndFormat(
      const std::vector<Models::Address>& addresses, const int64_t& threshold = 0) const;

  Responses::GetNewAddresses getNewAddresses(const Models::Seed& seed, const uint32_t& index = 0,
                                             const int32_t& total     = 0,
                                             bool           returnAll = false) const;

  Models::Bundle traverseBundle(const Types::Trytes& trunkTx) const;

  std::vector<Models::Bundle> traverseBundles(const std::vector<Types::Trytes>& trunkTrxs,
                                              bool throwOnFail = true) const;

  static void verifyBundle(const Models::Bundle& bundle);

  std::vector<Models::Bundle> bundlesFromAddresses(const std::vector<Models::Address>& addresses,
                                                   bool withInclusionStates = false) const;

  std::vector<Models::Transaction> findTransactionObjects(
      const std::vector<Models::Address>& addresses) const;

  std::vector<Models::Transaction> getTransactionsObjects(
      const std::vector<IOTA::Types::Trytes>& trx_hashes) const;

  std::vector<Models::Transaction> findTransactionObjectsByBundle(
      const std::vector<IOTA::Types::Trytes>& input) const;

  Responses::GetInclusionStates getLatestInclusion(const std::vector<Types::Trytes>& hashes) const;

  std::vector<Types::Trytes> prepareTransfers(const Models::Seed&                  seed,
                                              const std::vector<Models::Transfer>& transfers,
                                              const Models::Address&               remainder = {},
                                              const std::vector<Models::Address>&  inputs    = {},
                                              bool validateInputs = true) const;

  Responses::GetBundle getBundle(const Types::Trytes& transaction) const;

  Responses::GetTransfers getTransfers(const Models::Seed& seed, int start = 0, int end = 0,
                                       bool inclusionStates = false) const;

  Responses::SendTransfer sendTransfer(const Models::Seed& seed, int depth, int minWeightMagnitude,
                                       std::vector<Models::Transfer>&      transfers,
                                       const std::vector<Models::Address>& inputs    = {},
                                       const Models::Address&              remainder = {},
                                       const Types::Trytes&                reference = "") const;

  std::vector<Models::Transaction> sendTrytes(const std::vector<Types::Trytes>& trytes,
                                              const unsigned int&               depth,
                                              const unsigned int&               minWeightMagnitude,
                                              const Types::Trytes& reference = "") const;

  Responses::Base broadcastAndStore(const std::vector<Types::Trytes>& trytes) const;

  Responses::FindTransactions findTransactionsByAddresses(
      const std::vector<Models::Address>& addresses) const;

  Responses::FindTransactions findTransactionsByTags(const std::vector<Models::Tag>& tags) const;

  Responses::FindTransactions findTransactionsByApprovees(
      const std::vector<Types::Trytes>& approvees) const;

  Responses::FindTransactions findTransactionsByBundles(
      const std::vector<Types::Trytes>& bundles) const;

  Responses::GetAccountData getAccountData(const Models::Seed& seed, int start = 0, int end = 0,
                                           bool inclusionStates = true, long threshold = 0) const;

  std::vector<Types::Trytes> addRemainder(
      const Models::Seed& seed, const std::vector<Models::Address>& inputs, Models::Bundle& bundle,
      const Models::Tag& tag, int64_t totalValue, const Models::Address& remainderAddress,
      const std::vector<Types::Trytes>& signatureFragments = {}) const;

  Responses::ReplayBundle replayBundle(const Types::Trytes& transaction, int depth,
                                       int minWeightMagnitude) const;

  std::vector<Models::Transaction> initiateTransfer(
      const Models::Address& inputAddress, const Models::Address& remainderAddress,
      const std::vector<Models::Transfer>& transfers) const;

  bool isPromotable(const Types::Trytes& tail) const;

  Responses::SendTransfer promoteTransaction(const Types::Trytes& tail, int depth,
                                             int                            minWeightMagnitude,
                                             std::vector<Models::Transfer>& transfers, int delay,
                                             const std::function<bool()>& interrupt) const;

  std::vector<bool> isReattachable(const std::vector<Models::Address>& addresses);

private:
  void traverseBundles(const std::vector<Types::Trytes>&                          trxs,
                       const std::vector<std::reference_wrapper<Models::Bundle>>& bundles,
                       bool throwOnFail) const;

  static bool isTransfersCollectionValid(const std::vector<Models::Transfer>& transfers);
};

}  // namespace API

}  // namespace IOTA