NEARでホルダーsnapshotを作成する方法:任意のトークンやNFTコレクションのウォレットリストをCSVで取得
コミュニティに報酬を配りたいとき、allowlistを準備したいとき、あるいは単に自分のトークンを誰が持っているのかを知りたいとき。その第一歩が、NEARでホルダーsnapshotを作成する方法を押さえておくことです。わずか数秒で、トークンやNFTを保有するアカウントの完全なリストが手に入り、CSVでダウンロードしたり、そのままエアドロップへ流用したりできます。
このガイドでは、NEARにおけるsnapshotの用途、Smithiiのツールを使ってトークンやNFTコレクションから取得する方法、リストに含まれるものと除外されるもの、そして費用について解説します。それでは始めましょう。
ホルダーsnapshotとは?NEARでの用途を解説
snapshotとは、ある時点での資産分布のスナップショットで、そのトークンを保有するすべてのアカウントと残高が記録されたものです。NEARには他のネットワークにはない面白い特徴があり、alice.nearやTelegramのユーザー名のように読める名前のアカウントが多いため、リストが一目で把握できます。
開発者がよく使うケースは次の通りです。
- ホルダー向けエアドロップ: 別のトークンを持つユーザーや、コレクションのNFTを保有する人に、新しいトークンを配布する用途です。
- アローリスト: すでにプロジェクトに参加しているユーザーに、セールやミントの優先アクセス権を付与します。
- マイグレーション: トークンを再ローンチする場合、リストがあれば各ホルダーに元の保有量をそのまま戻せます。
- 分配状況の分析: 判断を下す前に、少数のウォレットがサプライを集中させすぎていないかを確認できます。
これらの用途はいずれも、ホルダー側に何かをさせたり許可を取ったりする必要はありません。トークンの残高はすべてチェーン上に公開されており、このツールの役割はそのデータを集めて整理し、すぐ使える形式で渡すことです。エクスプローラーのAPIを叩いたりスクリプトを書いたりする手間は不要です。だからこそ、自分のものではないトークンの調査にも使えます。たとえば連携したいプロジェクトのコミュニティを分析する場合などです。
NEARトークンのホルダーsnapshotを取る方法
SmithiiのNEAR向けToken Snapshotは、NEP-141トークンを保有するすべてのアカウントをエクスポートできるツールです。コードを書いたりエクスプローラーのAPIを使ったりする必要はありません。トレンドのトークンが提案されるほか、任意のトークンアドレスを貼り付けることもできます。ツール画面を開くと、次のような表示になります。
トークンアカウントと手数料用の11.55 NEARを用意しておけば、手順は次の通りです。
- NEARウォレットを接続: HOTやMeteorなど、セレクターにあるウォレットから選びます。
- トークンを選択: トレンドのトークンから1つクリックするか、アカウントを貼り付けます。例: token.rhealab.near。
- Take Snapshotをクリック: ツールがホルダー数を確認し、手数料の承認を求めます。
- リストをダウンロードまたは再利用: CSVやTXTで保存するか、そのままNEARのMultisenderに送信できます。
手数料が請求される前に、ツールがトークンのホルダー数を読み取り、名前の横に見積もりを表示します。上限を超える場合は支払い前に通知されるため、作成できないリストに料金を払うことはありません。
NEARのNFTコレクションからホルダーを取り出す方法
同じツールには2つ目のタブがあり、NEAR向けNFT SnapshotではNEP-171規格のコレクションを扱えます。残高の代わりに、そのコレクションのNFTを少なくとも1つ保有するアカウントを返します。開くとコレクションセレクターが表示されます。
動作はトークンの場合とまったく同じです。アクティブなコレクションを選ぶか、コントラクトのアカウントを貼り付け (例: asac.near)、Take Snapshotをクリックして11.55 NEARを承認し、リストをダウンロードするかmultisenderに送信します。セレクターに表示されるのはその日の転送回数が多いコレクションで、ホルダー数も合わせて表示されます。
ホルダーリストに含まれるものと除外されるもの
リストはNearBlocksがインデックスしたデータから生成され、ツールが渡す前にクリーンアップされます。残高ゼロのアカウントとトークンアカウント自体は除外されます。配布に使う意味がないためです。
一方、残高を持つコントラクトアカウントはそのままリストに残ります。RheaのプールやDAOのトレジャリーなどです。技術的には実在するホルダーですが人間ではないため、エアドロップで使う前にリストを確認して、含めるかどうかを判断してください。
リフレクション機能付きトークンのケース
リフレクション付きトークンでは、転送のたびに残高が自動的に増えるため、インデクサーが追いつかない場合があります。Smithiiで作成されたトークンについては、ツールが大口ホルダーの残高をチェーンから直接読み直すため、リスト上位の数値は実際の値になります。
NEARでトークンのsnapshotを取るタイミング
スナップショットを撮る瞬間が、誰に報酬を渡すかを決めます。日付を事前に告知してしまうと、直前の駆け込み購入が増え、報酬を受け取った途端に売る人や、複数回受け取るために残高を多数のアカウントに分散する人まで集まってしまいます。
キャンペーンを複雑にせず、これを回避するシンプルな方法が3つあります。
- エアドロップを告知する前にsnapshotを取る: こうすれば、リストには報酬目当てで集まった人ではなく、もともといた人が反映されます。
- 2回のスナップショットを組み合わせる: 今日1回取り、数週間後にもう1回取って、両方に出てくるアカウントだけに報酬を渡します。長く保有し続けるホルダーに直接報いる方法です。
- 最低保有量を設定する: 残高がごくわずかなアカウントはダストか、取り分を増やそうとしている人が多く、除外することでノイズを減らせます。
どんなルールでも悪用を完全に無くすことはできませんが、しっかりフィルタリングされたリストなら、長く残るホルダーにトークンが行き渡ります。これこそ、この手のキャンペーンを行うプロジェクトが本当に求めているものです。
NEARでsnapshotを取る費用と、何か問題が起きたときの挙動
| snapshotの種類 | 照会内容 | 上限 | 手数料 |
|---|---|---|---|
| トークンSnapshot | NEP-141トークンの残高を持つアカウント | 5,000ホルダー | 11.55 NEAR |
| NFT Snapshot | NEP-171コレクションのNFTを少なくとも1つ持つアカウント | 5,000ホルダー | 11.55 NEAR |
支払いは双方向で保護されています。トークンが大きすぎる場合は、支払う前にわかります。支払ったのにリストが読み込めなかった場合は、そのトークンとウォレットについて1日間だけ支払いが保持されるので、追加料金なしでsnapshotをやり直せます。
snapshotからエアドロップへ、途中のステップは不要
snapshotのあとは、そのアカウントに何かを配布するのが一般的な流れです。Smithiiならファイルをダウンロードして再アップロードする必要はなく、ワンクリックでNEARのMultisenderにホルダーが読み込まれ、必要なアカウントをあなたのトークンに登録まで済ませてくれます。
典型的な例が、あるコレクションのホルダーにプロジェクトのトークンで報酬を渡すケースです。NFT Snapshotを取り、multisenderにリストを送って全員に同じ数量を指定するだけで、数分で各ホルダーの手元に報酬が届きます。
アカウント登録込みでNEARでエアドロップを実行する手順の全体は、こちらで詳しく説明しています。
スナップショットは履歴にも残ります。過去のものを再ダウンロードしたり、2つの日付を比較してキャンペーン後にトークンの分布がどう変わったかを確認できます。
FAQ
NEARでホルダーのsnapshotを取るのにいくらかかりますか?
snapshotはトークンでもNFTコレクションでも1回あたり11.55 NEARに加えて、わずかなガス代がかかります。手数料はリストが構築される前にSmithiiへ支払われます。
どのトークンやコレクションを照会できますか?
NEARメインネットのNEP-141トークンとNEP-171コレクションなら、5,000ホルダーまで対応しています。トークンやコレクションがこの上限を超える場合、ツールは支払い前にリクエストを拒否します。
支払ったあとにリストが読み込めなかった場合はどうなりますか?
お支払いは、そのトークンとウォレットについて1日間保持されます。もう一度snapshotを実行しても、二重に課金されることはありません。
snapshotには残高ゼロのウォレットも含まれますか？
いいえ。残高ゼロのアカウントとトークン自身のアカウントはリストから除外されます。プールのような残高を持つコントラクトのアカウントは表示されるので、エアドロップ前に確認しておくのがおすすめです。
数日前に取得したsnapshotをもう一度使えますか？
はい。スナップショットは履歴に保存されており、後からダウンロードや再利用が可能です。たとえば2つの日付間で分布がどう変化したかを比較する用途にも使えます。
まとめ
NEARでホルダーのsnapshotを取得する方法が分かれば、任意のトークンやコレクションをアカウントのリストに変換できるようになります。エアドロップ、アローリスト、分析のいずれにもすぐ使える形です。ツールは課金前にサイズをチェックし、空残高も自動で除外してくれます。
配布前にコントラクトのアカウントを確認し、multisenderとの連携も活用してください。これで、リストから配布までの流れがそのまま完結します。
