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

​

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

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

​

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

1. options (объект, необязательно): Необязательный объект конфигурации, который может содержать:
   • commitment (строка, необязательно): Задает уровень подтверждения для запроса (например, "finalized", "confirmed", "processed"). Если параметр не указан, используется уровень подтверждения узла по умолчанию.
   • minContextSlot (u64, необязательно): Минимальный слот, на котором может быть выполнен запрос.

​

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

{
  "jsonrpc": "2.0",
  "result": 398146706879,
  "id": 1
}

​

Примеры кода

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

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();

​

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

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