Lọc token mint

​

Vấn đề: bộ lọc tài khoản thông thường bỏ sót hầu hết các giao dịch chuyển token

​

Cách matchMints hoạt động

​

Ngữ nghĩa

• Các điều kiện trong cùng một bộ lọc có tên vẫn được kết hợp bằng AND (vote, failed, signature và các danh sách tài khoản).
• Nhiều bộ lọc có tên vẫn được kết hợp bằng OR.
• Các giá trị trong một danh sách được kết hợp bằng OR (ngoại trừ accountRequired, trong đó tất cả đều phải khớp).
• Giao dịch không có số dư token sẽ quay về chỉ khớp theo khóa. matchMints không bao giờ thêm các giao dịch không có hoạt động token.
• Chỉ riêng matchMints không giới hạn luồng. Bạn vẫn cần ít nhất một khóa hoặc mint trong danh sách tài khoản (hoặc một điều kiện giới hạn khác) để bộ lọc được chấp nhận.

​

Sử dụng trong 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,
}

​

Kết hợp với tokenAccounts để theo dõi một token cho một ví

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 thông tin đã khớp

​

Giới hạn và lưu ý

• Các mint nằm trong cùng những danh sách accountInclude, accountExclude và accountRequired với các khóa tài khoản, vì vậy chúng được tính vào cùng giới hạn của gói cho mỗi danh sách. Không có giới hạn mint riêng.
• Chi phí khớp không tăng theo số lượng mint trong danh sách. Hiệu năng của 100 mint và 100.000 mint là như nhau, còn những người đăng ký không thiết lập cờ sẽ không chịu thêm chi phí nào.
• Phát lại dữ liệu lịch sử tuân theo matchMints, vì vậy đăng ký phát lại sẽ trả về cùng các giao dịch mà luồng trực tiếp sẽ trả về.
• Nếu bạn đính kèm một bộ lọc nén (cuckoo) vào đăng ký giao dịch, matchMints cũng kiểm tra tập hợp mint với bộ lọc đó, bên cạnh các khóa tài khoản.
• matchMints đang hoạt động trên tất cả khu vực LaserStream gRPC, cả mainnet và devnet. Hiện tại, tính năng này chưa khả dụng trên LaserStream WebSocket.
• Phiên bản SDK tối thiểu: JavaScript/TypeScript helius-laserstream 0.8.5, Rust helius-laserstream 0.6.4, Go go/v0.3.0.

​

Nội dung liên quan