Solana地址历史如何完整翻页？

getSignaturesForAddress返回的是“当前RPC能看到的、涉及该地址的签名摘要”，并且按新到旧排序。完整抓取不能用页码，因为新交易会不断插入顶部；正确做法是把每页最后一个signature作为下一页的before，同时保存游标、slot和抓取边界，允许中断后续跑。

请求参数先固定成采集合同

首轮请求至少固定address、limit、commitment和可选的until。limit决定单页上限，不保证一定返回这么多条；commitment决定节点采用哪个确认视图；until用于在到达某个已知签名时停止，但不替代before翻页。

{
  "method": "getSignaturesForAddress",
  "params": ["目标地址", {"limit": 1000, "commitment": "finalized"}]
}

若需要近实时监控，可单独跑confirmed增量任务；历史归档建议使用finalized，避免把短期重组造成的变化混进同一结果集。两种口径不要写入一张没有标记的表。

游标循环如何避免重复和死循环

处理完一页后，取最后一行signature作为nextBefore。下一次请求带上before: nextBefore，正常情况下返回更早记录。每条结果以signature作为主键去重，并记录slot、err、memo、blockTime和confirmationStatus。

before = null
while true:
  page = fetch(address, before)
  if page is empty: stop with reason
  upsert every signature
  next = page.last.signature
  if next == before: fail as cursor-stalled
  checkpoint(next, page.last.slot)
  before = next

游标不前进必须报错，不能无限重试。任务重启时从最后一个已提交checkpoint继续，而不是从第一页重抓。

空页不只有“历史结束”一种含义

空数组可能表示确实到达最早记录，也可能是该RPC不保留更早账本、地址参数错误、commitment视图尚不可用或服务商临时故障。判断时同时查询节点最早可用区块、当前slot，并用第二家RPC带相同before复取。

HTTP 429、超时和RPC错误不能转换成空数组。限流应指数退避并保留原游标；历史裁剪则应把缺口标为unavailable_before_slot，切换archive RPC后继续。不要用零条交易填补未知区间，否则统计结果会把“没数据”伪装成“没有活动”。

签名摘要不等于交易明细

列表中的err=null说明交易执行没有返回错误，但仍不能证明目标代币转账、余额变化或业务事件符合预期。对每个signature调用getTransaction，固定encoding和maxSupportedTransactionVersion，解析accountKeys、instructions、meta.err、preBalances、postBalances以及代币余额。

getTransaction返回null也要分类：交易版本不支持、节点历史缺失、commitment不满足或签名无效。大批量补详情时将“发现签名”和“解析交易”拆成两个队列，避免一个难查详情阻塞分页游标。