v0.121.0

Support for HIP-423 long term scheduled transactions was added to the mirror node awhile ago, but with its recent resurrection on consensus nodes we needed to certify our support. This release adds new acceptance tests for validating long term scheduled transactions.

HIP-1056 block stream design was completed for integrating block streams into the mirror node. Next release will see the initial support for block file reading, transformation, and verification.

A new command line tool was written to generate a CSV report of a given account's transfers and resulting balance. While mainly for internal use, it's available on NPM for use by anyone. Let us know of any feedback.

A community member updated the /api/v1/transactions/{hash} REST API to add support for thenonce and scheduled query parameters. This makes this endpoint consistent with /api/v1/transactions/{transactionId} which previously supported those parameters.

A new hedera.mirror.web3.throttle.gasUnit property was added to the web3 module. This property allows operators to set a multiplier to opt-in to throttles higher than one billion gas per second. Another change adjusts the minimum request per second throttle for contract call to allow values as low as 1 request per second, down from the previous minimum of 100 rps. Finally, the error message for gas and request rate limits were changed to make them distinct from each other.

A new hedera.mirror.web3.evm.modularizedServices=false property was added to the web3 module. This property controls whether the /api/v1/contracts/call should use the old EVM library or the newly rewritten modularized library. This marks the first time that the modularized code has been integrated enough to execute end to end. The new code flow is still under heavy development and most calls will not work.

Enhancements

• Move traffic-replay to tools folder #10045
• Bump copyright year to 2025 #10044
• Add sonar exclusion and fix sonar issues #10032
• Prepare runbook scripts for backup being enabled #9998
• Introduce gasUnit property to allow greater gas per second throttle #9994
• Fix BytecodeUtilsTest against modularized #9993
• Fix ContractCallNativePrecompileTest when running against modularized #9981
• Fix sonar issues #9979
• Expand throttling options for MN operators #9976
• Improved messaging for rate limits exceeded #9974
• Add a CLI reporting tool #9972
• Add acceptance tests for long term scheduled transactions #9963
• Add StartupNetworks component and bump hedera-app to 0.57 #9945
• Fix sonar issues #9944
• feat: Wrap modularized code in transactionExecutionService #9943
• Fix sonar issues #9941
• Add api proxy to the development docker environment #9939
• Fix ContractCallServicePrecompileReadonlyTest tests #9929
• Add modularized property #9927
• Fix code smells #9910
• Implemented the logic to support Nonce Filter on /api/v1/transactions/{hash} #9842
• Add file id and init bytecode in ContractCallContext #9799
• Add MirrorNodeState init with subcomponents #9793
• HIP-1056 Add block streams design #9716

Bug Fixes

• Generate valid secp256k1 key during key creation #10051
• Suppress ConfigUtils warning on Kubernetes startup #10043
• Use single sonar exclusion property #10037
• Return long term scheduled transaction in get transactions by id REST API #10028
• Add sonar properties file for efficient sonar management #9996
• Round down fee in tinybars #9973

Documentation

• Fix OpenAPI spec response schema for getTopicMessageByIdAndSequenceNumber #9991

Dependency Upgrades

• Bump sql-formatter from 15.4.8 to 15.4.9 in /hedera-mirror-rest #10050
• Bump @aws-sdk/client-s3 from 3.721.0 to 3.722.0 in /hedera-mirror-rest #10049
• Bump software.amazon.awssdk:bom from 2.29.44 to 2.29.45 #10048
• Bump @aws-sdk/client-s3 from 3.717.0 to 3.721.0 in /hedera-mirror-rest #10042
• Bump software.amazon.awssdk:bom from 2.29.43 to 2.29.44 #10041
• Bump commander from 12.1.0 to 13.0.0 in /tools/mirror-report #10039
• Bump golang.org/x/net from v0.26.0 to v0.33.0 #10034
• Bump express-openapi-validator from 5.3.9 to 5.4.2 in /hedera-mirror-rest #10025
• Bump google.golang.org/protobuf from 1.36.0 to 1.36.1 in /hedera-mirror-rosetta #10024
• Bump peter-evans/create-pull-request from 7.0.5 to 7.0.6 #10023
• Bump helm/kind-action from 1.11.0 to 1.12.0 #10022
• Bump software.amazon.awssdk:bom from 2.29.39 to 2.29.43 #10021
• Bump org.gaul:s3proxy from 2.4.1 to 2.5.0 #10020
• Bump org.web3j:web3j-gradle-plugin from 4.12.2 to 4.12.3 #10019
• Bump com.playtika.testcontainers:embedded-google-pubsub from 3.1.9 to 3.1.10 #10018
• Bump ioredis from 5.4.1 to 5.4.2 in /hedera-mirror-rest #10017
• Bump eslint-plugin-jest from 28.9.0 to 28.10.0 in /hedera-mirror-rest #10016
• Bump sql-formatter from 15.4.6 to 15.4.8 in /hedera-mirror-rest #10015
• Bump @aws-sdk/client-s3 from 3.712.0 to 3.717.0 in /hedera-mirror-rest #10014
• Bump com.google.guava:guava from 33.3.1-jre to 33.4.0-jre #10013
• Bump software.amazon.awssdk:bom from 2.29.34 to 2.29.39 #10011
• Bump net.java.dev.jna:jna from 5.15.0 to 5.16.0 #10010
• Bump com.hedera.hashgraph:app from 0.57.2 to 0.57.3 #10009
• Bump io.spring.gradle:dependency-management-plugin from 1.1.6 to 1.1.7 #10007
• Bump google.golang.org/protobuf from 1.35.2 to 1.36.0 in /hedera-mirror-rosetta #10006
• Bump codecov/codecov-action from 4.6.0 to 5.1.2 #10005
• Bump helm/kind-action from 1.10.0 to 1.11.0 #10004
• Bump actions/upload-artifact from 4.4.3 to 4.5.0 #10003
• Bump docker/setup-buildx-action from 3.7.1 to 3.8.0 #10002
• Bump gradle/actions from 4.2.1 to 4.2.2 #10001
• Bump actions/setup-java from 4.5.0 to 4.6.0 #10000
• Bump chalk from 5.3.0 to 5.4.1 in /hedera-mirror-rest/check-state-proof #9999
• Bump shadow jar plugin from...

v0.121.0-rc1

v0.121.0-rc1

v0.120.0

Smaller release focusing on paying down some technical debt. Spotless code formatting tool was ran against the whole codebase and a CI check added to enforce it stays formatted. A large number of Sonar issues were addressed reducing the number of overall code smells. Finally, a runbook was added that documents the steps to restore a database backup for Stackgres.

Enhancements

• Add feature flag for the admin_key in the get network nodes response #9875
• Add additional coverage for token airdrops tests #9868
• Fix sonar issues #9867
• Add Spotless check to CI #9866
• Add runbook to restore stackgres backup #9860
• Apply spotless formatting to the whole project #9840

Bug Fixes

• Fix acceptance race condition #9888
• Add db migration to fix missing token association for claimed airdrops #9877
• Fix timeout in monitor #9870
• Add entity type filtering in Token and Account kv states #9863
• HIP 904 add token associate on claim airdrop #9841

Dependency Upgrades

• Bump software.amazon.awssdk:bom from 2.29.23 to 2.29.29 #9908
• Bump flywayVersion from 11.0.0 to 11.0.1 #9907
• Bump org.owasp:dependency-check-gradle from 11.1.0 to 11.1.1 #9906
• Bump gorm.io/driver/postgres from 1.5.10 to 1.5.11 in /hedera-mirror-rosetta #9902
• Bump actions/cache from 4.1.2 to 4.2.0 #9900
• Bump @testcontainers/redis from 10.15.0 to 10.16.0 in /hedera-mirror-rest #9899
• Bump @testcontainers/postgresql from 10.15.0 to 10.16.0 in /hedera-mirror-rest #9898
• Bump @aws-sdk/client-s3 from 3.701.0 to 3.705.0 in /hedera-mirror-rest #9897
• Bump the npm_and_yarn group in /hedera-mirror-rest/monitoring with 2 updates #9881
• Bump the npm_and_yarn group in /hedera-mirror-rest with 2 updates #9880
• Bump github.com/coinbase/rosetta-sdk-go from 0.8.7 to 0.8.9 in /hedera-mirror-rosetta #9858
• Bump parse-duration from 1.1.0 to 1.1.1 in /hedera-mirror-test/traffic-replay/log-downloader #9857
• Bump org.springframework.cloud:spring-cloud-dependencies from 2023.0.3 to 2023.0.4 #9856
• Bump org.openapitools:openapi-generator-gradle-plugin from 7.9.0 to 7.10.0 #9855
• Bump parse-duration from 1.1.0 to 1.1.1 in /hedera-mirror-rest/monitoring #9854
• Bump io.grpc:grpc-bom from 1.68.1 to 1.68.2 #9853
• Bump org.testcontainers:postgresql from 1.20.3 to 1.20.4 #9851
• Bump org.sonarsource.scanner.gradle:sonarqube-gradle-plugin from 6.0.0.5145 to 6.0.1.5171 #9850
• Bump software.amazon.awssdk:bom from 2.29.20 to 2.29.23 #9849
• Bump com.hedera.hashgraph:sdk from 2.44.0 to 2.45.0 #9848
• Bump parse-duration from 1.1.0 to 1.1.1 in /hedera-mirror-rest #9847
• Bump @aws-sdk/client-s3 from 3.699.0 to 3.701.0 in /hedera-mirror-rest #9846
• Bump docker/build-push-action from 6.9.0 to 6.10.0 #9845
• Bump versions for v0.120.0-SNAPSHOT #9836
• Bump tech.pegasys:jc-kzg-4844 from 0.8.0 to 1.0.0 #9810

Deployments

• Upgrade performance environment to 0.120.0-rc1 #9930
• Upgrade mainnet-staging to 0.120.0-rc1 #9925
• Prepare Testnet NA for 119 Release #9920

Contributors

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

@edwin-greene
@jnels124
@kselveliev
@nickeynikolovv
@san-est
@sdimitrov9
@steven-sheehy
@xin-hedera

v0.120.0-rc1

v0.120.0-rc1

v0.119.0

The /api/v1/contracts/call API that simulates smart contract executions now supports the Ethereum Cancun upgrade. Additionally, there were a number of tasks completed integrating the latest modularized EVM library.

The helm chart gained support for the Kubernetes Gateway API. The Gateway API provides a newer alternative to the existing Ingress support in the chart. Our Gateway API support is still preliminary since we can't use it in production environments until Google adds support for GrpcRoute and RegularExpression path matching in GKE.

This release fixes a critical bug with the handling of claimed token airdrops. Now claimed airdrops will implicitly create a token association and properly track token balances. Any existing airdrops are corrected via a database migration. The same fixes were back-ported to v0.118.1.

Enhancements

• Cherry pick 9868 add additional coverage for token airdrop acceptance tests (0.119) #9885
• Add feature flag for the admin_key in the get network nodes response … #9882
• Add bootstrap flow verifications #9831
• Add support for Kubernetes Gateway API #9807
• AccountReadableKVState returns account with AccountNum accountId #9801
• Reduce Citus Disk Size #9796
• Add check for NftReadableKVState if spender is missing #9790
• Add OpenApiValidator feature flag #9784
• Rename CustomCallOperation #9782
• Add admin key to get /network/nodes endpoint #9776
• Add Cancun evm support web3 #9756
• Retry incomplete address book during acceptance tests #9744
• Add schema registry and migrator components #9710
• Create State implementation with registering all of the specific ReadableKVStates #9700

Bug Fixes

• Fix acceptance race condition (0.119) #9889
• Add db migration to fix missing token association for claimed airdrops (0.119) #9878
• HIP 904 add token associate on claim airdrop (0.119) #9872
• Fix timeout in monitor (0.119) #9871
• Modified the query to return all relevant transactions #9808
• Fix monitor host metrics #9803
• Fix file readable kv state for latest file #9777
• Add Retry to Acceptance Test Steps #9754
• Set Content Encoding Header Correctly #9741

Documentation

• Add Snapshot Step to Release Checklist #9742

Dependency Upgrades

• Bump express from 4.21.1 to 4.21.2 #9886
• Bump com.hedera.hashgraph:app from 0.55.2 to 0.56.6 #9832
• Bump gorm.io/driver/postgres from 1.5.9 to 1.5.10 in /hedera-mirror-rosetta #9829
• Bump github.com/stretchr/testify from 1.9.0 to 1.10.0 in /hedera-mirror-rosetta #9828
• Bump github.com/ethereum/go-ethereum from 1.14.11 to 1.14.12 in /hedera-mirror-rosetta #9827
• Bump step-security/helm-gh-pages from 1.7.0 to 1.7.1 #9825
• Bump step-security/harden-runner from 2.10.1 to 2.10.2 #9824
• Bump mathjs from 13.2.2 to 14.0.0 in /hedera-mirror-rest/monitoring #9823
• Bump @aws-sdk/client-s3 from 3.693.0 to 3.699.0 in /hedera-mirror-rest #9822
• Bump @testcontainers/postgresql from 10.14.0 to 10.15.0 in /hedera-mirror-rest #9821
• Bump @testcontainers/redis from 10.14.0 to 10.15.0 in /hedera-mirror-rest #9820
• Bump mathjs from 13.2.2 to 14.0.0 in /hedera-mirror-rest #9819
• Bump org.gaul:s3proxy from 2.3.0 to 2.4.1 #9818
• Bump com.hedera.hashgraph:hedera-protobuf-java-api from 0.55.0 to 0.56.2 #9817
• Bump flywayVersion from 10.21.0 to 11.0.0 #9816
• Bump org.testcontainers:junit-jupiter from 1.20.3 to 1.20.4 #9815
• Bump commons-io:commons-io from 2.17.0 to 2.18.0 #9814
• Bump software.amazon.awssdk:bom from 2.29.15 to 2.29.20 #9812
• Bump org.sonarsource.scanner.gradle:sonarqube-gradle-plugin from 5.1.0.4882 to 6.0.0.5145 #9811
• Bump Go from 1.22 to 1.23 #9806
• Bump Ubuntu from Jammy to Noble #9805
• Bump node from 18.18.2 to 18.20.5 #9804
• Bump gradle/actions from 4.1.0 to 4.2.1 #9781
• Bump cross-spawn from 7.0.x to 7.0.6 #9780
• Bump mathjs from 13.2.1 to 13.2.2 in /hedera-mirror-rest/monitoring #9775
• Bump pretty-ms from 9.1.0 to 9.2.0 in /hedera-mirror-rest/monitoring #9774
• Bump io.freefair.gradle:lombok-plugin from 8.10.2 to 8.11 #9773
• Bump software.amazon.awssdk:bom from 2.29.9 to 2.29.15 #9772
• Bump vertxVersion from 4.5.10 to 4.5.11 #9771
• Bump com.hedera.hashgraph:sdk from 2.43.0 to 2.44.0 #9770
• Bump io.projectreactor:reactor-core-micrometer from 1.1.11 to 1.2.0 #9769
• Bump google.golang.org/protobuf from 1.35.1 to 1.35.2 in /hedera-mirror-rosetta #9768
• Bump github.com/go-playground/validator/v10 from 10.22.1 to 10.23.0 in /hedera-mirror-rosetta #9767
• Bump mathjs from 13.2.1 to 13.2.2 in /hedera-mirror-rest #9763
• Bump sql-formatter from 15.4.5 to 15.4.6 in /hedera-mirror-rest #9762
• Bump qs from 6.13.0 to 6.13.1 in /hedera-mirror-rest #9761
• Bump @aws-sdk/client-s3 from 3.688.0 to 3.693.0 in /hedera-mirror-rest #9760
• Bump versions for v0.119.0-SNAPSHOT #9740

Deployments

• Deploy mainnet-staging to v0.119.0-rc2 #9891
• Prepare staging mainnet-citus and preprod performance-citus for 119 #9838
• Prepare previewnet for 119 #9837

Contributors

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

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

v0.119.0-rc2

v0.119.0-rc2

v0.118.1

This release fixes a critical bug with the handling of claimed token airdrops. Now claimed airdrops will implicitly create a token association and properly track token balances. Any existing airdrops are corrected via a database migration.

Enhancements

• Cherry pick 9868 add additional coverage for token airdrop acceptance tests (0.118) #9884

Bug Fixes

• Fix acceptance race condition (0.118) #9890
• Add db migration to fix missing token association for claimed airdrops (0.118) #9879
• HIP 904 add token associate on claim airdrop (0.118) #9876

Dependency Upgrades

• Bump express from 4.21.1 to 4.21.2 (0.118) #9887

Contributors

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

@nickeynikolovv
@sdimitrov9
@steven-sheehy
@xin-hedera

v0.119.0-rc1

v0.119.0-rc1

v0.118.0

A new developer quick start guide was added by a community member. This document is intended to help new contributors quickly setup their local development environment for the mirror node. Please try it out and hopefully make your first contribution!

This release includes a new Redis-based distributed cache for the REST API. When enabled, API responses will be retrieved from the cache instead of querying the slower distributed database. This will protect the API against attacks and improve its scalability. For now, this functionality is disabled by default as we work towards stabilizing it.

A number of new run books were added to improve the day two operations of managing the mirror node database. There are run books to aid in taking and restoring the database volume snapshot. There's also a run book to increase the database volume size. Finally, there's a run book to change the database machine type.

Enhancements

• Add OpenApiValidator feature flag (0.118) #9785
• Retry incomplete address book during acceptance tests (0.118) #9749
• Remove -deprecation JVM flag #9718
• Improve citus runbook scripts #9709
• ci: Update as per Q3 audit findings #9682
• Add network info subcomponent needed for the state #9673
• Add additional k6 web3 tests for modification functions #9645
• Add an application cache for REST API #9626

Bug Fixes

• Fix openapi validator validateResponses config #9736
• Fixes to the bootstrap flow #9717
• Set ZFS ARC max/min before importing zpool #9711
• Use Alias When Available and No sender_id On Contract Results Response #9708
• Fix acceptance tests expecting a memo #9706
• Fix token.id Param Validation #9681
• Fix contract deployment with value #9668

Documentation

• Add Developer Quickstart and Development Setup Documentation #9666
• Add Various Citus Runbooks #9398

Dependency Upgrades

• Bump cross-spawn from 7.0.x to 7.0.6 (0.118) #9786
• Bump cross-spawn from 7.0.3 to 7.0.5 #9738
• Bump @aws-sdk/client-s3 from 3.685.0 to 3.688.0 in /hedera-mirror-rest #9732
• Bump mathjs from 13.2.0 to 13.2.1 in /hedera-mirror-rest #9731
• Bump eslint-plugin-jest from 28.8.3 to 28.9.0 in /hedera-mirror-rest #9730
• Bump @testcontainers/postgresql from 10.13.2 to 10.14.0 in /hedera-mirror-rest #9729
• Bump @testcontainers/redis from 10.13.2 to 10.14.0 in /hedera-mirror-rest #9728
• Bump mathjs from 13.2.0 to 13.2.1 in /hedera-mirror-rest/monitoring #9727
• Bump github.com/coinbase/rosetta-sdk-go from 0.8.6 to 0.8.7 in /hedera-mirror-rosetta #9726
• Bump io.hypersistence:hypersistence-utils-hibernate-63 from 3.8.3 to 3.9.0 #9725
• Bump jooqVersion from 3.19.14 to 3.19.15 #9724
• Bump mapStructVersion from 1.6.2 to 1.6.3 #9723
• Bump software.amazon.awssdk:bom from 2.29.6 to 2.29.9 #9722
• Bump flywayVersion from 10.20.1 to 10.21.0 #9721
• Bump google-github-actions/auth from 2.1.6 to 2.1.7 #9699
• Bump google-github-actions/setup-gcloud from 2.1.1 to 2.1.2 #9698
• Bump express-openapi-validator from 5.3.8 to 5.3.9 in /hedera-mirror-rest #9697
• Bump @aws-sdk/client-s3 from 3.679.0 to 3.685.0 in /hedera-mirror-rest #9696
• Bump compression from 1.7.4 to 1.7.5 in /hedera-mirror-rest #9695
• Bump compression from 1.7.4 to 1.7.5 in /hedera-mirror-rest/monitoring #9694
• Bump org.bouncycastle:bcprov-jdk18on from 1.78.1 to 1.79 #9693
• Bump io.grpc:grpc-bom from 1.68.0 to 1.68.1 #9692
• Bump com.hedera.hashgraph:sdk from 2.42.0 to 2.43.0 #9691
• Bump com.hedera.hashgraph:app from 0.55.1 to 0.55.2 #9690
• Bump org.owasp:dependency-check-gradle from 11.0.0 to 11.1.0 #9688
• Bump software.amazon.awssdk:bom from 2.29.1 to 2.29.6 #9687
• Bump github.com/hashgraph/hedera-sdk-go/v2 from 2.48.0 to 2.49.0 in /hedera-mirror-rosetta #9686
• Bump github.com/cucumber/godog from 0.14.1 to 0.15.0 in /hedera-mirror-rosetta #9685
• Bump versions for v0.118.0-SNAPSHOT #9675

Deployments

• Disable recently added / enabled web3 k6 tests #9787
• Deploy v0.118.0-rc1 to performance-citus #9748
• Deploy v0.118.0-rc1 to staging #9747
• Remove use of Google Memorystore in preprod #9714
• Enable Response Cache in Integration #9713
• Add additional variables for k6 tests on mainnet to deploy branch #9712
• Use the Redis chart in integration #9707
• Deploy 0.116.1 To mainnet-na #9683

Contributors

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

@b-l-u-e
@edwin-greene
@jnels124
@kselveliev
@mishomihov00
@nickeynikolovv
@nirbosl
@steven-sheehy
@xin-hedera

v0.117.1

Enhancements

• Retry incomplete address book during acceptance tests (0.117) #9750
• Retry acceptance tests when incomplete address book #9743

Bug Fixes

• Fix acceptance tests expecting a memo (0.117) #9745
• Fix openapi validator validateResponses config (0.117) #9737

Dependency Upgrades

• Bump cross-spawn from 7.0.3 to 7.0.5 (0.117) #9739

Contributors

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

@steven-sheehy and @xin-hedera