Clio  develop
The XRP Ledger API server.
Loading...
Searching...
No Matches
AccountMPTokenIssuances.hpp
1#pragma once
2
3#include "data/BackendInterface.hpp"
4#include "rpc/Errors.hpp"
5#include "rpc/JS.hpp"
6#include "rpc/common/Checkers.hpp"
7#include "rpc/common/MetaProcessors.hpp"
8#include "rpc/common/Modifiers.hpp"
9#include "rpc/common/Specs.hpp"
10#include "rpc/common/Types.hpp"
11#include "rpc/common/Validators.hpp"
12
13#include <boost/json/conversion.hpp>
14#include <boost/json/value.hpp>
15#include <xrpl/protocol/AccountID.h>
16#include <xrpl/protocol/ErrorCodes.h>
17#include <xrpl/protocol/STLedgerEntry.h>
18#include <xrpl/protocol/jss.h>
19
20#include <cstdint>
21#include <memory>
22#include <optional>
23#include <string>
24#include <vector>
25
26namespace rpc {
27
33 // dependencies
34 std::shared_ptr<BackendInterface> sharedPtrBackend_;
35
36public:
37 static constexpr auto kLimitMin = 10;
38 static constexpr auto kLimitMax = 400;
39 static constexpr auto kLimitDefault = 200;
40
45 std::string mpTokenIssuanceId;
46 std::string issuer;
47 uint32_t sequence{};
48
49 std::optional<uint16_t> transferFee;
50 std::optional<uint8_t> assetScale;
51
52 std::optional<std::uint64_t> maximumAmount;
53 std::optional<std::uint64_t> outstandingAmount;
54 std::optional<std::uint64_t> lockedAmount;
55 std::optional<std::string> mptokenMetadata;
56 std::optional<std::string> domainID;
57
58 std::optional<bool> mptLocked;
59 std::optional<bool> mptCanLock;
60 std::optional<bool> mptRequireAuth;
61 std::optional<bool> mptCanEscrow;
62 std::optional<bool> mptCanTrade;
63 std::optional<bool> mptCanTransfer;
64 std::optional<bool> mptCanClawback;
65
66 std::optional<bool> mptImmutableCanLock;
67 std::optional<bool> mptImmutableRequireAuth;
68 std::optional<bool> mptImmutableCanEscrow;
69 std::optional<bool> mptImmutableCanTrade;
70 std::optional<bool> mptImmutableCanTransfer;
71 std::optional<bool> mptImmutableCanClawback;
72 std::optional<bool> mptImmutableCanHoldConfidentialBalance;
73 std::optional<bool> mptImmutableMetadata;
74 std::optional<bool> mptImmutableTransferFee;
75
76 std::optional<bool> mptCanHoldConfidentialBalance;
77 std::optional<std::uint64_t> confidentialOutstandingAmount;
78 std::optional<std::string> issuerEncryptionKey;
79 std::optional<std::string> auditorEncryptionKey;
80 };
81
85 struct Output {
86 std::string account;
87 std::vector<MPTokenIssuanceResponse> issuances;
88 std::string ledgerHash;
89 uint32_t ledgerIndex{};
90 bool validated = true;
91 std::optional<std::string> marker;
92 uint32_t limit{};
93 };
94
98 struct Input {
99 std::string account;
100 std::optional<std::string> ledgerHash;
101 std::optional<uint32_t> ledgerIndex;
102 uint32_t limit = kLimitDefault;
103 std::optional<std::string> marker;
104 };
105
106 using Result = HandlerReturnType<Output>;
107
113 AccountMPTokenIssuancesHandler(std::shared_ptr<BackendInterface> sharedPtrBackend)
114 : sharedPtrBackend_(std::move(sharedPtrBackend))
115 {
116 }
117
124 static RpcSpecConstRef
125 spec([[maybe_unused]] uint32_t apiVersion)
126 {
127 static auto const kRpcSpec = RpcSpec{
128 {JS(account),
132 Status(RippledError::RpcActMalformed)
133 }},
135 {JS(limit),
137 validation::Min(1u),
138 modifiers::Clamp<int32_t>{kLimitMin, kLimitMax}},
141 {JS(ledger), check::Deprecated{}},
142 };
143
144 return kRpcSpec;
145 }
146
154 [[nodiscard]] Result
155 process(Input const& input, Context const& ctx) const;
156
157private:
158 static void
159 addMPTokenIssuance(
160 std::vector<MPTokenIssuanceResponse>& issuances,
161 xrpl::SLE const& sle,
162 xrpl::AccountID const& account
163 );
164
165private:
172 friend void
173 tag_invoke(boost::json::value_from_tag, boost::json::value& jv, Output const& output);
174
181 friend Input
182 tag_invoke(boost::json::value_to_tag<Input>, boost::json::value const& jv);
183
190 friend void
192 boost::json::value_from_tag,
193 boost::json::value& jv,
194 MPTokenIssuanceResponse const& issuance
195 );
196};
197
198} // namespace rpc
static RpcSpecConstRef spec(uint32_t apiVersion)
Returns the API specification for the command.
Definition AccountMPTokenIssuances.hpp:125
AccountMPTokenIssuancesHandler(std::shared_ptr< BackendInterface > sharedPtrBackend)
Construct a new AccountMPTokenIssuancesHandler object.
Definition AccountMPTokenIssuances.hpp:113
Result process(Input const &input, Context const &ctx) const
Process the AccountMPTokenIssuances command.
Definition AccountMPTokenIssuances.cpp:120
friend void tag_invoke(boost::json::value_from_tag, boost::json::value &jv, Output const &output)
Convert the Output to a JSON object.
Definition AccountMPTokenIssuances.cpp:216
Check for a deprecated fields.
Definition Checkers.hpp:44
A meta-processor that wraps a validator and produces a custom error in case the wrapped validator fai...
Definition MetaProcessors.hpp:152
Clamp value between min and max.
Definition Modifiers.hpp:23
Validate that value is equal or greater than the specified min.
Definition Validators.hpp:205
This namespace contains all the RPC logic and handlers.
Definition AMMHelpers.cpp:17
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
A struct to hold the input data for the command.
Definition AccountMPTokenIssuances.hpp:98
A struct to hold data for one MPTokenIssuance response.
Definition AccountMPTokenIssuances.hpp:44
A struct to hold the output data of the command.
Definition AccountMPTokenIssuances.hpp:85
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:73
static CustomValidator accountValidator
Provides a commonly used validator for accounts.
Definition Validators.hpp:504
static CustomValidator accountMarkerValidator
Provides a commonly used validator for markers.
Definition Validators.hpp:519
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
Validates that the type of the value is one of the given types.
Definition Validators.hpp:128