Métodos RPC Principales

Los métodos de lectura esenciales que usa todo cliente de Solana: información de cuenta, saldos, escaneos de programas y búsquedas por lotes.

Receta

Tarjeta de receta de referencia rápida, lista para copiar y pegar.

import { createSolanaRpc, address } from "@solana/kit";
 
const rpc = createSolanaRpc("https://api.devnet.solana.com");
 
await rpc.getAccountInfo(pubkey, { encoding: "base64" }).send();
await rpc.getBalance(pubkey).send();
await rpc.getMultipleAccounts([pk1, pk2]).send();
await rpc.getProgramAccounts(programId, { encoding: "base64" }).send();

Cuándo usar esto:

• Para poblar la interfaz de usuario con saldos de billetera y tokens.
• Para obtener una única cuenta de configuración para tu programa.
• Para cargar por lotes cuentas de NFT/tokens para una vista de galería.
• Para escanear cuentas propiedad del programa (con filtros - ver página de GPA).

Ejemplo de Trabajo

import { createSolanaRpc, address } from "@solana/kit";
 
const rpc = createSolanaRpc("https://api.devnet.solana.com");
 
const SYSTEM_PROGRAM = address("11111111111111111111111111111111");
const wallet = address("YOUR_WALLET_PUBKEY");
 
const [balance, accountInfo, multi] = await Promise.all([
  rpc.getBalance(wallet, { commitment: "confirmed" }).send(),
  rpc.getAccountInfo(SYSTEM_PROGRAM, { encoding: "base64" }).send(),
  rpc.getMultipleAccounts([wallet, SYSTEM_PROGRAM], {
    commitment: "confirmed",
    encoding: "base64",
  }).send(),
]);
 
console.log({
  lamports: balance.value,
  systemExecutable: accountInfo.value?.executable,
  multiCount: multi.value?.length,
});

Lo que esto demuestra:

• getBalance devuelve lamports para billeteras propiedad del sistema.
• getAccountInfo devuelve propietario, lamports, datos, indicador de ejecutable.
• getMultipleAccounts agrupa hasta los límites del proveedor en un solo viaje de ida y vuelta de RPC.

Análisis Profundo

Cómo Funciona

• Todos los métodos son POSTs JSON-RPC con opciones de commitment y encoding.
• La codificación base64 es estándar para datos binarios de programas; jsonParsed funciona para algunos programas SPL en nodos compatibles.
• getProgramAccounts sin filtros escanea todo el espacio del programa - costoso en mainnet.
• Un value nulo significa que la cuenta no existe con el compromiso elegido.

Resumen de Métodos

Notas de TypeScript

// Prefiere el ayudante address() para claves base58
import { address, assertIsAddress } from "@solana/kit";
 
const mint = address("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
assertIsAddress(mint);

Trampas

• GPA sin filtrar en mainnet - tiempos de espera y 429s. Solución: filtros memcmp/dataSize (getProgramAccounts y Filtros).
• Asumir que la cuenta existe - value: null bloquea analizadores ingenuos. Solución: verifica si es nulo antes de decodificar.
• jsonParsed en todas partes - no todos los programas son compatibles. Solución: decodifica con tu IDL desde base64.
• Matrices de lotes enormes - los proveedores limitan la longitud de getMultipleAccounts. Solución: divide en lotes de 100 o según la documentación del proveedor.
• Compromiso obsoleto después de enviar - la interfaz de usuario muestra el saldo antiguo hasta la actualización de confirmed. Solución: sondea o suscríbete después de las transacciones.

Alternativas

Preguntas Frecuentes

Relacionado

• Conceptos Básicos de RPC - compromiso y transporte
• getProgramAccounts y Filtros - escaneos filtrados
• Paginación y Eficiencia - patrones de agrupación
• La API DAS - lecturas específicas de activos

Versiones de la pila: Esta página fue escrita para Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0, y LiteSVM 0.6.x.