API Akun Historis Solana (Beta)

Apa itu status akun historis?

• Memeriksa saldo token dompet pada suatu titik waktu untuk audit, akuntansi, atau pelaporan pajak
• Men-debug transaksi dengan membaca akun yang disentuhnya tepat sebelum dan sesudah transaksi dijalankan
• Membaca akun protokol, seperti pool, vault, atau oracle, pada slot sebelumnya tanpa memutar ulang ledger sendiri

Metode mana yang harus saya gunakan?

Ketersediaan dan harga

• Paket: Paket Business dan yang lebih tinggi.
• Biaya: 0 kredit per panggilan selama beta (harga dapat berubah).
• Batas laju: getHistoricalAccountInfo mengizinkan 100 permintaan per detik, dengan burst maksimum 100. getHistoricalTokenAccountsByOwner mengizinkan 10 permintaan per detik, dengan burst maksimum 10. Batas ini terpisah dari batas laju RPC paket Anda, dan permintaan yang melampauinya akan menghasilkan HTTP 429. Lihat batas laju.
• Jaringan: Hanya Mainnet. Panggil metode tersebut pada endpoint mainnet standar, https://mainnet.helius-rpc.com, atau endpoint Gatekeeper, https://beta.helius-rpc.com. Devnet menghasilkan galat -32601.

Cakupan data

Memilih posisi dalam riwayat

Membaca status sebelum dan sesudah transaksi

• Setelah transaksi: kueri slot dan transactionIndex milik transaksi tersebut.
• Sebelum transaksi: kueri slot yang sama dengan transactionIndex dikurangi 1. Jika transaksi tersebut merupakan transaksi pertama dalam slotnya (indeks 0), kueri slot sebelumnya tanpa 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" }
    ]
  }'

Memahami lastUpdatedAt

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

• slot dan transactionIndex menunjuk ke penulisan terakhir pada atau sebelum posisi yang Anda kueri. Dalam contoh di atas, kueri untuk slot 445,000,000 mengembalikan status yang terakhir ditulis oleh transaksi pada indeks 700 di slot 444,999,837.
• transactionIndex: null berarti penulisan terjadi di luar transaksi, seperti reward epoch.
• slot: 444959999 dengan transactionIndex: null berarti akun belum berubah sejak awal cakupan riwayat. Ini tidak berarti akun ditulis dalam slot tersebut.

Arti nilai null

• Respons null tidak memiliki lastUpdatedAt, sehingga respons tersebut tidak memberi tahu kapan akun dibuat atau ditutup. Untuk menemukan transaksi tersebut, gunakan getTransactionsForAddress.
• Alamat yang tidak pernah ada juga mengembalikan null, bukan galat.
• Slot sebelum cakupan riwayat menghasilkan galat -32018 untuk setiap alamat, baik akun tersebut pernah ada maupun tidak.

Menelusuri mundur riwayat akun

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
}

• Akun yang sekarang sudah ditutup mengembalikan null pada slot terbaru. Berikan posisi start dari saat akun masih ada.
• Penulisan nontransaksi mundur ke slot sebelumnya. Jika akun yang sama juga ditulis oleh transaksi pada awal slot tersebut, penelusuran akan melewati status itu.
• Untuk menelusuri maju dalam waktu, cantumkan transaksi akun dari yang paling lama terlebih dahulu dengan getTransactionsForAddress dan sortOrder: "asc". Kemudian baca status pada slot dan transactionIndex setiap transaksi.

Konteks respons

Melakukan paginasi secara konsisten

• Kirim kembali paginationKey dalam objek konfigurasi untuk mengambil halaman berikutnya.
• Berhenti hanya ketika paginationKey bernilai null. Sebuah halaman dapat memiliki sedikit hasil, atau kosong, tetapi masih memiliki hasil lainnya setelah halaman tersebut.
• Tetapkan slot yang sama di setiap halaman. Jika Anda menghilangkan slot, setiap halaman akan membaca slot terbaru yang telah diindeks, dan halaman Anda dapat berasal dari titik waktu yang berbeda.
• Atur limit antara 1 dan 5.000. Nilai default-nya adalah 5.000.

Enkode dan data yang diurai

• Enkode yang didukung adalah base64 (default), base64+zstd, dan jsonParsed. base58 dan binary tidak didukung.
• Akun token jsonParsed menggunakan jumlah desimal mint pada posisi yang dikueri, sehingga jumlahnya tetap benar meskipun mint telah berubah sejak saat itu. Jika mint tidak dapat dibaca pada posisi tersebut, akun akan kembali menggunakan base64.
• dataSlice berfungsi dengan cara yang sama seperti dalam getAccountInfo.

Komitmen

Galat

Pertanyaan umum

Bagaimana cara mendapatkan status akun Solana pada slot tertentu?

Dapatkah saya membaca akun di antara dua transaksi dalam slot yang sama?

Seberapa jauh ke belakang saya dapat melakukan kueri?

Paket mana yang menyertakan metode akun historis?

Berapa batas lajunya?

Bagaimana cara mendapatkan setiap status akun sebelumnya?

Apakah saya memerlukan SDK baru?

Langkah berikutnya