Core RPC Methods

Os métodos de leitura essenciais que todo cliente Solana usa: informações de conta, saldos, scans de programa e buscas em lote.

Receita

Cartão de receita para referência rápida - pronto para copiar e colar.

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

Quando usar:

• Hidratar UI com saldos de carteira e token.
• Buscar uma conta de config única do seu programa.
• Carregar em lote contas NFT/token para galeria.
• Escanear contas owned por programa (com filtros - veja página GPA).

Exemplo Prático

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

O que isso demonstra:

• getBalance retorna lamports para carteiras system-owned.
• getAccountInfo retorna owner, lamports, dados, flag executable.
• getMultipleAccounts agrupa até limites do provedor em um round trip RPC.

Aprofundamento

Como funciona

• Todos os métodos são POSTs JSON-RPC com opções commitment e encoding.
• Encoding base64 é padrão para dados binários de programa; jsonParsed funciona para alguns programas SPL em nós que suportam.
• getProgramAccounts sem filtros escaneia todo o espaço do programa - caro na mainnet.
• value null significa que a conta não existe no commitment escolhido.

Resumo de métodos

Notas TypeScript

// Prefer address() helper for base58 pubkeys
import { address, assertIsAddress } from "@solana/kit";
 
const mint = address("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v");
assertIsAddress(mint);

Erros comuns

• GPA sem filtro na mainnet - timeouts e 429s. Correção: filtros memcmp/dataSize ou indexer (getProgramAccounts & Filters).
• Assumir que conta existe - value: null quebra parsers ingênuos. Correção: verifique null antes de decodificar.
• jsonParsed em todo lugar - nem todos os programas suportados. Correção: decodifique com seu IDL a partir de base64.
• Arrays de lote enormes - provedores limitam comprimento de getMultipleAccounts. Correção: divida em lotes de 100 ou conforme docs do provedor.
• Commitment obsoleto após envio - UI mostra saldo antigo até refresh confirmed. Correção: polling ou assinatura após transações.

Alternativas

FAQs

Relacionados

• RPC Basics - commitment e transporte
• getProgramAccounts & Filters - scans filtrados
• Pagination & Efficiency - padrões de lote
• The DAS API - leituras específicas de ativos

Versões da stack: Esta página foi 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 e LiteSVM 0.6.x.