代币铸币地址过滤

LaserStream 的 matchMints 标志让 gRPC 交易订阅除了匹配账户键外，还能匹配交易前后代币余额中的代币铸币地址。将铸币地址放入 accountInclude，并设置 matchMints: true，即可接收涉及该代币的每笔交易：转账、兑换、铸造、销毁和账户关闭。

matchMints 仅适用于 LaserStream gRPC。目前尚不适用于 LaserStream WebSocket。

问题：普通账户过滤器会遗漏大多数代币转账

使用 accountInclude: [mint] 监控代币时，只能匹配铸币地址公钥出现在交易账户键中的交易。经典的 SPL Transfer 指令从不引用铸币地址。它只指定源代币账户、目标代币账户和所有者，因此普通账户过滤器会遗漏任何代币最常见的操作。只有直接传入铸币地址的指令才能匹配，例如 MintTo、Burn、TransferChecked，以及程序账户中包含铸币地址的兑换交易。此前唯一的解决方法是流式传输所有交易，并自行检查每笔交易的代币余额。

`matchMints` 的工作原理

在交易过滤器上设置 matchMints: true 后，LaserStream 会根据交易的 preTokenBalances 和 postTokenBalances 构建一组铸币地址。随后，你的 accountInclude、accountExclude 和 accountRequired 列表会同时匹配账户键和该铸币地址集合。如果某个铸币地址对应的任意代币账户出现在任一余额列表中，该铸币地址就符合条件，无论余额是否发生变化。该标志需要显式启用，未设置此标志的过滤器行为与之前完全相同。因此，你可以将它添加到现有订阅中，而不会改变该订阅原本接收的内容。SPL 和 Token-2022 铸币地址均受支持，因为这两个程序都会填充交易前后的代币余额。

语义

谓词	不使用 `matchMints`	使用 `matchMints: true`
`accountInclude`	如果列出的任意键位于账户键中，则匹配	如果列出的任意键位于账户键或铸币地址集合中，则匹配
`accountExclude`	如果列出的任意键位于账户键中，则拒绝	如果列出的任意键位于账户键或铸币地址集合中，则拒绝
`accountRequired`	列出的每个键都必须位于账户键中	列出的每个键都必须位于账户键或铸币地址集合中（每个键可由其中任意一项满足）

其余过滤逻辑保持不变：

同一个命名过滤器中的谓词仍通过 AND 组合（vote、failed、signature 和账户列表）。
多个命名过滤器仍通过 OR 组合。
列表中的值使用 OR 关系（accountRequired 除外，其中所有值都必须匹配）。
对于没有代币余额的交易，会回退到仅匹配账户键。matchMints 绝不会添加没有代币活动的交易。
单独使用 matchMints 不会限制流。要使过滤器被接受，仍需在账户列表中至少添加一个键或铸币地址（或使用其他限制性谓词）。

LaserStream 通过精确公钥匹配铸币地址。与 tokenAccounts: "balanceChanged" 不同，铸币地址没有“仅余额发生变化”模式。

在 LaserStream gRPC 中使用

在 SubscribeRequest 的交易过滤器中添加 matchMints: true，并将铸币地址放入 accountInclude。以下示例会流式传输主网上的每笔 USDC 交易：

TypeScript
Rust
Go

需要 helius-laserstream 0.8.5 或更高版本。该字段也可写作 match_mints。

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);
});

需要 helius-laserstream 0.6.4 或更高版本（它会引入 laserstream-core-proto 11.3.0）。该字段直接来自 proto crate。

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()
};

需要标签为 go/v0.3.0 或更高版本的 Go 模块。

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

如果你使用原始 gRPC 或 Yellowstone 客户端而不是 SDK，请基于 Helius proto 重新生成代码（laserstream-core-proto 11.3.0 或更高版本，或者使用 SDK 仓库中附带的 .proto）。 match_mints 是 SubscribeRequestFilterTransactions 的第 32 个字段。使用上游 Triton proto 生成的客户端会静默丢弃未知字段，因此在重新生成代码之前，该标志不会生效。有关所有交易过滤器字段，请参阅订阅请求参考。

与 `tokenAccounts` 结合使用，监控一个钱包中的一种代币

matchMints 可与 tokenAccounts 扩展组合使用，因此一个过滤器可以同时匹配钱包所有者和铸币地址。以下示例会流式传输某个钱包 USDC 余额的每次变化：

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

accountInclude 与 tokenAccounts 结合使用，可以找出该钱包代币余额发生变化的交易。accountRequired 与 matchMints 结合使用，可进一步将结果缩小到涉及 USDC 的交易。

查看匹配内容

交易通过铸币地址匹配后，请在 meta.preTokenBalances[].mint 和 meta.postTokenBalances[].mint 中查找该铸币地址。对于普通转账，铸币地址通常不会出现在账户键中，因此不要在那里查找。对同一 accountIndex 上的 preTokenBalances 和 postTokenBalances 进行差异比较，即可查看转移了多少代币以及代币在由哪些所有者控制的账户之间转移。交易监控指南详细介绍了交易结构。

限制和注意事项

铸币地址与账户键使用相同的 accountInclude、accountExclude 和 accountRequired 列表，因此它们计入相同的每列表套餐限制。没有单独的铸币地址限制。
匹配成本不会随列出的铸币地址数量而增加。列出 100 个和 100,000 个铸币地址的性能相同，未设置该标志的订阅者不会产生额外开销。
历史重放支持 matchMints，因此重放订阅返回的交易与实时流原本会返回的交易相同。
如果你将压缩（布谷鸟）过滤器附加到交易订阅，matchMints 除了会用账户键探测该过滤器，也会用铸币地址集合进行探测。
matchMints 已在所有 LaserStream gRPC 区域、主网和开发网上线。目前尚不适用于 LaserStream WebSocket。
SDK 最低版本：JavaScript/TypeScript helius-laserstream 0.8.5、Rust helius-laserstream 0.6.4、Go go/v0.3.0。

Token Account (ATA) Filtering

匹配涉及钱包所拥有代币账户的交易

Transaction Monitoring

完整的过滤策略和可通过 gRPC 运行的示例

Subscribe Request Reference

所有交易过滤器字段，包括 matchMints

Historical Replay

使用相同过滤器回填最多 24 小时的代币活动

开始使用

数据流与事件监听

数据 API 与 RPC

交易服务

发送交易

钱包即服务

隐私

资源

问题：普通账户过滤器会遗漏大多数代币转账

`matchMints` 的工作原理

语义

在 LaserStream gRPC 中使用

与 `tokenAccounts` 结合使用，监控一个钱包中的一种代币

查看匹配内容

限制和注意事项

相关内容

Token Account (ATA) Filtering

Transaction Monitoring

Subscribe Request Reference

Historical Replay

​问题：普通账户过滤器会遗漏大多数代币转账

​matchMints 的工作原理

​语义

​在 LaserStream gRPC 中使用

​与 tokenAccounts 结合使用，监控一个钱包中的一种代币

​查看匹配内容

​限制和注意事项

​相关内容

Token Account (ATA) Filtering

Transaction Monitoring

Subscribe Request Reference

Historical Replay

问题：普通账户过滤器会遗漏大多数代币转账

`matchMints` 的工作原理

语义

在 LaserStream gRPC 中使用

与 `tokenAccounts` 结合使用，监控一个钱包中的一种代币

查看匹配内容

限制和注意事项

相关内容