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 akan dikueri, yang dikodekan dalam base-58.
2. config (objek, opsional): Objek konfigurasi dengan bidang 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 dikonfirmasi oleh supermayoritas klaster sebagai blok yang telah mencapai penguncian maksimum.
     • confirmed: Node akan mengueri blok terbaru yang telah mendapatkan suara dari supermayoritas klaster.
     • 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 API RPC (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, '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(())
}

​

Tips untuk Developer

• Kesederhanaan untuk Saldo SOL: Jika Anda hanya memerlukan saldo SOL akun tanpa data on-chain lainnya (seperti pemilik, data, atau status executable), 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 belum pernah memiliki SOL), getBalance akan mengembalikan 0. Ini dapat menjadi cara cepat untuk memeriksa keberadaan akun jika Anda hanya memerlukan informasi tentang 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: Pilihan commitment dapat memengaruhi seberapa cepat Anda mendapatkan saldo dan seberapa kuat saldo tersebut telah dikonfirmasi. Untuk sebagian besar kebutuhan tampilan UI, confirmed memberikan keseimbangan yang baik. Untuk transaksi keuangan penting, finalized memberikan tingkat kepastian tertinggi. Lihat Tingkat Komitmen Solana untuk informasi mendetail.
• 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 banyak panggilan getBalance secara terpisah.

​

Metode Terkait