API des comptes historiques Solana (bêta)

Qu’est-ce que l’état historique d’un compte ?

• Vérifier les soldes de jetons d’un portefeuille à un instant donné, à des fins d’audit, de comptabilité ou de déclaration fiscale
• Déboguer une transaction en lisant les comptes qu’elle a affectés juste avant et juste après son exécution
• Lire les comptes d’un protocole, comme des pools, des coffres ou des oracles, à un slot passé sans rejouer vous-même le registre

Quelle méthode utiliser ?

Disponibilité et tarification

• Offres : offre Business et offres supérieures dans les offres.
• Coût : 0 crédit par appel pendant la bêta (tarification susceptible de changer).
• Limites de débit : getHistoricalAccountInfo autorise 100 requêtes par seconde, avec une rafale maximale de 100. getHistoricalTokenAccountsByOwner autorise 10 requêtes par seconde, avec une rafale maximale de 10. Ces limites sont distinctes de la limite de débit RPC de votre offre. Les requêtes qui les dépassent renvoient le code HTTP 429. Consultez les limites de débit.
• Réseau : Mainnet uniquement. Appelez ces méthodes sur l’endpoint Mainnet standard, https://mainnet.helius-rpc.com, ou sur l’endpoint Gatekeeper, https://beta.helius-rpc.com. Devnet renvoie l’erreur -32601.

Couverture des données

Choisir une position dans l’historique

Lire l’état avant et après une transaction

• Après la transaction : interrogez ses propres slot et transactionIndex.
• Avant la transaction : interrogez le même slot avec transactionIndex moins 1. Si la transaction est la première de son slot (index 0), interrogez le slot précédent sans transactionIndex.

# 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" }
    ]
  }'

Comprendre lastUpdatedAt

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

• slot et transactionIndex indiquent la dernière écriture effectuée à la position interrogée ou avant celle-ci. Dans l’exemple ci-dessus, une requête portant sur le slot 445,000,000 a renvoyé l’état écrit en dernier par la transaction à l’index 700 du slot 444,999,837.
• transactionIndex: null signifie que l’écriture a eu lieu en dehors d’une transaction, comme pour les récompenses d’époque.
• slot: 444959999 avec transactionIndex: null signifie que le compte n’a pas changé depuis le début de la couverture historique. Cela ne signifie pas que le compte a été écrit dans ce slot.

Signification d’une valeur null

• Une réponse null ne contient pas de lastUpdatedAt. Elle n’indique donc pas quand le compte a été créé ou fermé. Pour trouver ces transactions, utilisez getTransactionsForAddress.
• Une adresse qui n’a jamais existé renvoie également null, et non une erreur.
• Un slot antérieur à la couverture historique renvoie l’erreur -32018 pour toutes les adresses, que le compte ait existé ou non.

Remonter l’historique d’un compte

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
}

• Les comptes actuellement fermés renvoient null au dernier slot. Transmettez une position start correspondant à un moment où le compte existait encore.
• Les écritures hors transaction passent au slot précédent. Si le même compte a aussi été écrit par une transaction plus tôt dans ce slot, le parcours ignore cet état.
• Pour parcourir l’historique chronologiquement, répertoriez les transactions du compte de la plus ancienne à la plus récente avec getTransactionsForAddress et sortOrder: "asc". Lisez ensuite l’état aux slot et transactionIndex de chaque transaction.

Contexte de la réponse

Paginer de manière cohérente

• Renvoyez paginationKey dans l’objet de configuration pour récupérer la page suivante.
• Arrêtez-vous uniquement lorsque paginationKey vaut null. Une page peut être courte, voire vide, tout en étant suivie d’autres résultats.
• Conservez le même slot pour toutes les pages. Si vous omettez slot, chaque page lit le dernier slot indexé et vos pages peuvent provenir de différents moments.
• Définissez limit entre 1 et 5 000. La valeur par défaut est 5 000.

Encodages et données analysées

• Les encodages pris en charge sont base64 (par défaut), base64+zstd et jsonParsed. base58 et binary ne sont pas pris en charge.
• Les comptes de jetons jsonParsed utilisent le nombre de décimales du mint à la position interrogée. Les montants restent donc corrects même si le mint a changé depuis. Si le mint ne peut pas être lu à cette position, le compte utilise base64 comme solution de repli.
• dataSlice fonctionne de la même manière que dans getAccountInfo.

Niveau de confirmation

Erreurs

Questions fréquentes

Comment obtenir l’état d’un compte Solana à un slot précis ?

Puis-je lire un compte entre deux transactions du même slot ?

Jusqu’où puis-je remonter dans l’historique ?

Quelles offres incluent les méthodes de comptes historiques ?

Quelles sont les limites de débit ?

Comment obtenir tous les états passés d’un compte ?

Ai-je besoin d’un nouveau SDK ?

Étapes suivantes