Filtrado por mint de token

​

El problema: los filtros de cuenta simples omiten la mayoría de las transferencias de tokens

​

Cómo funciona matchMints

​

Semántica

• Los predicados dentro de un mismo filtro con nombre siguen combinándose con AND (vote, failed, signature y las listas de cuentas).
• Varios filtros con nombre siguen combinándose con OR.
• Los valores dentro de una lista se combinan con OR (excepto accountRequired, donde todos deben coincidir).
• Una transacción sin saldos de tokens vuelve a usar la comparación solo por claves. matchMints nunca agrega transacciones que no tengan actividad de tokens.
• matchMints por sí solo no restringe el flujo. Aún necesitas al menos una clave o un mint en una lista de cuentas (u otro predicado restrictivo) para que se acepte el filtro.

​

Úsalo en 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,
}

​

Combínalo con tokenAccounts para monitorear un token de una billetera

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,
  },
},

​

Cómo interpretar lo que coincidió

​

Límites y notas

• Los mints se colocan en las mismas listas accountInclude, accountExclude e accountRequired que las claves de cuenta, por lo que cuentan para los mismos límites del plan por lista. No hay un límite separado para mints.
• El costo de la comparación no aumenta con la cantidad de mints que incluyas. El rendimiento es el mismo con 100 mints que con 100,000, y los suscriptores que no establecen la marca no incurren en ningún costo adicional.
• La reproducción histórica respeta matchMints, por lo que una suscripción de reproducción devuelve las mismas transacciones que habría devuelto el flujo en vivo.
• Si adjuntas un filtro comprimido (cuckoo) a una suscripción de transacciones, matchMints compara el conjunto de mints con él, además de las claves de cuenta.
• matchMints está activo en todas las regiones de LaserStream gRPC, tanto en mainnet como en devnet. Actualmente no está disponible en LaserStream WebSocket.
• Versiones mínimas del SDK: JavaScript/TypeScript helius-laserstream 0.8.5, Rust helius-laserstream 0.6.4, Go go/v0.3.0.

​

Contenido relacionado