Solana SPL-токени: створення з Transfer Hook і Mint

Випуск токена легко перетворюється на джерело ризику: ролі роздані неакуратно, правила переказів не перевірені, а емісія ніким не керується. Ми розробляємо SPL-токени під ключ — з розширеннями, ролями та хук-правилами переказів. Налаштовуємо емісію та права так, що контроль залишається у вас, а передача супроводжується повною документацією.
Часті запитання

SPL-токен: де ламається випуск, емісія та перекази

Випуск SPL-токена виглядає як три інструкції: створити mint, завести акаунт власника, відправити першу партію в обіг.

Вартість проєкту з'являється не тут, а на супроводі — емісія токенів потрапляє в обіг, і кожен наступний переказ перевіряється за живими правилами, які до запуску ніхто не прогоняв на реальних сценаріях.

Перший типовий збій — розбіжність балансів. Якщо правила переказів реалізовані через Transfer Hook, він може утримати частину суми, відхилити операцію або спрацювати лише на одному з маршрутів.

У внутрішній обліковій системі списання вже відбулося, а на гаманець надійшло інше значення, і звірка реєстру перетворюється на ручний розбір кожної транзакції.

Другий — неможливість доналаштувати правила обігу. Розширення фіксуються на mint у момент створення, тому спроба додати ліміти, списки обмежень або обов'язкову перевірку відправника пізніше впирається в незмінний акаунт.

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

Третій — розмиті ролі емісії. Коли право випуску та заморозки висить на одному гаманці, а модель доступу всередині команди не описана, втрата підпису зупиняє емісію повністю. Далі розбираємо, як ці місця закриваються схемою акаунтів і регламентом операцій.

Що дає керований SPL-токен: випуск, ролі, перекази

Звичайний токен — це таблиця балансів, де правила обігу живуть на стороні сервісу, скрипта або біржі: власник дотримується їх добровільно, а емітент дізнається про порушення постфактум.

Керований SPL-токен у Solana переносить ці правила всередину самого токена, тому контроль обігу працює на рівні мережі, а не окремого інтерфейсу.

Правила переказів перестають залежати від зовнішніх гаманців

Розширення Transfer Hook викликає нашу програму перевірки на кожному переказі: вона звіряє адресу отримувача зі списком допущених, утримує комісію на переказі на користь емітента та відхиляє операцію, якщо ліміт на акаунт вичерпано.

Списання та відмова йдуть в одній транзакції, тому невірний переказ не залишає заборгованостей і ручних звірок. Правило діє однаково для будь-якого гаманця та майданчика — інтеграція більше не потребує довіри до конкретного посередника.

Ролі емісії та заморозки розводяться за різними ключами

Додатковий випуск і заморозка — різні повноваження, і ми розводимо їх за окремими ключами.

Ролі емісії підключаємо до сховища з кількома підписами, заморозку віддаємо операційному ключу, права на метадані ведемо третім: компрометація одного доступу не дає ні допечатати токени, ні заблокувати чужі баланси, ні підмінити назву.

Ротація ключа не потребує перевипуску токена — достатньо передати повноваження, не чіпаючи баланси та історію переказів.

У сумі це прибирає клас відмов, який у некерованих токенах закривають вручну: правила не розходяться між сервісами, а рутинна операція не потребує розширення прав.

Варіанти випуску: розширення проти окремої програми правил

Розширення токена навішуються на сам mint або на акаунт власника і виконуються засобами стандарту. Своя програма правил — окремий акаунт, до якого токен звертається при кожному переказі: логіка перевірок живе поза стандартом і змінюється без перевипуску. Від цього вибору залежить, хто зможе працювати з токеном без доопрацювань на своїй стороні.

Розширення базового набору проти своєї програми

Варіант Коли підходить Обмеження
Розширення токена Потрібні типові перевірки: заморозка, комісія з переказу, перехоплювач переказу з білим списком Набір заданий стандартом; не всі гаманці та кастодіани відображають такі токени коректно
Своя програма правил Логіка змінюється часто, потрібні перевірки поза стандартом або кілька сценаріїв одразу Кожен переказ потребує додаткової інструкції — частина зовнішніх майданчиків її не передає
Обмеження на рівні емісії Достатньо фіксованого обсягу, пауз і права на спалювання Гнучких правил переказу немає, перевипуск можливий тільки через міграцію

Сумісність з гаманцями перевіряється до запуску: розширення та перехоплювачі підтримують не всі кастодіани та біржові інтеграції.

Якщо токен уже в обігу, міграція випуску йде через знімок власників і новий mint — старий залишається читабельним, але правила на нього не переносяться.

Коли достатньо обмежень на рівні емісії

Фіксована емісія, право на спалювання та пауза переказів закривають більшість завдань розподілу та вестингу. Поки правила не залежать від того, хто і куди переказує, розширення та своя програма додають тільки точки відмови.

Як відбувається впровадження: від аудиту вимог до передачі

Впровадження відбувається етапами, і кожен закінчується артефактом, який можна перевірити до переходу далі. Помилка в правилах переказу спливає на стенді, а не в основній мережі, де її вже не відкотити.

  1. Аудит вимог. Фіксуємо, хто випускає токени, які обмеження діють при переказах, чи потрібні заморозка та ліміти на гаманець, хто володіє ключами підпису. На виході — таблиця вимог, де кожне обмеження прив'язане до конкретної перевірки в коді SPL-токена.
  2. Проєктування схеми ролей. Розводимо повноваження: випуск, управління правилами переказу та повсякденні операції — різні ролі, а зміна правил переходить під мультипідпис.
  3. Налаштування правил переказу. Описуємо умови, за яких переказ проходить: білий список адрес, ліміти на операцію та період, перевірка отримувача. Правила працюють на рівні програми — обійти їх через сторонній гаманець не можна.
  4. Тестовий контур. Піднімаємо ізольовану мережу з тим самим набором правил і прогоняємо сценарії: випуск, переказ, відмова за лімітом, спроба обходу перевірки, заморозка. Помилки ловимо до основного запуску.
  5. Передача в супровід. Віддаємо регламент випуску, карту ролей, порядок ротації ключів і дії при інциденті; ваша команда проводить операції сама.

Схема ролей і меж довіри

Права розносимо так, щоб один скомпрометований ключ не давав контролю над випуском і правилами одночасно. Критичні операції потребують кількох підписів, ключі лежать у захищеному сховищі з ротацією. Це прибирає головний ризик — незворотну зміну токена однією людиною.

Конфігурації, ролі та документація на передачу

Віддаємо не тільки розгорнутий SPL-токен на Solana, а й весь контур, який дозволяє обслуговувати його без нас. Нижче — що саме залишається у замовника, в якому вигляді та з якими правами.

Конфігурації та регламенти обслуговування

  • Паспорт токена: адреса mint, число десяткових знаків, обсяг емісії, поточний власник mint authority і freeze authority, ознака увімкненого Transfer Hook.
  • Політики доступу: які адреси можуть мінтити, спалювати та змінювати метадані, які — тільки переказувати; правила зміни authority та підтвердження операцій.
  • Налаштування Transfer Hook: адреса програми-обробника, які перевірки виконуються на вхідному та вихідному переказі, що відбувається при відмові перевірки.
  • Регламент обслуговування: періодичність ротації ключів, порядок оновлення метаданих, умови та процедура відключення hook.
  • Опис оточень: тестова та основна мережа, відповідність адрес і списків допущених контрагентів між ними.
  • Журнал змін: що, ким і на якій підставі змінювалося в конфігурації, щоб відкат був відтворюваним.

Документація для інтеграторів

  • Схема інтеграції з точками виклику hook, потоком підпису та підтвердження переказу.
  • Приклади викликів, коди помилок, вимоги до гаманців, бірж та кастодіальних сервісів.
  • Інструкція для служби підтримки: як відрізнити відмову на стороні hook від мережевої та що відповідати власникам.

Кейс: правила переказів і ролі емісії до та після

Платформа токенізованих нагород випускала SPL-токен, а обмеження переказів — стоп-листи, ліміти на гаманець, вікна продажів — жили на стороні сервісу. Мережа Solana про них не знала: додаток перевіряв умови перед відправкою, але сама транзакція залишалася без правил.

Що було до і що змінилося після

Обійти перевірку міг будь-хто, хто відправляв переказ прямо з гаманця, минаючи інтерфейс. Таких операцій набиралося до 7% від загальної кількості, і кожну розбирали вручну — повернути токен з чужої адреси не можна.

Правила перенесли в Transfer Hook: програма перевіряє умови всередині самої транзакції, і переказ на заборонену адресу або понад ліміт не виконується взагалі.

Клас відмов «токен пішов в обхід правил» закрився повністю — невалідних переказів і ручних розборів у звітному періоді нуль.

Права випуску та заморозки розвели на різні адреси та накрили мультипідписом, ключі зберігаються роздільно. Раніше єдиний ключ давав повний контроль над емісією; тепер для неправомірного випуску потрібно зібрати кворум підписів.

Від постановки до запуску минуло шість тижнів: два — на проєктування правил і ролі, три — на програму та тести, тиждень — на перенесення власників без зміни адрес.

Де метрика не змінилася

Час підтвердження переказу та пропускна здатність залишилися колишніми: перевірка всередині транзакції додає обчислень, але вузьким місцем вона не стала.

Кількість звернень до підтримки щодо інтерфейсу теж не впала — правила стали суворішими, а зрозумілішими не стали, тому підказки в гаманці дописували окремим завданням.

Чим обмеження емісії відрізняються від хука переказів?

Обмеження емісії — це параметри самого випуску. Вони задаються при створенні токена і описують, хто має право випускати нові одиниці, чи є верхня межа пропозиції, хто може заморожувати акаунти та спалювати токени.

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

Хук переказів влаштований інакше. Це розгорнута програма, прив'язана до токена, яку середовище викликає на кожному переказі до зарахування.

Вона пропускає операцію або відхиляє її за власними правилами: списки адрес, ліміти на розмір переказу, утримання частки, обов'язкова згода другої сторони.

Ключова відмінність — у тому, де живуть правила і як вони змінюються після запуску. Обмеження емісії правляться через права на токен, якщо ці права збережені, а зняття прав незворотне і назавжди закриває можливість щось змінювати.

Логіка хука лежить в окремій програмі, тому її оновлюють, не перестворюючи токен, — за умови, що програма розгорнута з можливістю оновлення. Але увімкнути хук на вже випущеному токені не можна: прив'язка задається на старті.

Тому схему контролю обирають до випуску, і переробка обходиться дорожче за початково правильне рішення.

Технічні сумніви перед стартом робіт

Перед стартом робіт по SPL-токену спливають одні й ті самі питання: що буде при збої правил, кому залишаться ключі, хто перевірить код. Нижче — відповіді по суті; їх ми фіксуємо письмово до першого рядка.

Що станеться з токеном, якщо правила дадуть збій?

Перекази тримаються окремо від службової логіки: якщо правило заморозки активів або оновлення спрацює некоректно, базові операції продовжують йти. Аварійний сценарій і порядок призупинення прописуємо заздалегідь і прогоняємо на тестовій мережі до запуску.

Кому залишаться ключі адміністратора?

У нас вони не зберігаються. Передаємо управління в захищене сховище замовника або в схему з порогом підписів, де ніхто не діє одноосібно. Регламент відновлення доступу та резервні копії — частина здачі.

Як перевіряється код перед публікацією?

Ключові шляхи — випуск, переказ, заморозка активів, відкликання прав — закриваємо перевірками і прогоняємо на копії мережі. Перед публікацією за потреби підключаємо незалежний аудит.

Чи можна змінювати правила після запуску?

Так, поки програма оновлювана: право на зміну закріплюється за конкретною адресою або порогом підписів, кожна зміна проходить тестову мережу. Якщо важливіша незмінність — фіксуємо програму остаточно, і правила перестають бути керованими.

Що входить у підтримку після запуску?

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

Обговоримо задачу: що підготувати до розмови

Звертаються до нас з трьох приводів: випустити новий SPL-токен, доопрацювати вже запущений (змінити модель прав, розширити логіку мінта) або увімкнути Transfer Hook у працюючий токен без зупинки обігу.

Чим точніше на вході описані правила емісії та переказів, тим менше припущень в оцінці — і тим менше переробок на тестовій мережі.

  • Призначення токена та коло власників: від цього залежить модель прав і чи потрібен Transfer Hook взагалі.
  • Параметри мінта: загальний обсяг, дробність, хто випускає нові одиниці та чи можливе відкликання.
  • Логіка Transfer Hook: які перевірки виконуються при переказі, що відбувається при відмові, чи є зовнішнє джерело даних.
  • З чим токен має стикуватися: гаманці, біржі, кастодіальні сервіси, інші програми.
  • Управління ключами: одноосібний доступ до мінт-акаунта або мультипідпис, хто тримає право емісії.
  • Що вже є: репозиторій, схема акаунтів, минулі аудити та зауваження по існуючому коду.
  • Цільовий результат: звіт по тестовій мережі або основна мережа з супроводом після запуску.

Якщо половини пунктів поки немає — це нормальний старт, відсутні рішення зафіксуємо разом. Опишіть задачу та додайте те, що вже зібрано, — повернемося з оцінкою та планом робіт, розбитим за етапами, щоб склад робіт і підготовка до старту були зрозумілі до початку розробки.

Напрямки блокчейн-розробки

Останні роботи

  • Розробка сайту компанії B2B ADVANCE
    Розробка сайту компанії B2B ADVANCE
    1574
  • Розробка веб-додатків для компанії FEEDME
    Розробка веб-додатків для компанії FEEDME
    1427
  • Розробка веб-сайту для компанії БЕЛФІНГРУП
    Розробка веб-сайту для компанії БЕЛФІНГРУП
    1105
  • Розробка інтернет магазину для компанії FURNORO
    Розробка інтернет магазину для компанії FURNORO
    1421
  • Розробка логотипу компанії B2B Advance
    Розробка логотипу компанії B2B Advance
    858
  • Розробка веб-додатків для компанії Enviok
    Розробка веб-додатків для компанії Enviok
    1181