Solana-API für historische Accounts (Beta)

Was ist der historische Account-Zustand?

• Prüfe die token-Salden einer Wallet zu einem bestimmten Zeitpunkt, etwa für Audits, Buchhaltung oder Steuererklärungen
• Debugge eine Transaktion, indem du die von ihr verwendeten Accounts direkt vor und nach ihrer Ausführung liest
• Lies die Accounts eines Protokolls, etwa Pools, Vaults oder Oracles, an einem vergangenen slot, ohne das Ledger selbst erneut abzuspielen

Welche Methode sollte ich verwenden?

Verfügbarkeit und Preise

• Tarife: Business-Tarife und höher.
• Kosten: 0 Credits pro Aufruf während der Beta-Phase (Preise können sich ändern).
• rate limit: getHistoricalAccountInfo erlaubt 100 requests pro Sekunde mit maximal 100 requests auf einmal. getHistoricalTokenAccountsByOwner erlaubt 10 requests pro Sekunde mit maximal 10 requests auf einmal. Diese Limits gelten unabhängig vom RPC-rate limit deines Tarifs. Darüber hinausgehende requests geben HTTP 429 zurück. Siehe rate limits.
• Netzwerk: Nur Mainnet. Rufe die Methoden über den standardmäßigen Mainnet-endpoint https://mainnet.helius-rpc.com oder den Gatekeeper-endpoint https://beta.helius-rpc.com auf. Devnet gibt den Fehler -32601 zurück.

Datenabdeckung

Position im Verlauf auswählen

Zustand vor und nach einer Transaktion lesen

• Nach der Transaktion: Frage ihre eigenen Werte für slot und transactionIndex ab.
• Vor der Transaktion: Frage denselben Wert für slot ab und ziehe 1 von transactionIndex ab. Wenn die Transaktion die erste in ihrem slot ist (Index 0), frage den vorherigen slot ohne transactionIndex ab.

# State of the account right after the transaction at index 10 in slot 445000000
curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "getHistoricalAccountInfo",
    "params": [
      "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      { "slot": 445000000, "transactionIndex": 10 },
      { "encoding": "jsonParsed" }
    ]
  }'

lastUpdatedAt verstehen

"lastUpdatedAt": { "slot": 444999837, "transactionIndex": 700 }

• slot und transactionIndex verweisen auf den letzten Schreibvorgang an oder vor der abgefragten Position. Im obigen Beispiel gab eine Abfrage für slot 445,000,000 den Zustand zurück, den zuletzt die Transaktion mit Index 700 in slot 444,999,837 geschrieben hatte.
• transactionIndex: null bedeutet, dass der Schreibvorgang außerhalb einer Transaktion stattfand, etwa durch Epochen-Rewards.
• slot: 444959999 mit transactionIndex: null bedeutet, dass sich der Account seit Beginn der Verlaufsabdeckung nicht geändert hat. Es bedeutet nicht, dass der Account in diesem slot beschrieben wurde.

Bedeutung eines null-Werts

• Eine response mit null enthält kein lastUpdatedAt. Sie zeigt daher nicht, wann der Account erstellt oder geschlossen wurde. Verwende getTransactionsForAddress, um diese Transaktionen zu finden.
• Eine Adresse, die nie existiert hat, gibt ebenfalls null und keinen Fehler zurück.
• Ein slot vor Beginn der Verlaufsabdeckung gibt für jede Adresse den Fehler -32018 zurück, unabhängig davon, ob der Account existierte.

Account-Verlauf rückwärts durchlaufen

const url = `https://mainnet.helius-rpc.com/?api-key=${process.env.HELIUS_API_KEY}`;
const COVERAGE_START_SLOT = 444959999;

type Position = { slot?: number; transactionIndex?: number };

async function getAccountHistory(address: string, start: Position = {}, maxStates = 100) {
  const states = [];
  let position = start;

  while (states.length < maxStates) {
    const response = await fetch(url, {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({
        jsonrpc: "2.0",
        id: "1",
        method: "getHistoricalAccountInfo",
        params: [address, position, { encoding: "base64" }],
      }),
    });
    const { result, error } = await response.json();
    if (error) throw new Error(`${error.code}: ${error.message}`);

    const account = result.value;
    if (!account) break; // The account didn't exist before this write

    states.push(account);
    const { slot, transactionIndex } = account.lastUpdatedAt;
    if (slot <= COVERAGE_START_SLOT) break; // Reached the start of history coverage

    // Step to the position just before this write
    position = transactionIndex ? { slot, transactionIndex: transactionIndex - 1 } : { slot: slot - 1 };
  }

  return states; // Newest first
}

• Accounts, die inzwischen geschlossen wurden, geben am neuesten slot null zurück. Übergib eine start-Position aus einem Zeitpunkt, an dem der Account noch existierte.
• Nicht transaktionsbezogene Schreibvorgänge springen zum vorherigen slot. Wenn derselbe Account zuvor in diesem slot auch durch eine Transaktion beschrieben wurde, überspringt der Durchlauf diesen Zustand.
• Um den Verlauf vorwärts zu durchlaufen, liste die Transaktionen des Accounts mit getTransactionsForAddress und sortOrder: "asc" von der ältesten zur neuesten auf. Lies dann den Zustand an den Werten slot und transactionIndex jeder Transaktion.

response-Kontext

Konsistent paginieren

• Übergib paginationKey erneut im Konfigurationsobjekt, um die nächste Seite abzurufen.
• Beende den Vorgang erst, wenn paginationKey den Wert null hat. Eine Seite kann kurz oder leer sein und trotzdem weitere Ergebnisse enthalten.
• Verwende für jede Seite denselben Wert für slot. Wenn du slot weglässt, liest jede Seite den neuesten indizierten slot. Deine Seiten können dann von unterschiedlichen Zeitpunkten stammen.
• Setze limit auf einen Wert zwischen 1 und 5.000. Der Standardwert ist 5.000.

Codierungen und geparste Daten

• Unterstützte Codierungen sind base64 (Standard), base64+zstd und jsonParsed. base58 und binary werden nicht unterstützt.
• jsonParsed-token-Accounts verwenden die Dezimalstellen der Mint an der abgefragten Position. Dadurch bleiben die Beträge korrekt, auch wenn sich die Mint inzwischen geändert hat. Wenn die Mint an dieser Position nicht gelesen werden kann, verwendet der Account stattdessen base64.
• dataSlice funktioniert genauso wie in getAccountInfo.

Commitment

Fehler

Häufig gestellte Fragen

Wie erhalte ich den Zustand eines Solana-Accounts an einem bestimmten slot?

Kann ich einen Account zwischen zwei Transaktionen im selben slot lesen?

Wie weit kann ich zurückgehen?

Welche Tarife enthalten Methoden für historische Accounts?

Welche rate limits gelten?

Wie erhalte ich jeden früheren Zustand eines Accounts?

Benötige ich ein neues SDK?

Nächste Schritte