Como Usar getBalance

​

Caso de Uso Principal

• Verificar Rapidamente o Saldo de SOL de uma Conta: O uso principal é determinar quanto SOL uma conta (carteira, programa, etc.) possui.

​

Parâmetros

1. publicKey (string, obrigatório): A chave pública codificada em base-58 da conta a ser consultada.
2. config (objeto, opcional): Um objeto de configuração com os seguintes campos:
   • commitment (string, opcional): Especifica o nível de compromisso a ser usado para a consulta. O padrão é finalized.
     • finalized: O nó consultará o bloco mais recente confirmado pela supermaioria do cluster como tendo atingido o bloqueio máximo.
     • confirmed: O nó consultará o bloco mais recente que foi votado por uma supermaioria do cluster.
     • processed: O nó consultará seu bloco mais recente. Note que o bloco pode não estar completo.
   • minContextSlot (número, opcional): O slot mínimo que a solicitação pode ser avaliada.

​

Resposta

• context (objeto):
  • slot (número): O slot em que o saldo foi recuperado.
  • apiVersion (string, opcional): A versão da API RPC (pode não estar presente em todos os nós).
• value (número): O saldo da conta em lamports (inteiro sem sinal de 64 bits).

​

Exemplo: Obtendo o Saldo de uma Conta

curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY -X POST -H "Content-Type: application/json" -d \
'{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getBalance",
  "params": [
    "9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin"
  ]
}'

const { Connection, PublicKey, LAMPORTS_PER_SOL } = require('@solana/web3.js');

async function checkBalance() {
  const rpcUrl = 'https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY'; // Replace YOUR_API_KEY
  const connection = new Connection(rpcUrl, 'confirmed');
  const accountPubKey = new PublicKey('9xQeWvG816bUx9EPjHmaT23yvVM2ZWbrrpZb9PusVFin');

  try {
    const lamports = await connection.getBalance(accountPubKey);
    const sol = lamports / LAMPORTS_PER_SOL;

    console.log(`Account PubKey: ${accountPubKey.toBase58()}`);
    console.log(`Balance (Lamports): ${lamports}`);
    console.log(`Balance (SOL): ${sol}`);

  } catch (error) {
    console.error('Error fetching balance:', error);
  }
}

checkBalance();

import { address, createSolanaRpc } from "@solana/kit";

const rpc_url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY";
const rpc = createSolanaRpc(rpc_url);

const publicKey = address("83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri");
const balance = await rpc.getBalance(publicKey).send();

console.log("Account Balance:", balance);

use anyhow::Result;
use solana_client::nonblocking::rpc_client::RpcClient;
use solana_sdk::{
    commitment_config::CommitmentConfig, native_token::LAMPORTS_PER_SOL, pubkey::Pubkey,
};
use std::str::FromStr;

#[tokio::main]
async fn main() -> Result<()> {
    let client = RpcClient::new_with_commitment(
        String::from("https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY"),
        CommitmentConfig::confirmed(),
    );

    let pubkey = Pubkey::from_str("83astBRguLMdt2h5U1Tpdq5tjFoJ6noeGwaY3mDLVcri")?;
    let balance = client.get_balance(&pubkey).await?;

    println!("{:#?} SOL", balance / LAMPORTS_PER_SOL);

    Ok(())
}

​

Dicas para Desenvolvedores

• Simplicidade para Saldo SOL: Se você precisa apenas do saldo SOL de uma conta e nenhum outro dado on-chain (como proprietário, dados ou status executável), getBalance é mais eficiente do que getAccountInfo pois busca menos dados.
• Contas Inexistentes: Se uma conta não existe on-chain (nunca foi inicializada ou teve SOL), getBalance retornará 0. Esta pode ser uma maneira rápida de verificar a existência da conta se você só se importa com seu saldo SOL.
• Lamports vs. SOL: Lembre-se de que o saldo é retornado em lamports. Você precisará dividir por LAMPORTS_PER_SOL (1.000.000.000) para convertê-lo para SOL.
• Níveis de Compromisso: A escolha de commitment pode afetar a rapidez com que você obtém o saldo e quão confirmado esse saldo está. Para a maioria dos propósitos de exibição em UI, confirmed oferece um bom equilíbrio. Para transações financeiras críticas, finalized fornece a maior garantia. Veja Níveis de Compromisso do Solana para informações detalhadas.
• Agrupamento com getMultipleAccounts: Enquanto getBalance é para uma única conta, se você precisar de saldos para muitas contas, usar getMultipleAccounts e então extrair o saldo lamport das informações de cada conta pode ser mais eficiente do que muitas chamadas individuais getBalance.

​

Métodos Relacionados