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

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

O método RPC [`getTransactionCount`](https://www.helius.dev/docs/api-reference/rpc/http/gettransactioncount) retorna o número total atual de transações processadas pelo ledger Solana desde o início, em um nível de compromisso especificado.

## Casos de Uso Comuns

* **Estatísticas da Rede:** Exibir o volume geral de transações na rede como um indicador geral de saúde ou atividade.
* **Acompanhamento de Crescimento:** Monitorar o aumento no número de transações ao longo do tempo para observar a adoção e tendências de uso da rede.
* **Métricas de Painel:** Fornecer uma visão geral das atividades do blockchain.

## Parâmetros de Solicitação

Este método possui um parâmetro opcional:

1. **`options`** (objeto, opcional): Um objeto de configuração opcional que pode incluir:
   * **`commitment`** (string, opcional): Especifica o [nível de comprometimento](https://www.helius.dev/blog/solana-commitment-levels) para a consulta (por exemplo, `"finalized"`, `"confirmed"`, `"processed"`). Se não for fornecido, o compromisso padrão do nó é usado.
   * **`minContextSlot`** (u64, opcional): O slot mínimo que a solicitação pode ser avaliada.

## Estrutura de Resposta

O campo `result` na resposta JSON-RPC é um número único `u64` que representa o total de transações do ledger até o slot determinado pelo nível de compromisso.

**Exemplo de Resposta:**

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

## Exemplos de Código

<CodeGroup>
  ```bash cURL theme={"system"}
  # Basic Request (uses default commitment of the RPC node):
  curl -X POST -H "Content-Type: application/json" -d \
    '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "getTransactionCount"
    }' \
    <YOUR_RPC_URL>

  # Request with a specific commitment level:
  curl -X POST -H "Content-Type: application/json" -d \
    '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "getTransactionCount",
      "params": [
        {
          "commitment": "confirmed"
        }
      ]
    }' \
    <YOUR_RPC_URL>
  ```

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

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

    try {
      const transactionCount = await connection.getTransactionCount();
      console.log(`Current ledger transaction count: ${transactionCount}`);

      // Example with commitment
      const confirmedTransactionCount = await connection.getTransactionCount('confirmed');
      console.log(`Current ledger transaction count (confirmed): ${confirmedTransactionCount}`);

    } catch (error) {
      console.error('Error fetching transaction count:', error);
    }
  }

  getCurrentTransactionCount();
  ```
</CodeGroup>

## Dicas para Desenvolvedores

* **Contagem do Ledger:** Este número representa todas as transações processadas no ledger desde sua criação, não apenas para uma conta ou bloco específico.
* **Valor Crescente:** A contagem de transações é um valor que cresce monotonamente.
* **Nível de Compromisso:** A contagem retornada depende do nível `commitment` escolhido. Um compromisso `processed` provavelmente resultará em uma contagem maior, mais atualizada do que `finalized`, mas `finalized` oferece garantia contra rollbacks.
* **Não é uma Métrica de TPS:** Embora relacionado à atividade da rede, esse valor único não se traduz diretamente em Transações Por Segundo (TPS) sem comparar contagens em um período de tempo definido.

Este guia explica como usar o método RPC `getTransactionCount` para recuperar o número total de transações na rede Solana.