v0.130.0

[steven-sheehy]

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

• Increase testnet-na web3 mod traffic to 100% #11230
• Deploy v0.130.0 to testnet-eu #11229
• Upgrade staging and perf to v0.130.0-rc1 #11172
• Increase modularized traffic to 3% on mainnet-eu #11089
• Bump versions for v0.130.0-SNAPSHOT #11075

Contributors

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

@bilyana-gospodinova
@filev94
@jnels124
@mgoelswirlds
@nickeynikolovv
@nirbosl
@sdimitrov9
@steven-sheehy
@xin-hedera

---

This discussion was created from the release v0.130.0.