rpc-requirements.md

RPC / API Requirements

Trust Wallet is a light client wallet, which means it needs to get data / information from remote nodes (either light nodes or full nodes). In order to integrate your blockchain into Trust Wallet smoothly, you must also fulfill RPC / API requirements. We list all needed APIs or RPCs plus an example below for your reference.

for Trust Wallet:

We need API or RPC to:

• query account / address balance
• query transaction details
• query fee / nonce for sending transaction
• query blockchain status (block height etc)
• send raw transaction

for Backend:

Used to create transaction list index and notify users about incoming/outgoing transactions.

• query transactions in a block

Example

We will take XRP as an example here, it supports WebSocket, JSON-RPC (including over HTTP)

Query account / address balance:

• JSON RPC method: account_info (https://xrpl.org/docs/references/http-websocket-apis/public-api-methods/account-methods/account_info)

Query transaction details:

• JSON RPC method: tx (https://xrpl.org/docs/references/http-websocket-apis/public-api-methods/transaction-methods/tx)

Query fee / nonce for sending transaction:

• fee: JSON RPC method: fee (https://xrpl.org/docs/references/http-websocket-apis/public-api-methods/server-info-methods/fee)
• nonce: same as account_info, you can find Sequence in response.

Query blockchain status (block height etc):

• JSON RPC method: server_state (https://xrpl.org/docs/references/http-websocket-apis/public-api-methods/server-info-methods/server_state)

Send raw transaction:

• JSON RPC method: submit (https://xrpl.org/docs/references/http-websocket-apis/public-api-methods/transaction-methods/submit)

Query sent / received transactions for an account / address:

• JSON RPC method: account_tx (https://xrpl.org/docs/references/http-websocket-apis/public-api-methods/account-methods/account_tx)

Query transactions in a block:

• JSON RPC method: ledger (https://xrpl.org/docs/references/http-websocket-apis/public-api-methods/ledger-methods/ledger)