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

# Cómo usar getTransactionCount

> Conoce los casos de uso, ejemplos de código, parámetros de solicitud, estructura de respuesta y consejos de getTransactionCount.

El método RPC [`getTransactionCount`](https://www.helius.dev/docs/api-reference/rpc/http/gettransactioncount) devuelve el número total actual de transacciones procesadas por el libro mayor de Solana desde su creación, en un nivel de compromiso específico.

## Casos de uso comunes

* **Estadísticas de la red:** Mostrar el volumen total de transacciones en la red como indicador general de su estado o actividad.
* **Seguimiento del crecimiento:** Supervisar el aumento en el número de transacciones a lo largo del tiempo para observar las tendencias de adopción y uso de la red.
* **Métricas del panel:** Proporcionar una descripción general de alto nivel de la actividad de la cadena de bloques.

## Parámetros de la solicitud

Este método tiene un parámetro opcional:

1. **`options`** (objeto, opcional): Un objeto de configuración opcional que puede incluir:
   * **`commitment`** (cadena, opcional): Especifica el [nivel de compromiso](https://www.helius.dev/blog/solana-commitment-levels) de la consulta (por ejemplo, `"finalized"`, `"confirmed"`, `"processed"`). Si no se proporciona, se usa el nivel de compromiso predeterminado del nodo.
   * **`minContextSlot`** (u64, opcional): El slot mínimo en el que se puede evaluar la solicitud.

## Estructura de la respuesta

El campo `result` de la respuesta JSON-RPC es un único número `u64` que representa el total de transacciones del libro mayor hasta el slot determinado por el nivel de compromiso.

**Ejemplo de respuesta:**

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

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

## Consejos para desarrolladores

* **Conteo de todo el libro mayor:** Este conteo representa todas las transacciones procesadas en el libro mayor desde su creación, no solo las de una cuenta o bloque específicos.
* **Valor creciente:** El número de transacciones es un valor que aumenta de forma monótona.
* **Nivel de compromiso:** El conteo devuelto depende del nivel `commitment` elegido. Un compromiso `processed` probablemente devolverá un conteo mayor y más actualizado que `finalized`, pero `finalized` ofrece una garantía contra reversiones.
* **No es una métrica de TPS:** Aunque está relacionado con la actividad de la red, este valor por sí solo no se traduce directamente en transacciones por segundo (TPS) sin comparar los conteos durante un período definido.

Esta guía explica cómo usar el método RPC `getTransactionCount` para obtener el número total de transacciones en la red de Solana.