Clio  develop
The XRP Ledger API server.
Loading...
Searching...
No Matches
TransactionEntry.hpp
1#pragma once
2
3#include "data/BackendInterface.hpp"
4#include "rpc/Errors.hpp"
5#include "rpc/JS.hpp"
6#include "rpc/common/MetaProcessors.hpp"
7#include "rpc/common/Specs.hpp"
8#include "rpc/common/Types.hpp"
9#include "rpc/common/Validators.hpp"
10
11#include <boost/json/conversion.hpp>
12#include <boost/json/object.hpp>
13#include <boost/json/value.hpp>
14#include <xrpl/protocol/LedgerHeader.h>
15#include <xrpl/protocol/jss.h>
16
17#include <cstdint>
18#include <memory>
19#include <optional>
20#include <string>
21
22namespace rpc {
23
31 std::shared_ptr<BackendInterface> sharedPtrBackend_;
32
33public:
37 struct Output {
38 std::optional<ripple::LedgerHeader> ledgerHeader;
39 // TODO: use a better type for this
40 boost::json::object metadata;
41 boost::json::object tx;
42 // validated should be sent via framework
43 bool validated = true;
44 uint32_t apiVersion;
45 };
46
50 struct Input {
51 std::string txHash;
52 std::optional<std::string> ledgerHash;
53 std::optional<uint32_t> ledgerIndex;
54 };
55
56 using Result = HandlerReturnType<Output>;
57
63 TransactionEntryHandler(std::shared_ptr<BackendInterface> sharedPtrBackend)
64 : sharedPtrBackend_(std::move(sharedPtrBackend))
65 {
66 }
67
74 static RpcSpecConstRef
75 spec([[maybe_unused]] uint32_t apiVersion)
76 {
77 static auto const kRPC_SPEC = RpcSpec{
78 {JS(tx_hash),
80 validation::Required{}, Status(ClioError::RpcFieldNotFoundTransaction)
81 },
85 };
86
87 return kRPC_SPEC;
88 }
89
97 Result
98 process(Input const& input, Context const& ctx) const;
99
100private:
107 friend void
108 tag_invoke(boost::json::value_from_tag, boost::json::value& jv, Output const& output);
109
116 friend Input
117 tag_invoke(boost::json::value_to_tag<Input>, boost::json::value const& jv);
118};
119
120} // namespace rpc
static RpcSpecConstRef spec(uint32_t apiVersion)
Returns the API specification for the command.
Definition TransactionEntry.hpp:75
Result process(Input const &input, Context const &ctx) const
Process the transaction_entry command.
Definition TransactionEntry.cpp:24
friend void tag_invoke(boost::json::value_from_tag, boost::json::value &jv, Output const &output)
Convert the Output to a JSON object.
Definition TransactionEntry.cpp:69
TransactionEntryHandler(std::shared_ptr< BackendInterface > sharedPtrBackend)
Construct a new Transaction Entry Handler object.
Definition TransactionEntry.hpp:63
A meta-processor that wraps a validator and produces a custom error in case the wrapped validator fai...
Definition MetaProcessors.hpp:152
This namespace contains all the RPC logic and handlers.
Definition AMMHelpers.cpp:18
RpcSpec const & RpcSpecConstRef
An alias for a const reference to RpcSpec.
Definition Specs.hpp:130
std::expected< OutputType, Status > HandlerReturnType
Return type for each individual handler.
Definition Types.hpp:62
Context of an RPC call.
Definition Types.hpp:99
Result type used to return responses or error statuses to the Webserver subsystem.
Definition Types.hpp:110
Represents a Specification of an entire RPC command.
Definition Specs.hpp:82
A status returned from any RPC handler.
Definition Errors.hpp:65
A struct to hold the input data for the command.
Definition TransactionEntry.hpp:50
A struct to hold the output data of the command.
Definition TransactionEntry.hpp:37
static CustomValidator ledgerIndexValidator
Provides a commonly used validator for ledger index.
Definition Validators.hpp:489
static CustomValidator uint256HexStringValidator
Provides a commonly used validator for uint256 hex string.
Definition Validators.hpp:551
A validator that simply requires a field to be present.
Definition Validators.hpp:28