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
- Bump com.hedera.hashgraph:app from 0.59.0 to 0.59.2 #10527
- Bump software.amazon.awssdk:bom from 2.30.26 to 2.30.31 #10526
- Bump flywayVersion from 11.3.3 to 11.3.4 #10525
- Bump org.openapitools:openapi-generator-gradle-plugin from 7.11.0 to 7.12.0 #10524
- Bump
@aws-sdk/client-s3 from 3.750.0 to 3.758.0 in /hedera-mirror-rest #10523 - Bump eslint-config-prettier from 10.0.1 to 10.0.2 in /hedera-mirror-rest #10522
- Bump express-openapi-validator from 5.4.4 to 5.4.6 in /hedera-mirror-rest #10521
- Bump mathjs from 14.2.1 to 14.3.0 in /hedera-mirror-rest/monitoring #10518
- Bump github.com/ethereum/go-ethereum from 1.15.2 to 1.15.4 in /hedera-mirror-rosetta #10517
- Bump com.hedera.hashgraph:sdk from 2.46.0 to 2.51.0 #10466
Contributors
Thank you to all the contributors who worked on this release:
@HarshSawarkar
@bilyana-gospodinova
@edwin-greene
@filev94
@HarshSawarkar
@jnels124
@kselveliev
@nickeynikolovv
@sdimitrov9
@steven-sheehy
@xin-hedera