推出 gTFA 代币账户过滤器

去年 10 月，我们发布了 getTransactionsForAddress。这是一种用于查询历史数据的新 Solana RPC 调用，将 getSignaturesForAddress 和 getTransaction 合并为一个方法。

今天，我们很高兴地宣布，getTransactionsForAddress (gTFA) 现在只需一次 RPC 调用，即可查询钱包的代币转账历史。

新的 tokenAccounts 功能允许用户包含钱包关联代币账户的交易。此前，gTFA 及其前身 getSignaturesForAddress 都会遗漏这些交易。

过去，开发者不得不先查询 getTokenAccountsByOwner，再针对每个代币账户查询 getSignaturesForAddress。

这种方式缓慢且成本高昂，通常需要额外执行数百次 RPC 调用。

现在，只需使用 tokenAccounts 调用一次 getTransactionsForAddress。

问题所在

在 Solana 上，你的钱包实际上并不直接持有代币。

相反，你的钱包拥有关联代币账户 (ATA)，而这些代币账户负责持有你的代币。

例如，当有人向你发送 USDC 时，USDC 会进入你的 USDC 代币账户，而不是你的主钱包地址。

这给查询钱包交易历史带来了一个大问题：

当你对钱包调用 getSignaturesForAddress 时，只能获得直接引用该钱包地址的交易。

与代币账户交互但未提及钱包的代币转账根本不会显示。

变通方案

在今天之前，开发者必须实施一个繁琐的变通方案：

调用 getTokenAccountsByOwner，获取钱包的代币账户
针对钱包本身调用 getSignaturesForAddress
针对每一个代币账户调用 getSignaturesForAddress
合并所有结果
去重（许多交易会涉及多个账户）
按时间顺序排序

这种方法存在几个问题：

1. 性能低下

一个拥有 50 个代币账户的钱包，仅为了构建完整历史记录就需要 51 次以上的 RPC 调用。专业交易者、重度 DeFi 用户或休闲 meme 币交易者可能拥有数百个代币账户。

2. 分页效率低

想获取最近的 20 笔交易？你不能简单地从每个来源获取 20 笔再合并，而是需要获取所有数据、去重、排序，最后才能取前 20 笔交易。

如果不超量获取数据，就无法高效分页。

3. RPC 成本不断累积

每次 RPC 调用都有额外开销。当每个用户请求需要执行 100 次以上的调用时，成本会迅速上升，尤其是在大规模使用时。

解决方案

使用新的 tokenAccounts 过滤器，只需一次 RPC 请求即可获得完整的钱包历史记录：

代码

{
    "jsonrpc": "2.0",
    "id": "helius-example",
    "method": "getTransactionsForAddress",
    "params": [
        "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
        {
            "filters": {
                "tokenAccounts": "all"
            },
            "sortOrder": "asc",
            "limit": 100
        }
    ]
}