Token-Account-Filterung (ATA) über WebSocket

Mit dem Filter tokenAccounts der WebSocket-Methode transactionSubscribe kann eine Subscription Aktivitäten auf den zugehörigen Token Accounts (ATAs) einer Wallet erfassen, nicht nur Transaktionen, in denen der pubkey der Wallet direkt vorkommt. Derselbe Filter ist über gRPC verfügbar. Die gRPC-Version findest du unter Token-Account-Filterung (ATA).

Das Problem: Einfache Account-Filter verpassen eingehende Token-Übertragungen

Wenn du eine Wallet mit accountInclude: [wallet] überwachst, erfasst du nur Transaktionen, bei denen der pubkey dieser Wallet in den Account-Schlüsseln der Transaktion vorkommt. Ein häufiger Fall wird nicht erfasst: Wenn jemand ein SPL-Token an die Wallet sendet, zum Beispiel USDC, betrifft die Übertragung das zugehörige Token Account (ATA) der Wallet — eine separate, vom Programm abgeleitete Adresse — und nicht den pubkey der Wallet selbst. Eine einfache Subscription mit accountInclude: [wallet] erkennt daher keine eingehenden Token-Übertragungen. Du müsstest vorab jedes ATA der Wallet auflisten und einzeln zum Filter hinzufügen. ATAs werden jedoch bei Bedarf erstellt — eines pro Mint. Daher kannst du nicht im Voraus alle ATAs kennen.

So funktioniert die Erweiterung mit `tokenAccounts`

Setze tokenAccounts in der Subscription, um den Abgleich zu erweitern. Eine Wallet unter accountInclude erfasst dann auch Transaktionen, die ein Token Account in ihrem Besitz betreffen. Der Abgleich erfolgt nach Eigentümer: LaserStream ermittelt zum Zeitpunkt des Abgleichs die Token Accounts, die deinen Adressen unter accountInclude gehören. Dadurch werden alle Token Accounts der Wallet erfasst, einschließlich nicht kanonischer Accounts, und nicht nur die abgeleitete ATA-Adresse. Du musst die ATAs nie selbst auflisten. Subscriptions ohne tokenAccounts verhalten sich genau wie bisher. Du kannst das Feld daher problemlos zu einem vorhandenen Filter hinzufügen.

Erweiterungsmodi

tokenAccounts akzeptiert einen von drei String-Werten:

Wert	Erfasst	Volumen	Verwende ihn für
`"balanceChanged"`	Transaktionen, bei denen sich das Guthaben eines eigenen Token Accounts tatsächlich geändert hat oder das Token Account geschlossen wurde	Niedriger — die empfohlene Standardeinstellung	„Benachrichtige mich, wenn tatsächlich Gelder bewegt wurden“ — Einzahlungen, Auszahlungen und Swaps, die in der Wallet abgewickelt werden
`"all"`	Jede Transaktion, die auf ein Token Account der Wallet verweist, auch wenn sich das Guthaben nicht geändert hat	Höher	Vollständige Sichtbarkeit aller Aktivitäten, die auch nur eines der Token Accounts der Wallet betreffen
`"none"`	Keine Erweiterung — entspricht dem Weglassen des Felds	—	Die Standardeinstellung

Beginne mit "balanceChanged". Dieser Modus erfasst tatsächliche Geldbewegungen mit nur einem Bruchteil des Volumens von "all".

Verwendung in `transactionSubscribe`

tokenAccounts ist eine Helius-Erweiterung der standardmäßigen Solana WebSocket API. Ein ungültiger Wert gibt den JSON-RPC-Fehler -32602 zurück: Invalid tokenAccounts value '<x>', expected one of: none, balanceChanged, all.

const ws = new WebSocket('wss://mainnet.helius-rpc.com/?api-key=<API_KEY>');

ws.on('open', () => {
  ws.send(JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'transactionSubscribe',
    params: [
      {
        accountInclude: ['<WALLET_PUBKEY>'],
        tokenAccounts: 'balanceChanged' // also match the wallet's ATAs
      },
      { commitment: 'confirmed', encoding: 'jsonParsed', maxSupportedTransactionVersion: 1 }
    ]
  }));
  setInterval(() => ws.ping(), 30_000);
});

ws.on('message', (data) => {
  const msg = JSON.parse(data.toString());
  const result = msg.params?.result;
  if (!result) return;
  // Token balances this wallet owns that changed in the tx
  const owned = (result.transaction.meta.postTokenBalances || [])
    .filter((b) => b.owner === '<WALLET_PUBKEY>');
  console.log(result.signature, owned);
});

Ermitteln, was erfasst wurde

Nachdem eine Transaktion durch die ATA-Erweiterung erfasst wurde, findest du die Token-Bewegungen der Wallet in meta.postTokenBalances und meta.preTokenBalances der Transaktion. Filtere diese Einträge nach owner, um die Guthaben zu isolieren, die tatsächlich deiner Wallet gehören. Vergleiche dann preTokenBalances mit postTokenBalances für denselben accountIndex, um zu sehen, wie stark sich jeder Mint verändert hat. Das obige Beispiel zeigt diesen Filterschritt.

Weitere Informationen

transactionSubscribe

Alle Filter und Optionen für transactionSubscribe, einschließlich tokenAccounts.

Token Account Filtering (gRPC)

Dieselbe Erweiterung mit tokenAccounts für LaserStream gRPC-Transaktionsfilter.

WebSocket Quickstart

Stelle eine Verbindung zu LaserStream WebSocket her und streame deine ersten Ereignisse.

Erste Schritte

Streaming von Daten und Event-Überwachung

Daten-APIs und RPCs

Trading

Transaktionen senden

Wallet-as-a-Service

Datenschutz

Ressourcen

Token-Account-Filterung (ATA) über WebSocket

Das Problem: Einfache Account-Filter verpassen eingehende Token-Übertragungen

So funktioniert die Erweiterung mit `tokenAccounts`

Erweiterungsmodi

Verwendung in `transactionSubscribe`

Ermitteln, was erfasst wurde

Weitere Informationen

transactionSubscribe

Token Account Filtering (gRPC)

WebSocket Quickstart

​Das Problem: Einfache Account-Filter verpassen eingehende Token-Übertragungen

​So funktioniert die Erweiterung mit tokenAccounts

​Erweiterungsmodi

​Verwendung in transactionSubscribe

​Ermitteln, was erfasst wurde

​Weitere Informationen

transactionSubscribe

Token Account Filtering (gRPC)

WebSocket Quickstart

Das Problem: Einfache Account-Filter verpassen eingehende Token-Übertragungen

So funktioniert die Erweiterung mit `tokenAccounts`

Erweiterungsmodi

Verwendung in `transactionSubscribe`

Ermitteln, was erfasst wurde

Weitere Informationen