Releases: hiero-ledger/hiero-mirror-node
v0.132.0
This is a smaller release focused on finalizing the non-zero shard and realm work. Based upon internal feedback, we adjusted the logic for encoding long-zero EVM addresses to not include shard and realm in the 20 byte address. This has no impact on regular networks
Enhancements
- K6 test for findStorage #11330
- Remove shard/realm from evm address lookups #11326
- Support web3 log in traffic-replay tool #11325
- Remove shard realm from entity lookup #11322
- Drop shard / realm in long form evm address encoding and validation #11321
- Utilize child error transactions in web3 #11319
- Acceptance tests should not encode shard and realm in EVM addresses #11292
- Remove copied readable and writable kv state classes v2 #11287
- Add integration tests for Schedule token create with smart contract #11284
Bug Fixes
- Fix secret-passwords template (0.132) #11415
- Revert removed copied readable and writable kv state classes (0.132) #11369
- Fix async java migration checksum tracking #11357
- Fix cleanup workflow #11334
- Fix failing acceptance test in testnet #11328
Documentation
- Update MAINTAINERS.md #11323
Dependency Upgrades
- Cherry-pick dependency bumps to 0.132 #11416
- Bump
@aws-sdk
/client-s3 from 3.821.0 to 3.826.0 in /rest #11353 - Bump express-openapi-validator from 5.5.3 to 5.5.6 in /rest #11352
- Bump jest-extended from 5.0.3 to 6.0.0 in /rest #11351
- Bump sql-formatter from 15.6.2 to 15.6.3 in /rest #11350
- Bump
@testcontainers
/redis from 11.0.0 to 11.0.2 in /rest #11349 - Bump
@testcontainers
/postgresql from 11.0.0 to 11.0.2 in /rest #11348 - Bump rewire from 7.0.0 to 8.0.0 in /rest #11347
- Bump io.hypersistence:hypersistence-utils-hibernate-63 from 3.9.10 to 3.9.11 #11344
- Bump org.bouncycastle:bcprov-jdk18on from 1.80 to 1.81 #11343
- Bump software.amazon.awssdk:bom from 2.31.54 to 2.31.59 #11342
- Bump flywayVersion from 11.8.2 to 11.9.1 #11341
- Bump the npm_and_yarn group in /rest with 1 update #11318
- Bump
@aws-sdk
/client-s3 from 3.817.0 to 3.821.0 in /rest #11314 - Bump
@testcontainers
/postgresql from 10.28.0 to 11.0.0 in /rest #11313 - Bump mathjs from 14.5.0 to 14.5.2 in /rest/monitoring #11312
- Bump mathjs from 14.5.0 to 14.5.2 in /rest #11311
- Bump
@testcontainers
/redis from 10.28.0 to 11.0.0 in /rest #11310 - Bump yargs from 17.7.2 to 18.0.0 in /tools/traffic-replay/log-downloader #11309
- Bump gorm.io/driver/postgres from 1.5.11 to 1.6.0 in /rosetta #11308
- Bump github.com/hiero-ledger/hiero-sdk-go/v2 from 2.62.0 to 2.63.0 in /rosetta #11307
- Bump yargs from 17.7.2 to 18.0.0 in /rest/check-state-proof #11306
- Bump io.grpc:grpc-bom from 1.72.0 to 1.73.0 #11305
- Bump com.hedera.hashgraph:app from 0.62.3 to 0.63.5 #11304
- Bump org.testcontainers:junit-jupiter from 1.21.0 to 1.21.1 #11303
- Bump software.amazon.awssdk:bom from 2.31.50 to 2.31.54 #11301
- Bump com.hedera.hashgraph:sdk from 2.56.1 to 2.57.0 #11300
- Bump com.diffplug.spotless:spotless-plugin-gradle from 7.0.3 to 7.0.4 #11299
- Bump protobufVersion from 4.31.0 to 4.31.1 #11298
- Bump io.cucumber:cucumber-bom from 7.22.2 to 7.23.0 #11297
- Bump org.testcontainers:postgresql from 1.21.0 to 1.21.1 #11296
- Bump step-security/ghaction-import-gpg from 6.1.0 to 6.3.0 #11295
- Bump docker/build-push-action from 6.17.0 to 6.18.0 #11294
- Bump step-security/close-milestone from 2.1.2 to 2.2.0 #11293
- Bump commons-beanutils:commons-beanutils from 1.10.1 to 1.11.0 in the gradle group #11285
- Bump versions for v0.132.0-SNAPSHOT #11281
- Bump org.springframework.boot:spring-boot-gradle-plugin from 3.4.5 to 3.5.0 #11250
Deployments
- Deploy v0.132.0-rc2 to performance and mainnet-staging #11376
- Increase helm release timeout for performance #11336
- Increase disk size for coordinators in performance #11335
- Prepare mainnet na for 0.131.0 #11332
Contributors
Thank you to all the contributors who worked on this release:
@filev94
@hendrikebbers
@jnels124
@kselveliev
@nickeynikolovv
@steven-sheehy
@xin-hedera
v0.132.0-rc2
v0.132.0-rc2
v0.131.1
This release fixes a regression caused by our Hiero package renaming that could cause our async database migrations to re-trigger.
Bug Fixes
Hiero migration breaks async java migrations #11363
Contributors
v0.132.0-rc1
v0.132.0-rc1
v0.130.1
This release fixes a regression caused by our Hiero package renaming that could cause our async database migrations to re-trigger.
Bug Fixes
Hiero migration breaks async java migrations #11362
Contributors
v0.131.0
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 protobufVe...
v0.131.0-beta1
v0.131.0-beta1
v0.130.0
After previously migrating the repository to Hiero, this release focuses on migrating the code base to use Hiero in place of Hedera. The top-level folders were all renamed to remove the hedera-mirror-
prefix in favor of a simpler module name like importer
. All Java packages were migrated from com.hedera.mirror
to org.hiero.mirror
. Properties were converted from hedera.mirror
to hiero.mirror
with a migration path for operators (see Breaking Changes). Finally, Prometheus metrics were also renamed to change Hedera to Hiero and standardized to include the module name.
HIP-1046 gRPC web proxy endpoints support is now available. Support for persisting the new gRPC proxy endpoints on the node create and update transactions was implemented. Additionally, a new grpc_proxy_endpoint
was added to each node entry in the /api/v1/network/nodes
REST API.
The mirror node now sets an implicit ContractID{shard, realm, num}
key on contract creation for contracts without a key. Additionally, we migrated existing contracts without a key to populate a ContractID
key.
An updated minimal and full database snapshot is now available for download and can be used to bootstrap new mirror nodes. The updated snapshots were taken with the 0.125.0 schema and reflect the database as of early March 2025. The minimal and full are identical except the minimal excludes our largest HCS topic and reduces the snapshot size by 90%.
Breaking Changes
All hedera.mirror.*
properties were renamed to hiero.mirror.*
. This includes both environment variables (e.g. HEDERA_MIRROR
) and yaml properties. To mitigate the impact of this breaking change, a property migrator was added that automatically converts any Hedera property to Hiero. When any mirror node component starts up, it will log a warning that it converted legacy Hedera properties. It's recommended that operators note these warnings and transition their configuration to use the new Hiero prefixed properties. In the future, we might remove this migration logic after customers have had time to migrate their configuration.
All hedera_mirror
prometheus metrics were renamed to hiero_mirror
. Any alerts or dashboards that referenced these metrics were also updated to use the new hiero metric. An operator using these metrics outside these areas should update to use the renamed metrics.
With the exception of the protobuf package, all packages were renamed from com.hedera.mirror
to org.hiero.mirror
. Since the mirror node does not publish a library that packages its code, this should not be user impacting. Any operator who's running a forked version of the code would need to update its folders and packages to reflect the new Hiero naming.
Enhancements
- Rename web3 properties and metrics to hiero #11162
- Cache null values on findStorage calls #11155
- Add support for HIP-1046 gRPC proxy endpoints #11143
- Migrate rest-java to Hiero #11142
- Rename hedera-mirror-common folder to common #11135
- Set an implicit ContractID key on contracts with no key #11134
- Migrate REST API to Hiero #11126
- Fix acceptance tests that were failing with INSUFFICIENT_GAS #11122
- Refactor BlockStreamPoller #11112
- Migrate rosetta to Hiero #11111
- Migrate test module to Hiero #11110
- Migrate importer to Hiero #11109
- Adapt block streams protobuf changes in 0.62 #11104
- Remove the temporary workaround for ThrottleAccumulator #11103
- Add support for migrating to hiero properties #11086
- Bootstrap full-db support and general optimizations #11073
- Migrate monitor to hiero #11058
- Fix importer tests to be NZR compatible #10903
Bug Fixes
- Optimize rest API resource management (0.130) #11221
- Add a request timeout interceptor to contract call (0.130) #11216
- Fix stateproof API metrics (0.130) #11190
- Fixing failing topic acceptance test (0.130) #11182
- Fix migrated environment variable to config property mapping #11170
- Fix new issue config #11163
- Fix npe in node transaction migration #11159
- Enforce a request timeout in web3 #11145
- Fix
NullPointerException
on FractionalFee getMaximumAmount() #11138 - Upgrade mapstructure to v2.2.1 #11124
- Add validation for smart contract sender accounts #11088
- Prevent batch transactions from being filtered #11082
- Fix snyk check & address book parsing #11078
Dependency Upgrades
- Bump express-openapi-validator from 5.4.9 to 5.5.0 in /rest #11148
- Bump io.cucumber:cucumber-bom from 7.22.1 to 7.22.2 #11147
- Bump software.amazon.awssdk:bom from 2.31.39 to 2.31.40 #11146
- Bump
@hashgraph
/proto from 2.16.0 to 2.17.0 in /rest #11131 - Bump
@aws-sdk
/client-s3 from 3.804.0 to 3.806.0 in /rest #11129 - Bump securego/gosec from 2.22.3 to 2.22.4 #11128
- Bump software.amazon.awssdk:bom from 2.31.38 to 2.31.39 #11127
- Bump gorm.io/gorm from 1.26.0 to 1.26.1 in /rosetta #11118
- Bump com.hedera.hashgraph:hedera-protobuf-java-api from 0.62.0 to 0.62.1 #11117
- Bump com.hedera.hashgraph:app from 0.62.0 to 0.62.1 #11116
- Bump software.amazon.awssdk:bom from 2.31.35 to 2.31.38 #11115
- Bump flywayVersion from 11.8.0 to 11.8.1 #11114
- Bump
@aws-sdk
/client-s3 from 3.802.0 to 3.804.0 in /hedera-mirror-rest #11113 - Bump github.com/hiero-ledger/hiero-sdk-go/v2 from 2.60.0 to 2.61.0 in /hedera-mirror-rosetta #11100
- Bump
@testcontainers
/postgresql from 10.24.2 to 10.25.0 in /hedera-mirror-rest #11099 - Bump
@testcontainers
/redis from 10.24.2 to 10.25.0 in /hedera-mirror-rest #11097 - Bump
@aws-sdk
/client-s3 from 3.797.0 to 3.802.0 in /hedera-mirror-rest #11096 - Bump software.amazon.awssdk:bom from 2.31.25 to 2.31.35 #11095
- Bump
@hashgraph
/proto from 2.16.0 to 2.17.0 in /hedera-mirror-rest/check-state-proof #11093 - Bump jooqVersion from 3.20.3 to 3.20.4 #11091
- Bump io.cucumber:cucumber-bom from 7.22.0 to 7.22.1 #11045
- Bump com.hedera.hashgraph:app from 0.61.3 to 0.62.0 #11039
- Bump google-github-actions/auth from 2.1.8 to 2.1.10 #11029
Deployments
v0.130.0-rc2
v0.130.0-rc2
v0.130.0-rc1
v0.130.0-rc1