eth_getTransactionReceipt - Boba Network RPC Method
Get transaction receipt with status and logs on Boba Network. Essential for verifying transaction execution for AI-powered dApps, Web2 API integration, enterprise blockchain solutions, and offchain computation.
Returns the receipt of a transaction by transaction hash on Boba Network. Receipt is only available for mined transactions.
Why Boba Network? Build on the Hybrid Compute L2 enabling smart contracts to access AI models and Web2 APIs natively with HybridCompute 2.0 for native AI/API access, $70M ecosystem funding, OP Stack compatibility, and two-way offchain integration.
When to Use This Method
eth_getTransactionReceipt is essential for AI dApp developers, enterprise integration teams, and builders requiring offchain compute access:
- Transaction confirmation with success/failure status: Verify that a transaction has been mined on Boba Network and determine whether it succeeded or reverted
- Gas usage analysis: Compare actual gas consumed against pre-transaction estimates for AI-powered dApps, Web2 API integration, enterprise blockchain solutions, and offchain computation
- 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 the Hybrid Compute L2 enabling smart contracts to access AI models and Web2 APIs natively by checking the
contractAddressfield
Common Use Cases
1. Confirm Transaction Success and Parse Emitted Events
Poll eth_getTransactionReceipt after submitting a transaction to confirm it was mined successfully on Boba Network. 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-boba-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('0x5d01c1b5655ee1315a49968be5bf94b730e8ea3854e88b3ee4ef7624f3b15565');2. Detect Contract Deployments by Checking contractAddress
When monitoring the chain for new contract deployments on Boba Network, 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-boba-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('0x5d01c1b5655ee1315a49968be5bf94b730e8ea3854e88b3ee4ef7624f3b15565')3. Compute Effective Gas Price Paid by the Sender
Use the effectiveGasPrice field from the receipt (available on EIP-1559 chains) to calculate the actual cost of a transaction on the Hybrid Compute L2 enabling smart contracts to access AI models and Web2 APIs natively. 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-boba-mainnet.n.dwellir.com/YOUR_API_KEY")
txHash := common.HexToHash("0x5d01c1b5655ee1315a49968be5bf94b730e8ea3854e88b3ee4ef7624f3b15565")
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 Practices
- Receipt is only available after mining; poll until non-null: A
nullresponse means the transaction is pending or not found; implement a polling loop with exponential backoff to wait for confirmation - Check the
statusfield:0x1indicates a successful execution;0x0means the transaction reverted and may have consumed all provided gas - Parse the
logsarray 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
effectiveGasPriceacross transactions in a block can reveal priority gas auction dynamics on the Hybrid Compute L2 enabling smart contracts to access AI models and Web2 APIs natively contractAddressis non-null only for contract deployment transactions: Use this field to distinguish regular transfers from contract create operations
Code Examples
Error Handling
| Error Code | Message | Description |
|---|---|---|
| -32602 | Invalid params | Invalid transaction hash |
Note: Returns null if transaction is not yet mined.
Related Methods
eth_getTransactionByHash- Get transaction detailseth_getLogs- Query logs by filter
eth_getTransactionByHash
Retrieve transaction details by hash on Boba Network. Essential for AI dApp developers, enterprise integration teams, and builders requiring offchain compute access tracking transactions on the Hybrid Compute L2 enabling smart contracts to access AI models and Web2 APIs natively.
eth_estimateGas
Estimate gas required for transactions on Boba Network. Essential for optimizing transaction costs for AI-powered dApps, Web2 API integration, enterprise blockchain solutions, and offchain computation.