Cách sử dụng getBalance

​

Trường hợp sử dụng chính

• Kiểm tra nhanh lượng SOL nắm giữ của một tài khoản: Mục đích chính là xác định lượng SOL mà một tài khoản (ví, chương trình, v.v.) đang nắm giữ.

​

Tham số

1. publicKey (chuỗi, bắt buộc): Khóa công khai được mã hóa base-58 của tài khoản cần truy vấn.
2. config (đối tượng, không bắt buộc): Đối tượng cấu hình có các trường sau:
   • commitment (chuỗi, không bắt buộc): Chỉ định mức cam kết dùng cho truy vấn. Giá trị mặc định là finalized.
     • finalized: Nút sẽ truy vấn khối mới nhất đã được cam kết vĩnh viễn. Nên ưu tiên giá trị này cho mã mới.
     • confirmed: Trong Alpenglow, tương đương với finalized; được giữ lại để đảm bảo khả năng tương thích.
     • processed: Nút sẽ truy vấn khối mới nhất của nó. Lưu ý rằng khối này có thể chưa hoàn chỉnh.
   • minContextSlot (số, không bắt buộc): Slot tối thiểu mà tại đó yêu cầu có thể được đánh giá.

​

Phản hồi

• context (đối tượng):
  • slot (số): Slot tại đó số dư được truy xuất.
  • apiVersion (chuỗi, không bắt buộc): Phiên bản API RPC (có thể không xuất hiện từ tất cả các nút).
• value (số): Số dư của tài khoản tính bằng lamport (số nguyên 64 bit không dấu).

​

Ví dụ: Truy xuất số dư tài khoản

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

​

Mẹo dành cho nhà phát triển

• Đơn giản khi truy vấn số dư SOL: Nếu bạn chỉ cần số dư SOL của một tài khoản và không cần dữ liệu nào khác trên chuỗi (như chủ sở hữu, dữ liệu hoặc trạng thái thực thi), getBalance hiệu quả hơn getAccountInfo vì truy xuất ít dữ liệu hơn.
• Tài khoản không tồn tại: Nếu một tài khoản không tồn tại trên chuỗi (chưa từng được khởi tạo hoặc chưa từng có SOL), getBalance sẽ trả về 0. Đây có thể là cách nhanh chóng để kiểm tra sự tồn tại của tài khoản nếu bạn chỉ quan tâm đến số dư SOL của tài khoản đó.
• Lamport và SOL: Hãy nhớ rằng số dư được trả về bằng lamport. Bạn cần chia cho LAMPORTS_PER_SOL (1.000.000.000) để chuyển đổi sang SOL.
• Mức cam kết: processed có thể hiển thị một số dư sau đó bị hoàn tác. Trong Alpenglow, confirmed và finalized cung cấp cùng một bảo đảm hoàn tất vĩnh viễn tại cùng một thời điểm; nên ưu tiên finalized cho mã mới.
• Gom nhóm bằng getMultipleAccounts: Mặc dù getBalance dùng cho một tài khoản, nếu cần số dư của nhiều tài khoản, việc sử dụng getMultipleAccounts rồi trích xuất số dư lamport từ thông tin của từng tài khoản có thể mang lại hiệu suất cao hơn so với nhiều lệnh gọi getBalance riêng lẻ.

​

Phương thức liên quan