Skip to content

Commit

Permalink
Initial draft for sunsetting balance file (#794)
Browse files Browse the repository at this point in the history
Signed-off-by: Michael Heinrichs <netopyr@users.noreply.github.com>
Signed-off-by: Michael Garber <michael.garber@swirldslabs.com>
Co-authored-by: Michael Garber <michael.garber@swirldslabs.com>
  • Loading branch information
netopyr and mgarbs committed Aug 29, 2023
1 parent a8787c3 commit 27b5d36
Showing 1 changed file with 65 additions and 0 deletions.
65 changes: 65 additions & 0 deletions HIP/hip-794.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
---
hip: 794
title: Sunsetting Balance File
author: Michael Heinrichs <michael@swirldslabs.com>
type: Standards Track
category: Service
needs-council-approval: Yes
status: Last Call
last-call-date-time: 2023-09-12T07:00:00Z
created: 2023-08-28
discussions-to: https://github.com/hashgraph/hedera-improvement-proposal/pull/794
updated: 2023-08-29
---

## Abstract

This HIP proposes sunsetting the balance file.

## Motivation

The ongoing success of the Hedera Network has caused an enormous growth of the data stored in consensus nodes. To ensure the continuous delivery of stable and responsive services, functionality that requires reading large amounts of data has to be disabled on consensus nodes and moved to other systems.

## Rationale

Calculating and providing balance files requires iterating over all accounts. This causes many disk reads, which can interfere with normal operations.

## User stories

As a user, I want a stable and responsive system that does not degrade as the usage scales out.

## Specification

Producing and making the balance file available will be stopped completely.

## Backwards Compatibility

Systems that depend on balance file availability must adapt and request account balances from Mirror Nodes. It is an open discussion if balance files should be provided in the future using other techniques.

## Security Implications

There are no security implications for this change.

## How to Teach This

It should be updated if balance files are mentioned at all in the Hedera documentation. Specific education is not required.

## Reference Implementation

The reference implementation must be complete before HIPs are given the "Final" status.

## Rejected Ideas

All ideas that produced the balance file on consensus nodes were rejected because they would solve the original problem of vast numbers of file reads.

## Open Issues

It is under discussion if balance files can be provided with a process that does not involve analyzing the data on consensus nodes.

## References

N/A

## Copyright/license

This document is licensed under the Apache License, Version 2.0 -- see [LICENSE](../LICENSE) or (https://www.apache.org/licenses/LICENSE-2.0)

0 comments on commit 27b5d36

Please sign in to comment.