transaction_entry - XRPL

Example code for the transaction_entry JSON RPC method. Complete guide to using transaction_entry JSON-RPC in the GetBlock Web3 documentation.

This method retrieves information on a single transaction from a specific ledger version. The tx Method is recommended instead, as it searches all ledgers.

Parameters

Parameter

Type

Required

Description

tx_hash

string

Yes

Transaction hash

ledger_hash

string

Ledger hash

ledger_index

string/number

Ledger index

Request Example

cURL

curl --location --request POST 'https://go.getblock.io/<ACCESS_TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "transaction_entry",
    "params": [{
        "tx_hash": "C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9",
        "ledger_index": 63632029
    }],
    "id": "getblock.io"
}'

JavaScript (Axios)

const axios = require('axios');

const url = 'https://go.getblock.io/<ACCESS_TOKEN>/';
const headers = {
    'Content-Type': 'application/json'
};

const payload = {
    jsonrpc: '2.0',
    method: 'transaction_entry',
    params: [{
        tx_hash: 'C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9',
        ledger_index: 63632029
    }],
    id: 'getblock.io'
};

axios.post(url, payload, { headers })
    .then(response => console.log(response.data))
    .catch(error => console.error(error));

Python

import requests

url = "https://go.getblock.io/<ACCESS_TOKEN>/"
headers = {
    "Content-Type": "application/json"
}

payload = {
    "jsonrpc": "2.0",
    "method": "transaction_entry",
    "params": [{
        "tx_hash": "C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9",
        "ledger_index": 63632029
    }],
    "id": "getblock.io"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

Rust

use reqwest::Client;
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();
    
    let payload = json!({
        "jsonrpc": "2.0",
        "method": "transaction_entry",
        "params": [{
            "tx_hash": "C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9",
            "ledger_index": 63632029
        }],
        "id": "getblock.io"
    });

    let response = client
        .post("https://go.getblock.io/<ACCESS_TOKEN>/")
        .header("Content-Type", "application/json")
        .json(&payload)
        .send()
        .await?;

    let result: serde_json::Value = response.json().await?;
    println!("{:#?}", result);
    
    Ok(())
}

Response Example

{
    "result": {
        "ledger_index": 63632029,
        "metadata": {
            "TransactionResult": "tesSUCCESS"
        },
        "status": "success",
        "tx_json": {
            "Account": "rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH",
            "TransactionType": "Payment"
        }
    }
}

Response Parameters

Parameter

Type

Description

tx_json

object

Transaction data

metadata

object

Transaction result

ledger_index

integer

Ledger containing tx

Use Cases

Get transaction from specific ledger
Historical analysis
Ledger auditing

Error Handling

txnNotFound

Transaction not found

lgrNotFound

Ledger not found

SDK Integration

xrpl.js

const xrpl = require('xrpl');

async function getTxEntry() {
    const client = new xrpl.Client('wss://xrplcluster.com');
    await client.connect();
    
    const response = await client.request({
        command: 'transaction_entry',
        tx_hash: 'C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9',
        ledger_index: 63632029
    });
    
    console.log(response.result);
    await client.disconnect();
}

getTxEntry();

xrpl-py

from xrpl.clients import JsonRpcClient
from xrpl.models.requests import TransactionEntry

client = JsonRpcClient("https://xrp.getblock.io/mainnet/")
request = TransactionEntry(
    tx_hash="C53ECF838647FA5A4C780377025FEC7999AB4182590510CA461444B207AB74A9",
    ledger_index=63632029
)
response = client.request(request)
print(response.result)

Previoussign - XRPL NextZcash (ZEC)

Last updated 2 months ago

Was this helpful?