Cara Menggunakan getBalance

​

Kasus Penggunaan Utama

• Memeriksa Kepemilikan SOL Akun dengan Cepat: Penggunaan utamanya adalah untuk mengetahui jumlah SOL yang dimiliki sebuah akun (dompet, program, dan sebagainya).

​

Parameter

1. publicKey (string, wajib): Kunci publik akun yang dienkode dengan base-58 untuk dikueri.
2. config (objek, opsional): Objek konfigurasi dengan kolom berikut:
   • commitment (string, opsional): Menentukan tingkat komitmen yang akan digunakan untuk kueri. Nilai default-nya adalah finalized.
     • finalized: Node akan mengueri blok terbaru yang telah dikomit secara permanen. Pilih nilai ini untuk kode baru.
     • confirmed: Dalam Alpenglow, setara dengan finalized; dipertahankan untuk kompatibilitas.
     • processed: Node akan mengueri blok terbarunya. Perhatikan bahwa blok tersebut mungkin belum lengkap.
   • minContextSlot (angka, opsional): Slot minimum tempat permintaan dapat dievaluasi.

​

Respons

• context (objek):
  • slot (angka): Slot tempat saldo diambil.
  • apiVersion (string, opsional): Versi RPC API (mungkin tidak tersedia dari semua node).
• value (angka): Saldo akun dalam lamport (bilangan bulat 64-bit tanpa tanda).

​

Contoh: Mengambil Saldo Akun

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

​

Tips untuk Developer

• Kesederhanaan untuk Saldo SOL: Jika Anda hanya memerlukan saldo SOL suatu akun tanpa data on-chain lainnya (seperti pemilik, data, atau status yang dapat dieksekusi), getBalance lebih efisien daripada getAccountInfo karena mengambil lebih sedikit data.
• Akun yang Tidak Ada: Jika akun tidak ada secara on-chain (belum pernah diinisialisasi atau memiliki SOL), getBalance akan mengembalikan 0. Ini dapat menjadi cara cepat untuk memeriksa keberadaan akun jika Anda hanya memedulikan saldo SOL-nya.
• Lamport vs. SOL: Ingat bahwa saldo dikembalikan dalam lamport. Anda perlu membaginya dengan LAMPORTS_PER_SOL (1.000.000.000) untuk mengonversinya menjadi SOL.
• Tingkat Komitmen: processed dapat menampilkan saldo yang kemudian dibatalkan. Dalam Alpenglow, confirmed dan finalized memberikan jaminan finalitas permanen yang sama pada titik yang sama; pilih finalized untuk kode baru.
• Pemrosesan Batch dengan getMultipleAccounts: Meskipun getBalance ditujukan untuk satu akun, jika Anda memerlukan saldo banyak akun, menggunakan getMultipleAccounts lalu mengekstrak saldo lamport dari informasi setiap akun dapat memberikan performa yang lebih baik daripada melakukan banyak panggilan getBalance secara terpisah.

​

Metode Terkait