Wie man getBlocksWithLimit verwendet

​

Häufige Anwendungsfälle

• Abrufen einer festen Anzahl nachfolgender Blöcke: Erhalten Sie eine definierte Anzahl von Block-Slots, die nach einem bestimmten Start-Slot bestätigt wurden.
• Paginierte Block-Exploration: Abrufen von Blöcken in Abschnitten bei der Analyse eines Segments der Blockchain.
• Überwachung neuer Blöcke: Erhalten Sie die letzten N Blöcke von einem bekannten, kürzlich erfolgten Slot.

​

Anfrageparameter

1. start_slot (u64, erforderlich): Der erste zu berücksichtigende Slot (einschließlich).
2. limit (u64, erforderlich): Die maximale Anzahl von Block-Slots, die zurückgegeben werden sollen. Die Gesamtzahl der abgefragten Slots (von start_slot bis zu limit Blöcke danach) darf 500.000 Slots nicht überschreiten.
3. commitment (String, optional): Gibt das Commitment-Level für die Abfrage an. Wenn weggelassen, wird das Standard-Commitment des Knotens verwendet. Dies wird als einziges Feld in einem Konfigurationsobjekt als letzter Parameter übergeben.

​

Antwortstruktur

• Beispiel: Wenn start_slot 5 ist und limit 3 ist, könnte ein mögliches Ergebnis [5, 6, 7] sein.

​

Beispiele

​

1. Abrufen einer begrenzten Anzahl von Blöcken ab einem Start-Slot

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. Abrufen von Blöcken mit Limit und einem spezifischen Commitment-Level

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

​

Entwickler-Tipps

• Bereichsklärung: Der limit Parameter bestimmt die maximale Anzahl von Block-Slots, die zurückgegeben werden sollen. Die 500.000-Slot-Beschränkung gilt für den konzeptionellen Bereich, der gescannt wird (d. h., von start_slot bis start_slot + limit - 1). Stellen Sie sicher, dass dieser konzeptionelle Bereich 500.000 Slots nicht überschreitet, selbst wenn innerhalb dieses Bereichs weniger tatsächliche Blöcke gefunden und zurückgegeben werden.
• Verfügbarkeit der Knotendaten: Knoten behalten möglicherweise nicht Informationen für alle historischen Slots. Ein sehr alter start_slot könnte weniger Blöcke als angegeben limit zurückgeben oder ein leeres Array, abhängig von der Ledger-Aufbewahrung des Knotens.
• Blockbestätigung: Diese Methode gibt bestätigte Blöcke zurück. Die genaue Menge an Blöcken kann je nach gewähltem commitment Level und dem abgefragten Knoten leicht variieren, insbesondere für sehr aktuelle Slots.
• Spezifität des Anwendungsfalls: getBlocksWithLimit ist ideal, wenn Sie den Startpunkt kennen und eine feste Anzahl nachfolgender Blöcke benötigen. Wenn Sie alle Blöcke in einem bekannten Slotbereich benötigen, könnte getBlocks besser geeignet sein.

​

Verwandte Methoden