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

v0.118.0-rc1

v0.118.0-rc1

v0.117.0

This is a smaller release as we focus on reworking the web3 module to use the modularized EVM library. All of the ReadableKVState classes are now implemented and the EVM properties are mapped. The next release should have most of the remaining pieces in place to start testing.

Enhancements

• Disable Automated Backup #9638
• Convert EVM properties to a map of configuration properties #9622
• Set delete_request_store for loki #9603
• Enable log retention in Loki and fix restjava routing #9600
• Implement AirdropsReadableKVState #9598
• Add REST API query normalization #9591
• Implement TokenRelationshipReadableKVState #9582

Bug Fixes

• Fix contract deployment with value (0.117) #9703
• Fix restjava topics info endpoint ingress path regex #9670
• Fix empty ipAddressV4 returning 127.0.0.1 in gRPC nodes API #9608

Documentation

• Fixing whitespace in configuration documentation #9635
• Make clear millisecond is the implied unit for frequency configurations #9633
• Fix properties in historical data ingestion documentation #9632

Dependency Upgrades

• Bump actions/checkout from 4.2.1 to 4.2.2 #9665
• Bump actions/setup-go from 5.0.2 to 5.1.0 #9664
• Bump actions/cache from 4.1.1 to 4.1.2 #9663
• Bump actions/setup-node from 4.0.4 to 4.1.0 #9662
• Bump actions/setup-java from 4.4.0 to 4.5.0 #9661
• Bump actions/setup-python from 5.2.0 to 5.3.0 #9660
• Bump org.owasp:dependency-check-gradle from 10.0.4 to 11.0.0 #9659
• Bump org.testcontainers:junit-jupiter from 1.20.2 to 1.20.3 #9658
• Bump org.apache.velocity:velocity-engine-core from 2.4 to 2.4.1 #9656
• Bump flywayVersion from 10.20.0 to 10.20.1 #9655
• Bump software.amazon.awssdk:bom from 2.28.26 to 2.29.1 #9654
• Bump org.testcontainers:postgresql from 1.20.2 to 1.20.3 #9653
• Bump jooqVersion from 3.19.13 to 3.19.14 #9652
• Bump com.google.cloud:spring-cloud-gcp-dependencies from 5.7.0 to 5.8.0 #9651
• Bump sql-formatter from 15.4.4 to 15.4.5 in /hedera-mirror-rest #9649
• Bump express-openapi-validator from 5.3.7 to 5.3.8 in /hedera-mirror-rest #9648
• Bump @aws-sdk/client-s3 from 3.675.0 to 3.679.0 in /hedera-mirror-rest #9647
• Bump pg from 8.13.0 to 8.13.1 in /hedera-mirror-rest #9646
• Bump Spring Boot from 3.3.4 to 3.3.5 #9640
• Updating action to use step-security maintained version. #9631
• Bump hedera-app and hedera-evm #9624
• Bump @aws-sdk/client-s3 from 3.670.0 to 3.675.0 in /hedera-mirror-rest #9621
• Bump sql-formatter from 15.4.3 to 15.4.4 in /hedera-mirror-rest #9620
• Bump io.projectreactor:reactor-core-micrometer from 1.1.10 to 1.1.11 #9618
• Bump flywayVersion from 10.19.0 to 10.20.0 #9616
• Bump com.hedera.hashgraph:sdk from 2.41.0 to 2.42.0 #9615
• Bump software.amazon.awssdk:bom from 2.28.21 to 2.28.26 #9614
• Bump gradle.plugin.io.snyk.gradle.plugin:snyk from 0.6.1 to 0.7.0 #9613
• Bump github.com/jackc/pgtype from 1.14.3 to 1.14.4 in /hedera-mirror-rosetta #9612
• Bump github.com/prometheus/client_golang from 1.20.4 to 1.20.5 in /hedera-mirror-rosetta #9611
• Bump github.com/coinbase/rosetta-sdk-go from 0.8.5 to 0.8.6 in /hedera-mirror-rosetta #9610
• Bump github.com/hashgraph/hedera-sdk-go/v2 from 2.47.0 to 2.48.0 in /hedera-mirror-rosetta #9609
• Bump versions for v0.117.0-SNAPSHOT #9596

Deployments

• Deploy v0.117.0 to testnet-eu #9704
• Update mainnet-staging to v0.117.0-rc1 #9678
• Update performance to v0.117.0-rc1 #9677
• Prepare testnet-na for v0.116.0 #9641
• Bump staging-lg to 0.116.0-rc3 #9625
• Bump staging and integration-docker to v0.116.0-rc3 #9607
• Auto Deploy pre-release for Citus #9597
• Prepare Previewnet For 116 Auto-deploy #9587

Contributors

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

@Neurone
@bilyana-gospodinova
@edwin-greene
@jnels124
@kselveliev
@san-est
@steven-sheehy
@xin-hedera

v0.117.0-rc1

v0.117.0-rc1

v0.116.1

Bug Fixes

• Fix restjava topics info endpoint ingress path regex (0.116) #9671

Contributors

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

@xin-hedera

v0.116.0

HIP-991 Permissionless revenue-generating Topic Ids for Topic Operators design was completed this sprint and relevant tasks created. Once this HIP is scheduled for inclusion in consensus nodes we'll proceed with implementing the design.

HIP-904 Friction-less Airdrops saw the final tasks completed. Some of these tasks were cherry-picked to 0.115 like the NFT support in the REST APIs. In addition, we saw additional airdrop performance tests added to k6 and acceptance test coverage increased.

Work continues on integrating the modularized EVM library into the web3 module. There were eight pull requests focused on adding the necessary key value state implementations to plug into this new library.

Citus saw some some important work including the addition of automated backup. This will remain off by default until some upstream issues are resolved. We also upgraded Stackgres from 1.11 to 1.13 which contains some important fixes. See breaking changes for more details on upgrading.

Breaking Changes

For the hedera-mirror Helm chart, if you're using Citus via Stackgres it has a minor version upgrade. Please follow the Stackgres upgrade runbook after upgrading the Helm release.

If you're using the hedera-mirror-common Helm chart, there are some breaking changes to be aware of. Loki, Prometheus Operator, and Traefik all had major version upgrades that require manual steps. Run the below commands to ensure the CRDs are updated appropriately. Also note Loki had a schema change that will require its volume be manually deleted and recreated.

kubectl apply --server-side --force-conflicts -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.76.0/example/prometheus-operator-crd/monitoring.coreos.com_alertmanagerconfigs.yaml
kubectl apply --server-side --force-conflicts -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.76.0/example/prometheus-operator-crd/monitoring.coreos.com_alertmanagers.yaml
kubectl apply --server-side --force-conflicts -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.76.0/example/prometheus-operator-crd/monitoring.coreos.com_podmonitors.yaml
kubectl apply --server-side --force-conflicts -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.76.0/example/prometheus-operator-crd/monitoring.coreos.com_probes.yaml
kubectl apply --server-side --force-conflicts -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.76.0/example/prometheus-operator-crd/monitoring.coreos.com_prometheusagents.yaml
kubectl apply --server-side --force-conflicts -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.76.0/example/prometheus-operator-crd/monitoring.coreos.com_prometheuses.yaml
kubectl apply --server-side --force-conflicts -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.76.0/example/prometheus-operator-crd/monitoring.coreos.com_prometheusrules.yaml
kubectl apply --server-side --force-conflicts -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.76.0/example/prometheus-operator-crd/monitoring.coreos.com_scrapeconfigs.yaml
kubectl apply --server-side --force-conflicts -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.76.0/example/prometheus-operator-crd/monitoring.coreos.com_servicemonitors.yaml
kubectl apply --server-side --force-conflicts -f https://raw.githubusercontent.com/prometheus-operator/prometheus-operator/v0.76.0/example/prometheus-operator-crd/monitoring.coreos.com_thanosrulers.yaml
kubectl apply --server-side --force-conflicts -k https://github.com/traefik/traefik-helm-chart/traefik/crds/
helm upgrade common hedera/hedera-mirror-common ...
kubectl delete crds ingressroutes.traefik.containo.us ingressroutetcps.traefik.containo.us ingressrouteudps.traefik.containo.us middlewares.traefik.containo.us middlewaretcps.traefik.containo.us serverstransports.traefik.containo.us tlsoptions.traefik.containo.us tlsstores.traefik.containo.us traefikservices.traefik.containo.us

Enhancements

• Disable Automated Backup Cherry-Pick #9639
• Set delete_request_store for loki (0.116) #9604
• Enable log retention in Loki and fix restjava routing (0.116) #9601
• Add Token readable kv state #9572
• Add FileReadableKVState #9570
• Migrate deprecated jest methods #9564
• Add k6 tests for token airdrops #9548
• Automated Backup For Citus #9541
• Add acceptance tests for NFT airdrop #9540
• Add tools and instructions for REST API traffic replay #9532
• Add node metrics to monitor metrics #9531
• Add acceptance tests for fungible token airdrop #9528
• Implement AliasesReadableKVState #9527
• Fix equals() and hashCode() for AccountReadableKVState #9493
• Remove jetbrains annotation dependency #9492
• Add NFTReadableKVState #9484
• Add NFTs to airdrop REST APIs #9483
• Implement ContractBytecodeReadableKVState #9452
• Implement ContractStorageReadableKVState #9450
• Update jooq repository to improve reusability #9424
• Add implementation for AccountReadableKVState #9414

Bug Fixes

• Comment Out Failing Acceptance Test Steps #9593
• Use Rest Java To Retrieve Airdrop Data #9590
• Fix recursive update exception in EntityIdServiceImpl #9578
• Remove recoverable errors for inactive EVM addresses #9542
• Add CustomCallOperation #9538
• Suppress INVALID_ALIAS_KEY and INVALID_NODE_ACCOUNT_ID recoverable errors #9534

Documentation

• Add HIP-991 design #9503

Dependency Upgrades

• Bump @aws-sdk/client-s3 from 3.668.0 to 3.670.0 in /hedera-mirror-rest #9581
• Bump google.golang.org/protobuf from 1.34.2 to 1.35.1 in /hedera-mirror-rosetta #9580
• Bump software.amazon.awssdk:bom from 2.28.19 to 2.28.21 #9579
• Bump @aws-sdk/client-s3 from 3.665.0 to 3.668.0 in /hedera-mirror-rest #9563
• Bump software.amazon.awssdk:bom from 2.28.16 to 2.28.19 #9561
• Bump org.openapitools:openapi-generator-gradle-plugin from 7.8.0 to 7.9.0 #9560
• Bump com.hedera.hashgraph:app from 0.54.1 to 0.54.2 #9559
• Bump actions/cache from 4.1.0 to 4.1.1 #9558
• Bump io.hypersistence:hypersistence-utils-hibernate-63 from 3.8.2 to 3.8.3 #9557
• Bump actions/upload-artifact from 4.4.0 to 4.4.3 #9556
• Bump io.cucumber:cucumber-bom from 7.20.0 to 7.20.1 #9555
• Bump sql-formatter from 15.4.2 to 15.4.3 in /hedera-mirror-rest #9554
• Bump actions/checkout from 4.2.0 to 4.2.1 #9553
• Bump com.hedera.hashgraph:hedera-protobuf-java-api from 0.54.0 to 0.55.0 #9552
• Bump flywayVersion from 10.18.2 to 10.19.0 #9551
• Bump org.apache.velocity:velocity-engine-core from 2.3 to 2.4 #9550
• Bump express from 4.2.0 to 4.2.1 #9537
• Bump mathjs from 13.1.1 to 13.2.0 in /hedera-mirror-rest #9526
• Bump @testcontainers/redis from 10.13.1 to 10.13.2 in /hedera-mirror-rest #9525
• Bump @aws-sdk/client-s3 from 3.658.1 to ...

v0.116.0-rc3

v0.116.0-rc3

v0.116.0-rc2

v0.116.0-rc2