Обновить метаданные токена Solana: имя, символ и логотип

Обновить метаданные токена Solana выглядит как одна задача, а их две. Метаданные это публичная карточка токена: имя, символ, логотип, описание и ссылки. Эти сведения лежат не в одном месте, а в двух, и правятся они по отдельности.

Отсюда самое частое сообщение после запуска: логотип поменяли неделю назад, а Solscan всё ещё показывает старое имя.

• Имя, символ и веб-адрес записаны в сети. Их правка стоит комиссию.
• Логотип, описание и ссылки на соцсети лежат в файле. Их правка бесплатна.
• Правка одного слоя никогда не трогает другой.
• Закрыть метаданные навсегда это единственное решение, которое не отменить.

Два слоя метаданных

Когда токен выпускают, его данные приходят через Metaplex Token Metadata, стандарт, которому следует почти любой токен на Solana. Он и создаёт первый слой. Как этот аккаунт привязан к минту, описано в документации Solana про Metaplex Metadata.

Первый слой лежит в сети. В нём ровно три вещи: имя, символ (тикер) и веб-адрес, который указывает на файл. Кошельки и обозреватели читают сначала отсюда. Тронуть любое из трёх значит записать в сеть, а это стоит денег.

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

Поэтому когда кто-то меняет логотип, а имя стоит на месте, ничего не сломалось. Логотип в файле, имя в сети, и правка одного никогда не сдвигает другое.

Поле	Слой	Как поменять	Стоимость
Имя токена	В сети	Инструмент обновления	0,2 SOL
Символ (тикер)	В сети	Инструмент обновления	0,2 SOL
Веб-адрес (URI)	В сети	Инструмент обновления	0,2 SOL
Логотип	Файл	Перезалить по тому же адресу	бесплатно
Описание	Файл	Перезалить по тому же адресу	бесплатно
Сайт и соцсети	Файл	Перезалить по тому же адресу	бесплатно

Когда метаданные правда стоит трогать

• Нужен новый логотип. Дизайн отдал версию получше. Логотип лежит в файле, поэтому файл перезаливают по тому же адресу, и всё. Бесплатно.
• Поменялась ссылка. Discord переехал, аккаунт X сменился, сайт на другом домене. То же самое: правят файл.
• Имя или символ неверные. Запускались под рабочим названием или в тикере опечатка. Это запечатанная сторона, значит через инструмент обновления.
• Файл переезжает в постоянное хранилище. Меняется сам адрес, поэтому это тоже запись в сеть. Этот шаг всегда идёт перед любой блокировкой.

Первые два случая сеть вообще не трогают и ничего не стоят, повторять их можно сколько угодно. Последние два идут через одну и ту же форму, будь то имя, тикер или адрес. Проще говоря: косметика бесплатна, а цену имеют только три запечатанных поля.

Как обновить метаданные токена Solana по шагам

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

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

Перед блокировкой файл обязан лежать в постоянном хранилище. Катастрофа, которая повторяется снова и снова: команда кладёт файл на бесплатный хостинг во время запуска, через пару недель закрывает метаданные, а спустя месяцы хостинг истекает. Адрес начинает отдавать 404. Имя остаётся видно, потому что запечатано в сети, а логотип и описание пропадают, и так как права на правку больше нет, никто уже не переведёт токен на новый файл.

Закрывать или оставить открытым

Рано или поздно кто-нибудь скажет закрыть метаданные. Закрыть значит навсегда отдать право на правку, чтобы никто больше ничего не менял, включая саму команду. Покупателям это нравится, и часть чек-листов для листинга такое спрашивает.

Решает порядок действий. Сначала файл переносят на Arweave или в IPFS с пиннингом, потом веб-адрес в сети переводят на новую ссылку, затем несколько дней проверяют с двух разных машин, и только после этого закрывают.

При закрытии выбирают глубину. Инструмент отзыва права на правку убирает только право на имя, символ и адрес. Инструмент make immutable отдаёт права на правку, выпуск и заморозку разом. Все три разобраны рядом в материале как отозвать полномочия токена.

Простое правило: закрывать, когда бренд устоялся, когда токен полгода живёт без переименований, когда файл уже в постоянном хранилище или когда этого прямо просит биржа. Ждать, пока ребрендинг всё ещё возможен, пока хостинг можно потерять, пока в воздухе висит вторая версия. Это единственная дверь во всём процессе, которая открывается только в одну сторону.

Почему правка иногда не проходит

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

Второй случай выглядит как поломка инструмента, но это не она. Чтение состояния показывает, у какого кошелька право, остаётся подключить именно его. Если право действительно ушло, дороги назад нет, и единственный путь это новый минт токена.

Есть третий случай, похожий на первые два и совершенно безобидный: правка давно прошла, а кошелёк всё ещё показывает старую картинку. Причины, по которым токен виден неправильно или не виден вовсе, собраны в материале токен не отображается в Phantom. А чтобы токен появился в поиске обозревателя, нужна отдельная процедура со своими условиями, она описана в руководстве Solana по верификации токенов.

Ошибки, которые повторяются чаще всего

• Править файл и считать, что имя подтянулось. Логотип в файле, имя в сети токена. Проверять их нужно по отдельности.
• Закрывать, пока файл на временном хостинге. Самая дорогая ошибка в списке, и после неё уже ничего не исправить.
• Не дождаться кэша. Десять или тридцать минут это норма. Прежде чем повторять операцию, прочитайте состояние токена.
• Пытаться переименовать через файл. Поле имени в файле кошельки игнорируют. Настоящее переименование всегда идёт через инструмент.
• Подписать не тем кошельком. Комиссию это не стоит, но каждый раз стоит нескольких минут путаницы.

Частые вопросы про метаданные

Можно ли поменять имя токена после запуска?

Можно, пока право на правку ещё у какого-то кошелька. Чтение состояния скажет это бесплатно, а сама правка стоит 0,2 SOL и подписывается тем же кошельком.

Почему токен всё ещё показывает старый логотип?

Либо правили не тот слой, либо кошелёк держит картинку в кэше. Перезалейте логотип по тому же адресу, прочитайте состояние токена и подождите кэш.

Сколько стоит обновление?

Правка файла не стоит ничего. Имя, символ или адрес обойдутся в 0,2 SOL плюс небольшая сетевая комиссия, и сумма видна на странице до подтверждения.

Стоит ли делать токен неизменяемым?

Когда бренд устоялся, у токена есть история и файл лежит в постоянном хранилище, стоит. Пока ребрендинг возможен, лучше подождать.

Что такое update authority?

Это право конкретного кошелька позже править метаданные токена, записанные в сети. Отдали его, и запись запечатана навсегда.

Работает ли это для Token-2022?

Лишь отчасти. Token-2022 умеет носить метаданные внутри самого токена и идёт другим путём. Этот материал описывает классический путь SPL с Metaplex.

Коротко о главном

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