So verwendest du getBlocksWithLimit

​

Häufige Anwendungsfälle

• Eine feste Anzahl nachfolgender Blöcke abrufen: Rufe eine festgelegte Anzahl von Block-slots ab, die nach einem bestimmten Start-slot bestätigt wurden.
• Paginierte Blocksuche: Rufe Blöcke in Abschnitten ab, wenn du einen Teil der Blockchain analysierst.
• Aktuelle Blöcke überwachen: Rufe die letzten N Blöcke ab einem bekannten aktuellen slot ab.

​

Request-Parameter

1. start_slot (u64, erforderlich): Der erste zu berücksichtigende slot (einschließlich).
2. limit (u64, erforderlich): Die maximale Anzahl zurückzugebender Block-slots. 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 den commitment-Level für die Abfrage an. Wenn du ihn weglässt, wird das standardmäßige commitment des node verwendet. Dieser Wert wird als einziges Feld in einem Konfigurationsobjekt als letzter Parameter übergeben.

​

Response-Struktur

• Beispiel: Wenn start_slot den Wert 5 und limit den Wert 3 hat, wäre [5, 6, 7] ein mögliches Ergebnis.

​

Beispiele

​

1. Eine begrenzte Anzahl von Blöcken ab einem Start-slot abrufen

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. Blöcke mit einem Limit und einem bestimmten commitment-Level abrufen

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

​

Tipps für Entwickler

• Erläuterung des Bereichs: Der Parameter limit bestimmt die maximale Anzahl zurückzugebender Block-slots. Die Beschränkung auf 500.000 slots gilt für den konzeptionell durchsuchten Bereich, also von start_slot bis start_slot + limit - 1. Achte darauf, dass dieser konzeptionelle Bereich 500.000 slots nicht überschreitet. Das gilt auch dann, wenn innerhalb dieses Bereichs weniger tatsächliche Blöcke gefunden und zurückgegeben werden.
• Datenverfügbarkeit des node: Nodes speichern möglicherweise nicht die Informationen zu allen historischen slots. Bei einem sehr alten start_slot werden abhängig von der Ledger-Aufbewahrung des node möglicherweise weniger Blöcke als durch limit angegeben oder ein leeres Array zurückgegeben.
• Blockbestätigung: Diese Methode gibt bestätigte Blöcke zurück. Die genaue Menge der Blöcke kann je nach gewähltem commitment-Level und abgefragtem node leicht variieren. Das gilt besonders für sehr aktuelle slots.
• Spezifischer Anwendungsfall: getBlocksWithLimit eignet sich ideal, wenn du den Startpunkt kennst und eine feste Anzahl nachfolgender Blöcke benötigst. Wenn du alle Blöcke in einem bekannten slot-Bereich benötigst, eignet sich getBlocks möglicherweise besser.

​

Verwandte Methoden