API de cuentas históricas de Solana (Beta)

¿Qué es el estado histórico de una cuenta?

• Consultar los saldos de tokens de una billetera en un momento determinado para auditorías, contabilidad o declaraciones de impuestos
• Depurar una transacción leyendo las cuentas que modificó justo antes y después de su ejecución
• Leer las cuentas de un protocolo, como pools, bóvedas u oráculos, en un slot anterior sin tener que reproducir el libro mayor

¿Qué método debo usar?

Disponibilidad y precios

• Planes: planes Business y superiores.
• Costo: 0 créditos por llamada durante la beta (los precios están sujetos a cambios).
• Límites de solicitudes: getHistoricalAccountInfo permite 100 solicitudes por segundo, con una ráfaga máxima de 100. getHistoricalTokenAccountsByOwner permite 10 solicitudes por segundo, con una ráfaga máxima de 10. Estos límites son independientes del límite de solicitudes RPC de tu plan, y las solicitudes que los superen devuelven HTTP 429. Consulta límites de solicitudes.
• Red: solo Mainnet. Llámalos en el endpoint estándar de mainnet, https://mainnet.helius-rpc.com, o en el endpoint de Gatekeeper, https://beta.helius-rpc.com. Devnet devuelve el error -32601.

Cobertura de datos

Elige una posición en el historial

Lee el estado antes y después de una transacción

• Después de la transacción: consulta sus propios slot e transactionIndex.
• Antes de la transacción: consulta el mismo slot con transactionIndex menos 1. Si la transacción es la primera de su slot (índice 0), consulta el slot anterior sin 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" }
    ]
  }'

Comprende lastUpdatedAt

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

• slot e transactionIndex apuntan a la última escritura en la posición consultada o antes de ella. En el ejemplo anterior, una consulta del slot 445,000,000 devolvió el estado escrito por última vez por la transacción en el índice 700 del slot 444,999,837.
• transactionIndex: null significa que la escritura ocurrió fuera de una transacción, como en el caso de las recompensas de época.
• slot: 444959999 con transactionIndex: null significa que la cuenta no ha cambiado desde que comenzó la cobertura del historial. No significa que la cuenta se haya escrito en ese slot.

Qué significa un valor null

• Una respuesta null no tiene lastUpdatedAt, por lo que no indica cuándo se creó o cerró la cuenta. Para encontrar esas transacciones, usa getTransactionsForAddress.
• Una dirección que nunca existió también devuelve null, no un error.
• Un slot anterior a la cobertura del historial devuelve el error -32018 para todas las direcciones, sin importar si la cuenta existía.

Recorre hacia atrás el historial de una cuenta

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
}

• Las cuentas que ahora están cerradas devuelven null en el último slot. Pasa una posición start correspondiente a cuando la cuenta todavía existía.
• Las escrituras ajenas a una transacción retroceden al slot anterior. Si una transacción también escribió en la misma cuenta anteriormente en ese slot, el recorrido omite ese estado.
• Para avanzar en el tiempo, enumera primero las transacciones más antiguas de la cuenta con getTransactionsForAddress e sortOrder: "asc". Luego, lee el estado en los valores slot e transactionIndex de cada transacción.

Contexto de la respuesta

Pagina de forma consistente

• Vuelve a pasar paginationKey en el objeto de configuración para obtener la página siguiente.
• Detente solo cuando paginationKey sea null. Una página puede ser corta o estar vacía y aun así tener más resultados después.
• Fija slot en todas las páginas. Si omites slot, cada página lee el último slot indexado y tus páginas pueden provenir de distintos momentos.
• Configura limit entre 1 y 5,000. El valor predeterminado es 5,000.

Codificaciones y datos analizados

• Las codificaciones compatibles son base64 (la predeterminada), base64+zstd e jsonParsed. base58 e binary no son compatibles.
• Las cuentas de tokens jsonParsed usan los decimales de la acuñación en la posición consultada, por lo que las cantidades son correctas aunque la acuñación haya cambiado desde entonces. Si la acuñación no puede leerse en esa posición, la cuenta usa base64 como alternativa.
• dataSlice funciona de la misma manera que en getAccountInfo.

Compromiso

Errores

Preguntas frecuentes

¿Cómo obtengo el estado de una cuenta de Solana en un slot específico?

¿Puedo leer una cuenta entre dos transacciones del mismo slot?

¿Hasta qué momento del pasado puedo consultar?

¿Qué planes incluyen los métodos de cuentas históricas?

¿Cuáles son los límites de solicitudes?

¿Cómo obtengo todos los estados anteriores de una cuenta?

¿Necesito un SDK nuevo?

Siguientes pasos