eth_getTransactionReceipt - Plasma RPC Method

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

Why Plasma? Build on an EVM Layer 1 for stablecoin payments with PlasmaBFT consensus and Reth execution with 1 second blocks, XPL gas, full EVM JSON-RPC, and debug plus txpool on Dwellir.

When to Use This MethodCopy Anchor Link

eth_getTransactionReceipt is essential for payment app developers, wallet teams, and teams shipping Solidity contracts for dollar transfers:

• Transaction confirmation with success/failure status: Verify that a transaction has been mined on Plasma and determine whether it succeeded or reverted
• Gas usage analysis: Compare actual gas consumed against pre-transaction estimates for stablecoin transfers, payment apps, and wallets that need 1 second confirmation
• Event log parsing from emitted events: Extract and decode contract events for indexing, analytics, and notification systems
• Contract deployment detection: Identify newly deployed contracts on an EVM Layer 1 for stablecoin payments with PlasmaBFT consensus and Reth execution by checking the contractAddress field

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionReceipt",
  "params": ["0xb7db21f5fcc47ea4f33c75deebf128eb8aaecaece720d3503e8752ec29df3e0f"],
  "id": 1
}

Common Use CasesCopy Anchor Link

1. Confirm Transaction Success and Parse Emitted EventsCopy Anchor Link

Poll eth_getTransactionReceipt after submitting a transaction to confirm it was mined successfully on Plasma. Once available, iterate through the logs array to decode and process events emitted by the transaction.

import { JsonRpcProvider } from 'ethers';

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

async function confirmAndParse(txHash) {
  let receipt = null;

  while (!receipt) {
    receipt = await provider.getTransactionReceipt(txHash);
    if (!receipt) {
      console.log('Waiting for confirmation...');
      await new Promise(r => setTimeout(r, 2000));
    }
  }

  const status = receipt.status === 1 ? 'Success' : 'Failed';
  console.log(`Transaction ${status} in block #${receipt.blockNumber}`);
  console.log(`Gas used: ${receipt.gasUsed.toString()}`);
  console.log(`Events emitted: ${receipt.logs.length}`);

  for (const log of receipt.logs) {
    console.log(`  Event from ${log.address} with topics:`, log.topics);
  }

  return receipt;
}

confirmAndParse('0xb7db21f5fcc47ea4f33c75deebf128eb8aaecaece720d3503e8752ec29df3e0f');

2. Detect Contract Deployments by Checking contractAddressCopy Anchor Link

When monitoring the chain for new contract deployments on Plasma, check the contractAddress field in transaction receipts. A non-null value indicates a contract creation transaction.

from web3 import Web3

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

def detect_deployment(tx_hash):
    receipt = w3.eth.get_transaction_receipt(tx_hash)

    if not receipt:
        print(f'Transaction {tx_hash} not yet mined')
        return None

    if receipt['contractAddress']:
        print(f'Contract deployed at: {receipt["contractAddress"]}')
        print(f'Deployer: {receipt["from"]}')
        print(f'Gas used: {receipt["gasUsed"]}')
        return receipt['contractAddress']
    else:
        print(f'Transaction {tx_hash} is not a contract deployment')
        return None

detect_deployment('0xb7db21f5fcc47ea4f33c75deebf128eb8aaecaece720d3503e8752ec29df3e0f')

3. Compute Effective Gas Price Paid by the SenderCopy Anchor Link

Use the effectiveGasPrice field from the receipt (available on EIP-1559 chains) to calculate the actual cost of a transaction on an EVM Layer 1 for stablecoin payments with PlasmaBFT consensus and Reth execution. Compare this against the gas price from the transaction object for fee analysis.

package main

import (
    "context"
    "fmt"
    "log"
    "math/big"

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

func main() {
    client, _ := ethclient.Dial("https://api-plasma-mainnet.n.dwellir.com/YOUR_API_KEY")

    txHash := common.HexToHash("0xb7db21f5fcc47ea4f33c75deebf128eb8aaecaece720d3503e8752ec29df3e0f")
    receipt, _ := client.TransactionReceipt(context.Background(), txHash)

    if receipt == nil {
        log.Fatal("Transaction not yet mined")
    }

    status := "Success"
    if receipt.Status == 0 {
        status = "Failed"
    }

    fmt.Printf("Status: %s\n", status)
    fmt.Printf("Block: %d\n", receipt.BlockNumber.Uint64())
    fmt.Printf("Gas used: %d\n", receipt.GasUsed)

    // Calculate total cost: gasUsed * effectiveGasPrice
    totalCost := new(big.Int).Mul(
        big.NewInt(int64(receipt.GasUsed)),
        receipt.EffectiveGasPrice,
    )
    fmt.Printf("Total cost: %s wei\n", totalCost.String())

    if receipt.ContractAddress != (common.Address{}) {
        fmt.Printf("Contract deployed at: %s\n", receipt.ContractAddress.Hex())
    }
}

Best PracticesCopy Anchor Link

• Receipt is only available after mining; poll until non-null: A null response means the transaction is pending or not found; implement a polling loop with exponential backoff to wait for confirmation
• Check the status field: 0x1 indicates a successful execution; 0x0 means the transaction reverted and may have consumed all provided gas
• Parse the logs array for events using known topic hashes: Each log entry contains up to 4 indexed topics and a data field; use ABI definitions to decode them into readable event parameters
• For frontrunning detection, compare effective gas price across similar transactions: Monitoring the effectiveGasPrice across transactions in a block can reveal priority gas auction dynamics on an EVM Layer 1 for stablecoin payments with PlasmaBFT consensus and Reth execution
• contractAddress is non-null only for contract deployment transactions: Use this field to distinguish regular transfers from contract create operations

Code ExamplesCopy Anchor Link

Error HandlingCopy Anchor Link

Note: Returns null if transaction is not yet mined.

Related MethodsCopy Anchor Link

• eth_getTransactionByHash - Get transaction details
• eth_getLogs - Query logs by filter