Cách sử dụng getTokenAccountBalance

​

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

• Hiển thị số dư token của người dùng: Cho người dùng biết họ sở hữu bao nhiêu token cụ thể trong ví (các tài khoản token liên kết).
• Xác minh token khả dụng: Kiểm tra xem tài khoản token có đủ số dư trước khi thực hiện chuyển token hoặc thao tác khác hay không.
• Theo dõi danh mục đầu tư: Tổng hợp số dư token của người dùng trên nhiều tài khoản token khác nhau.
• Tương tác với hợp đồng thông minh: Hợp đồng thông minh có thể truy vấn số dư token như một phần trong logic của chúng (mặc dù các chương trình on-chain thường truy cập trực tiếp dữ liệu này từ thông tin tài khoản).

​

Tham số yêu cầu

1. Khóa công khai của tài khoản token (chuỗi, bắt buộc): Khóa công khai được mã hóa base-58 của tài khoản SPL Token mà bạn muốn truy vấn.
2. Đối tượng cấu hình (đối tượng, không bắt buộc): Một đối tượng không bắt buộc có thể chứa trường sau:
   • commitment (chuỗi, không bắt buộc): Chỉ định mức cam kết cho truy vấn. Nếu bỏ qua, mức cam kết mặc định của node RPC sẽ được sử dụng (thường là finalized).

​

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

• amount (chuỗi): Số dư thô của tài khoản token dưới dạng chuỗi. Đây là một số nguyên biểu thị đơn vị nhỏ nhất của token (ví dụ: nếu một token có 6 chữ số thập phân, số lượng “1000000” tương đương với 1 token).
• decimals (u8): Số chữ số thập phân được xác định cho loại token này (bởi mint của token).
• uiAmount (số | null): Số dư được định dạng dưới dạng số dấu phẩy động, có tính đến decimals. Trong một số trường hợp, trường này có thể là null hoặc không còn được khuyến nghị sử dụng và được thay bằng uiAmountString.
• uiAmountString (chuỗi): Số dư được định dạng dưới dạng chuỗi, có tính đến decimals. Định dạng này thường được ưu tiên để hiển thị nhằm tránh sai số tiềm ẩn của số dấu phẩy động.

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

​

Ví dụ mã

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

​

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

• Tài khoản token so với tài khoản mint và tài khoản chủ sở hữu: Hãy đảm bảo bạn cung cấp khóa công khai của tài khoản SPL Token, không phải địa chỉ mint của token hoặc địa chỉ ví của chủ sở hữu. Thông thường, bạn có thể lấy các tài khoản token của một chủ sở hữu bằng getTokenAccountsByOwner.
• Chữ số thập phân: Luôn sử dụng trường decimals để diễn giải chính xác amount. Nhìn chung, uiAmountString an toàn hơn uiAmount khi hiển thị vì tránh được các vấn đề về độ chính xác của số dấu phẩy động.
• Tài khoản không tồn tại: Nếu khóa công khai được cung cấp không tương ứng với một tài khoản token hiện có, hành vi có thể khác nhau đôi chút tùy theo nhà cung cấp RPC hoặc thư viện. Tuy nhiên, value trong phản hồi thường sẽ là null hoặc hệ thống sẽ phát sinh lỗi. Ví dụ JavaScript có bước kiểm tra cơ bản đối với balance.value.
• Mức cam kết: processed có thể cho thấy một thay đổi số dư mà sau đó bị hoàn tác. Trong Alpenglow, confirmed và finalized có cùng độ trễ và cùng đảm bảo về tính chung cuộc vĩnh viễn; nên ưu tiên finalized cho mã mới.

​

Các phương thức liên quan