Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Wraps to 80 characters (backport #29259) #29263

Merged
merged 1 commit into from
Dec 14, 2022
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 18 additions & 4 deletions docs/src/storage_rent_economics.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,16 +2,30 @@
title: Storage Rent Economics
---

Each transaction that is submitted to the Solana ledger imposes costs. Transaction fees paid by the submitter, and collected by a validator, in theory, account for the acute, transactional, costs of validating and adding that data to the ledger. Unaccounted in this process is the mid-term storage of active ledger state, necessarily maintained by the rotating validator set. This type of storage imposes costs not only to validators but also to the broader network as active state grows so does data transmission and validation overhead. To account for these costs, we describe here our preliminary design and implementation of storage rent.
Each transaction that is submitted to the Solana ledger imposes costs.
Transaction fees paid by the submitter, and collected by a validator, in
theory, account for the acute, transactional, costs of validating and adding
that data to the ledger. Unaccounted in this process is the mid-term storage of
active ledger state, necessarily maintained by the rotating validator set. This
type of storage imposes costs not only to validators but also to the broader
network as active state grows so does data transmission and validation
overhead. To account for these costs, we describe here our preliminary design
and implementation of storage rent.

Storage rent can be paid via one of two methods:

Method 1: Set it and forget it

With this approach, accounts with two-years worth of rent deposits secured are exempt from network rent charges. By maintaining this minimum-balance, the broader network benefits from reduced liquidity and the account holder can rest assured that their `Account::data` will be retained for continual access/usage.
With this approach, accounts with two-years worth of rent deposits secured are
exempt from network rent charges. By maintaining this minimum-balance, the
broader network benefits from reduced liquidity and the account holder can rest
assured that their `Account::data` will be retained for continual access/usage.

Method 2: Pay per byte

If an account has less than two-years worth of deposited rent the network charges rent on a per-epoch basis, in credit for the next epoch. This rent is deducted at a rate specified in genesis, in lamports per kilobyte-year.
If an account has less than two-years worth of deposited rent the network
charges rent on a per-epoch basis, in credit for the next epoch. This rent is
deducted at a rate specified in genesis, in lamports per kilobyte-year.

For information on the technical implementation details of this design, see the [Rent](implemented-proposals/rent.md) section.
For information on the technical implementation details of this design, see the
[Rent](implemented-proposals/rent.md) section.