//------------------------------------------------------------------------------ /* This file is part of clio: https://github.com/XRPLF/clio Copyright (c) 2024, the clio developers. Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ //============================================================================== #pragma once #include "data/BackendInterface.hpp" #include "util/log/Logger.hpp" #include #include #include #include #include #include #include #include #include namespace etl::impl { class GrpcSource { util::Logger log_; std::unique_ptr stub_; std::shared_ptr backend_; static constexpr auto kKEEPALIVE_PING_INTERVAL_MS = 10000; static constexpr auto kKEEPALIVE_TIMEOUT_MS = 5000; static constexpr auto kKEEPALIVE_PERMIT_WITHOUT_CALLS = true; // Allow keepalive pings when no calls static constexpr auto kMAX_PINGS_WITHOUT_DATA = 0; // No limit static constexpr auto kDEADLINE = std::chrono::seconds(30); public: GrpcSource(std::string const& ip, std::string const& grpcPort, std::shared_ptr backend); /** * @brief Fetch data for a specific ledger. * * This function will continuously try to fetch data for the specified ledger until the fetch succeeds, the ledger * is found in the database, or the server is shutting down. * * @param sequence Sequence of the ledger to fetch * @param getObjects Whether to get the account state diff between this ledger and the prior one; defaults to true * @param getObjectNeighbors Whether to request object neighbors; defaults to false * @return A std::pair of the response status and the response itself */ std::pair fetchLedger(uint32_t sequence, bool getObjects = true, bool getObjectNeighbors = false); /** * @brief Download a ledger in full. * * @param sequence Sequence of the ledger to download * @param numMarkers Number of markers to generate for async calls * @return A std::pair of the data and a bool indicating whether the download was successful */ std::pair, bool> loadInitialLedger(uint32_t sequence, uint32_t numMarkers); }; } // namespace etl::impl