So verwendest du getTokenAccountBalance

​

Häufige Anwendungsfälle

• token-Bestände von Benutzern anzeigen: Zeige Benutzern, wie viel eines bestimmten token sie in ihrer Wallet besitzen (zugehörige Token Accounts).
• token-Verfügbarkeit prüfen: Prüfe vor einer Übertragung oder einem anderen Vorgang, ob ein Token Account über ausreichend Guthaben verfügt.
• Portfolio-Tracking: Fasse die token-Bestände eines Benutzers aus verschiedenen Token Accounts zusammen.
• Interaktionen mit Smart Contracts: Smart Contracts können token-Bestände als Teil ihrer Logik abfragen. On-Chain-Programme greifen jedoch normalerweise direkt über die Account-Informationen auf diese Daten zu.

​

Request-Parameter

1. Öffentlicher Schlüssel des Token Account (string, erforderlich): Der Base58-codierte öffentliche Schlüssel des SPL Token Account, den du abfragen möchtest.
2. Konfigurationsobjekt (object, optional): Ein optionales Objekt, das das folgende Feld enthalten kann:
   • commitment (string, optional): Gibt den commitment-Level für die Abfrage an. Wenn du ihn weglässt, wird das standardmäßige commitment des RPC node verwendet (normalerweise finalized).

​

Response-Struktur

• amount (string): Der Rohbestand des Token Account als String. Dies ist eine Ganzzahl, die die kleinste Einheit des token darstellt. Hat ein token beispielsweise 6 Dezimalstellen, entspricht der Betrag „1000000“ einem token.
• decimals (u8): Die Anzahl der für diesen token-Typ definierten Dezimalstellen, die durch seine Mint festgelegt wird.
• uiAmount (number | null): Der unter Berücksichtigung von decimals als Gleitkommazahl formatierte Bestand. Dieses Feld kann in manchen Kontexten null oder zugunsten von uiAmountString veraltet sein.
• uiAmountString (string): Der unter Berücksichtigung von decimals als String formatierte Bestand. Dieses Format wird für die Anzeige oft bevorzugt, um mögliche Ungenauigkeiten bei Gleitkommazahlen zu vermeiden.

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

​

Codebeispiele

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

​

Tipps für Entwickler

• Token Account vs. Mint Account vs. Owner Account: Stelle sicher, dass du den öffentlichen Schlüssel des SPL Token Account angibst, nicht die Mint-Adresse des token oder die Wallet-Adresse des Besitzers. Token Accounts eines Besitzers rufst du normalerweise mit getTokenAccountsByOwner ab.
• Dezimalstellen: Verwende immer das Feld decimals, um amount korrekt zu interpretieren. Für die Anzeige ist uiAmountString im Allgemeinen sicherer als uiAmount, da es Probleme mit der Gleitkommagenauigkeit vermeidet.
• Nicht vorhandene Accounts: Wenn der angegebene öffentliche Schlüssel keinem vorhandenen Token Account entspricht, kann das Verhalten je nach RPC-Anbieter oder Bibliothek leicht variieren. Häufig ist value in der response jedoch null oder es wird ein Fehler ausgelöst. Das JavaScript-Beispiel enthält eine einfache Prüfung auf balance.value.
• Commitment-Level: Verschiedene commitment-Level können beeinflussen, wie schnell du Änderungen am Bestand siehst. Das gilt besonders für sehr aktuelle Transaktionen. finalized ist am sichersten, hat aber die höchste Latenz.

​

Verwandte Methoden