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

# Как использовать getTransactionCount

> Изучите сценарии использования getTransactionCount, примеры кода, параметры запроса, структуру ответа и рекомендации.

Метод RPC [`getTransactionCount`](https://www.helius.dev/docs/api-reference/rpc/http/gettransactioncount) возвращает текущее общее количество транзакций, обработанных реестром Solana с момента его создания, для указанного уровня подтверждения.

## Распространенные сценарии использования

* **Статистика сети:** Отображение общего объема транзакций в сети как показателя ее общего состояния или активности.
* **Отслеживание роста:** Мониторинг увеличения количества транзакций с течением времени для оценки распространения сети и тенденций ее использования.
* **Метрики панели мониторинга:** Предоставление общей информации об активности блокчейна.

## Параметры запроса

Этот метод принимает один необязательный параметр:

1. **`options`** (объект, необязательно): Необязательный объект конфигурации, который может содержать:
   * **`commitment`** (строка, необязательно): Задает [уровень подтверждения](https://www.helius.dev/blog/solana-commitment-levels) для запроса (например, `"finalized"`, `"confirmed"`, `"processed"`). Если параметр не указан, используется уровень подтверждения узла по умолчанию.
   * **`minContextSlot`** (u64, необязательно): Минимальный слот, на котором может быть выполнен запрос.

## Структура ответа

Поле `result` в ответе JSON-RPC содержит одно число типа `u64`, представляющее общее количество транзакций в реестре вплоть до слота, определенного уровнем подтверждения.

**Пример ответа:**

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

## Примеры кода

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

## Рекомендации разработчикам

* **Количество транзакций во всем реестре:** Это значение представляет все транзакции, обработанные в реестре с момента его создания, а не только транзакции определенной учетной записи или блока.
* **Увеличивающееся значение:** Количество транзакций монотонно возрастает.
* **Уровень подтверждения:** Возвращаемое количество зависит от выбранного уровня `commitment`. Уровень подтверждения `processed`, скорее всего, вернет более высокое и актуальное значение, чем `finalized`, однако `finalized` гарантирует защиту от откатов.
* **Не является показателем TPS:** Хотя это значение связано с активностью сети, его нельзя напрямую преобразовать в количество транзакций в секунду (TPS), не сравнив показатели за определенный период времени.

В этом руководстве объясняется, как использовать метод RPC `getTransactionCount` для получения общего количества транзакций в сети Solana.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.