Phương thức Solana RPC 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": "Tham số không hợp lệ",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32001,
    "message": "Không được phép",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32005,
    "message": "Quá nhiều yêu cầu",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32603,
    "message": "Lỗi nội bộ",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32002,
    "message": "Dịch vụ không khả dụng",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32003,
    "message": "Cổng kết nối hết thời gian chờ",
    "data": {}
  },
  "id": "1"
}

Tổng quan

getProgramAccountsV2 là phiên bản nâng cao của phương thức getProgramAccounts tiêu chuẩn, được thiết kế cho các ứng dụng cần truy vấn hiệu quả những tập hợp lớn gồm các tài khoản thuộc sở hữu của các chương trình Solana cụ thể. Phương thức này bổ sung khả năng phân trang dựa trên con trỏ và cập nhật tăng dần.

Các tính năng mới trong V2:

Phân trang dựa trên con trỏ: Định cấu hình giới hạn từ 1 đến 10.000 tài khoản cho mỗi yêu cầu
Cập nhật tăng dần: Sử dụng changedSinceSlot để chỉ truy xuất các tài khoản được sửa đổi gần đây
Hiệu suất tốt hơn: Ngăn lỗi hết thời gian chờ và giảm mức sử dụng bộ nhớ đối với các tập dữ liệu lớn
Khả năng tương thích ngược: Hỗ trợ tất cả tham số getProgramAccounts hiện có
withContext tùy chọn: true thêm slot và apiVersion trong result.context; nếu bỏ qua hoặc đặt là false thì các trường này sẽ không được đưa vào

Lợi ích chính

Scalable Queries

Xử lý các chương trình có hàng triệu tài khoản bằng cách phân trang kết quả hiệu quả

Real-time Sync

Sử dụng changedSinceSlot để cập nhật tăng dần và đồng bộ hóa dữ liệu theo thời gian thực

Prevent Timeouts

Các truy vấn lớn từng bị hết thời gian chờ giờ đây hoạt động ổn định nhờ tính năng phân trang

Memory Efficient

Xử lý dữ liệu theo từng phần thay vì tải toàn bộ dữ liệu vào bộ nhớ cùng lúc

Các phương pháp hay nhất về phân trang

Hành vi phân trang quan trọng: Điểm kết thúc phân trang chỉ được biểu thị khi không có tài khoản nào được trả về. API có thể trả về ít tài khoản hơn giới hạn do quá trình lọc — hãy luôn tiếp tục phân trang cho đến khi paginationKey là null.

Mẫu phân trang cơ bản

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);

Cập nhật tăng dần

// 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
      }
    ]
  })
});

Mẹo cải thiện hiệu suất

Kích thước giới hạn tối ưu: Trong hầu hết trường hợp sử dụng, giới hạn từ 1.000 đến 5.000 tài khoản cho mỗi yêu cầu mang lại sự cân bằng tốt nhất giữa hiệu suất và độ ổn định.

Bắt đầu với giới hạn nhỏ hơn (1000) rồi tăng lên dựa trên hiệu suất mạng
Sử dụng kiểu mã hóa phù hợp: jsonParsed để thuận tiện, base64 để tối ưu hiệu suất
Áp dụng bộ lọc để giảm kích thước tập dữ liệu trước khi phân trang
Lưu paginationKey để tiếp tục truy vấn nếu bị gián đoạn
Theo dõi thời gian phản hồi và điều chỉnh giới hạn cho phù hợp

`withContext` (tùy chọn)

Giá trị Boolean trong đối tượng cấu hình chương trình (params[1]). Chỉ cấu trúc của result thay đổi, còn bộ lọc, giới hạn và cách phân trang không thay đổi.

// 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 }
}}

Di chuyển từ getProgramAccounts

Việc di chuyển từ phương thức ban đầu rất đơn giản — chỉ cần thay thế tên phương thức và thêm các tham số phân trang:

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

Các phương thức liên quan

getProgramAccounts

Phương thức ban đầu không hỗ trợ phân trang

getTokenAccountsByOwnerV2

Phương thức V2 dành cho các truy vấn tài khoản token

Tham số yêu cầu

string

bắt buộc

Khóa công khai (địa chỉ) của chương trình Solana cần truy vấn tài khoản, dưới dạng chuỗi được mã hóa base-58.

string

Mức cam kết cho yêu cầu.

confirmed
finalized
processed

number

Slot tối thiểu mà tại đó yêu cầu có thể được đánh giá.

boolean

Khi là true, trả về result.context (siêu dữ liệu ảnh chụp nhanh: slot, apiVersion) và lồng accounts cùng paginationKey trong result.value. Khi là false hoặc bị bỏ qua, các trường đó xuất hiện trực tiếp trên result (ví dụ: result.accounts). Áp dụng cùng bộ lọc và giới hạn.

string

Định dạng mã hóa cho dữ liệu tài khoản được trả về.

jsonParsed
base58
base64
base64+zstd

object

Yêu cầu một phần dữ liệu của tài khoản.

number

Số byte cần trả về.

number

Độ lệch byte để bắt đầu đọc.

number

Số lượng tài khoản tối đa trả về trong mỗi yêu cầu (1–10.000).

string

Con trỏ phân trang được mã hóa base-58 để truy xuất các trang tiếp theo. Sử dụng paginationKey từ phản hồi trước đó.

number

Chỉ trả về các tài khoản đã được sửa đổi tại hoặc sau số slot này. Hữu ích cho các bản cập nhật tăng dần.

array

Hệ thống lọc mạnh mẽ để truy vấn hiệu quả các mẫu dữ liệu tài khoản Solana cụ thể.

Ủy quyền

api-key

string

query

bắt buộc

Khóa API Helius của bạn. Bạn có thể nhận khóa miễn phí trong bảng điều khiển.

Nội dung

application/json

jsonrpc

enum<string>

mặc định:2.0

bắt buộc

Phiên bản giao thức JSON-RPC.

Tùy chọn có sẵn:

2.0

Ví dụ:

"2.0"

string

mặc định:1

bắt buộc

Mã định danh duy nhất cho yêu cầu.

Ví dụ:

"1"

method

enum<string>

mặc định:getProgramAccountsV2

bắt buộc

Tên của phương thức RPC cần gọi.

Tùy chọn có sẵn:

getProgramAccountsV2

Ví dụ:

"getProgramAccountsV2"

params

(string | object)[]

bắt buộc

Các tham số cho phương thức phân trang nâng cao.

Khóa công khai (địa chỉ) của chương trình Solana cần truy vấn tài khoản, dưới dạng chuỗi được mã hóa base-58.

Ví dụ:

"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"

Phản hồi

Đã truy xuất thành công các tài khoản chương trình được phân trang.

jsonrpc

enum<string>

Phiên bản giao thức JSON-RPC.

Tùy chọn có sẵn:

2.0

Ví dụ:

"2.0"

string

Mã định danh khớp với yêu cầu.

Ví dụ:

"1"

result

không có withContext · object

Các tài khoản chương trình đã phân trang. Các trường tương tự xuất hiện trong result khi withContext là false hoặc bị bỏ qua, hoặc trong result.value khi withContext là true.

không có withContext
có 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": "Tham số không hợp lệ",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32001,
    "message": "Không được phép",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32005,
    "message": "Quá nhiều yêu cầu",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32603,
    "message": "Lỗi nội bộ",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32002,
    "message": "Dịch vụ không khả dụng",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32003,
    "message": "Cổng kết nối hết thời gian chờ",
    "data": {}
  },
  "id": "1"
}

Bắt đầu

Truyền phát dữ liệu & lắng nghe sự kiện

API dữ liệu & RPC

Giao dịch

Gửi giao dịch

Quản lý tài khoản

getProgramAccountsV2

Tổng quan

Lợi ích chính

Scalable Queries

Real-time Sync

Prevent Timeouts

Memory Efficient

Các phương pháp hay nhất về phân trang

Mẫu phân trang cơ bản

Cập nhật tăng dần

Mẹo cải thiện hiệu suất

`withContext` (tùy chọn)

Di chuyển từ getProgramAccounts

Các phương thức liên quan

getProgramAccounts

getTokenAccountsByOwnerV2

Tham số yêu cầu

Ủy quyền

Nội dung

Phản hồi

​Tổng quan

​Lợi ích chính

Scalable Queries

Real-time Sync

Prevent Timeouts

Memory Efficient

​Các phương pháp hay nhất về phân trang

​Mẫu phân trang cơ bản

​Cập nhật tăng dần

​Mẹo cải thiện hiệu suất

​withContext (tùy chọn)

​Di chuyển từ getProgramAccounts

​Các phương thức liên quan

getProgramAccounts

getTokenAccountsByOwnerV2

​Tham số yêu cầu

Ủy quyền

Nội dung

Phản hồi

Tổng quan

Lợi ích chính

Các phương pháp hay nhất về phân trang

Mẫu phân trang cơ bản

Cập nhật tăng dần

Mẹo cải thiện hiệu suất

`withContext` (tùy chọn)

Di chuyển từ getProgramAccounts

Các phương thức liên quan

Tham số yêu cầu