JSON-RPC Request - TX_HISTORY

Shows transactions history for address, wallet or transaction by hash

CLI Example

Command syntax:

tx_history  
{-addr <addr> | -w <wallet_name> | -tx <tx_hash>} 
[-net <net_name>] 
[-chain <chain_name>]
[-limit] 
[-offset]
[-head]
[-tail]
 

Options:

-net - name of the Cellframe Network. The list of networks can be found in the <Config_dir> \ etc \ network folder or received by The Cellframe-Node-CLI using command - net list (optional)
-addr/-w/-tx - shows information using address hash, hash of the wallet or transaction hash (optional)
-chain - the name of Chain. The list of chains can be found in the directory <Config_dir> \ etc \ network \ <network_name> or by the Cellframe-Node-CLI using command - net list chains (optional)
-limit - number of elements being printed (optional)
-offset - number of the element from which printing will be started (optional)
-head - shows transactions list starting from the first one (optional)
-tail - shows transactions list startinf from the last one (optional)

Example:

Command:

cellframe-node-cli tx_history 
-tx   0xF9BCFF36A5C2B8FF9889CB3F133ED0487E21684AA88AA9FB887C2CDA4699933B 
-net Backbone 
-chain main 

Response:

            status: ACCEPTED
            atom_hash: 0x1B2AE588B9740D68352876AF4A2154EEF4AF2BB0E646DD01ECC6B77EC8964008
            hash: 0xF9BCFF36A5C2B8FF9889CB3F133ED0487E21684AA88AA9FB887C2CDA4699933B
            token_ticker: CELL
            ret_code: 0
            ret_code_str: DAP_LEDGER_TX_CHECK_OK
            tx_created: Thu Jan 25 16:52:47 2024
            items:
            type: TX_ITEM_TYPE_IN
            data:
                       prev_idx: 0
                       prev_hash: 0x5B595F08B4D4A008C6E7ABC547A003232535C8BDBD2077D5083BFAA745A8575F
 ...
"-brief parameter removes information below" 
            type: TX_ITEM_TYPE_SIG
            data:
                       sign_size: 3306
                       sign:
                       type: sig_dil
                       pkeyHash: 0x0E08E575A5142FBFEA5E61DA7266402DADD9D033F05D5B2EF0E1AEE1F11C8FAA
                       signPkeySize: 1196
                       signSize: 2096

JSON-RPC Example

Command:

curl -X POST http://rpc.cellframe.net/connect -d '{"method":"tx_history", "params":["tx_history;-tx;0xF9BCFF36A5C2B8FF9889CB3F133ED0487E21684AA88AA9FB887C2CDA4699933B;-net;Backbone;-chain;main"], "id":"1"}'

Response:

{ 
"type": 2,
"result": "same as cli response",
"errors": null,
"id": 1	
}