Método RPC getProgramAccountsV2 de Solana

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": "Parámetros no válidos",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32001,
    "message": "No autorizado",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32005,
    "message": "Demasiadas solicitudes",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32603,
    "message": "Error interno",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32002,
    "message": "Servicio no disponible",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32003,
    "message": "Tiempo de espera de la puerta de enlace agotado",
    "data": {}
  },
  "id": "1"
}

Descripción general

getProgramAccountsV2 es una versión mejorada del método estándar getProgramAccounts, diseñada para aplicaciones que necesitan consultar de manera eficiente grandes conjuntos de cuentas pertenecientes a programas específicos de Solana. Este método incorpora paginación basada en cursor y funciones de actualización incremental.

Nuevas funciones de V2:

Paginación basada en cursor: Configura límites de 1 a 10 000 cuentas por solicitud
Actualizaciones incrementales: Usa changedSinceSlot para obtener solo las cuentas modificadas recientemente
Mejor rendimiento: Evita tiempos de espera agotados y reduce el uso de memoria con conjuntos de datos grandes
Compatibilidad con versiones anteriores: Admite todos los parámetros existentes de getProgramAccounts
withContext opcional: true agrega slot y apiVersion dentro de result.context; omítelo o usa false para que no se incluyan

Beneficios principales

Consultas escalables

Gestiona programas con millones de cuentas mediante una paginación eficiente de los resultados

Sincronización en tiempo real

Usa changedSinceSlot para realizar actualizaciones incrementales y sincronizar datos en tiempo real

Evita tiempos de espera agotados

Las consultas grandes que antes agotaban el tiempo de espera ahora funcionan de manera confiable con la paginación

Uso eficiente de la memoria

Procesa los datos en bloques en lugar de cargar todo en la memoria de una sola vez

Prácticas recomendadas de paginación

Comportamiento importante de la paginación: El final de la paginación solo se indica cuando no se devuelve ninguna cuenta. La API puede devolver menos cuentas que el límite debido al filtrado. Continúa siempre la paginación hasta que paginationKey sea null.

Patrón básico de paginació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);

Actualizaciones incrementales

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

Consejos de rendimiento

Tamaño óptimo del límite: Para la mayoría de los casos de uso, un límite de entre 1000 y 5000 cuentas por solicitud ofrece el mejor equilibrio entre rendimiento y confiabilidad.

Comienza con límites más pequeños (1000) y auméntalos según el rendimiento de tu red
Usa la codificación adecuada: jsonParsed para mayor comodidad, base64 para mayor rendimiento
Aplica filtros para reducir el tamaño del conjunto de datos antes de la paginación
Guarda paginationKey para reanudar las consultas si se interrumpen
Supervisa los tiempos de respuesta y ajusta los límites según corresponda

`withContext` (opcional)

Valor booleano en el objeto de configuración del programa (params[1]). Solo cambia la estructura de result, no los filtros, los límites ni la paginación.

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

Migración desde getProgramAccounts

Migrar desde el método original es sencillo: solo reemplaza el nombre del método y agrega los parámetros de paginación:

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

Métodos relacionados

getProgramAccounts

Método original sin paginación

getTokenAccountsByOwnerV2

Método V2 para consultas de cuentas de tokens

Parámetros de la solicitud

string

requerido

La clave pública (dirección) del programa de Solana cuyas cuentas quieres consultar, como una cadena codificada en base 58.

string

El nivel de compromiso de la solicitud.

confirmed
finalized
processed

number

El slot mínimo en el que se puede evaluar la solicitud.

boolean

Cuando es true, devuelve result.context (metadatos de la instantánea: slot, apiVersion) y anida accounts y paginationKey dentro de result.value. Cuando es false o se omite, esos campos aparecen directamente en result (por ejemplo, result.accounts). Se aplican los mismos filtros y límites.

string

Formato de codificación de los datos de cuenta devueltos.

jsonParsed
base58
base64
base64+zstd

object

Solicita una sección de los datos de la cuenta.

number

Número de bytes que se devolverán.

number

Desplazamiento en bytes desde el que se comenzará a leer.

number

Número máximo de cuentas que se devolverán por solicitud (1-10 000).

string

Cursor de paginación codificado en base 58 para obtener las páginas siguientes. Usa el paginationKey de la respuesta anterior.

number

Devuelve únicamente las cuentas modificadas durante este número de slot o después. Es útil para las actualizaciones incrementales.

array

Potente sistema de filtrado para consultar de manera eficiente patrones específicos de datos de cuentas de Solana.

Autorizaciones

api-key

string

query

requerido

Tu clave de API de Helius. Puedes obtener una gratis en el panel.

Cuerpo

application/json

jsonrpc

enum<string>

predeterminado:2.0

requerido

La versión del protocolo JSON-RPC.

Opciones disponibles:

2.0

Ejemplo:

"2.0"

string

predeterminado:1

requerido

Un identificador único para la solicitud.

Ejemplo:

"1"

method

enum<string>

predeterminado:getProgramAccountsV2

requerido

El nombre del método RPC que se invocará.

Opciones disponibles:

getProgramAccountsV2

Ejemplo:

"getProgramAccountsV2"

params

(string | object)[]

requerido

Parámetros del método paginado mejorado.

La clave pública (dirección) del programa de Solana cuyas cuentas se consultarán, como una cadena codificada en base 58.

Ejemplo:

"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"

Respuesta

Las cuentas de programas paginadas se recuperaron correctamente.

jsonrpc

enum<string>

La versión del protocolo JSON-RPC.

Opciones disponibles:

2.0

Ejemplo:

"2.0"

string

Identificador que coincide con la solicitud.

Ejemplo:

"1"

result

sin withContext · object

Cuentas de programas paginadas. Los mismos campos aparecen en result cuando withContext es false o se omite, o en result.value cuando withContext es true.

sin withContext
con 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": "Parámetros no válidos",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32001,
    "message": "No autorizado",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32005,
    "message": "Demasiadas solicitudes",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32603,
    "message": "Error interno",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32002,
    "message": "Servicio no disponible",
    "data": {}
  },
  "id": "1"
}

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32003,
    "message": "Tiempo de espera de la puerta de enlace agotado",
    "data": {}
  },
  "id": "1"
}

Primeros pasos

Streaming de datos y escucha de eventos

API de datos y RPC

Trading

Envío de transacciones

Administración de cuentas

getProgramAccountsV2

Descripción general

Beneficios principales

Consultas escalables

Sincronización en tiempo real

Evita tiempos de espera agotados

Uso eficiente de la memoria

Prácticas recomendadas de paginación

Patrón básico de paginación

Actualizaciones incrementales

Consejos de rendimiento

`withContext` (opcional)

Migración desde getProgramAccounts

Métodos relacionados

getProgramAccounts

getTokenAccountsByOwnerV2

Parámetros de la solicitud

Autorizaciones

Cuerpo

Respuesta

​Descripción general

​Beneficios principales

Consultas escalables

Sincronización en tiempo real

Evita tiempos de espera agotados

Uso eficiente de la memoria

​Prácticas recomendadas de paginación

​Patrón básico de paginación

​Actualizaciones incrementales

​Consejos de rendimiento

​withContext (opcional)

​Migración desde getProgramAccounts

​Métodos relacionados

getProgramAccounts

getTokenAccountsByOwnerV2

​Parámetros de la solicitud

Autorizaciones

Cuerpo

Respuesta

Descripción general

Beneficios principales

Prácticas recomendadas de paginación

Patrón básico de paginación

Actualizaciones incrementales

Consejos de rendimiento

`withContext` (opcional)

Migración desde getProgramAccounts

Métodos relacionados

Parámetros de la solicitud