Add high-level methods for accounts

[LimpidCrypto]

• [x] does_account_exist -> bool
  1. Queries a ledger and checks if an account exists.

2. The function simply calls the get_account_info function. If the Result is no error the account exists.

fields	type	explanation
account	&str	An accounts classic address.
client	WebsocketClient/AsyncWebsocketClient	A websocket client object.
ledger_index	Option<&str>	A ledger index. Must be one of "validated", "current", "closed", or an integer as str.

Sources:

• https://github.com/XRPLF/xrpl-py/blob/master/xrpl/asyncio/account/main.py#L12

• [x] get_next_valid_account_seq_number -> u32

  1. Queries the ledger for an account to its next valid sequence number.

2. The function simply calls the get_account_root function and returns the AccountRoot object's Sequence field.

fields	type	explanation
account	&str	An accounts classic address.
client	WebsocketClient/AsyncWebsocketClient	A websocket client object.
ledger_index	Option<&str>	A ledger index. Must be one of: "validated", "current", "closed", integer as str

Sources:

• https://github.com/XRPLF/xrpl-py/blob/master/xrpl/asyncio/account/main.py#L42

• [x] get_account_xrp_balance -> Currency

  1. Queries the Ledger for an account's XRP balance.

2. The function simply calls the get_account_root function and returns the AccountRoot object's Balance field.

3. Use drops_to_xrp to convert the drops amount into a XRP amount.

fields	type	explanation
account	&str	An accounts classic address.
client	WebsocketClient/AsyncWebsocketClient	A websocket client object.
ledger_index	Optional<&str>	A ledger index. Must be one of: "validated", "current", "closed", integer as str

Sources:

• https://github.com/XRPLF/xrpl.js/blob/main/packages/xrpl/src/sugar/balances.ts#L43

• https://github.com/XRPLF/xrpl-py/blob/master/xrpl/asyncio/account/main.py#L64

• [ ] get_account_balances -> Vec<Currency>

  1. Queries the Ledger for all balances (XRP and Token) a given account holds.

2. The function calls the get_account_xrp_balance and the AccountLines request method and brings the balances in an easy-to-use format.

fields	type	explanation
account	&str	An accounts classic address.
client	WebsocketClient/AsyncWebsocketClient	A websocket client object.
ledger_index	Optional<&str>	A ledger index. Must be one of: "validated", "current", "closed", integer as str

Sources:

• https://github.com/XRPLF/xrpl.js/blob/main/packages/xrpl/src/sugar/balances.ts#L77

• [x] get_account_root -> AccountRoot

  1. Queries the ledger for an AccountRoot object of a given address.

2. The function simply calls the get_account_info function and returns the result's account_data field.

3. The return type AccountRoot may not be defined yet.

fields	type	explanation
account	&str	An accounts classic address.
client	WebsocketClient/AsyncWebsocketClient	A websocket client object.
ledger_index	Option<&str>	A ledger index. Must be one of: "validated", "current", "closed", integer as str

Sources:

• https://github.com/XRPLF/xrpl-py/blob/master/xrpl/asyncio/account/main.py#L84

• [ ] get_account_info -> Response

  1. Queries the ledger for account info of an account's address.

2. The function calls the AccountInfo request method using the WebsocketClient/AsyncWebsocketClient.

3. The returning Response struct may not have been added yet. Keep a look at https://github.com/sephynox/xrpl-rust/issues/17, if the tick is already set. The user can choose which ledger he wants to query using the ledger_index argument. If no ledger_index is defined (: None) the default is "validated". If a Ledger Index is defined edit the AccountInfo request as wished.

fields	type	explanation
account	&str	An accounts classic address.
client	WebsocketClient/AsyncWebsocketClient	A websocket client object.
ledger_index	Option<&str>	A ledger index. Must be one of: "validated", "current", "closed", integer as str

Sources:

• https://github.com/XRPLF/xrpl-py/blob/master/xrpl/asyncio/account/main.py#L105

• https://xrpl.org/account_info.html

• [x] get_latest_transaction -> Response

  1. Queries the Ledger for the last transaction a given account has sent.

2. The function calls the AccountTx request method using the WebsocketClient/AsyncWebsocketClient.

3. The returning Response struct may not have been added yet. Keep a look at https://github.com/sephynox/xrpl-rust/issues/17, if the tick is already set. To receive an account's latest transaction define request:

   AccountTx {
   command: RequestMethod::AccountTx, // maybe obsolete; check if `<https://github.com/sephynox/xrpl-rust/issues/19)>` is closed.
   account: account,
   id: None,
   ledger_hash: None,
   ledger_index: None,
   binary: None,
   forward: None,
   ledger_index_min: None,
   ledger_index_max: -1,
   limit: 1,
   marker: None
   }

fields	type	explanation
account	&str	An accounts classic address.
client	WebsocketClient/AsyncWebsocketClient	A websocket client object.

Sources:

• https://github.com/XRPLF/xrpl-py/blob/master/xrpl/asyncio/account/transaction_history.py#L10

• [ ] get_account_transactions

  1. Queries the Ledger for transactions sent by a given address.

2. The function calls the AccountTx request method using the WebsocketClient/AsyncWebsocketClient.

3. If an account has send too many transactions for the node to send, the node sends as many transactions as it can and includes a marker field to tell you to how many Ledgers it looked back. You can define the marker field in AccountTx to receive the next batch of transactions.

fields	type	explanation
account	&str	An accounts classic address.
client	WebsocketClient/AsyncWebsocketClient	A websocket client object.
marker	u32	The Marker to request the next batch of transactions.

Sources:

• https://xrpl.org/markers-and-pagination.html#markers-and-pagination

• https://xrpl.org/account_tx.html#account_tx

• https://github.com/XRPLF/xrpl-py/blob/master/xrpl/asyncio/account/transaction_history.py#L35

• [ ] get_account_payment_transactions

  1. Queries the Ledger for transactions sent by a given address with the TransactionType Payment.

2. The function simply calls the get_account_transactions function and filters the list of transactions for transactions with TransactionType Payment.

fields	type	explanation
account	&str	An accounts classic address.
client	WebsocketClient/AsyncWebsocketClient	A websocket client object.
marker	u32	The Marker to request the next batch of transactions.

Sources:

• https://github.com/XRPLF/xrpl-py/blob/master/xrpl/asyncio/account/transaction_history.py#L60