Docs
Supported ChainsXDC NetworkJSON-RPC APITransaction Methods

eth_getTransactionReceipt - XDC Network RPC Method

Get transaction receipt with status and logs on XDC Network. Essential for verifying transaction execution for tokenized trade finance (Letters of Credit, Bills of Lading), cross-border payments, and real-world asset tokenization.

Returns the receipt of a transaction by transaction hash on XDC Network. Receipt is only available for mined transactions.

Why XDC Network? Build on the enterprise-grade blockchain for trade finance with 2-second finality and ISO 20022 compliance with ISO 20022 messaging, ITFA membership, Contour Network acquisition, 801M+ transactions, and partnerships with Circle and Deutsche Telekom.

Use Cases

The eth_getTransactionReceipt method is essential for:

  • Transaction confirmation - Verify transaction was mined successfully
  • Gas analysis - Check actual gas used vs estimated
  • Event parsing - Read emitted events from logs
  • Status verification - Confirm success/failure for tokenized trade finance (Letters of Credit, Bills of Lading), cross-border payments, and real-world asset tokenization

Request Parameters

Request
transactionHashDATA

32-byte transaction hash

Response Body

Response
statusQUANTITY

1 (success) or 0 (failure)

transactionHashDATA

Transaction hash

blockHashDATA

Block hash

blockNumberQUANTITY

Block number

gasUsedQUANTITY

Gas used by this transaction

cumulativeGasUsedQUANTITY

Total gas used in block up to this tx

logsArray

Array of log objects

contractAddressDATA

Created contract address (if deployment)

Code Examples

Bash
curl -X POST https://api-xdc-mainnet.n.dwellir.com/YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionReceipt",
    "params": ["0x60975ea1a0c8283193d6b1ea0b8ea7d37745e30703eeb15f82a3acf1c72ce8f3"],
    "id": 1
  }'
JavaScript
import { JsonRpcProvider } from 'ethers';

const provider = new JsonRpcProvider('https://api-xdc-mainnet.n.dwellir.com/YOUR_API_KEY');

const txHash = '0x60975ea1a0c8283193d6b1ea0b8ea7d37745e30703eeb15f82a3acf1c72ce8f3';
const receipt = await provider.getTransactionReceipt(txHash);

if (receipt) {
  console.log('Status:', receipt.status === 1 ? 'Success' : 'Failed');
  console.log('Gas Used:', receipt.gasUsed.toString());
  console.log('Block:', receipt.blockNumber);
  console.log('Logs:', receipt.logs.length);

  // Parse specific events
  for (const log of receipt.logs) {
    console.log('Event from:', log.address);
  }
}
Python
from web3 import Web3

w3 = Web3(Web3.HTTPProvider('https://api-xdc-mainnet.n.dwellir.com/YOUR_API_KEY'))

tx_hash = '0x60975ea1a0c8283193d6b1ea0b8ea7d37745e30703eeb15f82a3acf1c72ce8f3'
receipt = w3.eth.get_transaction_receipt(tx_hash)

if receipt:
    status = 'Success' if receipt['status'] == 1 else 'Failed'
    print(f'Status: {status}')
    print(f'Gas Used: {receipt["gasUsed"]}')
    print(f'Block: {receipt["blockNumber"]}')
    print(f'Logs: {len(receipt["logs"])}')
Go
package main

import (
    "context"
    "fmt"
    "log"

    "github.com/ethereum/go-ethereum/common"
    "github.com/ethereum/go-ethereum/ethclient"
)

func main() {
    client, err := ethclient.Dial("https://api-xdc-mainnet.n.dwellir.com/YOUR_API_KEY")
    if err != nil {
        log.Fatal(err)
    }

    txHash := common.HexToHash("0x60975ea1a0c8283193d6b1ea0b8ea7d37745e30703eeb15f82a3acf1c72ce8f3")
    receipt, err := client.TransactionReceipt(context.Background(), txHash)
    if err != nil {
        log.Fatal(err)
    }

    fmt.Printf("Status: %d\n", receipt.Status)
    fmt.Printf("Gas Used: %d\n", receipt.GasUsed)
    fmt.Printf("Logs: %d\n", len(receipt.Logs))
}

Error Handling

Error CodeMessageDescription
-32602Invalid paramsInvalid transaction hash

Note: Returns null if transaction is not yet mined.