v0.73.1

Overview

This patch release focuses on improved logging flexibility and performance optimization within the JSON RPC Relay. It introduces new environment variables to enable JSON-formatted logs and configurable SDK log levels, offering enhanced observability and debugging control. Additionally, upstream transaction fetching has been optimized to avoid unnecessary requests, resulting in more efficient runtime performance.

What's Changed

• feat: Add ENV var to use JSON logging by @kasey-alusi-vcc in #4474
• feat: stop fetching transactions data when its not needed by @jasuwienas in #4598
• feat: add configurable SDK_LOG_LEVEL for enhanced SDK logging by @quiet-node in #4578

Full Changelog: v0.73.0...v0.73.1

v0.73.0

Overview

This release introduces transaction pool functionality to address nonce management challenges, where rapid transaction submissions could result in incorrect nonce calculations and transaction failures. The new transaction pool tracks pending transactions per address, enabling proper nonce prechecks in eth_sendRawTransaction and accurate responses for eth_getTransactionCount with "pending" block tags.

Other key API improvements include enhanced validation for eth_getBlockReceipts, enabled jumbo transaction feature for larger payloads, CREATE2 opcode fix in debug_traceBlockByNumber, proper to = null returns for contract deployments in eth_getTransactionByHash, and removed caching logic for eth_gasPrice to provide real-time gas price information.

Additional updates include LayerZero HTSConnector improvements, debug trace fixes for transactions without internal calls, security enhancements via StepSecurity, migration to ESLint v9, and numerous dependency updates through Dependabot.

What's Changed

• feat: use amountSentLD in .transferToken on _debit function in LayerZero HTSConnector by @natanasow in #4453
• chore(release): Bump versions for v0.73.0-SNAPSHOT by @swirlds-automation in #4442
• feat: improve eth_getBlockReceipts validation by @natanasow in #4456
• fix: enable jumbo transaction feature by @quiet-node in #4419
• feat: fix CREATE2 opcode on debug_traceBlockByNumber response by @natanasow in #4469
• build(deps): bump cipher-base from 1.0.4 to 1.0.6 in /tools/subgraph-example by @dependabot[bot] in #4410
• build(deps-dev): bump tar-fs from 2.1.2 to 2.1.4 in /tools/hardhat-example by @dependabot[bot] in #4411
• build(deps): bump sha.js from 2.4.11 to 2.4.12 in /tools/subgraph-example by @dependabot[bot] in #4412
• feat: adds factory pattern for relay class, to support future redis client … by @konstantinabl in #4471
• build(deps-dev): bump tar-fs from 2.1.3 to 2.1.4 by @dependabot[bot] in #4418
• build(deps): bump axios from 1.8.4 to 1.12.2 in /tools/layer-zero-example by @dependabot[bot] in #4432
• build(deps): bump axios from 1.11.0 to 1.12.2 in /tools/hardhat-viem-example by @dependabot[bot] in #4433
• feat: return to = null for contract deployment transaction on eth_getTransactionByHash by @natanasow in #4479
• chore: [StepSecurity] Apply security best practices by @stepsecurity-app[bot] in #4445
• build(deps): bump axios from 1.8.4 to 1.12.2 by @dependabot[bot] in #4458
• fix: fixes debug_traceBlockByNumber response to not be null for a transaction with no internal calls by @simzzz in #4440
• build(deps-dev): bump sinon from 14.0.2 to 21.0.0 in /packages/relay by @dependabot[bot] in #4232
• build(deps-dev): bump eslint from 8.48.0 to 9.34.0 by @dependabot[bot] in #4321
• build(deps-dev): bump lint-staged from 15.2.9 to 16.1.6 by @dependabot[bot] in #4352
• build(deps): bump the minor-and-patch-gomod-weekly group across 2 directories with 2 updates by @dependabot[bot] in #4426
• build(deps): bump the minor-and-patch-cargo-weekly group across 3 directories with 5 updates by @dependabot[bot] in #4482
• build(deps): bump @hashgraph/sdk from 2.71.1 to 2.75.0 in /dapp-example by @dependabot[bot] in #4483
• build(deps-dev): bump @hashgraph/sdk from 2.69.0 to 2.75.0 in /tools/hedera-crosschain-bridge by @dependabot[bot] in #4484
• build(deps): bump @hashgraph/sdk from 2.69.0 to 2.75.0 in /tools/whbar-hardhat-example by @dependabot[bot] in #4485
• build(deps): bump the minor-and-patch-actions-weekly group across 1 directory with 11 updates by @dependabot[bot] in #4496
• build(deps-dev): bump chai from 4.3.7 to 6.0.1 by @dependabot[bot] in #4307
• feat: migrate to ESLint v9 with flat config by @quiet-node in #4508
• build(deps): bump lerna from 8.2.1 to 9.0.0 by @dependabot[bot] in #4510
• build(deps): bump uuid from 11.1.0 to 13.0.0 by @dependabot[bot] in #4511
• build(deps-dev): bump @types/node from 17.0.45 to 24.9.1 by @dependabot[bot] in #4513
• build(deps-dev): bump @types/sinon from 10.0.20 to 17.0.4 by @dependabot[bot] in #4514
• build(deps-dev): bump @types/chai from 4.3.20 to 5.2.3 in /packages/relay by @dependabot[bot] in #4516
• build(deps): bump actions/download-artifact from 5.0.0 to 6.0.0 by @dependabot[bot] in #4522
• build(deps): bump actions/setup-go from 5.5.0 to 6.0.0 by @dependabot[bot] in #4523
• build(deps): bump react-dom from 19.1.1 to 19.2.0 in /dapp-example by @dependabot[bot] in #4525
• build(deps): bump @mui/material from 7.2.0 to 7.3.4 in /dapp-example by @dependabot[bot] in #4524
• fix: adds acceptance test toAddress is null and to field is missing by @konstantinabl in #4455
• chore: update package-lock.json by @quiet-node in #4549
• feat: Adds transaction pool funcitonality by @konstantinabl in #4454
• chore: fix ethers package in lock file by @acuarica in #4554
• fix: replace fee collector account in Postman tests to prevent CI timeouts by @quiet-node in #4557
• build(deps): bump actions/setup-python from 5.6.0 to 6.0.0 by @dependabot[bot] in #4535
• build(deps): bump @nomicfoundation/hardhat-toolbox-viem from 4.1.0 to 5.0.0 in /tools/hardhat-viem-example by @dependabot[bot] in #4536
• build(deps-dev): bump webpack from 5.101.3 to 5.102.1 in /dapp-example by @dependabot[bot] in #4539
• build(deps): bump tar-fs from 2.1.3 to 2.1.4 in /tools/subgraph-example by @dependabot[bot] in #4542
• build(deps): bump actions/setup-node from 4.4.0 to 6.0.0 by @dependabot[bot] in #4530
• fix: cherry pick removed caching logic for eth_gasPrice endpoint (#4582) to release/0.73 by @quiet-node in #4588

Full Changelog: v0.72.1...v0.73.0

v0.73.0-rc2

v0.73.0-rc2

v0.72.1

Overview

This patch release resolves an issue related to the gasPrice caching mechanism that could lead to inconsistent or unexpected results. The update removes the caching logic to ensure the eth_gasPrice endpoint always returns an accurate, up-to-date value.

What’s Changed

• fix: Remove caching logic for eth_gasPrice endpoint by @quiet-node in #4582

Full Changelog: https://github.com/hiero-ledger/hiero-json-rpc-relay/compare/v0.72.0…v0.72.1

v0.73.0-rc1

v0.73.0-rc1

v0.72.0

Overview

The v0.72.0 release delivers key enhancements to the Hiero JSON-RPC Relay, including expanded test coverage for Consensus Node XTS, improved WebSocket handling with unique RequestIDs, better error reporting in SDKClient.executeTransaction, and new validations for eth_call and debug_traceTransaction. It also introduces a blockTimestamp field in logs, optimizes transaction precheck logic, and refines the OpenRPC JSON updater. Several important bug fixes address transaction parsing, entity resolution, and HBAR transfer edge cases. Alongside these improvements, the release updates numerous dependencies across Go, Node.js, and TypeScript for security and stability, and formally deprecates eth_simulateV1.

What's Changed

• chore(release): Bump versions for v0.72.0-SNAPSHOT by @swirlds-automation in #4310
• build(deps): bump github.com/stretchr/testify from 1.10.0 to 1.11.0 in /tools/golang-example in the minor-and-patch-gomod-weekly group across 1 directory by @dependabot[bot] in #4322
• build(deps): bump the minor-and-patch-cargo-weekly group across 3 directories with 4 updates by @dependabot[bot] in #4326
• build(deps): bump @ethereumjs/rlp from 5.0.2 to 10.0.0 by @dependabot[bot] in #4231
• feat: enhance acceptance test suite for Consensus Node XTS by @quiet-node in #4329
• build(deps-dev): bump eslint-plugin-n from 15.7.0 to 17.21.3 by @dependabot[bot] in #4228
• build(deps-dev): bump cipher-base from 1.0.4 to 1.0.6 in /tools/waffle-example by @dependabot[bot] in #4303
• build(deps): bump sha.js from 2.4.11 to 2.4.12 in /tools/layer-zero-example by @dependabot[bot] in #4304
• build(deps-dev): bump @babel/core from 7.26.9 to 7.28.3 in /dapp-example by @dependabot[bot] in #4320
• build(deps): bump env-cmd from 10.1.0 to 11.0.0 in /k6 by @dependabot[bot] in #4330
• build(deps-dev): bump @types/k6 from 1.1.1 to 1.2.0 in /k6 by @dependabot[bot] in #4311
• build(deps): bump @hashgraph/sdk from 2.60.1 to 2.71.1 in /dapp-example by @dependabot[bot] in #4313
• build(deps-dev): bump sha.js from 2.4.11 to 2.4.12 in /tools/waffle-example by @dependabot[bot] in #4305
• build(deps-dev): bump the minor-and-patch-npm-weekly group across 1 directory with 2 updates by @dependabot[bot] in #4336
• fix: eth_getTransactionByHash correct response parsing by @stoyanov-st in #4331
• feat: upgrade the logs object to include blockТimestamp field by @natanasow in #4358
• chore: throw unsupport for eth_simulateV1 by @natanasow in #4359
• feat: increase test coverage in ws-server by @natanasow in #4333
• feat: update openrpc json updater by @natanasow in #4370
• build(deps): bump babel-loader in dapp-example from 9.1.3 to 10.0.0 by @natanasow in #4377
• feat: improve error handling in SDKClient.executeTransaction to preserve original error details by @natanasow in #4376
• feat: use a different RequestID for each ws request within a single connection by @natanasow in #4373
• feat: add optional stateOverride parameter validation to eth_call by @quiet-node in #4420
• fix: debug_traceTransaction validation for default tracer by @simzzz in #4404
• build(deps): bump @typescript-eslint/parser from 6.5.0 to 8.44.0 by @natanasow in #4406
• refactor: optimize precheckSendRawTransactionCheck for improved efficiency and code cleanliness by @quiet-node in #4360
• fix: extend xts suite with new coverage for HBAR transfers to zero address and reserved system accounts by @quiet-node in #4354
• fix: skipping calling resolveEntityType if action is CREATE by @simzzz in #4372

New Contributors

• @stoyanov-st made their first contribution in #4331

Full Changelog: v0.71.1...v0.72.0

v0.72.0-rc1

v0.72.0-rc1

v0.71.1

Overview

This patch release adds support for the optional stateOverride parameter to the eth_call JSON-RPC method to maintain compatibility with client tools.

What's Changed

• feat: add optional stateOverride parameter validation to eth_call by @quiet-node in #4422

Full Changelog: v0.71.0...v0.71.1

v0.71.0

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 getBalance method to require blockNumberOrTagOrHash parameter 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 _CONFIG object 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_getFilterChanges to ensure EVM compatibility by @romangzz in #3863
• chore: use Node's native fetch in 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 https://github.com/hiero-l...

v0.71.0-rc1

v0.71.0-rc1