So verwendest du getBalance

​

Wichtigster Anwendungsfall

• SOL-Bestand eines Kontos schnell prüfen: Du kannst damit vor allem ermitteln, wie viel SOL ein Konto (Wallet, Programm usw.) hält.

​

Parameter

1. publicKey (String, erforderlich): Der Base58-codierte öffentliche Schlüssel des abzufragenden Kontos.
2. config (Objekt, optional): Ein Konfigurationsobjekt mit den folgenden Feldern:
   • commitment (String, optional): Gibt das commitment level für die Abfrage an. Der Standardwert ist finalized.
     • finalized: Der node fragt den neuesten Block ab, den eine Supermehrheit des cluster als vollständig gesperrt bestätigt hat.
     • confirmed: Der node fragt den neuesten Block ab, für den eine Supermehrheit des cluster gestimmt hat.
     • processed: Der node fragt seinen neuesten Block ab. Beachte, dass der Block möglicherweise noch nicht vollständig ist.
   • minContextSlot (Zahl, optional): Der minimale slot, bei dem der request ausgewertet werden kann.

​

Response

• context (Objekt):
  • slot (Zahl): Der slot, bei dem der Kontostand abgerufen wurde.
  • apiVersion (String, optional): Die RPC-API-Version (ist möglicherweise nicht bei allen nodes vorhanden).
• value (Zahl): Der Kontostand des Kontos in Lamports (vorzeichenlose 64-Bit-Ganzzahl).

​

Beispiel: Kontostand eines Kontos abrufen

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

​

Tipps für Entwickler

• Einfacher SOL-Kontostand: Wenn du nur den SOL-Kontostand eines Kontos und keine anderen On-Chain-Daten wie Besitzer, Daten oder Ausführbarkeitsstatus benötigst, ist getBalance effizienter als getAccountInfo, da es weniger Daten abruft.
• Nicht vorhandene Konten: Wenn ein Konto On-Chain nicht existiert, also nie initialisiert wurde oder SOL besaß, gibt getBalance den Wert 0 zurück. So kannst du schnell prüfen, ob ein Konto existiert, wenn dich nur sein SOL-Kontostand interessiert.
• Lamports und SOL: Beachte, dass der Kontostand in Lamports zurückgegeben wird. Teile ihn durch LAMPORTS_PER_SOL (1.000.000.000), um ihn in SOL umzurechnen.
• Commitment Levels: Die Wahl von commitment kann beeinflussen, wie schnell du den Kontostand erhältst und wie stark er bestätigt ist. Für die meisten Anzeigen in Benutzeroberflächen bietet confirmed einen guten Kompromiss. Bei kritischen Finanztransaktionen bietet finalized die höchste Sicherheit. Ausführliche Informationen findest du unter Solana Commitment Levels.
• Bündeln mit getMultipleAccounts: getBalance ist für ein einzelnes Konto vorgesehen. Wenn du Kontostände für viele Konten benötigst, kann es effizienter sein, getMultipleAccounts zu verwenden und anschließend den Lamport-Kontostand aus den Informationen jedes Kontos zu extrahieren, statt viele einzelne getBalance-Aufrufe auszuführen.

​

Verwandte Methoden