Clio develop
The XRP Ledger API server.
Loading...
Searching...
No Matches
AccountCurrencies.hpp
1//------------------------------------------------------------------------------
2/*
3 This file is part of clio: https://github.com/XRPLF/clio
4 Copyright (c) 2023, the clio developers.
5
6 Permission to use, copy, modify, and distribute this software for any
7 purpose with or without fee is hereby granted, provided that the above
8 copyright notice and this permission notice appear in all copies.
9
10 THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11 WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12 MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13 ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14 WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
15 ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
16 OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17*/
18//==============================================================================
19
20#pragma once
21
22#include "data/BackendInterface.hpp"
23#include "rpc/JS.hpp"
24#include "rpc/common/Checkers.hpp"
25#include "rpc/common/Specs.hpp"
26#include "rpc/common/Types.hpp"
27#include "rpc/common/Validators.hpp"
28
29#include <boost/json/conversion.hpp>
30#include <boost/json/value.hpp>
31#include <xrpl/protocol/jss.h>
32
33#include <cstdint>
34#include <memory>
35#include <optional>
36#include <set>
37#include <string>
38
39namespace rpc {
40
48 // dependencies
49 std::shared_ptr<BackendInterface> sharedPtrBackend_;
50
51public:
55 struct Output {
56 std::string ledgerHash;
57 uint32_t ledgerIndex{};
58 std::set<std::string> receiveCurrencies;
59 std::set<std::string> sendCurrencies;
60 // validated should be sent via framework
61 bool validated = true;
62 };
63
67 struct Input {
68 std::string account;
69 std::optional<std::string> ledgerHash;
70 std::optional<uint32_t> ledgerIndex;
71 };
72
73 using Result = HandlerReturnType<Output>;
74
80 AccountCurrenciesHandler(std::shared_ptr<BackendInterface> const& sharedPtrBackend)
81 : sharedPtrBackend_(sharedPtrBackend)
82 {
83 }
84
91 static RpcSpecConstRef
92 spec([[maybe_unused]] uint32_t apiVersion)
93 {
94 static auto const kRPC_SPEC = RpcSpec{
98 {"account_index", check::Deprecated{}},
99 {JS(strict), check::Deprecated{}}
100 };
101
102 return kRPC_SPEC;
103 }
104
112 Result
113 process(Input input, Context const& ctx) const;
114
115private:
122 friend void
123 tag_invoke(boost::json::value_from_tag, boost::json::value& jv, Output const& output);
124
131 friend Input
132 tag_invoke(boost::json::value_to_tag<Input>, boost::json::value const& jv);
133};
134
135} // namespace rpc
The account_currencies command retrieves a list of currencies that an account can send or receive,...
Definition AccountCurrencies.hpp:47
AccountCurrenciesHandler(std::shared_ptr< BackendInterface > const &sharedPtrBackend)
Construct a new AccountCurrenciesHandler object.
Definition AccountCurrencies.hpp:80
friend void tag_invoke(boost::json::value_from_tag, boost::json::value &jv, Output const &output)
Convert the Output to a JSON object.
Definition AccountCurrencies.cpp:107
Result process(Input input, Context const &ctx) const
Process the AccountCurrencies command.
Definition AccountCurrencies.cpp:47
static RpcSpecConstRef spec(uint32_t apiVersion)
Returns the API specification for the command.
Definition AccountCurrencies.hpp:92
Check for a deprecated fields.
Definition Checkers.hpp:62
This namespace contains all the RPC logic and handlers.
Definition AMMHelpers.cpp:36
RpcSpec const & RpcSpecConstRef
An alias for a const reference to RpcSpec.
Definition Specs.hpp:145
std::expected< OutputType, Status > HandlerReturnType
Return type for each individual handler.
Definition Types.hpp:81
A struct to hold the input data for the command.
Definition AccountCurrencies.hpp:67
A struct to hold the output data of the command.
Definition AccountCurrencies.hpp:55
Context of an RPC call.
Definition Types.hpp:118
Result type used to return responses or error statuses to the Webserver subsystem.
Definition Types.hpp:129
Represents a Specification of an entire RPC command.
Definition Specs.hpp:98
static CustomValidator accountValidator
Provides a commonly used validator for accounts.
Definition Validators.hpp:491
static CustomValidator ledgerIndexValidator
Provides a commonly used validator for ledger index.
Definition Validators.hpp:484
static CustomValidator uint256HexStringValidator
Provides a commonly used validator for uint256 hex string.
Definition Validators.hpp:530
A validator that simply requires a field to be present.
Definition Validators.hpp:47