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 tendrá en cuenta (incluido).
2. limit (u64, obligatorio): El número máximo de slots de bloques que se devolverán. El número total de slots consultados (desde start_slot hasta limit bloques después de este) no debe superar los 500,000 slots.
3. commitment (string, opcional): Especifica el nivel de compromiso de la consulta. Si se omite, se utiliza el nivel de compromiso predeterminado del nodo. Se pasa como único campo de un objeto de configuración en el último parámetro.

​

Estructura de la respuesta

• Ejemplo: Si start_slot es 5 e 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": "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);

​

Consejos para desarrolladores

• Aclaración sobre el rango: El parámetro limit determina el número máximo de slots de bloques que se devolverán. 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 ese rango.
• Disponibilidad de datos del nodo: Es posible que los nodos no conserven información de todos los slots históricos. Un start_slot muy antiguo podría devolver menos bloques que el limit especificado, o un arreglo vacío, según la retención del libro mayor del nodo.
• Confirmación de bloques: Este método devuelve bloques confirmados. El conjunto exacto de bloques puede variar ligeramente según el nivel commitment elegido y el nodo que consultes, especialmente en el caso de slots muy recientes.
• Especificidad del caso de uso: getBlocksWithLimit es ideal cuando conoces el punto de partida y necesitas un número fijo de bloques posteriores. Si necesitas todos los bloques de un rango de slots conocido, getBlocks podría ser más adecuado.

​

Métodos relacionados