{"id":15626,"date":"2025-02-03T00:59:00","date_gmt":"2025-02-03T00:59:00","guid":{"rendered":"https:\/\/hederav2stg.wpenginepowered.com\/blog\/optimizing-cost-control-introducing-the-tiered-hbar-rate-limiter-for-hedera-json-rpc-relay\/"},"modified":"2026-02-03T18:36:13","modified_gmt":"2026-02-03T23:36:13","slug":"optimizing-cost-control-introducing-the-tiered-hbar-rate-limiter-for-hedera-json-rpc-relay","status":"publish","type":"post","link":"https:\/\/hedera.com\/blog\/optimizing-cost-control-introducing-the-tiered-hbar-rate-limiter-for-hedera-json-rpc-relay\/","title":{"rendered":"Optimizing Cost Control: Introducing the Tiered HBAR Rate Limiter for Hedera JSON-RPC Relay"},"content":{"rendered":"
\n

Introduction<\/h4>\n

As the Hedera ecosystem continues to grow, operators of the Hedera JSON-RPC Relay face new challenges, particularly in managing the costs associated with user transactions\u2014especially in public environments. Imagine this: you have allocated a daily, monthly, or yearly HBAR budget and want to ensure it isn\u2019t exceeded. Everything is running smoothly until certain users start submitting abnormally high-cost transactions. These transactions quickly deplete your HBAR resources, leaving less for other users and leading to an unfair distribution of the budget.<\/p>\n

To address this challenge, we have re-engineered our previous HBAR rate limiter. The earlier version simply tracked a single total limit over a specified period. In contrast, the new design introduces a customizable Tiered HBAR Rate Limiter<\/strong>, integrated into the relay, allowing for more granular control and flexibility in managing rate limits. This new feature empowers operators to take control of their spending by categorizing users into tiers with defined spending limits.<\/p>\n

In this blog post, we\u2019ll explore how this tiered approach works, why it matters, and how operators can use it to protect their financial resources while supporting the Hedera ecosystem.<\/p>\n

Understanding the Economic Model<\/h4>\n

Before diving into the functionality of the HBAR rate limiter, let\u2019s establish some context regarding the relay\u2019s economic model and how it compares to similar systems, such as Ethereum.<\/p>\n

The Role of the Hedera JSON-RPC Relay<\/a><\/h4>\n
\"HBAR-Rate-Limiter\"<\/figure>\n

The Hedera JSON-RPC Relay serves as a critical bridge, connecting EVM-based applications to the Hedera network. By translating Ethereum Virtual Machine (EVM) JSON-RPC calls into Hedera-compatible requests, the relay enables dApp developers to leverage Hedera\u2019s benefits seamlessly without modifying their existing codebases. These codebases are often built using third-party tools developed for the Ethereum network, such as Ethers.js and Web3.js.<\/p>\n

EVM Equivalence and Gas Costs<\/h4>\n

To maintain EVM equivalence, gas costs charged to users reflect the computational work required, similar to Ethereum. However, in addition to executing transactions within the EVM, certain operations require additional Hedera File Service (HFS) transactions to process large requests.<\/p>\n

Who Pays for These HFS Transaction Fees?<\/h4>\n

Currently, the relay operator bears the costs of these additional HFS transactions. In most cases, these costs are negligible. However, some users may repeatedly deploy large contracts (requiring multiple file transactions on Hedera) or submit high transaction volumes. Without a proper rate-limiting mechanism, these activities can lead to costs that exceed an operator\u2019s initial estimates, quickly becoming unsustainable.<\/p>\n

Introducing the Tiered HBAR Rate Limiter<\/h4>\n

To address these cost management challenges, we developed the Tiered HBAR Rate Limiter<\/strong>. By assigning different spending limits to users based on their tier, we enable sustainable and predictable cost management while still supporting the network\u2019s growth.<\/p>\n

How Does the Tiered System Work?<\/h4>\n

The tiered system assigns users (or groups of users) to specific HBAR spending plans tailored to their behavior and contribution to the network. Think of it like Netflix subscriptions\u2014spending plans can be assigned individually or to groups, similar to personal and family subscription categories.<\/p>\n

Basic Tier: General Users<\/h4>\n

By default, every new user who sends a request to our relay is automatically assigned a unique spending plan under the BASIC<\/code> tier (Tier 3<\/strong>).<\/p>\n

Extended Tier: Supported Projects<\/h4>\n

Users who exceed the usual activity levels but contribute significantly to the network may qualify for an EXTENDED<\/code> tier (Tier 2<\/strong>) spending plan.<\/p>\n

Privileged Tier: Trusted Partners<\/h4>\n

The PRIVILEGED<\/code> tier (Tier 1<\/strong>) is reserved for strategic or critical partnerships, providing users with a significantly higher spending limit.<\/p>\n

Configuring the Rate Limiter<\/h4>\n

Operators can fine-tune the rate limiter to match their specific needs. The relay\u2019s documentation provides a comprehensive guide to configuration options.<\/p>\n

Explore the detailed configuration guide in this GitHub repository.<\/a><\/p>\n

Benefits of the Enhanced HBAR Rate Limiter<\/h4>\n