Как выгрузить список holders в Arc: и для token, и для коллекции

Прежде чем запускать airdrop, собирать allowlist или закрывать доступ для тех, кто уже внутри, нужно ответить на один вопрос: у кого сейчас на руках твой token или твоя коллекция. Именно для этого стоит разобраться, как выгрузить список holders в Arc, чтобы получить файл со всеми holders token или NFT.

Идёт ли речь про token или про NFT, процесс один и тот же. Главное — понимать, какой именно snapshot тебе нужен и как проще всего выжать из него максимум. В этом гайде я показываю, как это делается. Погнали.

Как выгрузить список holders для token в Arc: пошагово

Token Snapshot от Smithii для Arc делает запрос on-chain напрямую, без зависимости от внешнего индексатора и без необходимости, чтобы token значился в каких-либо списках. Хватит адреса контракта, поэтому подойдёт любой ERC-20 в сети, твой или нет. Вот как выглядит интерфейс:

Когда адрес контракта найден, остаётся пять шагов:

1. Подключи wallet к сети. Он нужен, чтобы оплатить комиссию и чтобы инструмент мог сохранить историю запросов.
2. Оставайся на вкладке Token Snapshot, именно она работает с ERC-20.
3. Введи контракт: вставь адрес или найди его по названию. Под полем есть быстрые ссылки на самые активные tokens в сети.
4. Нажми Take Snapshot и подтверди оплату. Сумма выводится прямо над кнопкой до того, как ты подпишешь.
5. Дождись окончания выгрузки и скачай CSV с адресами.

Как выгрузить список holders коллекции в Arc без единой строчки кода

Вторая вкладка — это NFT Snapshot для коллекций Arc, переключаешься на неё через вкладки сверху. Данные нужны те же: адрес контракта, только уже ERC-721. Поскольку владение NFT — публичная информация, работает с любой существующей коллекцией в Arc. Выглядит так:

Порядок действий почти не отличается от предыдущего:

1. Подключи wallet к Arc. Без него не получится ни оплатить комиссию, ни зафиксировать выгрузку.
2. Перейди на вкладку NFT Snapshot, вторую из двух. Первая работает с ERC-20 и коллекции не распознаёт.
3. Вставь адрес контракта ERC-721 в поле поиска или введи название коллекции, чтобы выбрать её из списка.
4. Нажми Take Snapshot и подпиши платёж. Итоговая сумма показана под кнопкой ещё до подтверждения.
5. Скачай CSV, как только чтение закончится. Он к тому же привязан к wallet, которым ты платил, так что при необходимости его можно будет получить снова.

Что именно ты получаешь в каждом списке

Вот тут две вкладки и перестают быть похожими. Обе экспортируют только адреса, ничего больше, но принцип формирования строк у них разный, и именно от этого зависит, для чего тебе пригодится файл.

Дедупликацию во второй колонке стоит понять чётко, потому что она многих застаёт врасплох. wallet с сорока экземплярами коллекции занимает одну строку, ровно так же, как и с единственным, и в файле нет ничего, что подсказало бы, на какой из двух ты сейчас смотришь.

Для allowlist такой формат подходит идеально: задача забронировать одно место на человека, и тот, кто собрал сорок штук, не должен получить сорок слотов. А вот для распределения наград пропорционально владению это уже ограничение, и та же логика работает на вкладке с tokens, где балансов для градации тоже нет.

Контракты в обоих списках идут без пометок

Владелец для сети это адрес, который в ней записан как таковой. А за ним далеко не всегда стоит человек, с которым можно поговорить.

В списке ERC-20 liquidity pool попадает как обычный адрес, а с ним и любой контракт, который держит tokens. В списке коллекции типичный случай другой: когда экземпляр выставлен на продажу на маркетплейсе, который держит его у себя всё время листинга, владельцем на этот период считается контракт-хранитель. То же самое с vaults, staking и займами, где NFT принимают в залог. Человек по-прежнему стоит за операцией, но в файле фигурирует контракт.

Поскольку ни один из двух экспортов не содержит меток, такие строки на глаз не отличишь. Проверка обходится дёшево: прогони незнакомые адреса через эксплорер Arc и посмотри, есть ли у них связанный код. Если есть, это контракт. Стоит сделать это до раздачи, потому что отправку на контракт, который не знает, что делать с полученным, никто уже не откатит.

Определи момент отсечения до запуска чтения

Файл это снимок состояния сети в тот момент, когда ты его запускаешь. Сам он не обновляется: каждая последующая передача меняет картину, а CSV остаётся таким, каким был.

Для коллекции это критичнее, чем для token, потому что NFT переходят из рук в руки не равномерно, а рывками. Анонс, скачок цены или ожившая вторичка сдвигают за короткое время то, что за спокойные недели не сдвигается вообще, так что две выгрузки с разницей в час могут заметно расходиться по адресам.

Поэтому порядок важен. Сначала фиксируется момент отсечения, потом запускается чтение. Объявление ‘снимок делаем в пятницу в 18:00’ избавит тебя от предсказуемых претензий тех, кто продал за полчаса до и не попал. А если задача наградить тех, кто держит долго, решение простое: два запроса, разнесённых по времени, скрестить в таблице и получить список адресов, которые фигурируют в обоих.

Сколько стоит выгрузить snapshot в Arc

62,5 USDC за запуск, фиксированный тариф, одинаковый на обеих вкладках, плюс gas за транзакцию. Так как Arc берёт gas тоже в USDC, весь расход остаётся в одной валюте, без конвертаций посередине. Если на wallet ещё нет баланса, придётся завести USDC в сеть до запуска чтения.

Фиксированный значит, что размер не участвует в расчёте: token с пятьюдесятью wallets обходится так же, как с двадцатью тысячами, и серия из двухсот экземпляров так же, как из десяти тысяч. Следствие двойное. На большой базе каждый полученный адрес выходит очень дёшево, что переворачивает интуицию тех, кто пришёл с инструментов с оплатой за запись. В маленьком проекте всё наоборот, так что у каждой выгрузки лучше уже иметь назначенное применение, а не запускать её из любопытства.

Небольшая ремарка про бюджет, прежде чем идти дальше: если единственная цель списка — сразу же провести раздачу, multisender сам умеет вытянуть его за ту же сумму, и вы сэкономите шаг. Отдельно выгружать список здесь имеет смысл, когда файл нужен, чтобы сохранить его, переиспользовать позже или сравнить со следующим срезом.

Зачем экспортировать holders token в Arc

Отсутствие балансов и количеств кажется недостатком до тех пор, пока не посмотришь, для чего этот файл реально используется. Вот три сценария, где ничего кроме адреса и не нужно:

• Плоская раздача, когда все получают одинаково. CSV идёт прямо в массовую рассылку токенов в Arc, ничего переформатировать не надо.
• Allowlist для минта, пресейла или раннего доступа, где важно только одно: адрес внутри или снаружи.
• Отслеживать, как меняется твоя база. Два среза с разницей во времени показывают, сколько человек заходит, сколько уходит и кто держится с самого начала.

Третий сценарий самый недооценённый. Сравнить два файла в обычной таблице — и у тебя на руках список тех, кто остался, и тех, кто ушёл. Это отличная сегментация, и никакие балансы для неё не нужны. В свежезапущенной сети вроде Arc такой мониторинг стоит ещё дороже: база маленькая, и каждый вход или выход весит.

Ради честности стоит сказать и о том, чего в файле нет. Не получится сделать раздачу по тирам, замерить концентрацию supply или узнать, сколько wallet в среднем держит одна wallet в коллекции. Эти три вопроса решаются в обозревателе сети: он показывает балансы и позволяет копнуть конкретный адрес. snapshot даёт охват, обозреватель — детали.

FAQ

Сколько стоит snapshot holders в Arc?

62,5 USDC за каждую выгрузку по фиксированной ставке плюс gas сети, который тоже оплачивается в USDC. Цена одинаковая и во вкладке токенов, и во вкладке коллекций, и не зависит ни от количества holders, ни от размера серии.

Включает ли CSV балансы или количество NFT у каждой wallet?

Нет, ни в одном из вариантов. Выгрузка по ERC-20 содержит адреса без балансов и без доли в supply, а выгрузка по коллекции не тянет ни token IDs, ни количество единиц на владельца. Если кампания предполагает награду с весами, эти данные придётся собирать другим путём, прежде чем её проектировать.

Можно ли вытянуть holders у token или коллекции, которые мне не принадлежат?

Да. Кто чем владеет — это открытая информация на blockchain, поэтому достаточно адреса контракта, никакого отношения к проекту иметь не нужно. Это стандартный способ выйти с раздачей на комьюнити близкого по духу проекта или прикинуть реальный размер чужой базы holders.

Какая вкладка мне нужна: token или NFT?

Та, что соответствует типу контракта. Если актив взаимозаменяемый и у людей есть какое-то его количество, это ERC-20, и он идёт в Token Snapshot. Если каждая единица уникальна и владение поштучное, это ERC-721, и он идёт в NFT Snapshot. Контракт, вставленный не в ту вкладку, не вернёт результатов.

Подойдёт ли инструмент, чтобы раздать airdrop между holders?

Подойдёт, если все получают одинаково. С одной строкой на адрес файл ложится в multisender сети без правок. Чего он не позволяет: градуировать выдачу по тому, сколько у кого есть, потому что этого числа в CSV нет.

Можно ли восстановить старый snapshot?

Да, инструмент хранит историю выгрузок, привязанную к твоему wallet, так что при подключении ты снова видишь всё, что делал раньше. Тем не менее каждый CSV имеет смысл сохранять и у себя, особенно если планируешь сравнивать два списка, снятых в разное время.

Заключение

Теперь, когда ты знаешь, как сделать snapshot в Arc для токенов и коллекций NFT, остаётся только решить, что делать с этим списком. Если ты проводишь аудит wallets собственного проекта, эти данные пригодятся, чтобы понять, изменилось ли количество holders или выросло, либо чтобы устроить airdrop с наградами внутри своего комьюнити.

С трезвыми ожиданиями файл закрывает то, ради чего его почти всегда и делают: отфильтровать доступ, собрать allowlist или прогнать раздачу с одинаковой суммой для всех. Зафиксируй срез, сделай выгрузку и перепроверь список, прежде чем что-то по нему подписывать.

Jose Araujo

Контент-креатор и SEO-контрибьютор в Smithii. Студент системной инженерии и энтузиаст crypto-tech.