如何使用 getTokenSupply

​

常见用例

• 显示代币信息： 在浏览器或钱包界面上显示代币的总供应量。
• 代币经济学分析： 了解代币的最大或当前总发行量。
• 验证： 检查铸造账户本身报告的代币供应量。
• 监控供应变化： 如果代币是可铸造的，这可以用于跟踪其总供应量随时间的变化（尽管对于可替代代币，供应量通常是固定的或由铸造机构管理）。

​

请求参数

1. mintAddress (字符串，必需)：要查询其总供应量的代币铸造的 base-58 编码公钥。
2. options (对象，可选)：一个可选的配置对象，可以包括：
   • commitment (字符串，可选)：指定查询的承诺级别（例如，"finalized"，"confirmed"，"processed"）。

​

响应结构

• amount (字符串)：代币在其最小单位（原始数量）中的总供应量，以字符串形式表示。此值未调整小数位。
• decimals (u8)：为此代币铸造定义的小数位数。这对于将原始 amount 转换为人类可读格式至关重要。
• uiAmount (数字 | null)：调整为代币的 decimals 后的代币总供应量，以浮点数表示。此字段可能为 null 或不太精确；通常优先使用 uiAmountString 进行显示。
• uiAmountString (字符串)：调整为代币的 decimals 后的代币总供应量，以字符串形式表示。这是代币总供应量的最用户友好的表示。

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

​

代码示例

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

​

开发者提示

• 不可变供应（通常）： 对于大多数 SPL 代币，一旦铸造，从铸造账户本身的角度来看，总供应量是固定的，除非铸造账户有特定的铸造权限可以创建更多代币（或销毁它们，尽管销毁通常发生在代币账户，而不是直接从铸造的供应中）。
• decimals 是关键： 始终使用 decimals 字段来正确解释 amount 或 uiAmountString。
• 数据来源： 此方法直接查询铸造账户以获取其供应信息。