So verwendest du getSupply

​

Häufige Anwendungsfälle

• SOL-Tokenomics verstehen: Verschaffe dir einen Überblick über die aktuelle Verteilung von SOL.
• Wirtschaftliche Analyse: Verfolge Veränderungen der Mengenkennzahlen im Zeitverlauf.
• Netzwerkstatistiken anzeigen: Zeige Nutzern in Dashboards oder Explorern aktuelle Informationen zur SOL-Menge an.
• Inflation überwachen: getInflationRate und getInflationGovernor liefern zwar direktere Inflationsdaten, aber getSupply bietet einen umfassenderen Kontext.

​

Parameter für den request

1. commitment (string, optional): Gibt das commitment-Level für die Abfrage an. Wenn du es weglässt, wird das standardmäßige commitment des RPC node verwendet.
2. excludeNonCirculatingAccountsList (boolean, optional): Wenn du diesen Wert auf true setzt, wird das Array nonCirculatingAccounts aus der response ausgeschlossen. Der Standardwert ist false. Damit kannst du die Größe der response reduzieren, wenn du die Liste der einzelnen Konten mit nicht im Umlauf befindlichem SOL nicht benötigst.

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

​

Struktur der response

• value: Ein Objekt mit Informationen zur SOL-Menge:
  • total (u64): Die gesamte SOL-Menge in Lamports.
  • circulating (u64): Die im Umlauf befindliche SOL-Menge in Lamports.
  • nonCirculating (u64): Die nicht im Umlauf befindliche SOL-Menge in Lamports.
  • nonCirculatingAccounts (Array aus strings, optional): Ein Array mit öffentlichen Schlüsseln von Konten, die nicht im Umlauf befindliches SOL halten. Die Schlüssel sind als base58-codierte strings angegeben. Dieses Feld wird weggelassen, wenn excludeNonCirculatingAccountsList im request auf true gesetzt wurde.
• context: Ein Objekt mit folgendem Feld:
  • slot (u64): Der slot, zu dem die Informationen abgerufen wurden.

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

​

Codebeispiele

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

​

Tipps für Entwickler

• Lamports und SOL: Die Beträge werden in Lamports zurückgegeben. Teile sie durch 1,000,000,000 (1 SOL = 10^9 Lamports), um sie in SOL umzurechnen.
• Aktualität der Daten: Die Daten entsprechen dem Zustand am slot, der im Objekt context angegeben ist. Sie basieren außerdem auf dem verwendeten commitment-Level.
• excludeNonCirculatingAccountsList: Verwende diese Option, wenn du nur die aggregierten Mengenangaben benötigst. So optimierst du die Größe und Verarbeitungszeit der response. Das ist besonders nützlich, wenn die Liste der Konten mit nicht im Umlauf befindlichem SOL sehr lang ist.
• Dynamische Werte: Die Mengenangaben können sich durch die Ausgabe neuer token (Inflation) und das Verbrennen von token häufig ändern.

​

Verwandte Methoden