v0.131.0

[steven-sheehy]

This release expands upon our read only EVM functionality and includes many bug fixes and performance improvements. We added support for the HederaScheduleService system contracts in the modularized /api/v1/contracts/call REST API. Tests were added to verify HIP-719 which has system contracts for token associate, dissociate, and isAssociated. Additional testing was conducted to verify airdrops and get schedule info system contracts. The contract call API now supports per request filters including filtering by from, to, data, block, etc. If the filter is matched it can be configured to either log, reject, throttle, or redirect to modularized or monolithic code path. We've also documented the breaking changes to the modularized contract call (see section below for details).

There were some minor follow on tasks related to the Hiero migration after the major changes seen in the last release. The common and web3 modules as well as the OpenAPI generated models all saw their Java packages renamed from com.hedera.mirror to org.hiero.mirror. The hedera-mirror-web3 folder was renamed to just web3 to match the other modules. Finally, the documentation was changed to reduce the use of Hedera or replace it with Hiero.

Important for partial mirror nodes, we now automatically create the 0.0.2 treasury account if it does not exist. This is a special account we use internally to generate our balance snapshots and without it operators without all historical data could only track the latest balance. This synthetic account is excluded from API responses since it is not generated from consensus node state and only used internally.

Breaking Changes

While not specific to this release, we wanted to call out the changes in behavior being rolled out as a result of the modularized EVM project. We're in the midst of rolling out this rewritten /api/v1/contracts/call API that incorporates the latest consensus node EVM library. It is currently deployed to 100% of previewnet and testnet traffic. This change allows the mirror node to again provide accurate gas estimation and adds support for all the latest system contracts added upstream.

Unfortunately, it does include changes in behavior that customers need to be made aware of before we can safely roll it out to mainnet. We've prepared a document detailing the breaking changes that customers may experience. We ask that customers please test their application on previewnet or testnet to verify compatibility. If you experience any issues not noted in the document or have any questions about the document please reach out to us in Discord or in GitHub discussions.

Enhancements

• Add request filters to contract call #11245
• Add tests for HIP-719 - Associate, Dissociate and isAssociated #11242
• Ensure treasury entity exists for balance generation #11237
• Improving state key registry #11226
• Update database dashboard #11224
• Rename common and OpenaAPI model packages to Hiero #11219
• Rename hedera-mirror-web3 folder and packages #11217
• Add schedule KV state and tests #11123
• Add web3 integration tests for get schedule info #11101
• Add airdrop to contract system contract tests #11062
• Split downloaded files by date into different folders #11024

Bug Fixes

• Fix web3 throttle #11278
• Add user connection limit to pgbouncer #11268
• Fix unexpected changelog.md #11234
• Add caching in EntityIdSingleton #11225
• Fix flaky rest tests #11220
• Add a request timeout interceptor to contract call #11192
• Optimize rest API resource management #11189
• Fix stateproof API metrics #11188
• Fix flaky rest tests #11177
• Fixing failing topic acceptance test #11174
• Fix Rest API response cache handler #11151

Documentation

• Fix balances endpoint description #11270
• Add docs for modularized breaking changes #11239
• Update docs to remove references to Hedera #11227
• Create MAINTAINERS.md #10733

Dependency Upgrades

• Bump @aws-sdk/client-s3 from 3.812.0 to 3.817.0 in /rest #11262
• Bump @testcontainers/redis from 10.26.0 to 10.28.0 in /rest #11261
• Bump @testcontainers/postgresql from 10.26.0 to 10.28.0 in /rest #11260
• Bump sql-formatter from 15.6.1 to 15.6.2 in /rest #11259
• Bump jest-extended from 4.0.2 to 5.0.3 in /rest #11258
• Bump mathjs from 14.4.0 to 14.5.0 in /rest #11257
• Bump express-openapi-validator from 5.5.1 to 5.5.3 in /rest #11256
• Bump gorm.io/gorm from 1.26.1 to 1.30.0 in /rosetta #11255
• Bump software.amazon.awssdk:bom from 2.31.45 to 2.31.50 #11254
• Bump io.swagger:swagger-annotations from 1.6.15 to 1.6.16 #11253
• Bump io.projectreactor:reactor-core-micrometer from 1.2.5 to 1.2.6 #11252
• Bump com.hedera.hashgraph:app from 0.62.2 to 0.62.3 #11249
• Bump com.hedera.hashgraph:hedera-protobuf-java-api from 0.62.2 to 0.62.3 #11248
• Bump mathjs from 14.4.0 to 14.5.0 in /rest/monitoring #11247
• Bump Gradle from 8.11.1 to 8.14 #11235
• Bump xml2js from 0.4.23 to 0.5.0 #11228
• Bump express-openapi-validator from 5.5.0 to 5.5.1 in /rest #11215
• Bump @hashgraph/proto from 2.17.0 to 2.18.5 in /rest #11214
• Bump supertest from 7.1.0 to 7.1.1 in /rest #11213
• Bump @testcontainers/postgresql from 10.25.0 to 10.26.0 in /rest #11212
• Bump @aws-sdk/client-s3 from 3.806.0 to 3.812.0 in /rest #11211
• Bump pg from 8.15.6 to 8.16.0 in /rest #11209
• Bump @testcontainers/redis from 10.25.0 to 10.26.0 in /rest #11208
• Bump commander from 13.1.0 to 14.0.0 in /tools/mirror-report #11207
• Bump com.hedera.hashgraph:app from 0.62.1 to 0.62.2 #11206
• Bump com.hedera.hashgraph:hedera-protobuf-java-api from 0.62.1 to 0.62.2 #11205
• Bump com.playtika.testcontainers:embedded-google-pubsub from 3.1.11 to 3.1.13 #11204
• Bump flywayVersion from 11.8.1 to 11.8.2 #11203
• Bump com.hedera.hashgraph:sdk from 2.55.0 to 2.56.1 #11202
• Bump software.amazon.awssdk:bom from 2.31.40 to 2.31.45 #11201
• Bump dockerJavaVersion from 3.5.0 to 3.5.1 #11199
• Bump protobufVersion from 4.30.2 to 4.31.0 #11198
• Bump org.sonarsource.scanner.gradle:sonarqube-gradle-plugin from 6.1.0.5360 to 6.2.0.5505 #11197
• Bump @hashgraph/proto from 2.17.0 to 2.18.5 in /rest/check-state-proof #11196
• Bump github.com/hiero-ledger/hiero-sdk-go/v2 from 2.61.0 to 2.62.0 in /rosetta #11195
• Bump docker/build-push-action from 6.16.0 to 6.17.0 #11194
• Bump gradle/actions from 4.3.1 to 4.4.0 #11193
• Bump undici from 5.28.5 to 5.29.0 in /rest in the npm_and_yarn group #11181
• Bump com.hedera.hashgraph:sdk from 2.54.0 to 2.55.0 #11094

Deployments

• Prepare testnet eu for 0.131.0 #11289
• Update remote write config for testnet na #11288
• Prepare staging for 0.131 #11283
• Prepare performance for 0.131 #11280
• Prepare previewnet for 0.131 #11279

Contributors

Thank you to all the contributors who worked on this release:

@filev94
@hendrikebbers
@jnels124
@kselveliev
@Neurone
@nickeynikolovv
@sdimitrov9
@steven-sheehy
@xin-hedera

---

This discussion was created from the release v0.131.0.