Cómo usar getBlocks

El método RPC getBlocks te permite obtener una lista de números de slots de bloques confirmados entre un slot inicial específico y un slot final opcional. Esto resulta útil cuando necesitas saber qué bloques se confirmaron en un rango específico sin obtener el contenido completo de cada bloque.

Evita el procesamiento por lotes para mejorar el rendimientoEl procesamiento por lotes de métodos de archivo aumenta considerablemente la latencia. No se permiten lotes de más de 10 solicitudes.

Casos de uso comunes

Identificar bloques confirmados en un rango: Obtén rápidamente una lista de todos los slots de bloques que se confirmaron correctamente entre dos puntos del libro mayor.
Recorrer bloques: Usa la lista de slots devuelta para obtener después información detallada de cada bloque mediante getBlock, si es necesario.
Auditoría básica de bloques: Verifica la presencia de bloques dentro de un rango determinado.

Parámetros de solicitud

El método getBlocks acepta los siguientes parámetros:

start_slot (u64, obligatorio): El primer slot que se considerará en el rango (incluido).
end_slot (u64, opcional): El último slot que se considerará en el rango (incluido).
- Si no se proporciona, la consulta devolverá los bloques desde start_slot hasta el último slot confirmado.
- El rango entre start_slot e end_slot (o el último slot si se omite end_slot) no debe superar los 500,000 slots.
commitment (cadena, opcional): Especifica el nivel de compromiso de la consulta. Si se omite, se usa 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

El campo result de la respuesta JSON-RPC será un arreglo de enteros u64. Cada entero del arreglo representa el número de slot de un bloque confirmado dentro del rango especificado.

Ejemplo: [5, 6, 7, 8, 9, 10]

Ejemplos

1. Obtener bloques dentro de un rango específico de slots

Este ejemplo obtiene la lista de slots de bloques confirmados entre los slots 250000000 e 250000010.

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

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

async function getBlocksInRange(startSlot, endSlot) {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const blocks = await connection.getBlocks(startSlot, endSlot);
    console.log(`Confirmed blocks between slot ${startSlot} and ${endSlot}:`, blocks);
  } catch (error) {
    console.error('Error fetching blocks:', error);
  }
}

// Example usage:
const startSlot = 250000000;
const endSlot = 250000010;
getBlocksInRange(startSlot, endSlot);

2. Obtener bloques desde un slot inicial hasta el último slot confirmado

Este ejemplo obtiene los slots de bloques confirmados desde 260000000 hasta el último bloque confirmado por el nodo (respetando el límite de rango de 500,000 slots desde el 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": "getBlocks",
    "params": [
      260000000 
    ]
  }'

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

async function getBlocksFromStart(startSlot) {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    // The endSlot parameter is omitted to fetch up to the latest confirmed block
    const blocks = await connection.getBlocks(startSlot);
    console.log(`Confirmed blocks from slot ${startSlot} to latest:`, blocks);
    if (blocks.length > 0) {
      console.log(`Latest block in range: ${blocks[blocks.length - 1]}`);
    }
  } catch (error) {
    console.error('Error fetching blocks:', error);
  }
}

// Example usage (ensure this doesn't exceed the 500,000 slot limit from latest block):
const recentStartSlot = 260000000; 
getBlocksFromStart(recentStartSlot);

3. Obtener bloques con un nivel de compromiso específico

Este ejemplo obtiene bloques con el nivel de compromiso finalized.

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

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

async function getBlocksWithCommitment(startSlot, endSlot) {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const blocks = await connection.getBlocks(startSlot, endSlot, { commitment: 'finalized' });
    console.log(`Finalized blocks between slot ${startSlot} and ${endSlot}:`, blocks);
  } catch (error) {
    console.error('Error fetching blocks with commitment:', error);
  }
}

// Example usage:
const commitStartSlot = 270000000;
const commitEndSlot = 270000005;
getBlocksWithCommitment(commitStartSlot, commitEndSlot);

Consejos para desarrolladores

Límite del rango: Recuerda el límite de rango de 500,000 slots. Solicitar un rango mayor generará un error.
Disponibilidad de datos del nodo: Es posible que los nodos no conserven información de todos los slots históricos. Los valores muy antiguos de start_slot podrían devolver arreglos vacíos o errores, según la configuración del nodo y la retención del libro mayor.
Compromiso del bloque: Con Alpenglow, confirmed e finalized devuelven los mismos bloques confirmados permanentemente; usa preferentemente finalized en código nuevo. Los resultados de distintos nodos aún pueden variar brevemente debido al retraso de propagación.
Complemento de getBlock: getBlocks suele usarse como primer paso para identificar los slots de bloques relevantes antes de usar getBlock para obtener todos los detalles de cada bloque de esa lista.
Alternativa de paginación: Como getBlocks tiene un límite de rango, si necesitas examinar una parte muy grande de la cadena, tendrás que hacer varias llamadas a getBlocks y dividir el rango total deseado en segmentos de 500,000 slots o menos.

Esta guía ofrece una descripción clara de cómo usar el método RPC getBlocks para enumerar slots de bloques confirmados permanentemente en la red Solana.

Empieza aquí

Datos en tiempo real

Trading de baja latencia

Datos históricos y de billeteras

Guías de métodos RPC

Preparación para producción

Uso de Orb

Otras guías prácticas

Casos de uso comunes

Parámetros de solicitud

Estructura de la respuesta

Ejemplos

1. Obtener bloques dentro de un rango específico de slots

2. Obtener bloques desde un slot inicial hasta el último slot confirmado

3. Obtener bloques con un nivel de compromiso específico

Consejos para desarrolladores

Métodos relacionados

getBlock

getBlocksWithLimit

​Casos de uso comunes

​Parámetros de solicitud

​Estructura de la respuesta

​Ejemplos

​1. Obtener bloques dentro de un rango específico de slots

​2. Obtener bloques desde un slot inicial hasta el último slot confirmado

​3. Obtener bloques con un nivel de compromiso específico

​Consejos para desarrolladores

​Métodos relacionados

getBlock

getBlocksWithLimit

Casos de uso comunes

Parámetros de solicitud

Estructura de la respuesta

Ejemplos

1. Obtener bloques dentro de un rango específico de slots

2. Obtener bloques desde un slot inicial hasta el último slot confirmado

3. Obtener bloques con un nivel de compromiso específico

Consejos para desarrolladores

Métodos relacionados