rippled
TxFormats.cpp
1 //------------------------------------------------------------------------------
2 /*
3  This file is part of rippled: https://github.com/ripple/rippled
4  Copyright (c) 2012, 2013 Ripple Labs Inc.
5 
6  Permission to use, copy, modify, and/or 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 #include <ripple/protocol/TxFormats.h>
21 #include <ripple/protocol/jss.h>
22 
23 namespace ripple {
24 
26 {
27 #pragma push_macro("PSEUDO_TXN_COMMON_FIELDS")
28 
29  // clang-format off
30 
31  #define PSEUDO_TXN_COMMON_FIELDS \
32  {sfTransactionType, soeREQUIRED}, \
33  {sfFlags, soeOPTIONAL}, \
34  {sfSourceTag, soeOPTIONAL}, \
35  {sfAccount, soeREQUIRED}, \
36  {sfSequence, soeREQUIRED}, \
37  {sfPreviousTxnID, soeOPTIONAL}, /* emulate027 */ \
38  {sfLastLedgerSequence, soeOPTIONAL}, \
39  {sfAccountTxnID, soeOPTIONAL}, \
40  {sfFee, soeREQUIRED}, \
41  {sfOperationLimit, soeOPTIONAL}, \
42  {sfMemos, soeOPTIONAL}, \
43  {sfSigningPubKey, soeREQUIRED}, \
44  {sfTxnSignature, soeOPTIONAL}, \
45  {sfSigners, soeOPTIONAL}, /* submit_multisigned */ \
46  {sfNetworkID, soeOPTIONAL}
47 
48  // clang-format on
49 
50  // Fields shared by all pseudo-transaction txFormats:
51  static const std::initializer_list<SOElement> pseudoCommonFields{
52  PSEUDO_TXN_COMMON_FIELDS,
53  };
54 
55  // Fields shared by all normal transaction txFormats:
56  static const std::initializer_list<SOElement> commonFields{
57  PSEUDO_TXN_COMMON_FIELDS,
59  };
60 
61 #pragma pop_macro("PSEUDO_TXN_COMMON_FIELDS")
62 
63  add(jss::AccountSet,
65  {
76  },
77  commonFields);
78 
79  add(jss::TrustSet,
81  {
85  },
86  commonFields);
87 
88  add(jss::OfferCreate,
90  {
95  },
96  commonFields);
97 
98  add(jss::AMMCreate,
100  {
104  },
105  commonFields);
106 
107  add(jss::AMMDeposit,
109  {
110  {sfAsset, soeREQUIRED},
117  },
118  commonFields);
119 
120  add(jss::AMMWithdraw,
122  {
123  {sfAsset, soeREQUIRED},
129  },
130  commonFields);
131 
132  add(jss::AMMVote,
133  ttAMM_VOTE,
134  {
135  {sfAsset, soeREQUIRED},
138  },
139  commonFields);
140 
141  add(jss::AMMBid,
142  ttAMM_BID,
143  {
144  {sfAsset, soeREQUIRED},
149  },
150  commonFields);
151 
152  add(jss::AMMDelete,
153  ttAMM_DELETE,
154  {
155  {sfAsset, soeREQUIRED},
157  },
158  commonFields);
159 
160  add(jss::OfferCancel,
162  {
164  },
165  commonFields);
166 
167  add(jss::SetRegularKey,
169  {
171  },
172  commonFields);
173 
174  add(jss::Payment,
175  ttPAYMENT,
176  {
180  {sfPaths, soeDEFAULT},
184  },
185  commonFields);
186 
187  add(jss::EscrowCreate,
189  {
196  },
197  commonFields);
198 
199  add(jss::EscrowFinish,
201  {
202  {sfOwner, soeREQUIRED},
206  },
207  commonFields);
208 
209  add(jss::EscrowCancel,
211  {
212  {sfOwner, soeREQUIRED},
214  },
215  commonFields);
216 
217  add(jss::EnableAmendment,
218  ttAMENDMENT,
219  {
222  },
223  pseudoCommonFields);
224 
225  add(jss::SetFee,
226  ttFEE,
227  {
229  // Old version uses raw numbers
234  // New version uses Amounts
238  },
239  pseudoCommonFields);
240 
241  add(jss::UNLModify,
242  ttUNL_MODIFY,
243  {
247  },
248  pseudoCommonFields);
249 
250  add(jss::TicketCreate,
252  {
254  },
255  commonFields);
256 
257  // The SignerEntries are optional because a SignerList is deleted by
258  // setting the SignerQuorum to zero and omitting SignerEntries.
259  add(jss::SignerListSet,
261  {
264  },
265  commonFields);
266 
267  add(jss::PaymentChannelCreate,
269  {
276  },
277  commonFields);
278 
279  add(jss::PaymentChannelFund,
281  {
285  },
286  commonFields);
287 
288  add(jss::PaymentChannelClaim,
290  {
296  },
297  commonFields);
298 
299  add(jss::CheckCreate,
301  {
307  },
308  commonFields);
309 
310  add(jss::CheckCash,
311  ttCHECK_CASH,
312  {
316  },
317  commonFields);
318 
319  add(jss::CheckCancel,
321  {
323  },
324  commonFields);
325 
326  add(jss::AccountDelete,
328  {
331  },
332  commonFields);
333 
334  add(jss::DepositPreauth,
336  {
339  },
340  commonFields);
341 
342  add(jss::NFTokenMint,
344  {
348  {sfURI, soeOPTIONAL},
349  },
350  commonFields);
351 
352  add(jss::NFTokenBurn,
354  {
356  {sfOwner, soeOPTIONAL},
357  },
358  commonFields);
359 
360  add(jss::NFTokenCreateOffer,
362  {
366  {sfOwner, soeOPTIONAL},
368  },
369  commonFields);
370 
371  add(jss::NFTokenCancelOffer,
373  {
375  },
376  commonFields);
377 
378  add(jss::NFTokenAcceptOffer,
380  {
384  },
385  commonFields);
386 
387  add(jss::Clawback,
388  ttCLAWBACK,
389  {
391  },
392  commonFields);
393 }
394 
395 TxFormats const&
397 {
398  static TxFormats const instance;
399  return instance;
400 }
401 
402 } // namespace ripple
ripple::ttNFTOKEN_CREATE_OFFER
@ ttNFTOKEN_CREATE_OFFER
This transaction creates a new offer to buy or sell an NFT.
Definition: TxFormats.h:134
ripple::sfOfferSequence
const SF_UINT32 sfOfferSequence
ripple::ttACCOUNT_DELETE
@ ttACCOUNT_DELETE
This transaction type deletes an existing account.
Definition: TxFormats.h:122
ripple::sfPaths
const SField sfPaths
ripple::sfUNLModifyValidator
const SF_VL sfUNLModifyValidator
ripple::sfBaseFeeDrops
const SF_AMOUNT sfBaseFeeDrops
ripple::sfReserveBase
const SF_UINT32 sfReserveBase
ripple::ttAMM_DELETE
@ ttAMM_DELETE
This transaction type deletes AMM in the empty state.
Definition: TxFormats.h:161
ripple::sfAsset
const SF_ISSUE sfAsset
ripple::sfSendMax
const SF_AMOUNT sfSendMax
ripple::sfLedgerSequence
const SF_UINT32 sfLedgerSequence
ripple::sfNFTokenOffers
const SF_VECTOR256 sfNFTokenOffers
ripple::sfDestination
const SF_ACCOUNT sfDestination
ripple::ttREGULAR_KEY_SET
@ ttREGULAR_KEY_SET
This transaction type sets or clears an account's "regular key".
Definition: TxFormats.h:74
ripple::sfAmount2
const SF_AMOUNT sfAmount2
ripple::sfAmount
const SF_AMOUNT sfAmount
ripple::ttCLAWBACK
@ ttCLAWBACK
This transaction claws back issued tokens.
Definition: TxFormats.h:143
ripple::sfNFTokenID
const SF_UINT256 sfNFTokenID
ripple::sfWalletSize
const SF_UINT32 sfWalletSize
ripple::sfCheckID
const SF_UINT256 sfCheckID
ripple::ttSIGNER_LIST_SET
@ ttSIGNER_LIST_SET
This transaction type modifies the signer list associated with an account.
Definition: TxFormats.h:95
ripple::sfQualityOut
const SF_UINT32 sfQualityOut
ripple::sfOwner
const SF_ACCOUNT sfOwner
ripple::sfRegularKey
const SF_ACCOUNT sfRegularKey
ripple::ttESCROW_CANCEL
@ ttESCROW_CANCEL
This transaction type cancels an existing escrow.
Definition: TxFormats.h:71
ripple::sfEPrice
const SF_AMOUNT sfEPrice
ripple::ttFEE
@ ttFEE
This system-generated transaction type is used to update the network's fee settings.
Definition: TxFormats.h:173
ripple::ttAMM_DEPOSIT
@ ttAMM_DEPOSIT
This transaction type deposits into an AMM instance.
Definition: TxFormats.h:149
ripple::ttOFFER_CANCEL
@ ttOFFER_CANCEL
This transaction type cancels existing offers to trade one asset for another.
Definition: TxFormats.h:83
ripple::ttPAYCHAN_CREATE
@ ttPAYCHAN_CREATE
This transaction type creates a new unidirectional XRP payment channel.
Definition: TxFormats.h:98
ripple::sfQualityIn
const SF_UINT32 sfQualityIn
ripple::sfSetFlag
const SF_UINT32 sfSetFlag
ripple::soeREQUIRED
@ soeREQUIRED
Definition: SOTemplate.h:35
ripple::sfTicketSequence
const SF_UINT32 sfTicketSequence
ripple::ttNFTOKEN_ACCEPT_OFFER
@ ttNFTOKEN_ACCEPT_OFFER
This transaction accepts an existing offer to buy or sell an existing NFT.
Definition: TxFormats.h:140
ripple::sfLPTokenOut
const SF_AMOUNT sfLPTokenOut
ripple::ttAMENDMENT
@ ttAMENDMENT
This system-generated transaction type is used to update the status of the various amendments.
Definition: TxFormats.h:167
ripple::sfTradingFee
const SF_UINT16 sfTradingFee
ripple::sfTransferFee
const SF_UINT16 sfTransferFee
ripple::ttCHECK_CANCEL
@ ttCHECK_CANCEL
This transaction type cancels an existing check.
Definition: TxFormats.h:113
ripple::sfExpiration
const SF_UINT32 sfExpiration
ripple::sfSignerQuorum
const SF_UINT32 sfSignerQuorum
ripple::ttPAYMENT
@ ttPAYMENT
This transaction type executes a payment.
Definition: TxFormats.h:59
ripple::sfTakerPays
const SF_AMOUNT sfTakerPays
ripple::sfDeliverMin
const SF_AMOUNT sfDeliverMin
ripple::sfLimitAmount
const SF_AMOUNT sfLimitAmount
ripple::sfAsset2
const SF_ISSUE sfAsset2
ripple::ttUNL_MODIFY
@ ttUNL_MODIFY
This system-generated transaction type is used to update the network's negative UNL.
Definition: TxFormats.h:179
ripple::sfSettleDelay
const SF_UINT32 sfSettleDelay
ripple::sfUnauthorize
const SF_ACCOUNT sfUnauthorize
ripple::sfBidMax
const SF_AMOUNT sfBidMax
ripple::ttCHECK_CREATE
@ ttCHECK_CREATE
This transaction type creates a new check.
Definition: TxFormats.h:107
ripple::TxFormats::getInstance
static TxFormats const & getInstance()
Definition: TxFormats.cpp:396
ripple::sfNFTokenMinter
const SF_ACCOUNT sfNFTokenMinter
ripple::ttAMM_CREATE
@ ttAMM_CREATE
This transaction type creates an AMM instance.
Definition: TxFormats.h:146
ripple::ttTRUST_SET
@ ttTRUST_SET
This transaction type modifies a trustline between two accounts.
Definition: TxFormats.h:119
ripple::sfReserveIncrement
const SF_UINT32 sfReserveIncrement
ripple::soeOPTIONAL
@ soeOPTIONAL
Definition: SOTemplate.h:36
ripple::sfAuthAccounts
const SField sfAuthAccounts
ripple::TxFormats::TxFormats
TxFormats()
Create the object.
Definition: TxFormats.cpp:25
ripple::ttNFTOKEN_MINT
@ ttNFTOKEN_MINT
This transaction mints a new NFT.
Definition: TxFormats.h:128
ripple::ttESCROW_CREATE
@ ttESCROW_CREATE
This transaction type creates an escrow object.
Definition: TxFormats.h:62
ripple::sfTicketCount
const SF_UINT32 sfTicketCount
ripple::ttAMM_WITHDRAW
@ ttAMM_WITHDRAW
This transaction type withdraws from an AMM instance.
Definition: TxFormats.h:152
ripple::ttESCROW_FINISH
@ ttESCROW_FINISH
This transaction type completes an existing escrow.
Definition: TxFormats.h:65
ripple::sfTakerGets
const SF_AMOUNT sfTakerGets
ripple::sfTransferRate
const SF_UINT32 sfTransferRate
ripple::sfTickSize
const SF_UINT8 sfTickSize
ripple::sfAuthorize
const SF_ACCOUNT sfAuthorize
ripple::sfReserveIncrementDrops
const SF_AMOUNT sfReserveIncrementDrops
ripple::sfClearFlag
const SF_UINT32 sfClearFlag
ripple::sfBidMin
const SF_AMOUNT sfBidMin
ripple::TxFormats
Manages the list of known transaction formats.
Definition: TxFormats.h:185
ripple::sfReserveBaseDrops
const SF_AMOUNT sfReserveBaseDrops
ripple::ttNFTOKEN_CANCEL_OFFER
@ ttNFTOKEN_CANCEL_OFFER
This transaction cancels an existing offer to buy or sell an existing NFT.
Definition: TxFormats.h:137
ripple::ttOFFER_CREATE
@ ttOFFER_CREATE
This transaction type creates an offer to trade one asset for another.
Definition: TxFormats.h:80
ripple::sfUNLModifyDisabling
const SF_UINT8 sfUNLModifyDisabling
ripple::sfEmailHash
const SF_UINT128 sfEmailHash
ripple::ttACCOUNT_SET
@ ttACCOUNT_SET
This transaction type adjusts various account settings.
Definition: TxFormats.h:68
ripple::sfSignerEntries
const SField sfSignerEntries
ripple::sfBaseFee
const SF_UINT64 sfBaseFee
ripple::sfNFTokenBuyOffer
const SF_UINT256 sfNFTokenBuyOffer
ripple::sfURI
const SF_VL sfURI
ripple
Use hash_* containers for keys that do not need a cryptographically secure hashing algorithm.
Definition: RCLCensorshipDetector.h:29
ripple::sfWalletLocator
const SF_UINT256 sfWalletLocator
ripple::sfCondition
const SF_VL sfCondition
ripple::sfIssuer
const SF_ACCOUNT sfIssuer
ripple::ttDEPOSIT_PREAUTH
@ ttDEPOSIT_PREAUTH
This transaction type grants or revokes authorization to transfer funds.
Definition: TxFormats.h:116
ripple::sfInvoiceID
const SF_UINT256 sfInvoiceID
ripple::sfDestinationTag
const SF_UINT32 sfDestinationTag
ripple::ttCHECK_CASH
@ ttCHECK_CASH
This transaction type cashes an existing check.
Definition: TxFormats.h:110
ripple::sfSignature
const SF_VL sfSignature
ripple::ttPAYCHAN_FUND
@ ttPAYCHAN_FUND
This transaction type funds an existing unidirectional XRP payment channel.
Definition: TxFormats.h:101
ripple::sfBalance
const SF_AMOUNT sfBalance
ripple::sfReferenceFeeUnits
const SF_UINT32 sfReferenceFeeUnits
ripple::ttAMM_VOTE
@ ttAMM_VOTE
This transaction type votes for the trading fee.
Definition: TxFormats.h:155
ripple::ttPAYCHAN_CLAIM
@ ttPAYCHAN_CLAIM
This transaction type submits a claim against an existing unidirectional payment channel.
Definition: TxFormats.h:104
ripple::sfCancelAfter
const SF_UINT32 sfCancelAfter
ripple::sfMessageKey
const SF_VL sfMessageKey
ripple::ttNFTOKEN_BURN
@ ttNFTOKEN_BURN
This transaction burns (i.e.
Definition: TxFormats.h:131
ripple::sfFinishAfter
const SF_UINT32 sfFinishAfter
ripple::sfChannel
const SF_UINT256 sfChannel
ripple::sfNFTokenTaxon
const SF_UINT32 sfNFTokenTaxon
ripple::sfLPTokenIn
const SF_AMOUNT sfLPTokenIn
ripple::sfDomain
const SF_VL sfDomain
ripple::sfAmendment
const SF_UINT256 sfAmendment
ripple::sfFulfillment
const SF_VL sfFulfillment
ripple::sfPublicKey
const SF_VL sfPublicKey
ripple::sfNFTokenSellOffer
const SF_UINT256 sfNFTokenSellOffer
ripple::ttTICKET_CREATE
@ ttTICKET_CREATE
This transaction type creates a new set of tickets.
Definition: TxFormats.h:89
ripple::soeDEFAULT
@ soeDEFAULT
Definition: SOTemplate.h:37
ripple::sfNFTokenBrokerFee
const SF_AMOUNT sfNFTokenBrokerFee
ripple::KnownFormats< TxType, TxFormats >::add
Item const & add(char const *name, TxType type, std::initializer_list< SOElement > uniqueFields, std::initializer_list< SOElement > commonFields={})
Add a new format.
Definition: KnownFormats.h:170
ripple::ttAMM_BID
@ ttAMM_BID
This transaction type bids for the auction slot.
Definition: TxFormats.h:158
std::initializer_list