Розробка soul-bound credentials з on-chain верифікацією

Компаніям важливо видавати дипломи, сертифікати та права доступу так, щоб їх не можна було передати чи підробити. Ми розробляємо soul-bound credentials із перевіркою прямо в реєстрі — під ключ: від схем даних до регламентів випуску та відкликання. Замовник отримує непередавані посвідчення, які підтверджуються за секунди й працюють роками.
Часті запитання

Soul-bound credentials: де ламаються звичайні токени

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

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

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

Саме тут і живе підробка дипломів і допусків: підробляти бланк і печатку більше не потрібно, достатньо купити або перейняти передаваний токен.

Soul-bound credentials закривають це на рівні самого посвідчення: запис прив’язується до адреси отримувача, а операція переказу скасовується логікою контракту — посвідчення стає непередаваним.

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

Перевірка справжності відбувається без дзвінка в організацію — за адресою пред’явника та станом запису.

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

Що дає непередаване посвідчення в реєстрі

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

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

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

Далі — який клас відмов зникає: підробка, повторна видача того самого диплома, «загублений» оригінал, правка статусу заднім числом.

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

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

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

Режими випуску та верифікації посвідчень

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

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

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

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

Етапи впровадження: від аудиту вимог до передачі

Порядок робіт будується навколо одного питання: хто і на якій підставі підтверджує належність credential конкретній адресі. Поки це не зафіксовано, будь-який код — здогад.

Тому починаємо з аудиту вимог, а не зі смарт-контракту, і лише потім збираємо схему даних і контур перевірки.

  1. Аудит вимог і ролей. Фіксуємо, хто випускає credential, хто має право його відкликати, що вважається підставою для видачі та за якою процедурою оскаржується помилка. Розбираємо сценарії: реєстр тримає один видавець чи кілька, чи потрібна перевірка без звернення до зовнішнього сервісу.
  2. Схема даних. Визначаємо, що живе в контракті (володіння, ознака відкликання, тип), а що виноситься в метадані поза мережею. Описуємо зв’язку «адреса — ідентифікатор — строк дії», щоб читацька сторона отримувала відповідь одним викликом, а не склейкою з трьох джерел.
  3. Складання тестового контуру. Розгортаємо ізольовану мережу, тестових видавців і ті самі скрипти, що підуть у робоче середовище. Проганяємо випуск партії та фіксуємо час: він потім стає орієнтиром під час передачі.
  4. Перевірка на спробу підробки. Окремий блок сценаріїв — передача credential третій особі, повторний випуск на ту саму адресу, підміна метаданих після видачі, відкликання та його видимість для перевіряльника. Кожен сценарій закривається тестом; частка покритих шляхів — критерій готовності.
  5. Підготовка передачі. Збираємо регламент відкликання, порядок роботи з ключами видавця, схему оновлення метаданих і порядок викочування нових версій без втрати вже виданих credential.
  6. Передача в експлуатацію та навчання команди. Передаємо розгорнутий контур, доступи, документацію та розбір інцидентів, які можуть статися в перші місяці. Навчання ведемо на живих сценаріях команди — від випуску до відкликання.

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

Конфігурація, схеми та регламенти випуску

Пакет артефактів збирається паралельно з розробкою, а не після здачі.

Сенс у тому, щоб випуск, перевірку та відкликання soul-bound credentials можна було вести силами вашої команди: схема ролей і політики доступу описані так, що новий адміністратор входить у процес за день, а не розбирає код контракту.

  • Конфігурації розгортання — параметри мережі та адреси контрактів, ліміти на обсяг випуску, правила формування метаданих, прив’язка до домену перевіряльної сторони.
  • Схема ролей — хто випускає, хто підтверджує, хто відкликає; пороги мультипідпису та правило, за яким повноваження не можна звести до одного ключа.
  • Політики доступу — які персональні дані залишаються поза відкритим реєстром, що йде on-chain, хто зі співробітників бачить повний набір атрибутів.
  • Регламент відкликання — підстави для анулювання, строк реакції, порядок повідомлення утримувача та статус уже виданих копій перепустки.
  • Інструкція для перевіряльників — покрокова валідація: запит підпису, звірка власника, перевірка статусу відкликання, дії в спірній ситуації.
  • Документація із супроводу — як оновлювати схему атрибутів, змінювати ключі, мігрувати при зміні стандарту, що фіксувати в журналі змін.
  • План відновлення — порядок дій при компрометації ключа випуску та при масовому перевипуску раніше виданих документів.

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

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

Як було

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

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

Що побудували і що це дало

Запис про кваліфікацію випускається як soulbound-токен на адресу випускника: він не передається і не продається, метадані містять спеціальність, рік і хеш паперового оригіналу.

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

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

Показник До Після
Підтвердження диплома до 3 робочих днів, письмовий запит секунди, перевірка за адресою випускника
Звернення до підтримки близько половини тікетів сезону поодинокі, лише спірні випадки
Відкликання помилкового запису обдзвін організацій, які вже прийняли диплом подія в реєстрі, перевірка одразу дає відмову
Виявлення підробок за скаргою, із затримкою в місяці у момент перевірки, за станом реєстру

Чим soul-bound credentials відрізняються від звичайних токенів

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

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

У звичних стандартах на кшталт ERC-721 переказ — обов’язкова частина логіки; тут його навмисно прибирають і замінюють безумовною відмовою.

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

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

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

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

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

Відкликання, приватність, міграція: технічні сумніви

Технічні сумніви навколо soul-bound credentials зводяться до чотирьох: втрата ключа власником, відкликання вже виданого посвідчення, обсяг даних, що йдуть у публічну частину, і перенесення реєстру без перевипуску. Кожен закривається механізмом, закладеним в архітектуру заздалегідь, а не ручною правкою за фактом.

Власник втратив ключ — доступ і посвідчення відновлюються?

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

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

Як відкликати посвідчення, якщо воно вже на руках?

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

Які дані стають публічними і як переноситься реєстр?

У публічну частину йде лише криптографічний відбиток і технічні мітки — персональні дані та вміст документів залишаються в закритому сховищі емітента.

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

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

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

Саме вони задають архітектуру випуску та перевірки soul-bound credentials — від моделі реєстру до порядку відкликання, — а ми на їхній основі збираємо план впровадження та склад команди.

  • Сценарії видачі: кому і за якою подією випускається credential, хто виступає емітентом і підписує транзакцію.
  • Модель реєстру: окремий контракт на кожен тип чи фабрика, де лежать метадані — у мережі чи поза нею, з хешем на ланцюжку.
  • Відкликання та перевипуск: у кого є право, що відбувається з раніше виданими токенами, чи відновлюється credential після втрати доступу до гаманця.
  • Порядок перевірки: хто верифікує — власний сервіс, сторонні гаманці чи зовнішня інтеграція за програмним інтерфейсом.
  • Приватність: які поля не можна публікувати у відкритому реєстрі та чи потрібні підтвердження без розкриття самих даних.
  • Інфраструктура та доступи: тестова мережа, ключі підпису, ролі в мультипідписі, кому переходить володіння контрактом після здачі.
  • Критерії приймання: які перевірки зобов’язані проходити до видачі та на якому наборі даних фіксуємо результат.

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

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

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

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