Cómo usar getBalance

​

Caso de uso principal

• Consultar rápidamente las tenencias en SOL de una cuenta: El uso principal es determinar cuánto SOL tiene una cuenta (billetera, programa, etc.).

​

Parámetros

1. publicKey (cadena, obligatorio): La clave pública codificada en base 58 de la cuenta que se consultará.
2. config (objeto, opcional): Un objeto de configuración con los siguientes campos:
   • commitment (cadena, opcional): Especifica el nivel de compromiso que se usará para la consulta. El valor predeterminado es finalized.
     • finalized: El nodo consultará el bloque más reciente confirmado de forma permanente. Usa preferentemente este valor para código nuevo.
     • confirmed: En Alpenglow, equivale a finalized; se conserva por compatibilidad.
     • processed: El nodo consultará su bloque más reciente. Ten en cuenta que el bloque podría no estar completo.
   • minContextSlot (número, opcional): El slot mínimo en el que se puede evaluar la solicitud.

​

Respuesta

• context (objeto):
  • slot (número): El slot en el que se obtuvo el saldo.
  • apiVersion (cadena, opcional): La versión de la API RPC (puede no estar presente en todos los nodos).
• value (número): El saldo de la cuenta en lamports (entero sin signo de 64 bits).

​

Ejemplo: Obtener el saldo de una cuenta

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, 'finalized');
  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::finalized(),
    );

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

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

    Ok(())
}

​

Consejos para desarrolladores

• Simplicidad para consultar el saldo de SOL: Si solo necesitas el saldo de SOL de una cuenta y ningún otro dato en la cadena (como el propietario, los datos o el estado ejecutable), getBalance es más eficiente que getAccountInfo porque obtiene menos datos.
• Cuentas inexistentes: Si una cuenta no existe en la cadena (nunca se inicializó ni tuvo SOL), getBalance devolverá 0. Esta puede ser una forma rápida de comprobar si una cuenta existe cuando solo te interesa su saldo de SOL.
• Lamports frente a SOL: Recuerda que el saldo se devuelve en lamports. Tendrás que dividirlo entre LAMPORTS_PER_SOL (1,000,000,000) para convertirlo a SOL.
• Niveles de compromiso: processed puede mostrar un saldo que luego se revierta. En Alpenglow, confirmed y finalized ofrecen la misma garantía de finalidad permanente en el mismo punto; usa preferentemente finalized para código nuevo.
• Procesamiento por lotes con getMultipleAccounts: Aunque getBalance sirve para una sola cuenta, si necesitas los saldos de muchas cuentas, usar getMultipleAccounts y después extraer el saldo en lamports de la información de cada cuenta puede ofrecer un mejor rendimiento que realizar muchas llamadas individuales a getBalance.

​

Métodos relacionados