Визначення

Metadata — це структурований набір даних, що описує властивості токена: назву, символ, посилання на зображення, опис та додаткові атрибути. У Solana metadata зберігається в окремому акаунті (PDA), який створюється і керується програмою Token Metadata від Metaplex, а не в самому токен-акаунті чи mint-акаунті.

Як працює

Коли розробник або користувач створює токен із metadata, відбувається кілька кроків:

  • Спочатку створюється mint-акаунт — він містить лише технічну інформацію: кількість випущених одиниць, власника та тип токена.
  • Потім програма Metaplex Token Metadata створює окремий акаунт (PDA), адреса якого детерміновано обчислюється з адреси mint-акаунта та ідентифікатора програми metadata.
  • У цей PDA записуються поля: name, symbol, uri, seller_fee_basis_points, creators та інші.
  • Поле uri вказує на зовнішній JSON-файл (зазвичай на Arweave або IPFS), де зберігається зображення, детальний опис і розширені атрибути токена.

Таке розділення дозволяє mint-акаунту залишатися компактним, а metadata — оновлюватися за потреби (якщо це дозволено правилами програми) без зміни самого токена.

Приклад

Ви створюєте токен із назвою «Ukrainian Hryvnia Token» і символом «UHT». Mint-акаунт фіксує лише загальну кількість випуску. Паралельно створюється metadata-акаунт, у якому записується:

  • name: Ukrainian Hryvnia Token
  • symbol: UHT
  • uri: https://arweave.net/abc123... — за цим посиланням лежить JSON із зображенням монети та описом проєкту
  • seller_fee_basis_points: 500 (5 % комісії при вторинних продажах, якщо це NFT)
  • creators: список адрес із відсотками авторства

Гаманці та dApps читають саме цей metadata-акаунт, щоб показати користувачеві назву, логотип та іншу інформацію замість технічного адресного рядка.

Типова помилка

Змішувати metadata-акаунт із токен-акаунтом. Токен-акаунт (token account) зберігає баланс конкретного власника, тоді як metadata-акаунт описує сам актив і є спільним для всіх власників цього токена. Якщо ви шукаєте назву чи зображення токена в токен-акаунті — ви його там не знайдете.

Пов'язані матеріали

Внутрішні переходи

  • Token account — як працює акаунт, що тримає баланс токена
  • NFT — як metadata використовується для нерозмінних токенів