Cách sử dụng getSupply

​

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

• Tìm hiểu mô hình kinh tế của SOL: Xem nhanh thông tin phân bổ SOL hiện tại.
• Phân tích kinh tế: Theo dõi những thay đổi của các chỉ số nguồn cung theo thời gian.
• Hiển thị số liệu thống kê mạng: Cung cấp cho người dùng thông tin mới nhất về nguồn cung SOL trên bảng điều khiển hoặc trình khám phá.
• Theo dõi lạm phát: Mặc dù getInflationRate và getInflationGovernor cung cấp dữ liệu lạm phát trực tiếp hơn, getSupply có thể cung cấp bối cảnh tổng quát hơn.

​

Tham số yêu cầu

1. 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 nút RPC sẽ được sử dụng.
2. excludeNonCirculatingAccountsList (boolean, không bắt buộc): Nếu được đặt thành true, mảng nonCirculatingAccounts sẽ bị loại khỏi phản hồi. Giá trị mặc định là false. Tùy chọn này có thể giúp giảm kích thước phản hồi nếu không cần danh sách từng tài khoản không lưu hành.

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

​

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

• value: Một đối tượng chứa thông tin nguồn cung:
  • total (u64): Tổng nguồn cung SOL tính bằng lamport.
  • circulating (u64): Nguồn cung SOL lưu hành tính bằng lamport.
  • nonCirculating (u64): Nguồn cung SOL không lưu hành tính bằng lamport.
  • nonCirculatingAccounts (mảng chuỗi, không bắt buộc): Mảng khóa công khai (dưới dạng chuỗi được mã hóa base58) của các tài khoản nắm giữ SOL không lưu hành. Trường này sẽ bị bỏ qua nếu excludeNonCirculatingAccountsList được đặt thành true trong yêu cầu.
• context: Một đối tượng chứa:
  • slot (u64): Slot tại thời điểm truy xuất thông tin.

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

​

Ví dụ mã

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

​

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

• Lamport và SOL: Các giá trị được trả về bằng lamport. Hãy nhớ chia cho 1,000,000,000 (1 SOL = 10^9 lamport) để chuyển đổi sang SOL.
• Độ mới của dữ liệu: Dữ liệu phản ánh trạng thái tại slot được chỉ định trong đối tượng context và dựa trên mức cam kết đã sử dụng.
• excludeNonCirculatingAccountsList: Sử dụng tùy chọn này nếu chỉ cần các số liệu nguồn cung tổng hợp để tối ưu hóa kích thước phản hồi và thời gian xử lý, đặc biệt khi danh sách tài khoản không lưu hành rất dài.
• Giá trị động: Các số liệu nguồn cung có thể thay đổi thường xuyên do cơ chế phát hành token (lạm phát) và đốt token.

​

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