Como Usar getBlocksWithLimit

​

Casos de Uso Comuns

• Buscar um Número Fixo de Blocos Subsequentes: Obtenha um número definido de slots de blocos que foram confirmados após um slot inicial específico.
• Exploração de Blocos Paginada: Recupere blocos em partes ao analisar um segmento do blockchain.
• Monitoramento de Blocos Recentes: Obtenha os últimos N blocos de um slot recente conhecido.

​

Parâmetros de Solicitação

1. start_slot (u64, obrigatório): O primeiro slot a considerar (inclusivo).
2. limit (u64, obrigatório): O número máximo de slots de blocos a retornar. O número total de slots consultados (de start_slot até limit blocos após ele) não deve exceder 500.000 slots.
3. commitment (string, opcional): Especifica o nível de compromisso para a consulta. Se omitido, o compromisso padrão do nó é usado. Isso é passado como o único campo em um objeto de configuração como o último parâmetro.

​

Estrutura da Resposta

• Exemplo: Se start_slot for 5 e limit for 3, um resultado possível é [5, 6, 7].

​

Exemplos

​

1. Obter um Número Limitado de Blocos a partir de um Slot Inicial

curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBlocksWithLimit",
    "params": [
      280000000, 
      5 
    ]
  }'

const { Connection } = require('@solana/web3.js');

async function getBlocksWithLimitExample(startSlot, limit) {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const blocks = await connection.getBlocksWithLimit(startSlot, limit);
    console.log(`Up to ${limit} confirmed blocks starting from slot ${startSlot}:`, blocks);
  } catch (error) {
    console.error('Error fetching blocks with limit:', error);
  }
}

// Example usage:
const startSlot = 280000000;
const limit = 5;
getBlocksWithLimitExample(startSlot, limit);

​

2. Obter Blocos Com Limite e Um Nível de Compromisso Específico

curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getBlocksWithLimit",
    "params": [
      290000000,
      3,
      { "commitment": "confirmed" }
    ]
  }'

const { Connection } = require('@solana/web3.js');

async function getBlocksWithLimitAndCommitment(startSlot, limit) {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const blocks = await connection.getBlocksWithLimit(startSlot, limit, { commitment: 'confirmed' });
    console.log(`Up to ${limit} confirmed blocks (with 'confirmed' commitment) starting from slot ${startSlot}:`, blocks);
  } catch (error) {
    console.error('Error fetching blocks with limit and commitment:', error);
  }
}

// Example usage:
const commitStartSlot = 290000000;
const commitLimit = 3;
getBlocksWithLimitAndCommitment(commitStartSlot, commitLimit);

​

Dicas para Desenvolvedores

• Clareza de Intervalo: O parâmetro limit dita o número máximo de slots de blocos a retornar. A restrição de 500.000 slots se aplica ao intervalo conceitual analisado (ou seja, de start_slot até start_slot + limit - 1). Garanta que esse intervalo conceitual não exceda 500.000 slots, mesmo se menos blocos reais forem encontrados e retornados dentro desse intervalo.
• Disponibilidade de Dados do Nó: Os nós podem não reter informação para todos os slots históricos. Um start_slot muito antigo pode retornar menos blocos do que o especificado limit, ou um array vazio, dependendo da retenção do livro-razão do nó.
• Confirmação de Blocos: Este método retorna blocos confirmados. O conjunto exato de blocos pode variar ligeiramente dependendo do nível commitment escolhido e qual nó você consulta, especialmente para slots muito recentes.
• Especificidade do Caso de Uso: getBlocksWithLimit é ideal quando você conhece o ponto de partida e precisa de um número fixo de blocos subsequentes. Se você precisa de todos os blocos em um intervalo de slots conhecido, getBlocks pode ser mais apropriado.

​

Métodos Relacionados