feat: Soft failure reason for evm op results

[usmansaleem]

PR description

Add Soft failure reason for evm op results. This will help in tracer implementations such as call tracer which need soft failure reasons.

** New File:**
SoftFailureReason

Main Modifications:

org.hyperledger.besu.evm.operation.Operation
org.hyperledger.besu.evm.operation.AbstractCallOperation#execute

Fixed Issue(s)

Thanks for sending a pull request! Have you done the following?

• Checked out our contribution guidelines?
• Considered documentation and added the doc-change-required label to this PR if updates are required.
• Considered the changelog and included an update if required.
• For database changes (e.g. KeyValueSegmentIdentifier) considered compatibility and performed forwards and backwards compatibility tests

Locally, you can run these tests to catch failures early:

• spotless: ./gradlew spotlessApply
• unit tests: ./gradlew build
• acceptance tests: ./gradlew acceptanceTest
• integration tests: ./gradlew integrationTest
• reference tests: ./gradlew ethereum:referenceTests:referenceTests

[Copilot]

Pull Request Overview

This PR introduces a soft failure reason mechanism for EVM operation results to help tracer implementations distinguish between different types of failures that don't halt execution.

• Adds a new SoftFailureReason interface with predefined failure types
• Enhances OperationResult to include optional soft failure reason information
• Updates AbstractCallOperation to set specific soft failure reasons for insufficient balance and max call depth scenarios

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
SoftFailureReason.java	New interface defining soft failure reasons with default implementations
Operation.java	Enhanced OperationResult to include optional SoftFailureReason field
AbstractCallOperation.java	Updated to set soft failure reasons for balance and depth check failures

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Gabriel-Trintinalia]

LGTM

[macfarla]

what is a soft failure?

[usmansaleem]

@macfarla soft failures doesn't cause a revert or transaction to fail. For example, not enough balance or if calls depth is more than 1024. A good example of "soft failure" is https://github.com/hyperledger/besu/blob/main/evm/src/main/java/org/hyperledger/besu/evm/operation/AbstractExtCallOperation.java#L206 as well.