如何在 NEAR 上制作持有者 snapshot：以 CSV 格式拿到任意代币或 NFT 系列的钱包列表
无论你是要奖励社区、准备一份 allowlist，还是单纯想弄清楚谁持有你的代币，学会如何在 NEAR 上制作持有者 snapshot都是第一步。几秒钟内，你就能拿到持有某个代币或某个 NFT 的完整账户列表，可直接下载为 CSV 或者转化为空投。
本指南会讲清楚 NEAR 上的 snapshot 是做什么用的、如何用 Smithii 的工具从代币和 NFT 系列中生成列表、列表里包含什么、又排除了什么，以及费用是多少。开始吧。
什么是持有者 snapshot，它在 NEAR 上有什么用
snapshot 就是某一时刻资产分布的一张快拍，记录所有持有该资产的账户以及它们的余额。NEAR 相比其他网络有个有意思的优势：很多账户名都是可读的，比如 alice.near 或者直接是 Telegram 用户名，整份列表一眼就能看明白。
对开发者来说，最常见的用途有这些：
- 给持有者空投：把新代币发给持有某个代币的用户，或者持有你系列里某个 NFT 的用户。
- 白名单：给已经参与项目的用户优先销售或优先铸造的资格。
- 迁移：如果你要重新发币，这份列表能让你把每位持有者原来的数量原封不动还回去。
- 分布分析：做决策前先看看是不是少数几个钱包集中了太多供应量。
这些用途都不需要持有者做任何事，也不需要他们授权。任何代币的余额都公开在链上，这款工具的价值就是把这些数据整理好、清理干净，再以你能直接用的格式交给你，不用去调用浏览器 API，也不用自己写脚本。所以它也可以拿来研究不是你发的代币，比如你想合作的那个项目的社区代币。
如何在 NEAR 上为代币做一次持有者 snapshot
Smithii 推出的 NEAR Token Snapshot 是一款工具，让你无需写代码也不用调用浏览器 API，就能导出所有持有某个 NEP-141 代币的账户。它会推荐当下活跃度最高的代币，你也可以直接粘贴任意其他代币。进入工具界面后，你会看到下面这些内容：
如果你手上有代币账户，并且备好了 11.55 NEAR 作为手续费，流程是这样的：
- 连接你的 NEAR 钱包：HOT、Meteor，或者选择器里的任意一款都行。
- 选择代币：点击某个热门代币，或者粘贴它的账户，比如 token.rhealab.near。
- 点击 Take Snapshot：工具会核对持有者数量，并提示你确认手续费。
- 下载或复用列表：导出 CSV 或 TXT，或者直接发送到 NEAR 的 Multisender。
在收费之前，工具会先读取代币的持有者数量，并在代币名称旁边显示预估值。如果超过上限，付款前就会告知你，所以你永远不会为一份构建不出来的列表付费。
如何从 NEAR 的 NFT 系列中导出持有者
同一款工具还有第二个页签，就是 针对 NEAR 的 NFT Snapshot，专门处理 NEP-171 标准的系列。它返回的不是余额，而是至少持有该系列中一个 NFT 的账户。打开后你会看到系列选择器：
操作方式和代币那边完全一样。选择一个活跃的系列，或者粘贴它的合约账户，比如 asac.near，点击 Take Snapshot，确认 11.55 NEAR 的手续费，然后下载列表或者直接发送到 multisender。选择器里显示的系列是当天转账次数最多的，旁边还会标出它们各自的持有者数量。
持有者列表包含哪些内容，又会排除哪些
列表来自 NearBlocks 索引的数据，工具在交付前会先做一次清理。余额为零的账户以及代币自身的账户会被剔除，因为它们对分发毫无意义。
保留下来的是有余额的合约账户，比如 Rhea 的流动性池或者某个 DAO 的金库。从技术层面讲，它们确实是真实的持有者，但毕竟不是真人，所以用于空投前请先过一遍列表，自己决定要不要把它们算进去。
reflection 类代币的情况
reflection 类代币的余额会随着每一次转账自动增长，索引器可能会有延迟。对于用 Smithii 创建的代币，工具会直接从链上重新读取大额持有者的余额，这样列表顶部的数字就是真实数值。
什么时候该为你的 NEAR 代币做 snapshot
你按下快门的那一刻，决定了你会奖励给谁。如果你提前公布日期，就会吸引到最后一刻的买盘，这些人一拿到奖励就会卖掉；还会有人把余额拆分到多个账户，想多薅几次。
有三种简单的方法可以避免这种情况,而且不会让活动变复杂:
- 在公布 airdrop 之前就做 snapshot:这样名单反映的是本来就在的人,而不是冲着奖励才来的人。
- 结合两次快照:今天拍一张,过几周再拍一张,只奖励两次都出现的账户。这是直接奖励长期持有者的方式。
- 设置最低余额门槛:持仓金额过小的账户通常是 dust,或者是想拆分多拿一份的人,把它们排除掉可以减少噪音。
没有任何规则能完全杜绝滥用,但是一份经过筛选的名单会把 token 分给真正留下来的 holder,这正是任何做这类活动的项目所追求的。
在 NEAR 上做一次 snapshot 要多少钱,出问题了怎么办
| snapshot 类型 | 查询内容 | 上限 | 手续费 |
|---|---|---|---|
| Token Snapshot | 持有某个 NEP-141 token 的账户 | 5,000 holder | 11.55 NEAR |
| NFT Snapshot | 至少持有一个 NEP-171 系列 NFT 的账户 | 5,000 holder | 11.55 NEAR |
付款在两个方向上都有保障。如果 token 太大,你在付款前就会知道。如果你付了款但名单没能加载出来,付款会为那个 token 和那个 wallet 保留一天,所以你可以重新跑一次 snapshot,不会被二次扣费。
从 snapshot 直接走到 airdrop,中间不用多做任何步骤
做完 snapshot 之后,通常都会给那些账户发点东西。用 Smithii 就不用先下载文件再重新上传,因为一键就能把 holder 加载进 NEAR 的 Multisender,它还会顺便为需要的账户在你的 token 上完成注册。
一个常见的例子是用你项目的 token 奖励某个系列的 holder。你做一次 NFT Snapshot,把名单发给 multisender,选一个所有人统一的数量,几分钟后每个 holder 就能拿到自己的奖励。
这里是完整的流程:在 NEAR 上做一次 airdrop,包含账户注册在内。
快照还会保留在你的历史记录里。你可以重新下载过去的某一次,或者对比两个日期,看看一次活动之后你的 token 分布有什么变化。
FAQ
在 NEAR 上做一次 holder snapshot 要多少钱?
每次 snapshot 收费 11.55 NEAR,不管是 token 的还是 NFT 系列的,再加一点 gas。手续费是在名单构建之前付给 Smithii 的。
我可以查询哪些 token 和系列?
NEAR mainnet 上任何 NEP-141 token 和任何 NEP-171 系列都可以,持有者数量上限 5,000。如果 token 或者系列超过了这个上限,工具会在你付款之前直接拒绝。
付款之后名单没加载出来怎么办?
你的付款会为该代币和该钱包保留一天。再次执行 snapshot，不会被二次收费。
snapshot 包含零余额的钱包吗？
不包含。零余额账户以及代币自身的账户都不会出现在列表中。有余额的合约账户（例如流动性池）会被包含在内，建议在空投前先核查一下。
我能重做几天前的 snapshot 吗？
可以。snapshot 会保存在你的历史记录中，之后可以随时下载或复用，比如用来对比两个日期之间持仓分布的变化。
总结
一旦掌握了在 NEAR 上制作持有者 snapshot 的方法，你就能把任何代币或 NFT 系列转化成一份账户清单，可直接用于空投、allowlist 或数据分析。工具会在收费前检查规模，并自动过滤掉空余额的账户。
分发前先检查合约账户，充分利用与 multisender 的联动。这样一来，从清单到分发的衔接就是即时完成的。
