RPC e subscriptions

JSON-RPC HTTP tipado e subscriptions WebSocket com @solana/kit 7.0.0.

Receita

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

import { createSolanaRpc, createSolanaRpcSubscriptions, address } from "@solana/kit";
 
const rpc = createSolanaRpc(process.env.RPC_URL!);
const balance = await rpc.getBalance(address("PUBKEY")).send();
 
const ws = createSolanaRpcSubscriptions(process.env.RPC_WSS_URL!);

Quando usar:

• Qualquer leitura on-chain a partir de TypeScript (saldos, contas, blocos).
• Atualizações de UI ao vivo via subscriptions de conta ou assinatura.
• Leituras server-side em route handlers Next.js.
• Substituir chamadas fetch não tipadas para JSON-RPC.

Exemplo prático

import { createSolanaRpc, createSolanaRpcSubscriptions, address } from "@solana/kit";
 
const rpc = createSolanaRpc("https://api.devnet.solana.com");
const rpcSubscriptions = createSolanaRpcSubscriptions("wss://api.devnet.solana.com");
 
async function watchBalance(owner: string) {
  const acct = address(owner);
  const { value } = await rpc.getBalance(acct).send();
  console.log("initial", value);
 
  const abort = new AbortController();
  const stream = await rpcSubscriptions
    .accountNotifications(acct, { commitment: "confirmed" })
    .subscribe({ abortSignal: abort.signal });
 
  for await (const n of stream) {
    console.log("update", n.value.lamports);
  }
}

O que isso demonstra:

• RPC HTTP para leituras pontuais com .send().
• URL WSS correspondente para notificações push.
• AbortController para limpeza.

Mergulho profundo

Como funciona

• createSolanaRpc encapsula JSON-RPC 2.0 com métodos e respostas tipados.
• createSolanaRpcSubscriptions abre WebSocket e expõe notificações async iterable.
• Commitment nas chamadas controla obsolescência vs finalidade.
• URLs de provedor frequentemente embutem API keys como query params.

Métodos RPC comuns

Notas TypeScript

// Passe commitment em leituras que alimentam UI de tesouraria
await rpc.getBalance(owner, { commitment: "finalized" }).send();

Erros comuns

• URL HTTP no cliente WebSocket - conexão falha silenciosamente ou lança erro. Correção: use wss:// da documentação do provedor.
• Limites de taxa de RPC público - 429 sob carga. Correção: endpoint dedicado devnet/mainnet.
• Vazamento de subscriptions - abas abertas esgotam limites do provedor. Correção: abort no unmount.
• Assumir DAS em todo RPC - getAsset precisa de hosts com DAS. Correção: matriz de capacidades por vendor.
• Pular .send() - builders RPC são lazy até enviar. Correção: sempre encadeie .send().

Alternativas

FAQs

Relacionados

• Noções básicas de RPC - commitment e clusters
• Noções básicas do @solana/kit - primer kit
• Assinatura e envio - caminho de submissão

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.