How to Use getInflationGovernor
Learn getInflationGovernor use cases, code examples, request parameters, response structure, and tips.
The getInflationGovernor
RPC method returns the current inflation parameters for the Solana cluster. These parameters define how the issuance of new SOL (inflation) is managed over time, including the initial rate, how it tapers, the long-term terminal rate, and allocations for the foundation.
Understanding these parameters is important for analyses related to tokenomics, staking rewards, and the overall economic model of Solana.
Common Use Cases
- Economic Analysis: Retrieve the current parameters governing SOL inflation for research or modeling.
- Staking Reward Calculation: While
getInflationRate
gives the current annual rate,getInflationGovernor
provides the underlying parameters that determine this rate and its future trajectory. - Understanding Tokenomics: Gain insight into the planned token supply changes over time.
Request Parameters
This method can optionally take a configuration object with the following parameter:
commitment
(string, optional): Specifies the commitment level to use when querying the ledger. If not provided, the default commitment of the node is used (usuallyfinalized
).
Response Structure
The result
field of the JSON-RPC response will be an object containing the following inflation parameters (all are f64
floating-point numbers representing percentages or terms):
initial
: The initial inflation rate (e.g., 0.15 for 15%).terminal
: The long-term, terminal inflation rate (e.g., 0.015 for 1.5%).taper
: The rate at which the inflation rate decreases from theinitial
to theterminal
rate. This is a yearly percentage decrease in the inflation rate itself (e.g., a taper of 0.15 means the inflation rate decreases by 15% each year until it reaches the terminal rate).foundation
: The proportion of the newly inflated SOL allocated to the Solana Foundation (e.g., 0.05 for 5%).foundationTerm
: The period, in years, over which thefoundation
allocation is distributed.
Examples
1. Get Current Inflation Governor Parameters
This example fetches the current inflation governor settings using the default commitment.
2. Get Inflation Governor Parameters with ‘confirmed’ Commitment
Developer Tips
- Static Parameters: These inflation parameters are set at the genesis of the cluster or by network upgrades and are generally not expected to change frequently without a formal governance process and network update.
- Impact on Staking Rewards: These parameters collectively determine the overall inflation schedule, which in turn affects the Annual Percentage Rate (APR) for staking SOL.
- Foundation Allocation: The
foundation
andfoundationTerm
parameters describe a specific portion of the inflation directed towards the Solana Foundation for a defined period to support ecosystem development and operations.
This guide provides an overview of how to use the getInflationGovernor
RPC method to retrieve and understand the core parameters governing inflation on the Solana network.