Cara Menggunakan getTokenSupply

​

Kasus Penggunaan Umum

• Menampilkan Informasi Token: Menampilkan total suplai token pada penjelajah atau di antarmuka dompet.
• Analisis Tokenomik: Memahami jumlah maksimum atau total penerbitan token saat ini.
• Verifikasi: Memeriksa suplai token sebagaimana dilaporkan oleh akun mint itu sendiri.
• Memantau Perubahan Suplai: Jika token dapat dicetak, metode ini dapat digunakan untuk melacak perubahan total suplainya dari waktu ke waktu (meskipun untuk token yang dapat dipertukarkan, suplai biasanya tetap atau dikelola oleh otoritas pencetakan).

​

Parameter Permintaan

1. mintAddress (string, wajib): Kunci publik akun mint token yang dienkode dengan base-58 dan total suplainya ingin Anda kueri.
2. options (object, opsional): Objek konfigurasi opsional yang dapat mencakup:
   • commitment (string, opsional): Menentukan tingkat commitment untuk kueri (misalnya, "finalized", "confirmed", "processed").

​

Struktur Respons

• amount (string): Total suplai token dalam denominasi terkecilnya (jumlah mentah), dalam bentuk string. Nilai ini tidak disesuaikan dengan jumlah desimal.
• decimals (u8): Jumlah tempat desimal yang ditetapkan untuk mint token ini. Nilai ini sangat penting untuk mengonversi amount mentah ke format yang mudah dibaca manusia.
• uiAmount (number | null): Total suplai token sebagai angka titik mengambang, yang disesuaikan dengan decimals token. Kolom ini mungkin bernilai null atau kurang presisi; uiAmountString umumnya lebih disarankan untuk ditampilkan.
• uiAmountString (string): Total suplai token dalam bentuk string, yang disesuaikan dengan decimals token. Ini adalah representasi total suplai yang paling ramah pengguna.

{
  "jsonrpc": "2.0",
  "result": {
    "context": { "slot": 123456789 },
    "value": {
      "amount": "1000000000000000", // e.g., 1,000,000,000 tokens with 6 decimals
      "decimals": 6,
      "uiAmount": 1000000000.0,
      "uiAmountString": "1000000000.0"
    }
  },
  "id": 1
}

​

Contoh Kode

# Replace <TOKEN_MINT_PUBKEY> with the actual mint address
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTokenSupply",
    "params": [
      "<TOKEN_MINT_PUBKEY>"
    ]
  }' \
  <YOUR_RPC_URL>

# Example with commitment level
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTokenSupply",
    "params": [
      "<TOKEN_MINT_PUBKEY>",
      { "commitment": "confirmed" }
    ]
  }' \
  <YOUR_RPC_URL>

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

async function checkTokenSupply(mintAddress) {
  // Replace with your RPC endpoint
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  const mintPublicKey = new PublicKey(mintAddress);

  try {
    const tokenSupply = await connection.getTokenSupply(mintPublicKey);
    console.log(`Token Supply for Mint ${mintAddress}:`);
    console.log(`  UI Amount: ${tokenSupply.value.uiAmountString}`);
    console.log(`  Raw Amount: ${tokenSupply.value.amount}`);
    console.log(`  Decimals: ${tokenSupply.value.decimals}`);
    // For full details:
    // console.log(JSON.stringify(tokenSupply, null, 2));
  } catch (error) {
    console.error(`Error fetching token supply for mint ${mintAddress}:`, error);
  }
}

// Replace with the actual token mint public key you want to query
const exampleTokenMint = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'; // USDC mint
checkTokenSupply(exampleTokenMint);

// Example with a different mint (e.g., Raydium)
// const raydiumMint = '4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R';
// checkTokenSupply(raydiumMint);

​

Kiat untuk Pengembang

• Suplai Tidak Dapat Diubah (Biasanya): Untuk sebagian besar token SPL, setelah dicetak, total suplai dari perspektif akun mint itu sendiri bersifat tetap, kecuali mint tersebut memiliki otoritas pencetakan khusus yang dapat membuat lebih banyak token (atau membakarnya, meskipun pembakaran biasanya dilakukan dari akun token, bukan langsung dari suplai mint).
• decimals adalah Kunci: Selalu gunakan kolom decimals untuk menafsirkan amount atau uiAmountString dengan benar.
• Sumber Data: Metode ini mengueri akun mint secara langsung untuk mendapatkan informasi suplainya.