Filtragem por mint de token

​

O problema: filtros de conta simples não detectam a maioria das transferências de tokens

​

Como matchMints funciona

​

Semântica

• Os predicados dentro de um mesmo filtro nomeado continuam combinados com AND (vote, failed, signature e as listas de contas).
• Vários filtros nomeados continuam combinados com OR.
• Os valores dentro de uma lista são combinados com OR (exceto em accountRequired, em que todos devem corresponder).
• Uma transação sem saldos de token volta a usar a correspondência somente por chaves. matchMints nunca adiciona transações sem atividade de token.
• matchMints isoladamente não restringe o stream. Você ainda precisa de pelo menos uma chave ou um mint em uma lista de contas (ou outro predicado restritivo) para que o filtro seja aceito.

​

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

​

Combine com tokenAccounts para monitorar um token de uma carteira

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

​

Como identificar o que correspondeu

​

Limites e observações

• Os mints ficam nas mesmas listas accountInclude, accountExclude e accountRequired que as chaves de conta. Portanto, eles contam para os mesmos limites por lista do plano. Não há um limite separado para mints.
• O custo da correspondência não aumenta com o número de mints listados. O desempenho é o mesmo com 100 ou 100.000 mints, e os assinantes que não definem a flag não têm nenhum custo adicional.
• A reprodução histórica respeita matchMints. Portanto, uma assinatura de reprodução retorna as mesmas transações que o stream em tempo real retornaria.
• Se você anexar um filtro compactado (cuckoo) a uma assinatura de transações, matchMints também verifica o conjunto de mints no filtro, além das chaves de conta.
• matchMints está disponível em todas as regiões do LaserStream gRPC, na mainnet e na devnet. No momento, não está disponível no LaserStream WebSocket.
• Versões mínimas do SDK: JavaScript/TypeScript helius-laserstream 0.8.5, Rust helius-laserstream 0.6.4, Go go/v0.3.0.

​

Relacionados