При создании токена в Solana базовый контракт SPL Token сохраняет только сырые балансы и количество десятичных знаков. Он не хранит название токена, его тикер, описание, официальный сайт или логотип.
Для отображения информации о токене в кошельках (например, Phantom и Solflare) и на децентрализованных биржах (Raydium, DexScreener) Solana использует Стандарт метаданных Metaplex.
Понимание того, как ончейн-аккаунты ссылаются на off-chain JSON-файлы, гарантирует корректное отображение логотипа и информации без сбоев.
Ончейн-аккаунты против Off-Chain метаданных
Стандарт метаданных Metaplex разделяет информацию о токене на два уровня:
Специальный аккаунт в памяти валидаторов Solana, привязанный к адресу минта токена. Он хранит фиксированные текстовые поля:
- Название (Name): Название токена (до 32 символов).
- Тикер (Symbol): Символ токена (до 10 символов).
- URI: Ссылка (до 200 символов), указывающая на внешняя JSON-файл.
- Update Authority: Публичный ключ с правами на изменение метаданных.
2. Внешний JSON-файл метаданных (Off-Chain)
Структурированный JSON-файл, размещенный в децентрализованном хранилище (например, Arweave или IPFS). Он содержит расширенные данные о проекте:
image: Прямая ссылка на файл логотипа в формате PNG, JPEG или SVG.description: Подробное описание проекта.external_url: Ссылка на официальный сайт.properties.files: Массив медиафайлов и типов контента.
Официальные спецификации описаны в Документации разработчиков Metaplex.
Распространенные причины неработающих логотипов
Создатели токенов часто замечают, что логотип отображается в кошельке Phantom, но не загружается на Solscan (или наоборот). Это происходит из-за ошибок в оформлении:
- Косвенные ссылки на картинку: Указание ссылки на веб-страницу вместо прямой ссылки на файл изображения, заканчивающийся на
.png или .svg.
- Ограничения CORS: Размещение логотипа на централизованном сервере, который блокирует кросс-доменные запросы от кошельков и бирж.
- Не квадратное изображение: Использование картинок с нестандартным соотношением сторон. Кошельки требуют строго квадратные логотипы (например, 512x512 пикселей).
- Временные хостинги: Загрузка логотипов на бесплатные сервисы, которые удаляют файлы через 30 дней.
Рекомендуемые стандарты метаданных
Чтобы логотип корректно отображался во всех кошельках и на DEX-агрегаторах, соблюдайте следующие правила:
- Формат изображения: PNG или SVG (желательно с прозрачным фоном).
- Размер: Квадрат 512x512 пикселей (объемом менее 1 МБ).
- Хостинг JSON: Децентрализованное хранилище (шлюз Arweave или IPFS).
- Протокол HTTPS: Все URI должны использовать безопасные протоколы
https:// или ar://.
Как PumpBolt автоматизирует создание метаданных
Ручное создание и загрузка JSON-файлов Metaplex требует настройки кошельков Arweave и использования консольных инструментов разработки.
Конструктор токенов Solana на PumpBolt автоматизирует весь процесс в один шаг:
- Вы загружаете квадратный логотип прямо в веб-форме.
- PumpBolt оптимизирует картинку и загружает ее в децентрализованное хранилище Arweave.
- PumpBolt генерирует валидный JSON-файл метаданных Metaplex.
- При выпуске токена PumpBolt привязывает Arweave URI к ончейн-аккаунту метаданных в той же транзакции.
Соблюдение стандарта Metaplex и использование надежного хранилища гарантирует, что брендинг вашего токена останется доступным и неизменным во всей экосистеме Solana.