So verwendest du getTokenSupply

​

Häufige Anwendungsfälle

• Token-Informationen anzeigen: Zeige das Gesamtangebot eines Token in einem Explorer oder einer Wallet-Oberfläche an.
• Tokenomics-Analyse: Ermittle die maximale oder aktuelle Gesamtausgabe eines Token.
• Überprüfung: Prüfe das vom Mint-Konto selbst gemeldete Angebot eines Token.
• Änderungen des Angebots überwachen: Wenn sich weitere Token minten lassen, kannst du damit Änderungen des Gesamtangebots im Zeitverlauf verfolgen. Bei fungiblen Token ist das Angebot jedoch normalerweise festgelegt oder wird von einer Minting Authority verwaltet.

​

Request-Parameter

1. mintAddress (string, erforderlich): Der Base58-codierte öffentliche Schlüssel des Token Mint, dessen Gesamtangebot du abfragen möchtest.
2. options (object, optional): Ein optionales Konfigurationsobjekt, das Folgendes enthalten kann:
   • commitment (string, optional): Gibt das commitment für die Abfrage an (z. B. "finalized", "confirmed", "processed").

​

Response-Struktur

• amount (string): Das Gesamtangebot des Token in seiner kleinsten Einheit als String. Dieser Rohwert berücksichtigt keine Dezimalstellen.
• decimals (u8): Die für diesen Token Mint definierte Anzahl an Dezimalstellen. Dieser Wert ist entscheidend, um den Rohwert amount in ein menschenlesbares Format umzuwandeln.
• uiAmount (number | null): Das Gesamtangebot des Token als Gleitkommazahl, angepasst an decimals des Token. Dieses Feld kann null oder weniger präzise sein. Für die Anzeige wird im Allgemeinen uiAmountString empfohlen.
• uiAmountString (string): Das Gesamtangebot des Token als String, angepasst an decimals des Token. Dies ist die benutzerfreundlichste Darstellung des Gesamtangebots.

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

​

Codebeispiele

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

​

Tipps für Entwickler

• Unveränderliches Angebot (normalerweise): Bei den meisten SPL Token bleibt das Gesamtangebot aus Sicht des Mint-Kontos nach dem Minting unverändert. Eine Ausnahme besteht, wenn der Mint über eine bestimmte Minting Authority verfügt, die weitere Token erstellen oder vernichten kann. Das Vernichten erfolgt allerdings normalerweise über Token-Konten und nicht direkt über das Angebot des Mint.
• decimals ist entscheidend: Verwende immer das Feld decimals, um amount oder uiAmountString korrekt zu interpretieren.
• Datenquelle: Diese Methode fragt die Angebotsinformationen direkt beim Mint-Konto ab.