1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
use alloc::borrow::Cow;
use serde::{Deserialize, Serialize};
use serde_with::skip_serializing_none;
use crate::models::{requests::RequestMethod, Model};
use super::{CommonFields, LedgerIndex, LookupByLedgerRequest, Marker, Request};
/// This request retrieves from the ledger a list of
/// transactions that involved the specified account.
///
/// See Account Tx:
/// `<https://xrpl.org/account_tx.html>`
#[skip_serializing_none]
#[derive(Debug, Serialize, Deserialize, PartialEq, Eq, Clone)]
pub struct AccountTx<'a> {
/// The common fields shared by all requests.
#[serde(flatten)]
pub common_fields: CommonFields<'a>,
/// A unique identifier for the account, most commonly the
/// account's address.
pub account: Cow<'a, str>,
/// The unique identifier of a ledger.
#[serde(flatten)]
pub ledger_lookup: Option<LookupByLedgerRequest<'a>>,
/// Defaults to false. If set to true, returns transactions
/// as hex strings instead of JSON.
pub binary: Option<bool>,
/// Defaults to false. If set to true, returns values indexed
/// with the oldest ledger first. Otherwise, the results are
/// indexed with the newest ledger first.
/// (Each page of results may not be internally ordered, but
/// the pages are overall ordered.)
pub forward: Option<bool>,
/// Use to specify the earliest ledger to include transactions
/// from. A value of -1 instructs the server to use the earliest
/// validated ledger version available.
pub ledger_index_min: Option<u32>,
/// Use to specify the most recent ledger to include transactions
/// from. A value of -1 instructs the server to use the most
/// recent validated ledger version available.
pub ledger_index_max: Option<u32>,
/// Default varies. Limit the number of transactions to retrieve.
/// The server is not required to honor this value.
pub limit: Option<u16>,
/// Value from a previous paginated response. Resume retrieving
/// data where that response left off. This value is stable even
/// if there is a change in the server's range of available
/// ledgers.
pub marker: Option<Marker<'a>>,
}
impl<'a> Model for AccountTx<'a> {}
impl<'a> Request<'a> for AccountTx<'a> {
fn get_common_fields(&self) -> &CommonFields<'a> {
&self.common_fields
}
fn get_common_fields_mut(&mut self) -> &mut CommonFields<'a> {
&mut self.common_fields
}
}
impl<'a> AccountTx<'a> {
pub fn new(
id: Option<Cow<'a, str>>,
account: Cow<'a, str>,
ledger_hash: Option<Cow<'a, str>>,
ledger_index: Option<LedgerIndex<'a>>,
binary: Option<bool>,
forward: Option<bool>,
ledger_index_min: Option<u32>,
ledger_index_max: Option<u32>,
limit: Option<u16>,
marker: Option<Marker<'a>>,
) -> Self {
Self {
common_fields: CommonFields {
command: RequestMethod::AccountTx,
id,
},
account,
ledger_lookup: Some(LookupByLedgerRequest {
ledger_hash,
ledger_index,
}),
binary,
forward,
ledger_index_min,
ledger_index_max,
limit,
marker,
}
}
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn test_serde_round_trip() {
let req = AccountTx::new(
Some("atx-1".into()),
"rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh".into(),
None,
None,
Some(false),
Some(true),
Some(1),
Some(99999),
Some(25),
None,
);
let serialized = serde_json::to_string(&req).unwrap();
let deserialized: AccountTx = serde_json::from_str(&serialized).unwrap();
assert_eq!(req, deserialized);
assert!(serialized.contains("\"command\":\"account_tx\""));
assert!(serialized.contains("\"forward\":true"));
}
}