> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Como Usar getInflationGovernor

> Aprenda sobre os casos de uso do getInflationGovernor, exemplos de código, parâmetros de solicitação, estrutura de resposta e dicas.

O método RPC [`getInflationGovernor`](https://www.helius.dev/docs/api-reference/rpc/http/getinflationgovernor) retorna os parâmetros atuais de [inflação](https://www.helius.dev/blog/solana-issuance-inflation-schedule) para o cluster Solana. Esses parâmetros definem como a emissão de novos SOL (inflação) é gerenciada ao longo do tempo, incluindo a taxa inicial, como ela diminui, a taxa terminal de longo prazo e as alocações para a fundação.

Compreender esses parâmetros é importante para análises relacionadas a tokenomics, recompensas de staking e o modelo econômico geral do Solana.

## Casos de Uso Comuns

* **Análise Econômica:** Recupere os parâmetros atuais que governam a inflação do SOL para pesquisa ou modelagem.
* **Cálculo de Recompensas de Staking:** Enquanto `getInflationRate` fornece a taxa anual atual, `getInflationGovernor` fornece os parâmetros subjacentes que determinam essa taxa e sua trajetória futura.
* **Compreendendo a Tokenomics:** Obtenha insights sobre as mudanças planejadas na oferta de tokens ao longo do tempo.

## Parâmetros de Solicitação

Este método pode opcionalmente levar um objeto de configuração com o seguinte parâmetro:

* **`commitment`** (string, opcional): Especifica o [nível de compromisso](https://www.helius.dev/blog/solana-commitment-levels) a ser usado ao consultar o ledger. Se não for fornecido, o compromisso padrão do nó é usado (geralmente `finalized`).

## Estrutura da Resposta

O campo `result` da resposta JSON-RPC será um objeto contendo os seguintes parâmetros de inflação (todos são números de ponto flutuante `f64` representando percentuais ou termos):

* **`initial`**: A taxa inicial de inflação (ex.: 0,15 para 15%).
* **`terminal`**: A taxa terminal de longo prazo de inflação (ex.: 0,015 para 1,5%).
* **`taper`**: A taxa na qual a taxa de inflação diminui da `initial` para a `terminal`. Esta é uma diminuição percentual anual na própria taxa de inflação (ex.: um decréscimo de 0,15 significa que a taxa de inflação diminui 15% a cada ano até atingir a taxa terminal).
* **`foundation`**: A proporção do SOL recentemente inflacionado alocada para a Fundação Solana (ex.: 0,05 para 5%).
* **`foundationTerm`**: O período, em anos, durante o qual a alocação `foundation` é distribuída.

## Exemplos

### 1. Obter Parâmetros Atuais do Governador de Inflação

Este exemplo recupera as configurações atuais do governador de inflação usando o compromisso padrão.

<CodeGroup>
  ```bash cURL theme={"system"}
  curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
    '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "getInflationGovernor"
    }'
  ```

  ```javascript JavaScript (using @solana/web3.js) theme={"system"}
  const { Connection } = require('@solana/web3.js');

  async function logInflationGovernor() {
    const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
    try {
      const inflationGovernor = await connection.getInflationGovernor();
      console.log('Current Inflation Governor Parameters:');
      console.log(`  Initial Rate: ${(inflationGovernor.initial * 100).toFixed(2)}%`);
      console.log(`  Terminal Rate: ${(inflationGovernor.terminal * 100).toFixed(2)}%`);
      console.log(`  Taper Rate: ${(inflationGovernor.taper * 100).toFixed(2)}% per year`);
      console.log(`  Foundation Allocation: ${(inflationGovernor.foundation * 100).toFixed(2)}%`);
      console.log(`  Foundation Term: ${inflationGovernor.foundationTerm} years`);
      // For full raw details:
      // console.log(JSON.stringify(inflationGovernor, null, 2));
    } catch (error) {
      console.error('Error fetching inflation governor:', error);
    }
  }

  logInflationGovernor();
  ```
</CodeGroup>

### 2. Obter Parâmetros do Governador de Inflação com Compromisso 'confirmado'

<CodeGroup>
  ```bash cURL theme={"system"}
  curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
    '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "getInflationGovernor",
      "params":[{"commitment":"confirmed"}]
    }'
  ```

  ```javascript JavaScript (using @solana/web3.js) theme={"system"}
  const { Connection } = require('@solana/web3.js');

  async function logConfirmedInflationGovernor() {
    const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
    try {
      const inflationGovernor = await connection.getInflationGovernor('confirmed');
      console.log('Confirmed Inflation Governor Parameters:');
      console.log(`  Initial Rate: ${(inflationGovernor.initial * 100).toFixed(2)}%`);
      console.log(`  Terminal Rate: ${(inflationGovernor.terminal * 100).toFixed(2)}%`);
      // console.log(JSON.stringify(inflationGovernor, null, 2));
    } catch (error) {
      console.error('Error fetching confirmed inflation governor:', error);
    }
  }

  logConfirmedInflationGovernor();
  ```
</CodeGroup>

## Dicas para Desenvolvedores

* **Parâmetros Estáticos:** Esses parâmetros de inflação são definidos na gênese do cluster ou por atualizações da rede e geralmente não são esperados para mudar frequentemente sem um processo formal de governança e atualização da rede.
* **Impacto nas Recompensas de Staking:** Esses parâmetros determinam coletivamente o cronograma geral de inflação, que por sua vez afeta a Taxa Percentual Anual (APR) para staking de SOL.
* **Alocação da Fundação:** Os parâmetros `foundation` e `foundationTerm` descrevem uma parte específica da inflação direcionada à Fundação Solana por um período definido para apoiar o desenvolvimento e as operações do ecossistema.

Este guia fornece uma visão geral de como usar o método RPC `getInflationGovernor` para recuperar e entender os parâmetros principais que governam a inflação na rede Solana.

## Métodos Relacionados

<CardGroup cols={2}>
  <Card title="getInflationRate" href="/docs/pt-BR/api-reference/rpc/http/getinflationrate">
    Obtenha a taxa de inflação da época atual
  </Card>

  <Card title="getInflationReward" href="/docs/pt-BR/api-reference/rpc/http/getinflationreward">
    Obtenha recompensas de inflação para endereços específicos
  </Card>
</CardGroup>
