feat: Add new opcodes endpoint

[victor-yanev]

Description:

This MR adds the following changes:

• TransactionIdOrHashParameter
  • record used to parse and store an input parameter for transaction ID or hash.
  • validation fails if the input is neither a parsable:
    • ETH hash: ^(0x)?([0-9A-Fa-f]{64})$
    • Transaction ID: ^(\\d+)\\.(\\d+)\\.(\\d+)-(\\d{1,19})-(\\d{1,9})$
• OpcodeSerivce:
  • contains the logic related to building ContractCallServiceParameters:
    • if an ETH hash Is passed:
      • fetches the ContractTransactionHash
      • fetches the EthereumTransaction
      • fetches the ContractResult
      • then builds the ContractCallServiceParameters from the fetched data
    • if a transaction ID is passed:
      • fetches the Transaction
      • fetches the EthereumTransaction
      • fetches the ContractResult
      • then builds the ContractCallServiceParameters from the fetched data
  • contains the logic related to building an OpcodesResponse from the OpcodesProcessingResult which is after calling ContractCallService:
    • some additional fetching is needed from EntityDatabaseAccessor to the get the EVM addresses of the sender and the receiver
• OpcodesController:
  • can be enabled by property hedera.mirror.opcode.tracer.enabled (false by default)
  • GET: /api/v1/contracts/results/{transactionIdOrHash}/opcodes
    • calls OpcodeService to construct the CallServiceParameters from the given transactionIdOrHash
    • calls the processOpcodeCall method in ContractCallService
    • calls OpcodeService to build an OpcodesResponse from the result

More info can be found here.

Related issue(s):

Fixes #8174

Notes for reviewer:

The actual logic for ContractCallService.processOpcodeCall is currently in progress in another PR.

I've added it as an empty method which throws UnsupportedOperationException.

Tests Added

• OpcodesControllerTests:
  • verifies the constructed CallServiceParameters for different type of transactions:
    • native transactions:
      • contract call
      • contract create
    • Ethereum transactions:
      • EIP-1559
      • EIP-2930
  • verifies the constructed OpcodesResponse with different values passed for stack, memory and storage
  • TransactionProviderEnum:
    • builds mocked Legacy, EIP-1559, EIP-2930 transactions which are used throughout the tests

Checklist

• Documented (Code comments, README, etc.)
• Tested (unit, integration, etc.)

[steven-sheehy]

Need to also add this endpoint to the ingress routes in the web3 helm chart.

[victor-yanev]

Just noticed the large gap in test coverage. Every repository and service should have a corresponding integration test (not mock).

Will be done in the PR for the integration tests.

OOO

[sonarcloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
No data about Coverage
0.0% Duplication on New Code

See analysis details on SonarCloud

[xin-hedera]

LGTM