feat: Implement MirrorNodeContractQuery

[0xivanov]

Description:

A new MirrorNodeContractQuery class has been introduced to support EVM gas estimation and simulation. This query class provides two distinct types of queries:

1. MirrorNodeContractCallQuery – Executes a contract call and returns the result, simulating the execution of the contract.
2. MirrorNodeContractEstimateGasQuery – Estimates the gas usage for a contract call, allowing developers to understand the cost of executing a transaction.

The inputs for these queries match those of ContractExecuteTransaction, making it easy for developers to calculate the cost of a follow-up transaction.

The MirrorNodeContractQuery issues an HTTP request to the api/v1/contracts/call endpoint of the Mirror Node Web3 module, which supports both gas estimation and transient simulation of state-changing transactions. This enables accurate cost predictions and helps developers optimize their contract interactions before executing them on the network.

Related issue(s):

Fixes #2076

Notes for reviewer:

Checklist

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

[Nana-EC]

Nice start.
Missing some fields.
Also you might be able to leverage some Mirror Node web3 module tests as references of example calls.
@kselveliev should be able to help

[rbarkerSL]

Approval applies to gradle/plugins/src/main/kotlin/com.hedera.gradle.java.gradle.kts

[kselveliev]

LGTM

[codecov]

Codecov Report

Attention: Patch coverage is 91.59664% with 10 lines in your changes missing coverage. Please review.

Project coverage is 83.14%. Comparing base (b86ee46) to head (7a5c88b).
Report is 187 commits behind head on main.

Files with missing lines	Patch %	Lines
.../hedera/hashgraph/sdk/MirrorNodeContractQuery.java	92.85%	3 Missing and 3 partials ⚠️
.../java/com/hedera/hashgraph/sdk/EntityIdHelper.java	86.20%	3 Missing and 1 partial ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##               main    #2073      +/-   ##
============================================
+ Coverage     82.20%   83.14%   +0.94%     
- Complexity     3588     4029     +441     
============================================
  Files           186      202      +16     
  Lines         11697    12820    +1123     
  Branches       1150     1266     +116     
============================================
+ Hits           9615    10659    +1044     
- Misses         1604     1701      +97     
+ Partials        478      460      -18     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[0xivanov]

Hey @Nana-EC @SimiHunjan can you please take a look at the updated version of the queries?
You can focus on the exposed APIs and not so much the business logic.

[Nana-EC]

Looking good, some comments

[san-est]

applies to files owned by us: gradle/plugins/src/main/kotlin/com.hedera.gradle.java.gradle.kts

[Nana-EC]

Nice work, left some details on the examples section

[Nana-EC]

LG, thanks

[san-est]

re-approving:
applies to files owned by us: gradle/plugins/src/main/kotlin/com.hedera.gradle.java.gradle.kts