Filtrage par mint de jeton

​

Le problème : les filtres de compte simples manquent la plupart des transferts de jetons

​

Fonctionnement de matchMints

​

Sémantique

• Les prédicats d’un même filtre nommé sont toujours combinés avec l’opérateur AND (vote, failed, signature et les listes de comptes).
• Plusieurs filtres nommés sont toujours combinés avec l’opérateur OR.
• Les valeurs d’une liste sont combinées avec l’opérateur OR (sauf pour accountRequired, où toutes doivent correspondre).
• Pour une transaction sans solde de jetons, la correspondance repose uniquement sur les clés. matchMints n’ajoute jamais de transactions sans activité de jetons.
• Utilisé seul, matchMints ne restreint pas le flux. Vous devez toujours fournir au moins une clé ou un mint dans une liste de comptes (ou un autre prédicat restrictif) pour que le filtre soit accepté.

​

Utilisation dans LaserStream gRPC

import { subscribe, CommitmentLevel, LaserstreamConfig, SubscribeRequest } from 'helius-laserstream';
import bs58 from 'bs58';

const USDC = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';

const subscriptionRequest: SubscribeRequest = {
  transactions: {
    'usdc-txs': {
      accountInclude: [USDC],
      accountExclude: [],
      accountRequired: [],
      vote: false,
      failed: false,
      matchMints: true, // match USDC via pre/post token-balance mints
    },
  },
  commitment: CommitmentLevel.CONFIRMED,
  accounts: {}, slots: {}, transactionsStatus: {},
  blocks: {}, blocksMeta: {}, entry: {}, accountsDataSlice: [],
};

const config: LaserstreamConfig = {
  apiKey: 'YOUR_API_KEY',
  endpoint: 'https://laserstream-mainnet-ewr.helius-rpc.com',
};

await subscribe(config, subscriptionRequest, async (data) => {
  const tx = data.transaction?.transaction;
  if (!tx) return;
  // USDC balances touched by this transaction
  const usdcBalances = (tx.meta?.postTokenBalances || []).filter((b: any) => b.mint === USDC);
  console.log(bs58.encode(tx.signature), usdcBalances);
}, async (error) => {
  console.error('Stream error:', error);
});

use std::collections::HashMap;
use helius_laserstream::grpc::{SubscribeRequest, SubscribeRequestFilterTransactions};

let request = SubscribeRequest {
    transactions: HashMap::from([(
        "usdc-txs".to_string(),
        SubscribeRequestFilterTransactions {
            account_include: vec!["EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v".to_string()],
            vote: Some(false),
            failed: Some(false),
            match_mints: true,
            ..Default::default()
        },
    )]),
    ..Default::default()
};

vote := false
failed := false
req := &laserstream.SubscribeRequest{
    Transactions: map[string]*laserstream.SubscribeRequestFilterTransactions{
        "usdc-txs": {
            AccountInclude: []string{"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"},
            Vote:           &vote,
            Failed:         &failed,
            MatchMints:     true,
        },
    },
    Commitment: &commitmentLevel,
}

​

Combinaison avec tokenAccounts pour surveiller un jeton d’un portefeuille

transactions: {
  'wallet-usdc': {
    accountInclude: [WALLET],
    accountRequired: [USDC],
    accountExclude: [],
    tokenAccounts: 'balanceChanged', // wallet matched via its token accounts
    matchMints: true,                // USDC matched via balance mints
    vote: false,
    failed: false,
  },
},

​

Lecture des correspondances

​

Limites et remarques

• Les mints utilisent les mêmes listes accountInclude, accountExclude et accountRequired que les clés de compte. Ils sont donc soumis aux mêmes limites par liste selon l’offre. Il n’existe aucune limite distincte pour les mints.
• Le coût de la recherche de correspondances n’augmente pas avec le nombre de mints répertoriés. Les performances sont identiques pour 100 et 100 000 mints, et les abonnés qui n’activent pas l’indicateur ne supportent aucun coût supplémentaire.
• La relecture historique prend en charge matchMints. Un abonnement de relecture renvoie donc les mêmes transactions que le flux en direct aurait renvoyées.
• Si vous associez un filtre compressé (cuckoo) à un abonnement aux transactions, matchMints teste également l’ensemble de mints avec ce filtre, en plus des clés de compte.
• matchMints est actif dans toutes les régions LaserStream gRPC, sur le réseau principal et le réseau de développement. Il n’est pas disponible sur LaserStream WebSocket pour le moment.
• Versions minimales du SDK : JavaScript/TypeScript helius-laserstream 0.8.5, Rust helius-laserstream 0.6.4, Go go/v0.3.0.

​

Contenu associé