Metode RPC Solana getProgramAccountsV2

POST

getProgramAccountsV2

curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getProgramAccountsV2",
  "params": [
    "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
    {
      "encoding": "base64",
      "limit": 1000
    }
  ]
}
'

import requests

url = "https://mainnet.helius-rpc.com/?api-key="

payload = {
    "jsonrpc": "2.0",
    "id": "1",
    "method": "getProgramAccountsV2",
    "params": [
        "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
        {
            "encoding": "base64",
            "limit": 1000
        }
    ]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getProgramAccountsV2',
    params: [
      'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA',
      {encoding: 'base64', limit: 1000}
    ]
  })
};

fetch('https://mainnet.helius-rpc.com/?api-key=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://mainnet.helius-rpc.com/?api-key=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'jsonrpc' => '2.0',
    'id' => '1',
    'method' => 'getProgramAccountsV2',
    'params' => [
        'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA',
        [
                'encoding' => 'base64',
                'limit' => 1000
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://mainnet.helius-rpc.com/?api-key="

	payload := strings.NewReader("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": \"1\",\n  \"method\": \"getProgramAccountsV2\",\n  \"params\": [\n    \"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA\",\n    {\n      \"encoding\": \"base64\",\n      \"limit\": 1000\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://mainnet.helius-rpc.com/?api-key=")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": \"1\",\n  \"method\": \"getProgramAccountsV2\",\n  \"params\": [\n    \"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA\",\n    {\n      \"encoding\": \"base64\",\n      \"limit\": 1000\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://mainnet.helius-rpc.com/?api-key=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"jsonrpc\": \"2.0\",\n  \"id\": \"1\",\n  \"method\": \"getProgramAccountsV2\",\n  \"params\": [\n    \"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA\",\n    {\n      \"encoding\": \"base64\",\n      \"limit\": 1000\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "accounts": [
      {
        "pubkey": "CxELquR1gPP8wHe33gZ4QxqGB3sZ9RSwsJ2KshVewkFY",
        "account": {
          "lamports": 15298080,
          "owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
          "data": [
            "2R9jLfiAQ9bgdcw6h8s44439",
            "base64"
          ],
          "executable": false,
          "rentEpoch": 28,
          "space": 165
        }
      }
    ],
    "paginationKey": "8WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
  }
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32602,
    "message": "Parameter tidak valid",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32001,
    "message": "Tidak diotorisasi",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32005,
    "message": "Terlalu banyak permintaan",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32603,
    "message": "Kesalahan internal",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32002,
    "message": "Layanan tidak tersedia",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32003,
    "message": "Waktu tunggu gateway habis",
    "data": {}
  },
  "id": "1"
}

Ikhtisar

getProgramAccountsV2 adalah versi yang disempurnakan dari metode standar getProgramAccounts, yang dirancang untuk aplikasi yang perlu mengueri kumpulan besar akun milik program Solana tertentu secara efisien. Metode ini menyediakan paginasi berbasis kursor dan kemampuan pembaruan inkremental.

Fitur Baru di V2:

Paginasi berbasis kursor: Konfigurasikan batas dari 1 hingga 10.000 akun per permintaan
Pembaruan inkremental: Gunakan changedSinceSlot untuk mengambil hanya akun yang baru saja dimodifikasi
Performa lebih baik: Mencegah waktu habis dan mengurangi penggunaan memori untuk kumpulan data besar
Kompatibilitas mundur: Mendukung semua parameter getProgramAccounts yang ada
withContext opsional: true menambahkan slot dan apiVersion di bawah result.context; hilangkan atau gunakan false agar keduanya tidak disertakan

Manfaat Utama

Scalable Queries

Tangani program dengan jutaan akun melalui paginasi hasil yang efisien

Real-time Sync

Gunakan changedSinceSlot untuk pembaruan inkremental dan sinkronisasi data secara real-time

Prevent Timeouts

Kueri besar yang sebelumnya mengalami waktu habis kini berfungsi secara andal dengan paginasi

Memory Efficient

Proses data dalam beberapa bagian alih-alih memuat semuanya ke memori sekaligus

Praktik Terbaik Paginasi

Perilaku Paginasi Penting: Akhir paginasi hanya ditunjukkan ketika tidak ada akun yang dikembalikan. API dapat mengembalikan lebih sedikit akun daripada batas Anda karena pemfilteran—selalu lanjutkan paginasi hingga paginationKey adalah null.

Pola Paginasi Dasar

let allAccounts = [];
let paginationKey = null;

do {
  const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=${API_KEY}`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getProgramAccountsV2',
      params: [
        "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
        {
          encoding: 'base64',
          filters: [{ dataSize: 165 }],
          limit: 5000,
          ...(paginationKey && { paginationKey })
        }
      ]
    })
  });
  
  const data = await response.json();
  allAccounts.push(...data.result.accounts);
  paginationKey = data.result.paginationKey;
} while (paginationKey);

Pembaruan Inkremental

// Get only accounts modified since slot 150000000
const incrementalUpdate = await fetch(`https://mainnet.helius-rpc.com/?api-key=${API_KEY}`, {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getProgramAccountsV2',
    params: [
      programId,
      {
        encoding: 'jsonParsed',
        limit: 1000,
        changedSinceSlot: 150000000
      }
    ]
  })
});

Tips Performa

Ukuran Batas Optimal: Untuk sebagian besar kasus penggunaan, batas 1.000–5.000 akun per permintaan memberikan keseimbangan terbaik antara performa dan keandalan.

Mulai dengan batas yang lebih kecil (1000), lalu tingkatkan berdasarkan performa jaringan Anda
Gunakan pengodean yang sesuai: jsonParsed untuk kemudahan, base64 untuk performa
Terapkan filter untuk mengurangi ukuran kumpulan data sebelum paginasi
Simpan paginationKey untuk melanjutkan kueri jika terhenti
Pantau waktu respons dan sesuaikan batas sebagaimana diperlukan

`withContext` (opsional)

Nilai Boolean pada objek konfigurasi program (params[1]). Hanya bentuk result yang berubah, bukan filter, batas, atau paginasi.

// Omitted or false
{ "jsonrpc": "2.0", "id": "1", "result": { "accounts": [], "paginationKey": null } }

// true — snapshot metadata plus page under `result.value`
{ "jsonrpc": "2.0", "id": "1", "result": {
  "context": { "slot": 411895550, "apiVersion": "3.1.9" },
  "value": { "accounts": [], "paginationKey": null }
}}

Migrasi dari getProgramAccounts

Migrasi dari metode asli cukup mudah—cukup ganti nama metode dan tambahkan parameter paginasi:

{
  "jsonrpc": "2.0",
  "id": "1",
- "method": "getProgramAccounts",
+ "method": "getProgramAccountsV2",
  "params": [
    "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
    {
      "encoding": "base64",
      "filters": [{ "dataSize": 165 }],
+     "limit": 5000
    }
  ]
}

Metode Terkait

getProgramAccounts

Metode asli tanpa paginasi

getTokenAccountsByOwnerV2

Metode V2 untuk kueri akun token

Parameter Permintaan

string

wajib

Kunci publik (alamat) program Solana yang akunnya akan dikueri, dalam bentuk string yang dikodekan dengan base-58.

string

Tingkat komitmen untuk permintaan.

confirmed
finalized
processed

number

Slot minimum tempat permintaan dapat dievaluasi.

boolean

Jika true, mengembalikan result.context (metadata snapshot: slot, apiVersion) dan menempatkan accounts serta paginationKey di bawah result.value. Jika false atau dihilangkan, kolom tersebut muncul langsung pada result (misalnya result.accounts). Filter dan batas yang sama tetap berlaku.

string

Format pengodean untuk data akun yang dikembalikan.

jsonParsed
base58
base64
base64+zstd

object

Minta sebagian data akun.

number

Jumlah byte yang akan dikembalikan.

number

Offset byte tempat pembacaan dimulai.

number

Jumlah maksimum akun yang akan dikembalikan per permintaan (1–10.000).

string

Kursor paginasi yang dikodekan dengan base-58 untuk mengambil halaman berikutnya. Gunakan paginationKey dari respons sebelumnya.

number

Hanya kembalikan akun yang dimodifikasi pada atau setelah nomor slot ini. Berguna untuk pembaruan inkremental.

array

Sistem pemfilteran canggih untuk mengueri pola data akun Solana tertentu secara efisien.

Otorisasi

api-key

string

query

wajib

Kunci API Helius Anda. Anda dapat memperolehnya secara gratis di dasbor.

Body

application/json

jsonrpc

enum<string>

default:2.0

wajib

Versi protokol JSON-RPC.

Opsi yang tersedia:

2.0

Contoh:

"2.0"

string

default:1

wajib

Pengidentifikasi unik untuk permintaan.

Contoh:

"1"

method

enum<string>

default:getProgramAccountsV2

wajib

Nama metode RPC yang akan dipanggil.

Opsi yang tersedia:

getProgramAccountsV2

Contoh:

"getProgramAccountsV2"

params

(string | object)[]

wajib

Parameter untuk metode paginasi yang ditingkatkan.

Kunci publik (alamat) program Solana yang akunnya akan dikueri, sebagai string yang dikodekan dengan base-58.

Contoh:

"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"

Respons

Berhasil mengambil akun program yang dipaginasi.

jsonrpc

enum<string>

Versi protokol JSON-RPC.

Opsi yang tersedia:

2.0

Contoh:

"2.0"

string

Pengidentifikasi yang cocok dengan permintaan.

Contoh:

"1"

result

tanpa withContext · object

Akun program yang dipaginasi. Bidang yang sama muncul pada result saat withContext bernilai false atau dihilangkan, atau di bawah result.value saat withContext bernilai true.

tanpa withContext
dengan withContext

Show child attributes

⌘I

getProgramAccountsV2

curl --request POST \
  --url 'https://mainnet.helius-rpc.com/?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getProgramAccountsV2",
  "params": [
    "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
    {
      "encoding": "base64",
      "limit": 1000
    }
  ]
}
'

import requests

url = "https://mainnet.helius-rpc.com/?api-key="

payload = {
    "jsonrpc": "2.0",
    "id": "1",
    "method": "getProgramAccountsV2",
    "params": [
        "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
        {
            "encoding": "base64",
            "limit": 1000
        }
    ]
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getProgramAccountsV2',
    params: [
      'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA',
      {encoding: 'base64', limit: 1000}
    ]
  })
};

fetch('https://mainnet.helius-rpc.com/?api-key=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://mainnet.helius-rpc.com/?api-key=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'jsonrpc' => '2.0',
    'id' => '1',
    'method' => 'getProgramAccountsV2',
    'params' => [
        'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA',
        [
                'encoding' => 'base64',
                'limit' => 1000
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://mainnet.helius-rpc.com/?api-key="

	payload := strings.NewReader("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": \"1\",\n  \"method\": \"getProgramAccountsV2\",\n  \"params\": [\n    \"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA\",\n    {\n      \"encoding\": \"base64\",\n      \"limit\": 1000\n    }\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://mainnet.helius-rpc.com/?api-key=")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"2.0\",\n  \"id\": \"1\",\n  \"method\": \"getProgramAccountsV2\",\n  \"params\": [\n    \"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA\",\n    {\n      \"encoding\": \"base64\",\n      \"limit\": 1000\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://mainnet.helius-rpc.com/?api-key=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"jsonrpc\": \"2.0\",\n  \"id\": \"1\",\n  \"method\": \"getProgramAccountsV2\",\n  \"params\": [\n    \"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA\",\n    {\n      \"encoding\": \"base64\",\n      \"limit\": 1000\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "accounts": [
      {
        "pubkey": "CxELquR1gPP8wHe33gZ4QxqGB3sZ9RSwsJ2KshVewkFY",
        "account": {
          "lamports": 15298080,
          "owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
          "data": [
            "2R9jLfiAQ9bgdcw6h8s44439",
            "base64"
          ],
          "executable": false,
          "rentEpoch": 28,
          "space": 165
        }
      }
    ],
    "paginationKey": "8WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
  }
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32602,
    "message": "Parameter tidak valid",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32001,
    "message": "Tidak diotorisasi",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32005,
    "message": "Terlalu banyak permintaan",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32603,
    "message": "Kesalahan internal",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32002,
    "message": "Layanan tidak tersedia",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32003,
    "message": "Waktu tunggu gateway habis",
    "data": {}
  },
  "id": "1"
}

Memulai

Streaming Data & Pemantauan Peristiwa

API Data & RPC

Perdagangan

Mengirim Transaksi

Manajemen Akun

getProgramAccountsV2

Ikhtisar

Manfaat Utama

Scalable Queries

Real-time Sync

Prevent Timeouts

Memory Efficient

Praktik Terbaik Paginasi

Pola Paginasi Dasar

Pembaruan Inkremental

Tips Performa

`withContext` (opsional)

Migrasi dari getProgramAccounts

Metode Terkait

getProgramAccounts

getTokenAccountsByOwnerV2

Parameter Permintaan

Otorisasi

Body

Respons

​Ikhtisar

​Manfaat Utama

Scalable Queries

Real-time Sync

Prevent Timeouts

Memory Efficient

​Praktik Terbaik Paginasi

​Pola Paginasi Dasar

​Pembaruan Inkremental

​Tips Performa

​withContext (opsional)

​Migrasi dari getProgramAccounts

​Metode Terkait

getProgramAccounts

getTokenAccountsByOwnerV2

​Parameter Permintaan

Otorisasi

Body

Respons

Ikhtisar

Manfaat Utama

Praktik Terbaik Paginasi

Pola Paginasi Dasar

Pembaruan Inkremental

Tips Performa

`withContext` (opsional)

Migrasi dari getProgramAccounts

Metode Terkait

Parameter Permintaan