explorer-monorepo/scripts/check-failed-transaction-details.sh

#!/usr/bin/env bash
# Check Failed Transaction Details on RPC Node
# Analyzes specific failed transactions

set -euo pipefail

RPC_IP="${1:-192.168.11.250}"
SSH_PASSWORD="${SSH_PASSWORD:-${2:-}}"
if [ -z "${SSH_PASSWORD}" ]; then
    echo "ERROR: SSH_PASSWORD is required. Pass it as an argument or export SSH_PASSWORD in the environment." >&2
    echo "       Hardcoded default removed for security; see docs/SECURITY.md." >&2
    exit 2
fi

TX_HASH="${3:-0x4dc9f5eedf580c2b37457916b04048481aba19cf3c1a106ea1ee9eefa0dc03c8}"

echo "╔══════════════════════════════════════════════════════════════╗"
echo "║     CHECKING FAILED TRANSACTION DETAILS                     ║"
echo "╚══════════════════════════════════════════════════════════════╝"
echo ""
echo "Transaction: $TX_HASH"
echo "RPC: $RPC_IP"
echo ""

# Check if sshpass is available
if ! command -v sshpass >/dev/null 2>&1; then
    echo "⚠️  sshpass not installed. Installing..."
    sudo apt-get update -qq && sudo apt-get install -y sshpass 2>/dev/null || {
        echo "❌ Cannot install sshpass automatically"
        exit 1
    }
fi

# Get transaction receipt
echo "═══════════════════════════════════════════════════════════════"
echo "1. TRANSACTION RECEIPT"
echo "═══════════════════════════════════════════════════════════════"
echo ""

RECEIPT=$(sshpass -p "$SSH_PASSWORD" ssh -o StrictHostKeyChecking=no -o ConnectTimeout=10 \
    root@"$RPC_IP" \
    "curl -s -X POST -H 'Content-Type: application/json' \
     --data '{\"jsonrpc\":\"2.0\",\"method\":\"eth_getTransactionReceipt\",\"params\":[\"$TX_HASH\"],\"id\":1}' \
     http://localhost:8545" 2>&1)

if [ -n "$RECEIPT" ]; then
    echo "$RECEIPT" | jq '.' 2>/dev/null || echo "$RECEIPT"
    
    STATUS=$(echo "$RECEIPT" | jq -r '.result.status // empty' 2>/dev/null || echo "")
    GAS_USED=$(echo "$RECEIPT" | jq -r '.result.gasUsed // empty' 2>/dev/null || echo "")
    CONTRACT=$(echo "$RECEIPT" | jq -r '.result.contractAddress // empty' 2>/dev/null || echo "")
    
    echo ""
    echo "Status: $STATUS"
    echo "Gas Used: $GAS_USED"
    echo "Contract Address: $CONTRACT"
else
    echo "❌ Could not retrieve transaction receipt"
fi
echo ""

# Get transaction details
echo "═══════════════════════════════════════════════════════════════"
echo "2. TRANSACTION DETAILS"
echo "═══════════════════════════════════════════════════════════════"
echo ""

TX_DETAILS=$(sshpass -p "$SSH_PASSWORD" ssh -o StrictHostKeyChecking=no -o ConnectTimeout=10 \
    root@"$RPC_IP" \
    "curl -s -X POST -H 'Content-Type: application/json' \
     --data '{\"jsonrpc\":\"2.0\",\"method\":\"eth_getTransactionByHash\",\"params\":[\"$TX_HASH\"],\"id\":1}' \
     http://localhost:8545" 2>&1)

if [ -n "$TX_DETAILS" ]; then
    echo "$TX_DETAILS" | jq '.' 2>/dev/null || echo "$TX_DETAILS"
    
    FROM=$(echo "$TX_DETAILS" | jq -r '.result.from // empty' 2>/dev/null || echo "")
    TO=$(echo "$TX_DETAILS" | jq -r '.result.to // empty' 2>/dev/null || echo "")
    GAS=$(echo "$TX_DETAILS" | jq -r '.result.gas // empty' 2>/dev/null || echo "")
    GAS_PRICE=$(echo "$TX_DETAILS" | jq -r '.result.gasPrice // empty' 2>/dev/null || echo "")
    INPUT=$(echo "$TX_DETAILS" | jq -r '.result.input // empty' 2>/dev/null || echo "")
    INPUT_LEN=${#INPUT}
    
    echo ""
    echo "From: $FROM"
    echo "To: $TO (null = contract creation)"
    echo "Gas Limit: $GAS"
    echo "Gas Price: $GAS_PRICE"
    echo "Input Length: $INPUT_LEN chars (contract bytecode)"
else
    echo "❌ Could not retrieve transaction details"
fi
echo ""

# Search logs for this transaction
echo "═══════════════════════════════════════════════════════════════"
echo "3. LOGS FOR THIS TRANSACTION"
echo "═══════════════════════════════════════════════════════════════"
echo ""

TX_SHORT="${TX_HASH:0:20}..."
LOG_ENTRIES=$(sshpass -p "$SSH_PASSWORD" ssh -o StrictHostKeyChecking=no -o ConnectTimeout=10 \
    root@"$RPC_IP" \
    "journalctl -u besu-rpc -n 5000 --no-pager 2>/dev/null | grep -i '$TX_SHORT\|${TX_HASH:2}' || echo 'NO_LOGS'" 2>&1)

if echo "$LOG_ENTRIES" | grep -qv "NO_LOGS"; then
    echo "$LOG_ENTRIES" | head -20
else
    echo "  ℹ️  No log entries found for this transaction"
    echo "  (Transaction may have been processed but not logged)"
fi
echo ""

# Try to get revert reason (if available)
echo "═══════════════════════════════════════════════════════════════"
echo "4. REVERT REASON (if available)"
echo "═══════════════════════════════════════════════════════════════"
echo ""

# Try debug_traceTransaction if available
TRACE=$(sshpass -p "$SSH_PASSWORD" ssh -o StrictHostKeyChecking=no -o ConnectTimeout=10 \
    root@"$RPC_IP" \
    "curl -s -X POST -H 'Content-Type: application/json' \
     --data '{\"jsonrpc\":\"2.0\",\"method\":\"debug_traceTransaction\",\"params\":[\"$TX_HASH\",{\"tracer\":\"callTracer\"}],\"id\":1}' \
     http://localhost:8545" 2>&1)

if [ -n "$TRACE" ] && ! echo "$TRACE" | grep -q "method not found\|not available"; then
    echo "$TRACE" | jq '.' 2>/dev/null | head -50 || echo "$TRACE" | head -50
else
    echo "  ℹ️  debug_traceTransaction not available or not enabled"
    echo "  (Requires DEBUG API to be enabled)"
fi
echo ""

# Summary
echo "═══════════════════════════════════════════════════════════════"
echo "SUMMARY"
echo "═══════════════════════════════════════════════════════════════"
echo ""

if [ "$STATUS" = "0x0" ]; then
    echo "❌ Transaction FAILED (status 0x0)"
    echo ""
    echo "Possible causes:"
    echo "  1. Contract constructor reverted"
    echo "  2. Out of gas (but gas was provided)"
    echo "  3. Network-level restriction"
    echo "  4. Invalid bytecode"
    echo "  5. Network state issue"
    echo ""
    echo "Next steps:"
    echo "  - Check if contract bytecode is valid"
    echo "  - Verify network allows contract creation"
    echo "  - Check validator logs for restrictions"
    echo "  - Try deploying from validator node"
fi
echo ""