Cómo usar getBlocksWithLimit

​

Casos de uso comunes

• Obtener un número fijo de bloques posteriores: Obtén un número definido de slots de bloques confirmados después de un slot inicial específico.
• Exploración paginada de bloques: Recupera bloques por grupos cuando analices un segmento de la cadena de bloques.
• Monitoreo de bloques recientes: Obtén los últimos N bloques a partir de un slot reciente conocido.

​

Parámetros de solicitud

1. start_slot (u64, obligatorio): El primer slot que se considerará (incluido).
2. limit (u64, obligatorio): La cantidad máxima de slots de bloques que se devolverá. La cantidad total de slots consultados (desde start_slot hasta limit bloques después de este) no debe superar los 500,000 slots.
3. commitment (cadena, opcional): Especifica el nivel de compromiso de la consulta. Si se omite, se usa el compromiso predeterminado del nodo. Se pasa como el único campo de un objeto de configuración en el último parámetro.

​

Estructura de la respuesta

• Ejemplo: Si start_slot es 5 y limit es 3, un resultado posible es [5, 6, 7].

​

Ejemplos

​

1. Obtener un número limitado de bloques a partir de un 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. Obtener bloques con un límite y un nivel de compromiso 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": "finalized" }
    ]
  }'

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: 'finalized' });
    console.log(`Up to ${limit} finalized blocks 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);

​

Consejos para desarrolladores

• Aclaración sobre el rango: El parámetro limit determina la cantidad máxima de slots de bloques que se devolverá. La restricción de 500,000 slots se aplica al rango conceptual examinado (es decir, desde start_slot hasta start_slot + limit - 1). Asegúrate de que este rango conceptual no supere los 500,000 slots, incluso si se encuentran y devuelven menos bloques reales dentro de él.
• Disponibilidad de datos del nodo: Es posible que los nodos no conserven información de todos los slots históricos. Un valor muy antiguo de start_slot podría devolver menos bloques que el valor especificado de limit, o un arreglo vacío, según la retención del libro mayor del nodo.
• Compromiso del bloque: Con Alpenglow, confirmed y finalized devuelven los mismos bloques comprometidos permanentemente; prefiere finalized para código nuevo. Los distintos nodos aún pueden variar brevemente debido al retraso de propagación.
• Especificidad del caso de uso: getBlocksWithLimit es ideal cuando conoces el punto de partida y necesitas una cantidad fija de bloques posteriores. Si necesitas todos los bloques de un rango conocido de slots, getBlocks podría ser más apropiado.

​

Métodos relacionados