通过 gRPC 订阅 Solana 交易 - Solana Tracker

按交易引用的账户筛选已执行交易。费用、日志、错误和代币余额来自执行元数据；具体交易含义需要解码程序指令或事件。先将快速入门中的辅助代码保存为同一目录的 stream.mts。以下示例使用相同的环境变量与依赖。

按程序或账户订阅

transactions.mts

import bs58 from "bs58";
import { subscribe } from "./stream.mts";

const address = process.env.WATCH_ADDRESS;
if (!address) throw new Error("Set WATCH_ADDRESS to a program or account");

for await (const update of subscribe({
  transactions: {
    selected: {
      vote: false, failed: false,
      accountInclude: [address], accountExclude: [], accountRequired: [],
    },
  },
})) {
  const transaction = update.transaction?.transaction;
  if (!transaction) continue;
  console.log({
    signature: bs58.encode(transaction.signature),
    slot: update.transaction!.slot,
    feeLamports: transaction.meta?.fee,
    error: transaction.meta?.err,
    logs: transaction.meta?.logMessages,
  });
}

export WATCH_ADDRESS="YOUR_PROGRAM_OR_ACCOUNT_ADDRESS"
npx tsx transactions.mts

组合交易筛选条件

accountInclude：至少匹配一个列出的账户。
accountRequired：必须匹配所有列出的账户。
accountExclude：排除引用任意列出账户的交易。
vote: false：排除验证者投票。
failed: false：仅成功执行；true 仅失败；省略则包含两者。
signature：选择一个交易签名。

Include、required 与 exclude 条件共同生效。空 include 列表本身不缩小范围。

解释交易结果

签名为二进制数据，显示时转换为 base58。Slot 位于 update.transaction，执行详情位于 update.transaction.transaction.meta。余额变化可能包含费用、租金或多个指令，不能直接视为单次转账金额。

处理重复与间隔

索引 confirmed 或 finalized 交易时，可使用签名去重。消费 processed 更新时，应保留 slot/分叉上下文，以便后续确认时对账。重连本身不会补齐遗漏历史。

相关指南

Pump.fun 交易

可靠性与性能