feat: Debug RPC- call tracer

[usmansaleem]

PR description

This PR is built on top of #8960. It add fixes for DELEGATECALL, Precompiles, SELFDESTRUC, Calls without RETURN and soft failures such as insufficient balance to transfer. It also refactors utility methods from CallTracerResultConverter class for easier readability and testability.

It bring integration tests from #9091. These integration cases were generated running against Geth instance.

Caution

This feature is enabled by using flag: --Xenable-extra-debug-tracers=true. Its disabled by default as it is experimental.

Note

Tracer config options specific to callTracer, such as onlyTopCall:true, are not yet supported

Summary of Changes per file (Generated by Copilot)

File	Description
TraceFrame.java	Adds soft failure reason and gas available for child calls to support detailed tracing
Operation.java	Extends OperationResult with gas allocation tracking for failed calls
AbstractCallOperation.java	Updates soft failure handling to include gas information
DebugOperationTracer.java	Integrates soft failure and gas tracking into trace frames
CallTracerResultConverter.java	Core converter implementing Geth-compatible call tracing logic
CallTracerResult.java	Adds getters and improves revert reason handling
CallTracerHelper.java	Utility class for memory extraction and byte conversion
Test files	Comprehensive test suite covering various call scenarios

Example Call for debug_trace* methods

{
  jsonrpc: "2.0",
  method:  "debug_traceTransaction",
  params:  [
    $txHash,
    {
      tracer:       "callTracer",
      tracerConfig: { onlyTopCall: false }
    }
  ],
  id: 1
}

Acceptance tests: Following scenarios should produce identical output against Geth and Besu

• Simple Transaction
• Contract Creation Tx
• Contract Calls (Simple) Tx
• Contract Calls (Complex: Contract3.x() -> Contract2.x() -> Contract1.x()) Tx
• Execution error in Contract Creation
• Revert Reasons
• Self destruct
• Precompiled Gas Cost
• Refunds
• Soft failures (insufficient balance to transfer to another account in a contract)

Fixed Issue(s)

#8326

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[macfarla]

can we have a changelog entry included for this

Dismiss review as requested changes implemented.