Cách sử dụng getTokenSupply

​

Các trường hợp sử dụng phổ biến

• Hiển thị thông tin token: Hiển thị tổng nguồn cung của token trên trình khám phá hoặc trong giao diện ví.
• Phân tích tokenomics: Xác định tổng lượng phát hành tối đa hoặc hiện tại của token.
• Xác minh: Kiểm tra nguồn cung của token theo dữ liệu do chính tài khoản mint báo cáo.
• Theo dõi thay đổi nguồn cung: Nếu có thể mint thêm token, phương thức này có thể được dùng để theo dõi những thay đổi trong tổng nguồn cung theo thời gian (mặc dù với token có thể thay thế, nguồn cung thường cố định hoặc do một cơ quan mint quản lý).

​

Tham số yêu cầu

1. mintAddress (chuỗi, bắt buộc): Khóa công khai được mã hóa base-58 của mint token có tổng nguồn cung mà bạn muốn truy vấn.
2. options (đối tượng, không bắt buộc): Đối tượng cấu hình không bắt buộc, có thể bao gồm:
   • commitment (chuỗi, không bắt buộc): Chỉ định mức cam kết cho truy vấn (ví dụ: "finalized", "confirmed", "processed").

​

Cấu trúc phản hồi

• amount (chuỗi): Tổng nguồn cung của token theo đơn vị nhỏ nhất (số lượng thô), ở dạng chuỗi. Giá trị này chưa được điều chỉnh theo số chữ số thập phân.
• decimals (u8): Số chữ số thập phân được xác định cho mint token này. Thông tin này rất quan trọng để chuyển đổi amount thô sang định dạng con người có thể đọc được.
• uiAmount (số | null): Tổng nguồn cung của token dưới dạng số dấu phẩy động, được điều chỉnh theo decimals của token. Trường này có thể là null hoặc có độ chính xác thấp hơn; uiAmountString thường được ưu tiên để hiển thị.
• uiAmountString (chuỗi): Tổng nguồn cung của token dưới dạng chuỗi, được điều chỉnh theo decimals của token. Đây là cách biểu diễn tổng nguồn cung thân thiện nhất với người dùng.

{
  "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
}

​

Ví dụ mã

# 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);

​

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

• Nguồn cung bất biến (thường là vậy): Với hầu hết SPL Token, sau khi được mint, tổng nguồn cung theo góc nhìn của chính tài khoản mint sẽ cố định, trừ khi mint có một cơ quan mint cụ thể có thể tạo thêm token (hoặc đốt token, mặc dù việc đốt thường diễn ra từ các tài khoản token chứ không trực tiếp từ nguồn cung của mint).
• decimals là yếu tố then chốt: Luôn sử dụng trường decimals để diễn giải chính xác amount hoặc uiAmountString.
• Nguồn dữ liệu: Phương thức này truy vấn trực tiếp tài khoản mint để lấy thông tin nguồn cung.