Solana 履歴アカウント API（ベータ版）

履歴アカウント状態とは？

• 監査、会計、税務申告のために、特定時点でのウォレットのトークン残高を確認する
• トランザクションの実行直前と直後に、そのトランザクションが操作したアカウントを読み取り、デバッグする
• 台帳を自分でリプレイせずに、過去のスロット時点におけるプール、ボールト、オラクルなどのプロトコルアカウントを読み取る

どのメソッドを使用すべきですか？

提供状況と料金

• プラン: Business プラン以上。
• コスト: ベータ期間中は 1 回の呼び出しにつき 0 クレジット（料金は変更される可能性があります）。
• レート制限: getHistoricalAccountInfo は 1 秒あたり 100 リクエスト、最大バースト 100 です。getHistoricalTokenAccountsByOwner は 1 秒あたり 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 のクエリに対して、スロット 444,999,837 のインデックス 700 にあるトランザクションが最後に書き込んだ状態が返されています。
• transactionIndex: null は、エポック報酬など、書き込みがトランザクション外で発生したことを意味します。
• transactionIndex: null を伴う slot: 444959999 は、履歴対象範囲の開始以降、アカウントが変更されていないことを意味します。そのスロットでアカウントが書き込まれたという意味ではありません。

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 アカウントの状態を取得するにはどうすればよいですか？

同じスロット内の 2 つのトランザクション間でアカウントを読み取れますか？

どこまで過去に遡ってクエリできますか？

履歴アカウントメソッドを利用できるプランはどれですか？

レート制限はいくつですか？

アカウントの過去のすべての状態を取得するにはどうすればよいですか？

新しい SDK は必要ですか？

次のステップ