v0.127.0-rc1

v0.127.0-rc1

v0.126.0

A large focus of this release was to support non-zero realms and shards. To that end, the gRPC API was updated to properly validate the file ID in the address book API against the configured realm and shard. The REST API now uses the hedera.mirror.common.shard and hedera.mirror.common.realm properties instead of the now deleted hedera.mirror.rest.shard property. This includes a change to now look up the alias and EVM address using either the user provided or configured shard and realm. The database encoding of shard.realm.num identifiers was tweaked to increase the number of bits to num from 32 to 38 bits and decrease the shard from 15 to 10 bits. This change should not impact current mirror node deployments. Balance snapshot and pending reward calculation was updated to not hardcode system accounts with 0.0. The default operator in the acceptance tests and monitor was changed from 0.0.2 to use the configured shard and realm. Finally, the web3 API now uses the configured realm and shard as well.

Integrating the modularized consensus node library into the web3 module made excellent progress. A new property hedera.mirror.web3.evm.modularizedTrafficPercent was added to enable a gradual rollout of the new code base. Metrics were updated to include a modularized flag so we can monitor its rollout. A number of missing singletons were implemented that the library requires. There were a large number of fixes to make the acceptance tests work against the modularized web3 as well.

A number of bug fixes and improvements for HIP-1056 block streams were tackled including handling the genesis block and processing contract block items.

Also of note, the max age to cache the response for /api/v1/schedule/{id} was increased from one second to one hour for deleted or executed schedules. Finally, we switched code coverage and static analysis from Codecov and Sonar to Codacy.

Breaking Changes

Similar to the last release, specific shard properties were removed in favor of a common shard properties. Thus hedera.mirror.rest.shard was removed in favor of using the hedera.mirror.common.shard and hedera.mirror.common.realm properties. Most customers should not be using these properties so will not be impacted.

Enhancements

• Support non-zero realms in gRPC API #10631
• Add metrics and logging for transaction traffic split #10625
• Use shard and realm in balance snapshot generation and querying #10611
• Workaround Codacy outage #10610
• Fix historical.feature failing acceptance tests against modularized EVM #10606
• Fix precompile.feature acceptance tests #10600
• Support realm property in REST API #10598
• Add missing singletons #10592
• Use shard and realm for entity stake calculation #10591
• Adapt web3 startup with modularized for non genesis startup #10588
• Remove codecov and sonar #10566
• Use shard realm from common properties to configure operator for acceptance tests #10564
• Upload coverage reports to Codacy #10563
• Support non-zero realm in monitor #10562
• Change entity id encoding #10557
• Use shard and realm properties in web3 API #10554
• Fix get token default kyc status test for modularized #10549
• Refactor historical tests in web3 module #10548
• Disable deterministic throttle from hedera app #10547
• Implement gradual rollout for modularized txn execution #10545
• Add update token custom fee test cases #10544
• HIP-1056 Handle standalone state changes in genesis block #10542
• HIP-1056 Contract BlockItem Transformer #10506
• Add EntityIdSingleton for modularized #10503
• Added the logic to increase the response cache maxAge for /schedule/id #10383

Bug Fixes

• Downgrade sdk to 2.50.0 #10635
• Handle optional block stream transaction output #10615
• Fix block stream pathPrefix support #10613
• Fix NPE in monitor metrics #10609
• Fix token null metadata issue #10608
• Add Receipt ContractId to Ethereum Transformer #10599
• Fix address book updates requiring an IP #10556

Dependency Upgrades

• Bump golang.org/x/net from 0.34.0 to 0.36.0 in /hedera-mirror-rosetta in the go_modules group #10605
• Bump @babel/runtime from 7.26.0 to 7.26.10 in /hedera-mirror-rest/monitoring in the npm_and_yarn group #10601
• Bump github.com/prometheus/client_golang from 1.21.0 to 1.21.1 in /hedera-mirror-rosetta #10586
• Bump github.com/ethereum/go-ethereum from 1.15.4 to 1.15.5 in /hedera-mirror-rosetta #10585
• Bump github.com/hiero-ledger/hiero-sdk-go/v2 from 2.56.0 to 2.57.0 in /hedera-mirror-rosetta #10584
• Bump mathjs from 14.3.0 to 14.3.1 in /hedera-mirror-rest/monitoring #10583
• Bump com.gorylenko.gradle-git-properties:gradle-git-properties from 2.4.2 to 2.5.0 #10582
• Bump org.testcontainers:postgresql from 1.20.5 to 1.20.6 #10581
• Bump flywayVersion from 11.3.3 to 11.3.4 #10580
• Bump io.freefair.gradle:lombok-plugin from 8.12.2 to 8.12.2.1 #10579
• Bump org.testcontainers:junit-jupiter from 1.20.5 to 1.20.6 #10578
• Bump com.hedera.hashgraph:app from 0.59.2 to 0.59.3 #10577
• Bump io.hypersistence:hypersistence-utils-hibernate-63 from 3.9.2 to 3.9.3 #10575
• Bump org.web3j:web3j-gradle-plugin from 4.12.3 to 4.13.0 #10574
• Bump ioredis from 5.5.0 to 5.6.0 in /hedera-mirror-rest #10573
• Bump eslint-config-prettier from 10.0.2 to 10.1.1 in /hedera-mirror-rest #10572
• Bump mathjs from 14.3.0 to 14.3.1 in /hedera-mirror-rest #10571
• Bump @fetch-mock/jest from 0.2.14 to 0.2.15 in /tools/mirror-report #10570
• Bump peter-evans/create-pull-request from 7.0.7 to 7.0.8 #10569
• Bump step-security/close-milestone from 2.1.1 to 2.1.2 #10568
• Bump securego/gosec from 2.22.1 to 2.22.2 #10567
• Bump axios from 1.7.7 to 1.8.2 in /hedera-mirror-rest in the npm_and_yarn group #10565
• Bump versions for v0.126.0-SNAPSHOT #10539
• Bump codecov/codecov-action from 5.3.1 to 5.4.0 #10532
• Bump actions/cache from 4.2.1 to 4.2.2 #10531
• Bump docker/setup-qemu-action from 3.4.0 to 3.6.0 #10530
• Bump docker/setup-buildx-action from 3.9.0 to 3.10.0 #10529
• Bump docker/build-push-action from 6.14.0 to 6.15.0 [#10528](https://github.com/hi...

v0.125.0

HIP-991 topic custom fees support was added to our REST APIs. The /api/v1/topics/{id} endpoint now displays the list of custom fees associated with a topic as well as its fee_schedule_key and fee_exempt_key_list. Additionally, the /api/v1/transactions and /api/v1/transactions/{id} endpoints were updated to add the new max_custom_fees the payer was willing to accept.

The design for HIP-551 batch transactions was completed and its tasks broken down. Look for its implementation to be completed in the near future.

Support for non-zero realms is being explored starting with this release. New properties hedera.mirror.common.realm and hedera.mirror.common.shard were added to centralize the configuration of a mirror node's base realm and shard. With this came support for configuring common properties across sub-charts in Helm. So with a single Helm value property like global.env.HEDERA_MIRROR_COMMON_REALM=0 or global.config.hedera.mirror.common.shard=0 it can configure eight sub-charts with similar config. We will explore extracting other properties that apply to multiple modules like network to these common properties in the future.

Breaking Changes

The hedera.mirror.importer.shard, hedera.mirror.restJava.shard, hedera.mirror.rosetta.realm, and hedera.mirror.rosetta.shard configuration properties were removed in favor of hedera.mirror.common.realm and hedera.mirror.common.shard properties. Users most likely never used these properties since the default value was zero and the network does not support non-zero values at this time. In the unlikely event these properties were explicitly set to zero by an operator, they will need to be updated to the new property paths.

Enhancements

• Add global config and env variable to helm chart #10513
• Fix estimatePrecompile acceptance test with modularized services #10504
• Add a common realm property #10501
• Fix dependency check workflow #10494
• bootstrap.sh improvements #10490
• Fix nft owner mapping from nft readable state #10488
• Convert license header to SPDX format #10482
• Add batch transaction design #10481
• Fix contract storage readable kv state slot values #10480
• Fix mint fungible test for modularized #10479
• Added max_custom_fees to transactions REST api endpoint #10451
• Add topic custom fee fields to /topics/{id} endpoint #10450
• Refactor persistNFT method in web3 test code #10447
• Change to SPDX license header in Gradle #10445
• ci: Add workflow to sync gh-pages branch #10427
• Remove SENDER_ALIAS & SPENDER_ALIAS constants in web3 tests #10405
• HIP-1056 Add token blockitem to recorditem transformers #10354

Bug Fixes

• Fix rosetta construction parse error #10508
• Honor timestamp param for token by id endpoint #10495
• Fix local rest gradle build #10491
• Fixes after SPDX header change #10486
• Disable dependency check and sonar workflows #10442
• Update REST API tokens query to correct for deleted token timestamps #10440
• Improve Performance of Contracts REST API Endpoints with High Entity Count #10434

Dependency Upgrades

• Bump mathjs from 14.2.1 to 14.3.0 in /hedera-mirror-rest #10520
• Bump @fetch-mock/jest from 0.2.12 to 0.2.14 in /tools/mirror-report #10519
• Bump peter-evans/create-pull-request from 7.0.6 to 7.0.7 #10483
• Bump actions/upload-artifact from 4.6.0 to 4.6.1 #10478
• Bump actions/cache from 4.2.0 to 4.2.1 #10477
• Bump ncipollo/release-action from 1.15.0 to 1.16.0 #10476
• Bump azure/setup-helm from 4.2.0 to 4.3.0 #10475
• Bump docker/build-push-action from 6.13.0 to 6.14.0 #10474
• Bump express-openapi-validator from 5.4.3 to 5.4.4 in /hedera-mirror-rest #10473
• Bump @aws-sdk/client-s3 from 3.749.0 to 3.750.0 in /hedera-mirror-rest #10472
• Bump org.testcontainers:junit-jupiter from 1.20.4 to 1.20.5 #10471
• Bump org.springframework.boot:spring-boot-gradle-plugin from 3.4.2 to 3.4.3 #10470
• Bump org.testcontainers:postgresql from 1.20.4 to 1.20.5 #10469
• Bump long from 5.3.0 to 5.3.1 in /hedera-mirror-rest #10467
• Bump sql-formatter from 15.4.10 to 15.4.11 in /hedera-mirror-rest #10465
• Bump software.amazon.awssdk:bom from 2.30.21 to 2.30.26 #10464
• Bump io.freefair.gradle:lombok-plugin from 8.12.1 to 8.12.2 #10463
• Bump flywayVersion from 11.3.2 to 11.3.3 #10462
• Bump jooqVersion from 3.19.18 to 3.20.1 #10461
• Bump @fetch-mock/jest from 0.2.10 to 0.2.12 in /tools/mirror-report #10460
• Bump github.com/prometheus/client_golang from 1.20.5 to 1.21.0 in /hedera-mirror-rosetta #10459
• Bump github.com/ethereum/go-ethereum from 1.15.1 to 1.15.2 in /hedera-mirror-rosetta #10458
• Bump github.com/hiero-ledger/hiero-sdk-go/v2 from 2.55.0 to 2.56.0 in /hedera-mirror-rosetta #10457
• Bump versions for v0.125.0-SNAPSHOT #10437

Deployments

• Deploy v0.125.0-rc1 to performance and mainnet-staging #10541
• Update commit status GitHub PAT #10499
• Prepare staging and performance for 0.124.0-rc1 #10441

Contributors

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

@bilyana-gospodinova
@edwin-greene
@filev94
@HarshSawarkar
@jnels124
@kselveliev
@nirbosl
@rbarker-dev
@sdimitrov9
@steven-sheehy
@xin-hedera

v0.125.0-rc1

v0.125.0-rc1

v0.123.1

Bug Fixes

• Fix rosetta construction parse error (0.123) #10509

Contributors

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

@xin-hedera

v0.124.1

Bug Fixes

• Cherry pick Stackgres fix #10454
• Add id for SGScript entries #10453

Contributors

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

@jnels124

v0.124.0

The Hedera Mirror node is now the Hiero Mirror Node! The GitHub repository was migrated to the hiero-ledger organization and can now be found at https://github.com/hiero-ledger/hiero-mirror-node. To facilitate the Hiero migration, the docs were updated to reference the new git repository and the workflows update to use the new Hiero GitHub runners. Unfortunately, since our Helm repository is located at https://hashgraph.github.io/hedera-mirror-node/charts and served via GitHub Pages we could not automatically redirect all requests from Hashgraph to the Hiero repository. We're working on setting up an OCI registry and once that is available we'll ask people to start migrating away from the old Helm repository.

The block stream (HIP-1056) saw major progress this release including the addition of a block stream poller. This poller polls the S3 bucket for newer block streams, downloads them, and verifies their contents. In addition, block stream to record stream transformers for accounts, topics, and other system transactions were completed. A number of changes were made as a result of changes upstream in the consensus nodes. This includes the previous hash now read from the block proof, the BlockHeader and RoundHeader used for block root hash calculation, and changing to use the BlockHeader.firstTransactionConsensusTime.

The transition to the modularized EVM continues to make progress. This release saw 14 PRs closed and now down to only 4 tests not passing. The web3 web3 docs were updated to show the currently unsupported operations.

Finally, our Stackgres chart was updated from 1.13 to 1.15. If you're using Stackgres, ensure Stackgres gets updated appropriately when deploying our Helm chart.

Enhancements

• Change default resources for envoy #10426
• ci: Update runners to use new hiero configuration #10424
• Update web3 docs for newer unsupported operations #10422
• Fix more tests in ContractCallServiceTests #10382
• Fix the rest ContractCallDynamicCallsTest tests #10381
• Fix ContractCallEvmCodesHistoricalTest tests #10380
• Fix ContractCallServiceHistoricalNegativeTest #10373
• Add annotations to marketplace images #10372
• HIP-1056 Read previous hash from block proof #10365
• Fix ContractCallServicePrecompileHistoricalTest tests #10363
• Upgrade to Stackgres 1.15 #10360
• Refactor web3 test code #10358
• Adapt storage capturing in OpcodeTracer for modularized execution #10357
• Fix system precompile tests for modularized #10355
• Fix nested calls historical tests for modularized #10349
• Include BlockHeader and RoundHeader for block root hash calculation #10322
• HIP-1056 Topic block item to record item transformer #10318
• Use BlockHeader.firstTransactionConsensusTime #10317
• HIP-1056 Account BlockItem to RecordItem transformers #10314
• Mirror node state scoped cache implementation #10306
• Fix additional tests in contract call service tests #10305
• Add System BlockItem to RecordItem transformers #10294
• Refactor web3 tests code #10293
• Fix tests from ContractCallDynamicCallsTest test class #10284
• HIP-1056 Add block stream poller #10250

Bug Fixes

• Configure GraphQL parsing limits #10379
• Fix null previous block item #10377
• Fix unboxing issue causing errors in acceptance tests #10375
• Fix failing acceptance tests on mainnet for scheduled transactions #10312
• Fix importer tests using mirror_node user #10309
• Use owner template #10304

Documentation

• Update repo name to hiero #10429

Dependency Upgrades

• Bump com.hedera.hashgraph:app version from 0.58.4 to 0.59.0 #10409
• Bump compression from 1.7.5 to 1.8.0 in /hedera-mirror-rest/monitoring #10403
• Bump step-security/harden-runner from 2.10.4 to 2.11.0 #10402
• Bump docker/setup-qemu-action from 3.3.0 to 3.4.0 #10401
• Bump docker/setup-buildx-action from 3.8.0 to 3.9.0 #10400
• Bump securego/gosec from 2.22.0 to 2.22.1 #10399
• Bump @aws-sdk/client-s3 from 3.744.0 to 3.749.0 in /hedera-mirror-rest #10398
• Bump compression from 1.7.5 to 1.8.0 in /hedera-mirror-rest #10397
• Bump @hashgraph/proto from 2.15.0 to 2.16.0 in /hedera-mirror-rest #10396
• Bump pg from 8.13.1 to 8.13.3 in /hedera-mirror-rest #10395
• Bump github.com/go-playground/validator/v10 from 10.24.0 to 10.25.0 in /hedera-mirror-rosetta #10394
• Bump github.com/ethereum/go-ethereum from 1.15.0 to 1.15.1 in /hedera-mirror-rosetta #10393
• Bump commons-beanutils:commons-beanutils from 1.10.0 to 1.10.1 #10392
• Bump io.hypersistence:hypersistence-utils-hibernate-63 from 3.9.1 to 3.9.2 #10391
• Bump io.projectreactor:reactor-core-micrometer from 1.2.2 to 1.2.3 #10389
• Bump flywayVersion from 11.3.1 to 11.3.2 #10388
• Bump org.owasp:dependency-check-gradle from 12.0.2 to 12.1.0 #10387
• Bump software.amazon.awssdk:bom from 2.30.16 to 2.30.21 #10386
• Bump vertxVersion from 4.5.12 to 4.5.13 #10385
• Bump @hashgraph/proto from 2.15.0 to 2.16.0 in /hedera-mirror-rest/check-state-proof #10384
• Bump hiero-sdk-go to 2.55.0 #10371
• Bump parse-duration from 2.1.2 to 2.1.3 in /hedera-mirror-rest in the npm_and_yarn group #10370
• Bump parse-duration from 2.1.2 to 2.1.3 in /hedera-mirror-rest/monitoring in the npm_and_yarn group #10369
• Bump parse-duration from 2.1.2 to 2.1.3 in /tools/traffic-replay/log-downloader in the npm_and_yarn group #10368
• Bump json-smart from 2.5.1 to 2.5.2 #10367
• Bump netty from 4.1.117.Final to 4.1.118.Final #10361
• Bump long from 5.2.4 to 5.3.0 in /hedera-mirror-rest #10350
• Bump @fetch-mock/jest from 0.2.9 to 0.2.10 in /tools/mirror-report #10347
• Bump docker/setup-qemu-action from 3.3.0 to 3.4.0 #10346
• Bump docker/setup-buildx-action from 3.8.0 to 3.9.0 #10345
• Bump step-security/close-milestone from 2.1.0 to 2.1.1 #10344
• Bump github.com/ethereum/go-ethereum from 1.14.13 to 1.15.0 in /hedera-mirror-rosetta [#10343](https://github.com/hiero-ledger/hi...

v0.124.0-rc1

v0.124.0-rc1

v0.123.0

This release saw initial support for HIP-991 topic custom fees. The design was updated to reflect the recent changes in the improvement proposal. The importer now supports ingesting topic custom fees and persisting them. It's recommended that mirror node operators update to this release before consensus nodes upgrade to v0.59. In a future release, we'll work on exposing this information via the existing APIs.

HIP-1056 block streams saw continued progress. Additional block item to record item transformers were completed including file and schedule transactions. The topic running hash column was made nullable since it is no longer sent in block streams.

Finally, a large amount of progress was made towards our modularized EVM effort. In this release, a total of 12 PRs related to modularized EVM were closed and we're getting close to a fully functional implementation.

Enhancements

• Add 0.59 protobuf response codes #10297
• HIP-991 Ingest topic custom fees related information #10295
• Handle exception throwing in binary gas estimator when performing estimate gas #10258
• HIP 1056 Add schedule block item transformers #10254
• Fix INSUFFICIENT\_GAS issue in ContractCallServiceTests #10253
• Fix broken tests and document methods #10252
• Fix the ERC historical tests #10251
• HIP-1056 Add File BlockItem to RecordItem transformers #10248
• Fix OpcodeServiceTest for modularized #10247
• Fix ContractCallEvmCodesHistoricalTest #10221
• Fix multiple tests within ContractCallServicePrecompileModificationTest #10219
• Remove file upload on contract create and use maxSignedTxnSize property #10218
• Modularized fix ContractCallNestedCallsTest #10217
• Fix ContractCallEvmCodesTest #10216
• HIP-1056: Update topic message running hash version to be nullable #10215
• Fix contract call ERC modification approve tests #10210
• Enhancing if statement to disable retry for web3 & modularized services #10209
• Fix Gradle JUnit deprecation warnings #10204
• Remove automatic publishing of builds data #10170
• Cherry Pick Migration Fix #10308

Bug Fixes

• Fix NPE in node data migration #10300
• Set prometheus pod priority class to high #10287
• Fix node data migration #10260
• Fix rest java specs failing when they're changed #10220
• Fix add block columns migration #10212

Documentation

• HIP-991 update design #9978

Dependency Upgrades

• Bump hedera-protobuf-java-api to 0.59.0 #10298
• Bump s3proxy to v2.6.0 #10296
• Bump gradle/actions from 4.2.2 to 4.3.0 #10266
• Bump actions/setup-node from 4.1.0 to 4.2.0 #10265
• Bump actions/setup-java from 4.6.0 to 4.7.0 #10264
• Bump actions/setup-python from 5.3.0 to 5.4.0 #10262
• Bump google-github-actions/setup-gcloud from 2.1.2 to 2.1.4 #10261
• Bump github.com/ethereum/go-ethereum from 1.14.12 to 1.14.13 in /hedera-mirror-rosetta in the go_modules group #10257
• Bump mathjs from 14.0.1 to 14.1.0 in /hedera-mirror-rest/monitoring #10246
• Bump parse-duration from 1.1.1 to 2.0.1 in /hedera-mirror-rest/monitoring #10245
• Bump google.golang.org/protobuf from 1.36.3 to 1.36.4 in /hedera-mirror-rosetta #10244
• Bump commander from 13.0.0 to 13.1.0 in /tools/mirror-report #10243
• Bump codecov/codecov-action from 5.1.2 to 5.3.1 #10242
• Bump parse-duration from 1.1.1 to 2.0.1 in /tools/traffic-replay/log-downloader #10241
• Bump actions/setup-go from 5.2.0 to 5.3.0 #10240
• Bump helm/chart-testing-action from 2.6.1 to 2.7.0 #10239
• Bump docker/build-push-action from 6.12.0 to 6.13.0 #10238
• Bump parse-duration from 1.1.1 to 2.0.1 in /hedera-mirror-rest #10237
• Bump @testcontainers/postgresql from 10.16.0 to 10.17.1 in /hedera-mirror-rest #10236
• Bump sql-formatter from 15.4.9 to 15.4.10 in /hedera-mirror-rest #10235
• Bump @testcontainers/redis from 10.16.0 to 10.17.1 in /hedera-mirror-rest #10234
• Bump mathjs from 14.0.1 to 14.1.0 in /hedera-mirror-rest #10233
• Bump @aws-sdk/client-s3 from 3.731.1 to 3.735.0 in /hedera-mirror-rest #10232
• Bump org.openapitools:openapi-generator-gradle-plugin from 7.10.0 to 7.11.0 #10231
• Bump io.freefair.gradle:lombok-plugin from 8.11 to 8.12 #10230
• Bump software.amazon.awssdk:bom from 2.30.2 to 2.30.6 #10229
• Bump org.springframework.boot:spring-boot-gradle-plugin from 3.4.1 to 3.4.2 #10228
• Bump com.hedera.hashgraph:hedera-protobuf-java-api from 0.57.3 to 0.58.4 #10227
• Bump org.gradle:test-retry-gradle-plugin from 1.6.0 to 1.6.1 #10226
• Bump io.grpc:grpc-bom from 1.69.1 to 1.70.0 #10225
• Bump vertxVersion from 4.5.11 to 4.5.12 #10224
• Bump versions for v0.123.0-SNAPSHOT #10205

Deployments

• Updated staging-council's addressBook value in the cluster's sealed-secret #10315
• Upgrade performance to 0.123.0-rc2 #10310
• Upgrade mainnet-staging to 0.123.0-rc2 #10303

Contributors

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

@bilyana-gospodinova
@edwin-greene
@filev94
@jnels124
@kselveliev
@Neurone
@nickeynikolovv
@nirbosl
@sdimitrov9
@steven-sheehy
@xin-hedera

v0.123.0-rc2

v0.123.0-rc2