API исторических состояний аккаунтов Solana (бета-версия)

Что такое историческое состояние аккаунта?

• Проверять балансы токенов кошелька на определенный момент времени для аудита, бухгалтерского учета или налоговой отчетности
• Отлаживать транзакцию, считывая затронутые ею аккаунты непосредственно до и после ее выполнения
• Считывать аккаунты протокола, например пулы, хранилища или оракулы, в прошлом слоте без самостоятельного воспроизведения реестра

Какой метод использовать?

Доступность и цены

• Тарифы: Business и более высокие тарифы.
• Стоимость: 0 кредитов за вызов в период бета-тестирования (цены могут измениться).
• Ограничения частоты запросов: getHistoricalAccountInfo допускает 100 запросов в секунду с максимальным всплеском до 100. getHistoricalTokenAccountsByOwner допускает 10 запросов в секунду с максимальным всплеском до 10. Эти ограничения не зависят от ограничения частоты RPC-запросов вашего тарифа. При их превышении запросы возвращают HTTP 429. См. ограничения частоты запросов.
• Сеть: только Mainnet. Вызывайте методы через стандартную конечную точку Mainnet https://mainnet.helius-rpc.com или конечную точку Gatekeeper https://beta.helius-rpc.com. Devnet возвращает ошибку -32601.

Охват данных

Выбор позиции в истории

Чтение состояния до и после транзакции

• После транзакции: укажите в запросе ее собственные slot и transactionIndex.
• До транзакции: укажите в запросе тот же slot и значение transactionIndex, уменьшенное на 1. Если транзакция была первой в слоте (индекс 0), запросите предыдущий слот без 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" }
    ]
  }'

Описание lastUpdatedAt

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

• slot и transactionIndex указывают на последнюю запись в запрошенной позиции или перед ней. В приведенном выше примере запрос для слота 445,000,000 вернул состояние, которое в последний раз было записано транзакцией с индексом 700 в слоте 444,999,837.
• transactionIndex: null означает, что запись была выполнена вне транзакции, например при начислении вознаграждений за эпоху.
• slot: 444959999 с transactionIndex: null означает, что аккаунт не менялся с начала охвата истории. Это не означает, что аккаунт был записан в этом слоте.

Что означает значение null

• Ответ с null не содержит lastUpdatedAt, поэтому по нему нельзя определить, когда аккаунт был создан или закрыт. Чтобы найти эти транзакции, используйте getTransactionsForAddress.
• Адрес, который никогда не существовал, также возвращает null, а не ошибку.
• Слот до начала охвата истории возвращает ошибку -32018 для любого адреса независимо от того, существовал аккаунт или нет.

Обход истории аккаунта в обратном порядке

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
}

• Аккаунты, закрытые в настоящее время, возвращают null в последнем слоте. Передайте позицию start, относящуюся к моменту, когда аккаунт еще существовал.
• Записи вне транзакций переводят курсор к предыдущему слоту. Если тот же аккаунт ранее в этом слоте также был записан транзакцией, обход пропустит это состояние.
• Чтобы выполнить обход вперед во времени, получите список транзакций аккаунта от самых старых к самым новым с помощью getTransactionsForAddress и sortOrder: "asc". Затем считайте состояние в slot и transactionIndex каждой транзакции.

Контекст ответа

Согласованная пагинация

• Передайте paginationKey обратно в объекте конфигурации, чтобы получить следующую страницу.
• Останавливайтесь только тогда, когда paginationKey имеет значение null. Страница может быть неполной или пустой, но после нее могут оставаться дополнительные результаты.
• Зафиксируйте slot для всех страниц. Если не указать slot, каждая страница будет считывать последний проиндексированный слот, поэтому страницы могут относиться к разным моментам времени.
• Задайте limit в диапазоне от 1 до 5 000. Значение по умолчанию — 5 000.

Кодировки и разобранные данные

• Поддерживаемые кодировки: base64 (по умолчанию), base64+zstd и jsonParsed. base58 и binary не поддерживаются.
• Аккаунты токенов jsonParsed используют количество десятичных разрядов минта в запрошенной позиции, поэтому суммы остаются корректными, даже если с тех пор минт изменился. Если минт невозможно прочитать в этой позиции, аккаунт возвращается в формате base64.
• dataSlice работает так же, как в getAccountInfo.

Уровень подтверждения

Ошибки

Часто задаваемые вопросы

Как получить состояние аккаунта Solana в определенном слоте?

Можно ли прочитать аккаунт между двумя транзакциями в одном слоте?

Насколько далеко в прошлое можно выполнять запросы?

Какие тарифы включают методы исторических состояний аккаунтов?

Каковы ограничения частоты запросов?

Как получить все прошлые состояния аккаунта?

Нужен ли новый SDK?

Дальнейшие действия