Cara Menggunakan getSupply

​

Kasus Penggunaan Umum

• Memahami Tokenomik SOL: Dapatkan gambaran terkini tentang distribusi SOL.
• Analisis Ekonomi: Pantau perubahan metrik pasokan dari waktu ke waktu.
• Menampilkan Statistik Jaringan: Berikan informasi terbaru tentang pasokan SOL kepada pengguna melalui dasbor atau penjelajah.
• Memantau Inflasi: Meskipun getInflationRate dan getInflationGovernor menyediakan data inflasi yang lebih langsung, getSupply dapat memberikan konteks yang lebih luas.

​

Parameter Permintaan

1. commitment (string, opsional): Menentukan tingkat komitmen untuk kueri. Jika dihilangkan, komitmen default dari node RPC akan digunakan.
2. excludeNonCirculatingAccountsList (boolean, opsional): Jika diatur ke true, array nonCirculatingAccounts akan dikecualikan dari respons. Nilai defaultnya adalah false. Opsi ini berguna untuk mengurangi ukuran respons jika daftar setiap akun yang menyimpan SOL tidak beredar tidak diperlukan.

{
  "commitment": "finalized",
  "excludeNonCirculatingAccountsList": true
}

​

Struktur Respons

• value: Objek yang berisi informasi pasokan:
  • total (u64): Total pasokan SOL dalam lamport.
  • circulating (u64): Pasokan SOL yang beredar dalam lamport.
  • nonCirculating (u64): Pasokan SOL yang tidak beredar dalam lamport.
  • nonCirculatingAccounts (array string, opsional): Array kunci publik (sebagai string yang dikodekan dalam base58) dari akun yang menyimpan SOL tidak beredar. Bidang ini dihilangkan jika excludeNonCirculatingAccountsList diatur ke true dalam permintaan.
• context: Objek yang berisi:
  • slot (u64): Slot tempat informasi tersebut diambil.

{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "slot": 169890374
    },
    "value": {
      "circulating": 423105827585008800,
      "nonCirculating": 123456789012345678, // Example value
      "nonCirculatingAccounts": [
        "Stake11111111111111111111111111111111111111",
        "Vote11111111111111111111111111111111111111",
        // ... other non-circulating accounts
      ],
      "total": 546562616597354478
    }
  },
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "slot": 169890380
    },
    "value": {
      "circulating": 423105830000000000,
      "nonCirculating": 123456780000000000, // Example value
      "total": 546562610000000000
      // nonCirculatingAccounts field is absent
    }
  },
  "id": 1
}

​

Contoh Kode

# Basic Request:
curl -X POST -H "Content-Type: application/json" -d \
  '{"jsonrpc":"2.0","id":1,"method":"getSupply"}' \
  <YOUR_RPC_URL>

# Request with excludeNonCirculatingAccountsList:
curl -X POST -H "Content-Type: application/json" -d \
  '{"jsonrpc":"2.0","id":1,"method":"getSupply", "params": [{"excludeNonCirculatingAccountsList": true}]}' \
  <YOUR_RPC_URL>

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

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

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

  try {
    const supplyInfo = await connection.getSupply();
    console.log('Supply Information:', supplyInfo.value);
    console.log('Total SOL:', supplyInfo.value.total / 1_000_000_000); // Convert lamports to SOL
    console.log('Circulating SOL:', supplyInfo.value.circulating / 1_000_000_000);
    console.log('Non-Circulating SOL:', supplyInfo.value.nonCirculating / 1_000_000_000);

    if (supplyInfo.value.nonCirculatingAccounts) {
      console.log('Non-circulating accounts count:', supplyInfo.value.nonCirculatingAccounts.length);
    }

    // Example with options
    const supplyInfoWithoutAccountsList = await connection.getSupply({
      commitment: 'finalized',
      excludeNonCirculatingAccountsList: true,
    });
    console.log('\nSupply Information (excluding non-circulating accounts list):');
    console.log('Total SOL:', supplyInfoWithoutAccountsList.value.total / 1_000_000_000);
    console.log('Circulating SOL:', supplyInfoWithoutAccountsList.value.circulating / 1_000_000_000);

  } catch (error) {
    console.error('Error getting supply information:', error);
  }
}

getNetworkSupply();

​

Tips untuk Developer

• Lamport vs. SOL: Jumlah dikembalikan dalam lamport. Ingatlah untuk membaginya dengan 1,000,000,000 (1 SOL = 10^9 lamport) agar dikonversi menjadi SOL.
• Kebaruan Data: Data mencerminkan status pada slot yang ditunjukkan dalam objek context dan berdasarkan tingkat komitmen yang digunakan.
• excludeNonCirculatingAccountsList: Gunakan opsi ini jika Anda hanya memerlukan angka pasokan agregat untuk mengoptimalkan ukuran respons dan waktu pemrosesan, terutama jika daftar akun yang menyimpan SOL tidak beredar sangat panjang.
• Nilai Dinamis: Angka pasokan dapat sering berubah karena penerbitan token (inflasi) dan mekanisme pembakaran.

​

Metode Terkait