[HBAR Rate Limit Redesign] Redesign of the HBar Rate Limiter

[ebadiere]

Problem

The current HBar rate limiter is designed to limit the operator HBar spending over a duration such as a minute, but the relay may get batches of many FileAppend transactions that disproportionally spend the relay's operator balance. Reducing the remaining balance in the HBar rate limiter can stop the many incoming FileAppend transactions but can also stop other users from simply deploying transactions.

Solution

Redesign the HBar rate limiter

Consider:

• Rate limiting using the operator's quota for the day. Query the mirror node for updated operator balance at regular intervals.
• Limit the FileAppend per user of IP
• Define requirements

Alternatives

No response

Tasks

Beta Give feedback

1. Implement real-time tracking of HBar spending across different operations and transaction types.
2. Support flexible alerting mechanisms for spending thresholds. (TODO)
3. [HBAR Rate Limit Redesign] Create design document #2863
   design enhancement +2
   
4. [HBAR Rate Limit Redesign] Provide configurable rate limiting based on original caller addresses, IP addresses -- whitelist system #2850
   10 of 12
   Epic enhancement +2
   

   
5. [HBAR Rate Limit Redesign] Enable early detection and prevention of potential HBar drainage -- preemptive rate limits #2849
   2 of 2
   enhancement +1
   
6. [HBAR Rate Limit Redesign] Replace usages of HbarLimit with the new HbarLimitService and delete it #2896
   enhancement +1
   
7. [HBAR Rate Limit Redesign] Add new metrics for tracking usage of HBar Spending Plans #2933
   2 of 2
   enhancement +1
   
8. [HBAR Rate Limit Redesign] add and/or make request ID mandatory in logging #2940
   enhancement +1
   
9. [HBAR Rate Limit Redesign] Add high-level flow diagram #2968
   design documentation +2
   
10. [HBAR Rate Limit Redesign] Note what configurations are used #2970
    design documentation +2
    
11. [HBAR Rate Limit Redesign] Make limit duration and budget configurable #3018
    design enhancement +2
    
12. [HBAR Rate Limit Redesign] Improive logging logic for hbarLimit related classes #3025
    enhancement +1
    
13. [HBAR Rate Limit Redesign] Implement configuration to pre-populate the cache with spending plans #3055
    P1 enhancement +2
    
14. [HBAR Rate Limit Redesign] Create acceptance tests for the new hbar limiter #3059
    1 of 5
    Epic enhancement +2
    
15. [HBAR Rate Limit Redesign] Reset metrics which are dependent on the limit duration #3092
    P1 bug +2
    
16. [HBAR Rate Limit Redesign] Implement custom LRU cache with protected keys #3096
    P1 enhancement +2
    
17. [HBAR Rate Limit Redesign] Add OPERATOR tier (post-release) #3099
    Technical Debt enhancement +2
18. [HBAR Rate Limit Redesign] Add a counter to expose DAU metrics. #3109
    0 of 2
    enhancement +1