Como Usar getTransactionCount

​

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

1. options (objeto, opcional): Um objeto de configuração opcional que pode incluir:
   • commitment (string, opcional): Especifica o nível de comprometimento 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

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

​

Exemplos de Código

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

​

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.