Cara Menggunakan getTokenAccountBalance

​

Kasus Penggunaan Umum

• Menampilkan Saldo Token Pengguna: Menunjukkan kepada pengguna jumlah token tertentu yang mereka miliki dalam dompet mereka (akun token terkait).
• Memverifikasi Ketersediaan Token: Memeriksa apakah akun token memiliki saldo yang cukup sebelum mencoba transfer atau operasi lainnya.
• Melacak Portofolio: Menggabungkan saldo token pengguna dari berbagai akun token.
• Interaksi Kontrak Pintar: Kontrak pintar mungkin meminta saldo token sebagai bagian dari logikanya (meskipun program on-chain biasanya mengakses data ini langsung dari informasi akun).

​

Parameter Permintaan

1. Kunci Publik Akun Token (string, wajib): Kunci publik akun SPL Token yang dienkode dengan base-58 dan ingin Anda kueri.
2. Objek Konfigurasi (object, opsional): Objek opsional yang dapat memuat bidang berikut:
   • commitment (string, opsional): Menentukan tingkat komitmen untuk kueri. Jika dihilangkan, komitmen default dari node RPC akan digunakan (biasanya finalized).

​

Struktur Respons

• amount (string): Saldo mentah akun token sebagai string. Ini adalah bilangan bulat yang merepresentasikan unit terkecil token (misalnya, jika token memiliki 6 tempat desimal, jumlah “1000000” berarti 1 token).
• decimals (u8): Jumlah tempat desimal yang ditentukan untuk jenis token ini (oleh mint-nya).
• uiAmount (number | null): Saldo yang diformat sebagai angka titik mengambang dengan memperhitungkan decimals. Dalam beberapa konteks, bidang ini mungkin bernilai null atau sudah tidak digunakan dan digantikan oleh uiAmountString.
• uiAmountString (string): Saldo yang diformat sebagai string dengan memperhitungkan decimals. Format ini sering lebih disarankan untuk ditampilkan guna menghindari potensi ketidakakuratan titik mengambang.

{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "slot": 183457201
    },
    "value": {
      "amount": "500000000",
      "decimals": 9,
      "uiAmount": 0.5,
      "uiAmountString": "0.5"
    }
  },
  "id": 1
}

​

Contoh Kode

# Basic Request (replace <TOKEN_ACCOUNT_PUBKEY>):
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTokenAccountBalance",
    "params": [
      "<TOKEN_ACCOUNT_PUBKEY>"
    ]
  }' \
  <YOUR_RPC_URL>

# Request with commitment (replace <TOKEN_ACCOUNT_PUBKEY>):
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTokenAccountBalance",
    "params": [
      "<TOKEN_ACCOUNT_PUBKEY>",
      {
        "commitment": "confirmed"
      }
    ]
  }' \
  <YOUR_RPC_URL>

const { Connection, PublicKey } = require('@solana/web3.js');

async function checkTokenBalance(tokenAccountPublicKey) {
  // Replace with your RPC endpoint
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  
  try {
    const tokenAccountPubKey = new PublicKey(tokenAccountPublicKey);
    const balance = await connection.getTokenAccountBalance(tokenAccountPubKey);

    if (!balance.value) {
        console.log(`Could not find token account: ${tokenAccountPublicKey}`);
        return;
    }

    console.log(`Token Account: ${tokenAccountPublicKey}`);
    console.log(`Raw Amount: ${balance.value.amount}`);
    console.log(`Decimals: ${balance.value.decimals}`);
    console.log(`UI Amount (string): ${balance.value.uiAmountString}`);
    // console.log(JSON.stringify(balance, null, 2)); // For full response details

  } catch (error) {
    console.error(`Error fetching token account balance for ${tokenAccountPublicKey}:`, error);
  }
}

// Replace with an actual SPL Token Account Public Key
const exampleTokenAccount = 'HHisAGTT6ADDd52jY1g65Akn3N2f4jSdQS2rTiyDEw5c'; // Example: An account holding some USDC on mainnet
checkTokenBalance(exampleTokenAccount);

// Example for a token account that might not exist or have 0 balance
// const nonExistentAccount = '11111111111111111111111111111111'; 
// checkTokenBalance(nonExistentAccount);

​

Tips untuk Developer

• Akun Token vs. Akun Mint vs. Akun Pemilik: Pastikan Anda memberikan kunci publik Akun SPL Token, bukan alamat mint token atau alamat dompet pemilik. Anda biasanya mendapatkan akun token milik seorang pemilik menggunakan getTokenAccountsByOwner.
• Desimal: Selalu gunakan bidang decimals untuk menafsirkan amount dengan benar. uiAmountString umumnya lebih aman untuk ditampilkan daripada uiAmount guna menghindari masalah presisi titik mengambang.
• Akun yang Tidak Ada: Jika kunci publik yang diberikan tidak sesuai dengan akun token yang ada, perilakunya mungkin sedikit berbeda menurut penyedia atau pustaka RPC. Namun, value dalam respons sering kali akan bernilai null atau sebuah galat akan dilemparkan. Contoh JavaScript mencakup pemeriksaan dasar untuk balance.value.
• Tingkat Komitmen: processed dapat menampilkan perubahan saldo yang kemudian dibatalkan. Di bawah Alpenglow, confirmed dan finalized memiliki latensi dan jaminan finalitas permanen yang sama; pilih finalized untuk kode baru.

​

Metode Terkait