> ## 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 minimumLedgerSlot

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

O método RPC [`minimumLedgerSlot`](https://www.helius.dev/docs/api-reference/rpc/http/minimumledgerslot) retorna o menor slot (mais antigo) sobre o qual o nó RPC consultado tem informações em seu livro-razão. Isso é útil para entender a retenção de dados históricos de um nó específico.

## Casos de Uso Comuns

* **Determinando a Disponibilidade de Dados Históricos:** Antes de tentar consultar dados históricos muito antigos (por exemplo, blocos ou transações antigas), você pode usar este método para verificar se o nó provavelmente possui esses dados. Se você precisar de dados de um slot inferior ao `minimumLedgerSlot`, pode ser necessário encontrar um nó arquivador.
* **Conscientização sobre Poda de Nós:** Compreender que nós RPC (especialmente os não-arquivadores) podem podar dados do livro-razão antigos. Este valor indica o limite inferior atual de seu histórico armazenado.
* **Sincronizando Capturadores de Dados Históricos:** Se você está construindo um serviço que ingere dados históricos do Solana, isso pode ajudar a entender o ponto de partida dos dados disponíveis em um determinado nó.

## Parâmetros de Solicitação

Este método não aceita nenhum parâmetro.

## Estrutura de Resposta

O campo `result` na resposta JSON-RPC é um único número `u64` representando o slot mínimo do livro-razão disponível no nó.

**Exemplo de Resposta:**

```json theme={"system"}
{
  "jsonrpc": "2.0",
  "result": 123456789,
  "id": 1
}
```

## Exemplos de Código

<CodeGroup>
  ```bash cURL theme={"system"}
  curl -X POST -H "Content-Type: application/json" -d \
    '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "minimumLedgerSlot"
    }' \
    <YOUR_RPC_URL>
  ```

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

  async function getMinLedgerSlot() {
    // Replace with your RPC endpoint
    const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');

    try {
      const minSlot = await connection.getMinimumLedgerSlot();
      console.log(`Minimum ledger slot available on the node: ${minSlot}`);
    } catch (error) {
      console.error('Error fetching minimum ledger slot:', error);
    }
  }

  getMinLedgerSlot();
  ```
</CodeGroup>

## Dicas para Desenvolvedores

* **Específico do Nó:** O `minimumLedgerSlot` retornado é específico para o nó RPC que você está consultando. Nós diferentes podem ter políticas de retenção de livro-razão diferentes e, portanto, slots mínimos diferentes.
* **Valor Dinâmico:** Este valor pode aumentar com o tempo à medida que o nó poda partes mais antigas de seu livro-razão para economizar espaço. Ele não diminuirá.
* **Nem Toda História:** Isso não significa que o nó tenha *todos* os blocos entre este slot e a ponta atual. Ele apenas indica o slot mais baixo para o qual *pode* ter dados. Lacunas ainda podem existir, especialmente em nós não-arquivadores.
* **Nós Arquivadores:** Para acessar o histórico completo do blockchain desde a gênese, normalmente você precisaria consultar um nó arquivador, que visa armazenar todos os dados do livro-razão.

Este guia ajuda você a entender e usar o método RPC `minimumLedgerSlot` para verificar a extensão dos dados históricos armazenados por um nó RPC Solana.
