Overview
The Hedera JSON-RPC Relay v0.71.0 release comes with a strong focus on new features, stability, and modernization across the codebase. Highlights include the addition of paymaster functionality, improved Mirror Node error handling, stricter balance validation for operator accounts, and extended conformity and stress testing frameworks. The getBalance method now enforces a required block parameter for better EVM alignment, while multiple fixes—such as returning proper 32-byte block hashes and aligning uncle-related endpoints with the Ethereum OpenRPC spec—ensure improved compatibility. The codebase has been modernized with TypeScript v5 updates, config simplifications, logging refinements, and Node.js v22 adoption. Numerous dependency upgrades enhance security and reliability, and test coverage has been expanded across core services and RPC endpoints.
What's Changed
- chore(release): Bump versions for v0.71.0-SNAPSHOT by @swirlds-automation in #3965
- build(deps): bump pbkdf2 from 3.1.2 to 3.1.3 in /tools/whbar-hardhat-example by @dependabot[bot] in #3961
- build(deps): bump @openzeppelin/contracts-upgradeable from 5.3.0 to 5.4.0 in /tools/hedera-crosschain-bridge by @dependabot[bot] in #3967
- build(deps): bump form-data in /tools/hardhat-example by @dependabot[bot] in #3969
- chore: improve test coverage for sdkClient by @konstantinabl in #3946
- chore: Add testing documentation regarding conformity tests by @mwb-al in #3904
- build(deps): bump on-headers and compression in /tools/subgraph-example by @dependabot[bot] in #3968
- build(deps): bump form-data and @cypress/request in /dapp-example by @dependabot[bot] in #3970
- feat: gracefully handle HTML error responses from remote Mirror Node server by @quiet-node in #3962
- feat: validate that operator account has positive balance by @acuarica in #3930
- chore: [StepSecurity] Apply security best practices by @stepsecurity-app[bot] in #3888
- feat: paymaster functionality by @natanasow in #3941
- feat: update
getBalancemethod to requireblockNumberOrTagOrHashparameter instead of allowing null (#3838) by @mwb-al in #3859 - build(deps): bump form-data in /tools/whbar-hardhat-example by @dependabot[bot] in #3980
- feat: simplify
_CONFIGobject structure by @natanasow in #3979 - feat: fix CI after simplifying the config object by @natanasow in #3983
- build(deps): bump form-data in /tools/hardhat-viem-example by @dependabot[bot] in #3982
- feat: increased k6 coverage for all RPC endpoints by @quiet-node in #3977
- fix: return 32-byte block hash from
eth_getFilterChangesto ensure EVM compatibility by @romangzz in #3863 - chore: use Node's native
fetchin PR check workflow by @acuarica in #3984 - chore: add dependabot.yml by @PavelSBorisov in #3725
- fix: replaces nyc with c8 by @konstantinabl in #3978
- feat: Prepare Additional Conformity Test Scenarios (#3886) by @mwb-al in #3887
- build(deps): bump step-security/helm-gh-pages from 1.7.0 to 1.7.3 by @dependabot[bot] in #4011
- build(deps): bump step-security/harden-runner from 2.7.0 to 2.13.0 by @dependabot[bot] in #4010
- build(deps): bump step-security/gh-docker-logs from 2.2.2 to 2.2.5 by @dependabot[bot] in #4005
- build(deps): bump docker/setup-qemu-action from 3.3.0 to 3.6.0 by @dependabot[bot] in #3997
- build(deps): bump actions/download-artifact from 4.1.7 to 4.3.0 by @dependabot[bot] in #3996
- build(deps): bump step-security/release-notes-generator-action from 3.1.6 to 3.1.8 by @dependabot[bot] in #3995
- build(deps): bump step-security/ghaction-import-gpg from 1.0.0 to 6.3.0 by @dependabot[bot] in #3994
- build(deps): bump docker/login-action from 3.1.0 to 3.4.0 by @dependabot[bot] in #3992
- build(deps): bump docker/build-push-action from 5.3.0 to 6.18.0 by @dependabot[bot] in #4001
- build(deps): bump peter-evans/create-pull-request from 6.0.5 to 7.0.8 by @dependabot[bot] in #4000
- build(deps): bump reqwest from 0.12.15 to 0.12.22 in /tools/alloy-core-rs-example by @dependabot[bot] in #3998
- build(deps): bump tokio from 1.44.2 to 1.47.0 in /tools/web3rs-example by @dependabot[bot] in #4026
- build(deps): bump koa-router from 13.0.1 to 13.1.1 by @dependabot[bot] in #4034
- build(deps-dev): bump webpack from 5.94.0 to 5.101.0 in /dapp-example by @dependabot[bot] in #4036
- build(deps): bump dotenv from 16.4.5 to 17.2.1 by @dependabot[bot] in #4039
- build(deps-dev): bump hardhat from 2.23.0 to 2.26.1 in /tools/hardhat-example by @dependabot[bot] in #4050
- build(deps-dev): bump @types/lodash from 4.17.7 to 4.17.20 by @dependabot[bot] in #4055
- build(deps-dev): bump hardhat from 2.22.4 to 2.26.1 in /tools/hardhat-viem-example by @dependabot[bot] in #4056
- build(deps): bump react-dom from 18.3.1 to 19.1.1 in /tools/wagmi-example by @dependabot[bot] in #4067
- build(deps): bump @hashgraph/sdk from 2.63.0 to 2.69.0 in /tools/whbar-hardhat-example by @dependabot[bot] in #4076
- build(deps-dev): bump dotenv from 10.0.0 to 17.2.1 in /tools/subgraph-example by @dependabot[bot] in #4063
- build(deps): bump dotenv from 16.4.7 to 17.2.1 in /tools/whbar-hardhat-example by @dependabot[bot] in #4072
- build(deps-dev): bump dotenv from 16.5.0 to 17.2.1 in /tools/hedera-crosschain-bridge by @dependabot[bot] in #4059
- build(deps): bump dotenv from 16.5.0 to 17.2.1 in /tools/hardhat-viem-example by @dependabot[bot] in #4057
- build(deps-dev): bump hardhat from 2.22.17 to 2.26.1 in /tools/whbar-hardhat-example by @dependabot[bot] in #4074
- build(deps-dev): bump hardhat from 2.20.1 to 2.26.1 in /tools/subgraph-example by @dependabot[bot] in #4064
- build(deps-dev): bump @hashgraph/sdk from 2.66.0 to 2.69.0 in /tools/hedera-crosschain-bridge by @dependabot[bot] in #4060
- build(deps): bump dotenv from 14.3.2 to 17.2.1 in /docs/examples by @dependabot[bot] in #4046
- build(deps-dev): bump @types/k6 from 0.53.1 to 1.1.1 in /k6 by @dependabot[bot] in #4047
- build(deps-dev): bump @typescript-eslint/eslint-plugin from 6.5.0 to 6.21.0 by @dependabot[bot] in #4045
- build(deps): bump dotenv from 16.4.7 to 17.2.1 in /tools/web3js-example by @dependabot[bot] in #4071
- build(deps): bump @keyvhq/core from 1.6.26 to 2.1.7 by @dependabot[bot] in #4043
- build(deps-dev): bump @open-rpc/schema-utils-js from 1.16.1 to 2.1.2 by @dependabot[bot] in #4030
- build(deps-dev): bump hardhat from 2.23.0 to 2.26.1 in /tools/solidity-coverage-example by @dependabot[bot] in #4061
- build(deps-dev): bump @babel/preset-env from 7.26.9 to 7.28.0 in /dapp-example by @dependabot[bot] in #4028
- build(deps-dev): bump redis-memory-server from 0.10.0 to 0.12.1 by @dependabot[bot] in #4027
- build(deps): bump keyv-file from 0.3.3 to 5.1.3 by @dependabot[bot] in #4024
- build(deps): bump hex-literal from 0.4.1 to 1.0.0 in /tools/web3rs-example by @dependabot[bot] in #4023
- build(deps): bump @emotion/styled from 11.14.0 to 11.14.1 in /dapp-example by @dependabot[bot] in #4020
- build(deps-dev): bump husky from 8.0.3 to 9.1.7 by @dependabot[bot] in #4021
- build(deps): bump serial_test from 0.5.1 to 3.2.0 in /tools/ethers-rs-example by @dependabot[bot] in #4019
- build(deps-dev): bump cypress-multi-reporters from 1.6.4 to 2.0.5 in /dapp-example by @dependabot[bot] in #4014
- build(deps): bump ethers from 6.13.5 to 6.15.0 in /dapp-example by @dependabot[bot] in #4031
- build(deps-dev): bump dotenv from 16.5.0 to 17.2.1 in /tools/hardhat-example by @dependabot[bot] in #4054
- build(deps-dev): bump dotenv from 16.4.5 to 17.2.1 in /tools/waffle-example by @dependabot[bot] in #4065
- build(deps): bump tokio from 1.44.2 to 1.47.0 in /tools/ethers-rs-example by @dependabot[bot] in #4016
- build(deps-dev): bump @types/co-body from 6.1.0 to 6.1.3 by @dependabot[bot] in #4052
- build(deps): bump pino from 7.11.0 to 9.7.0 by @dependabot[bot] in #4051
- build(deps): bump ethers from 6.13.5 to 6.15.0 in /k6 by @dependabot[bot] in #4048
- build(deps): bump secp256k1 from 0.29.1 to 0.31.1 in /tools/web3rs-example by @dependabot[bot] in #4022
- build(deps-dev): bump prettier from 3.0.3 to 3.6.2 by @dependabot[bot] in #4017
- build(deps): bump alloy from 0.2.1 to 1.0.23 in /tools/alloy-core-rs-example by @dependabot[bot] in #4008
- build(deps-dev): bump cypress-wait-until from 3.0.1 to 3.0.2 in /dapp-example by @dependabot[bot] in #4029
- build(deps): bump react and react-dom in /dapp-example by @dependabot[bot] in #4082
- build(deps-dev): bump start-server-and-test from 2.0.11 to 2.0.12 in /dapp-example by @dependabot[bot] in #4035
- build(deps): bump keccak from 3.0.3 to 3.0.4 by @dependabot[bot] in #4004
- build(deps): bump serde_json from 1.0.140 to 1.0.141 in /tools/ethers-rs-example by @dependabot[bot] in #4013
- build(deps): bump github.com/ethereum/go-ethereum from 1.14.13 to 1.16.1 in /tools/golang-example by @dependabot[bot] in #3999
- chore: adds new tests for server.ts file by @konstantinabl in #4078
- build(deps-dev): bump shelljs from 0.8.5 to 0.10.0 by @dependabot[bot] in #4096
- feat: adds new decorators following the typescript v5 standard + updates to TypeScript v5 by @simzzz in #3951
- build(deps): bump tokio from 1.44.2 to 1.47.0 in /tools/alloy-core-rs-example by @dependabot[bot] in #4003
- build(deps): bump github.com/ethereum/go-ethereum from 1.14.13 to 1.16.1 in /tools/golang-json-rpc-tests by @dependabot[bot] in #4006
- build(deps-dev): bump chai-as-promised and @types/chai-as-promised by @dependabot[bot] in #4015
- build(deps-dev): bump eslint-config-prettier from 8.10.0 to 10.1.8 by @dependabot[bot] in #4099
- build(deps): bump node from 20-bookworm-slim to 24-bookworm-slim by @dependabot[bot] in #3991
- build(deps): bump @mui/material from 5.16.14 to 7.2.0 in /dapp-example by @dependabot[bot] in #4033
- build(deps-dev): bump @cypress/webpack-batteries-included-preprocessor from 3.0.3 to 3.1.2 in /dapp-example by @dependabot[bot] in #4042
- build(deps): bump @hashgraph/sdk from 2.63.0 to 2.69.0 by @dependabot[bot] in #4032
- build(deps): bump koa-logger from 3.2.1 to 4.0.0 by @dependabot[bot] in #4089
- chore: make
CacheService's logger part of the logger tree by @acuarica in #4086 - chore: update tools to typescript v5 by @simzzz in #3973
- chore: removes deprecated husky lines by @konstantinabl in #4148
- feat: removes duration from rpc_relay_client_service metric by @simzzz in #4111
- chore: refine dependabot config to ease PR load by @PavelSBorisov in #4145
- chore: simplify
Request IDlogging mechanism by @acuarica in #3990 - build(deps-dev): bump @nomicfoundation/hardhat-toolbox from 2.0.2 to 6.1.0 in /tools/hedera-crosschain-bridge by @dependabot[bot] in #4132
- build(deps): bump the minor-and-patch-gomod-weekly group across 2 directories with 1 update by @dependabot[bot] in #4156
- build(deps): bump the minor-and-patch-cargo-weekly group across 2 directories with 2 updates by @dependabot[bot] in #4157
- chore: remove unused packages by @acuarica in #4164
- build(deps): bump the minor-and-patch-actions-weekly group with 13 updates by @dependabot[bot] in #4158
- build(deps): bump actions/setup-node from 3.8.2 to 4.4.0 by @dependabot[bot] in #4160
- build(deps): bump actions/download-artifact from 4.3.0 to 5.0.0 by @dependabot[bot] in #4161
- build(deps): bump actions/checkout from 2.7.0 to 4.2.2 by @dependabot[bot] in #4159
- build(deps): bump uuid from 3.4.0 to 11.1.0 by @dependabot[bot] in #4087
- build(deps): bump step-security/semver-utils from 1.0.0 to 4.3.0 by @dependabot[bot] in #4117
- build(deps): bump mikepenz/action-junit-report from 4.2.1 to 5.6.2 by @dependabot[bot] in #4121
- chore: extend Relay's
JsonRpcErrorfromErrorby @acuarica in #4171 - chore: updates node version used to 22 by @konstantinabl in #4146
- build(deps-dev): bump @nomicfoundation/hardhat-toolbox from 3.0.0 to 6.1.0 in /tools/solidity-coverage-example by @dependabot[bot] in #4141
- build(deps): bump stefanzweifel/git-auto-commit-action from 5.0.1 to 6.0.1 by @dependabot[bot] in #4115
- refactor: improve execution event handling by @natanasow in #4081
- feat: removes custom CPU and Memory usage Gauge by @simzzz in #4176
- build(deps-dev): bump @nomicfoundation/hardhat-toolbox from 4.0.0 to 6.1.0 in /tools/hardhat-example by @dependabot[bot] in #4129
- build(deps-dev): bump hardhat-gas-reporter from 1.0.9 to 2.3.0 in /tools/subgraph-example by @dependabot[bot] in #4116
- build(deps-dev): bump @nomicfoundation/hardhat-toolbox from 5.0.0 to 6.1.0 in /tools/whbar-hardhat-example by @dependabot[bot] in #4138
- build(deps): bump redis from 4.7.0 to 5.7.0 by @dependabot[bot] in #4100
- fix: history clearing in eth_call unit test by @konstantinabl in #4179
- build(deps): bump @nomicfoundation/hardhat-toolbox-viem from 3.0.0 to 4.1.0 in /tools/hardhat-viem-example by @dependabot[bot] in #4131
- feat: implement traffic-weighted stress test framework and scenario improvements by @quiet-node in #4169
- build(deps-dev): bump axios-mock-adapter from 1.21.5 to 2.1.0 by @dependabot[bot] in #4095
- feat(k6): Implement staged RPS (ramp-up, stable, ramp-down) for stress tests using ramping-arrival-rate executor by @quiet-node in #4181
- docs: indicate proper error codes for unsupported methods by @acuarica in #4192
- chore: improve JSON-RPC request validation by @acuarica in #4180
- fix: add
valuein transaction object for synthetic transactions by @acuarica in #4198 - build(deps): bump tmp and @expo/devcert in /dapp-example by @dependabot[bot] in #4167
- fix: sets node version to 22.17 by @konstantinabl in #4207
- chore: updates workflow to run on PRs when openrpc.json is updated by @konstantinabl in #4190
- chore: updates ethers to v6 by @konstantinabl in #4197
- build(deps): bump alloy from 1.0.23 to 1.0.24 in /tools/alloy-core-rs-example in the minor-and-patch-cargo-weekly group across 1 directory by @dependabot[bot] in #4182
- feat: moves formatContractResult from CommonServices to formatters by @simzzz in #4196
- build(deps): bump actions/checkout from 4.2.2 to 5.0.0 by @dependabot[bot] in #4215
- chore: restore node 22 latest and update mocha by @acuarica in #4212
- chore: refine npm weekly group updates by @PavelSBorisov in #4220
- chore: refactor
SDKClientandHAPIServiceby @acuarica in #4210 - feat: removes logging from test clients by @simzzz in #4204
- build(deps): bump the minor-and-patch-npm-weekly group across 7 directories with 11 updates by @dependabot[bot] in #4229
- build(deps): bump the minor-and-patch-actions-weekly group across 1 directory with 3 updates by @dependabot[bot] in #4223
- chore: create PR to update openrpc only when it hits
mainby @acuarica in #4299 - fix: align uncle-related RPC endpoints with Ethereum OpenRPC Spec by @quiet-node in #4211
- build(deps): bump lru-cache from 7.14.0 to 11.1.0 by @natanasow in #4302
- chore: updates prom-client to new major version by @konstantinabl in #4219
New Contributors
Full Changelog: v0.70.1...v0.71.0