SOBOR · HACKATHON · 2026

Что я сделал
для Onym

Начал с каталога сервисов, а в процессе собрал ещё сервис бэкапа, браузерный клиент и связку, которая позволяет использовать в чатах имя из существующего Stellar-аккаунта. Затем разработал протокол аутентификации через Onym и второй веб-клиент, который использует его для настройки имени на сайте BSN.

С чего начать проверку ↓Все результатыКак работает имя из BSN

ДЛЯ СУДЬИ

С чего начать проверку

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

  1. Место в Onym: Каталог сервисов · discovery. Откройте Atlas, найдите сервис и посмотрите его карточку. В меню есть добавление своего сервиса по URL манифеста, а каталог можно подключить к совместимому клиенту Onym.
  2. Место в Onym: Пользовательский клиент; отдельный seat не заявлен. Откройте Onym Web, создайте тестовую идентичность или импортируйте свою и задайте пароль. В разделе «Моя идентичность» доступны публичный ключ, Stellar-адрес и работа с именем BSN.
  3. Место в Onym: Провайдер имён · naming.association. Посмотрите манифест провайдера имён и пройдите сценарий привязки ниже. Для чтения публичного имени Stellar-кошелёк не нужен; для записи тега связи понадобится подпись владельца аккаунта.
  4. Место в Onym: Протокол входа на сайты и настройки сервисов; отдельный seat не заявлен. Прочитайте протокол аутентификации через Onym. В нём описаны два способа входа — с сайта и из мессенджера — на основе OpenID Connect и OAuth 2.0, с подтверждением идентичности ключом Onym.
  5. Место в Onym: Клиентская интеграция с сервером входа и провайдером naming.association. Откройте второй веб-клиент — Onym Web Preview и проверьте реализацию протокола: выберите BSN среди сервисов Discovery, нажмите «Настроить на сайте», подтвердите вход и передачу публичного ключа. В кабинете BSN можно настроить имя или увидеть уже подключённое, затем вернуться в клиент и получить его через подписанный API. Подробный путь описан в разделе об аутентификации.

Страница Simple backup и Android PR доступны ниже. Новый сценарий входа и настройки имени описан в разделе «Войти с Onym»; там же есть ссылка на preview.

Что получилось

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

01Работает на сайте

Atlas — каталог сервисов Onym

Взял за основу референсный Onym Discovery и добавил сайт, через который можно искать сервисы, смотреть карточки, сравнивать варианты и предлагать свои. Сохранил исходный механизм подписания манифеста и снимков каталога, чтобы Atlas оставался совместимым источником Discovery.

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

Каталог периодически проверяет записи и исключает недоступные или просроченные сервисы из подписанного снимка. Изменившиеся манифесты проходят через решение владельца. Для посетителя всё это выглядит как обычный каталог с поиском, фильтрами и кнопкой подключения к Onym.

02Демо развёрнуто

Simple backup

Поднял отдельного оператора резервных копий на основе Onym Backup. Он принимает зашифрованные архивы совместимого клиента, позволяет получить список копий, скачать архив, экспортировать данные и удалить свои записи. Доступ подтверждается ключом пользователя.

Адаптировал сервис для работы в подпапке домена, включая проверку подписанного пути запроса, добавил его собственный манифест и карточку в Atlas. Приложение шифрует данные до отправки, поэтому сервис хранит архив без ключа расшифровки.

5копий на пользователя
256 МиБна одну копию
Бесплатнодемонстрационный сервис

Демо работает на одном сервере, без географического дублирования. Проверка серверного протокола выполнена; полное восстановление истории на телефоне отдельно не проверялось.

03Работает · alpha

Onym в браузере

Сделал веб-клиент в форке Android-проекта, чтобы пользоваться Onym и проверять интеграции без установки мобильного приложения. В нём можно создать или импортировать идентичность, открыть приглашение в чат и работать с сообщениями.

Ключи хранятся локально в браузере в хранилище, зашифрованном паролем. Для получения ключа из пароля используется Argon2id, для шифрования — AES-GCM. В клиент добавлены отображение публичного ключа и Stellar-адреса, настройка имени BSN и подготовка транзакции привязки.

Для меня этот клиент стал ещё и местом, где можно пройти весь сценарий внешнего имени: от существующего Stellar-аккаунта до проверенной записи, которую видят участники чата. Создание и администрирование групп, а также удаление участников с обновлением ключей пока реализованы не полностью.

04Спецификация опубликована

Протокол и API для провайдера имён

Описал конкретный HTTP API, через который клиент может запросить имя, получить подписанную запись, подтвердить её публикацию, найти имя по публичному ключу и затем отозвать своё согласие. За основу взял проект Association Naming в Onym и зафиксировал формат запросов, подписей и ответов для нашей реализации.

Этот документ — опубликованный экспериментальный профиль onym:naming-implementation:bsn-stellar-http-v1. Его статус позволяет другим разработчикам воспроизвести интеграцию и обсудить API; утверждение в качестве общего стандарта Onym потребует согласования с исходным проектом.

Основные обращения к API
ЗапросЧто происходит
GET manifest.jsonКлиент получает подписанный манифест, ключ провайдера и ссылку на политику.
POST v1/previewПроверяется имя в Stellar и наличие связи с идентичностью Onym.
POST v1/request-issuanceПо подписанному запросу выдаётся предложение записи имени.
POST v1/accept-recordВладелец подписывает принятие конкретной записи и разрешает публикацию.
POST v1/resolve-subjectДругой клиент получает записи для публичного ключа участника.
POST v1/disavow-recordВладелец отзывает принятие имени.

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

05Провайдер развёрнут

Имя из BSN — в чатах Onym

Реализовал этот API как отдельный BSN naming provider. Источником имени служит тег Name существующего Stellar-аккаунта; если такого тега нет, проверяется name. Менять имя по-прежнему можно через кошелёк, который управляет этим аккаунтом.

Для привязки владелец добавляет в Stellar тег OwnershipFull или его свободный пронумерованный вариант со Stellar-адресом своей идентичности Onym. Затем клиент подписывает запрос своим ключом, провайдер проверяет обе стороны связи и выдаёт запись, которую пользователь явно принимает.

ИСТОЧНИКStellar · NameИмя и тег связи
ПРОВЕРКАBSN providerПодписанная запись
ОТОБРАЖЕНИЕOnymИмя участника чата

Веб-клиент готовит XDR-транзакцию добавления тега: находит свободный номер, показывает значение, комиссию, резерв и срок действия. Её можно скопировать, скачать или открыть через SEP-7, чтобы подписать и отправить своим Stellar-кошельком.

При показе имени клиент использует проверенный ключ участника из состава группы. Рядом остаётся источник имени, поскольку одинаковые имена могут принадлежать разным аккаунтам. Изменение имени или тега связи в Stellar делает старую запись недействительной при следующей проверке; опубликованное имя также можно отозвать из клиента.

06Открыт Draft PR

Поддержка в Android-клиенте

Подготовил и отправил PR #263 в исходный onymchat/onym-android. Он добавляет работу с тем же провайдером в настройки активной идентичности: запрос имени, просмотр предложения, подтверждение публикации и отзыв.

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

Подписи создаются через существующий механизм хранилища Android, без передачи приватного ключа провайдеру. Запросы выполняются, пока чат открыт; срок актуальности подписанного ответа ограничен 60 секундами.

Демонстрация на 24 сентября. Доступна демонстрационная Android-сборка с поддержкой BSN. Ниже — присланные примеры экрана настроек и отображения полученного имени. Это debug APK для знакомства с интеграцией; новый вход через сайт провайдера описан отдельно в разделе про веб-preview.

Как это выглядит в мобильном клиенте

Скачать демонстрационный клиент для Android · APK · 49.6 МиБ

Скачайте APK на Android и откройте файл для установки. Если система попросит разрешение, разрешите установку из приложения, через которое открываете файл. Для знакомства со сборкой можно создать тестовую идентичность.

Контрольная сумма APK · SHA-256

e2f1294847b897a68d7ea6bbfba7ca0752924463b3ae0e0e4669178906a23022

07Проект спецификации опубликован

Протокол аутентификации через Onym

Разработал протокол, по которому сайт может подтвердить идентичность пользователя Onym и открыть ему личный кабинет. Описаны оба сценария: человек начинает вход на сайте или переходит к настройке сервиса из мессенджера. Основа — OpenID Connect и OAuth 2.0 с Authorization Code, PKCE и PAR; владение ключом Onym подтверждается отдельным подписанным запросом.

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

08Работает в preview

Войти с Onym — рабочее демо и второй веб-клиент

Разработал протокол аутентификации через Onym и сделал второй веб-клиент, Onym Web Preview, который использует этот протокол для работы с провайдером имён BSN. В нём можно выбрать провайдера из Discovery, подтвердить вход своей идентичностью, открыть кабинет BSN и после настройки получить имя в мессенджере. Основная версия клиента остаётся доступна по прежнему адресу.

Когда начал подключать провайдеров имён, стало понятно, что каждому из них может понадобиться свой интерфейс. Для BSN надо указать Stellar-аккаунт и проверить теги, у другого провайдера могут быть свои условия. Поэтому сделал вход на сайт через идентичность Onym, чтобы провайдер мог узнать пользователя и дать ему настроить всё в своём кабинете, а мессенджер получил проверенное имя для отображения в чатах.

Сервер входа развёрнут на Atlas, за основу взяты OpenID Connect и OAuth 2.0: Authorization Code, PKCE и PAR. Владение идентичностью Onym подтверждается подписью запроса в клиенте. Перед входом человек видит, какому сайту он передаёт публичный ключ и зачем он нужен. Сид-фраза и приватный ключ остаются в клиенте.

Вход можно начать на сайте BSN или из настроек провайдера в Onym. В текущей реализации оба пути проходят через явное подтверждение в веб-клиенте, после которого открывается кабинет. Здесь уже работает конкретная интеграция с BSN; подключение произвольных сайтов и остальные расширения описаны в проекте протокола и требуют дальнейшей реализации.

Как попробовать

  1. Откройте Onym Web Preview, создайте тестовую идентичность или импортируйте существующую и задайте пароль. Preview хранит данные отдельно от основной версии.
  2. В настройках откройте сервисы из Discovery, выберите провайдера имён BSN и нажмите «Настроить на сайте». Можно начать и с кабинета BSN, который предложит войти через Onym.
  3. В клиенте проверьте сайт и выбранную идентичность, подтвердите вход и передачу публичного ключа, затем продолжите переход в кабинет.
  4. При первой настройке укажите Stellar-адрес. Провайдер проверит имя и тег связи; если связи ещё нет, подготовит транзакцию, которую можно подписать и отправить своим Stellar-кошельком.
  5. Вернитесь в Onym. Клиент запросит состояние настройки через подписанный API и предложит принять имя. После принятия оно используется для вашего профиля и отображения в совместимых чатах; у собеседника тоже должна быть включена поддержка этих имён.

Если имя уже подключено

Кабинет находит ранее принятое имя, в том числе если оно было настроено через старый встроенный экран. После входа видны само имя, связанный Stellar-адрес, теги имени и связи, идентичность Onym и срок действия записи. Пока привязка действует, поле для другого Stellar-адреса не показывается, а сервер отклоняет попытку заменить адрес через форму.

В preview уже принятое действующее имя подгружается и после импорта той же сид-фразы. Кнопка «Проверить имя» сначала ищет такую запись и проверяет подписи; повторно принимать её не требуется. Если принятой записи нет, клиент проверяет настройки кабинета и предлагает принять новое имя, когда связь готова. Изменение самого имени выполняется владельцем в Stellar, после чего обновлённую запись нужно снова принять в Onym.

Что изменилось в веб-клиенте

Добавил раздел выбора сервисов из подключённого Discovery: реле сообщений, реле контрактов, резервного копирования и провайдера имён. Для BSN настройки открываются на сайте по данным манифеста. Возвратная ссылка открывает клиент, а результат он получает отдельно через API с проверкой подписей. Встроенный экран BSN в preview убран, в основной версии он сохранён.

Основной клиент продолжает работать по прежнему адресу. Новые возможности опубликованы отдельно в preview; исходники этой версии доступны в ветке codex/auth-preview на GitHub.

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

РАЗОБРАТЬСЯ ПОДРОБНЕЕ

Как связать имя из BSN с Onym

В статье я разбираю этот путь на примере своего Stellar-аккаунта: где хранится имя, как получается адрес идентичности Onym, какую транзакцию нужно отправить, что подписывает клиент и как другой участник чата проверяет результат. Внутри есть команды curl и примеры TypeScript для API.

Открыть статью отдельной страницей ↗

Прочитать полную статью здесь

У меня есть Stellar-аккаунт, в котором уже записано имя в BSN. Хочется использовать это же имя в Onym, чтобы оно появлялось в моём профиле и рядом с сообщениями в чатах. Соответственно, нужен сервис, который прочитает имя, проверит, что я действительно связываю этот аккаунт со своей идентичностью Onym, и даст другим клиентам возможность проверить результат.

Для этого сделан BSN Naming Provider, а в веб-версии Onym появилась его поддержка. Ниже разберём весь процесс на моём Stellar-адресе: сначала то, что делает пользователь, а затем запросы, которые при этом выполняет клиент.

1. Откуда берётся имя

Возьмём мой адрес в основной сети Stellar:

GCPJUXPETZEIJNEAAEO2LGZIA6IQNNWGOHPNP4ZQECDS6IKKIGJO5LFV

В его данных есть тег Name со значением Valerij Utrosin. Именно эту строку мы и будем использовать для отображения. Увидеть её можно через Horizon, публичный API Stellar:

ACCOUNT='GCPJUXPETZEIJNEAAEO2LGZIA6IQNNWGOHPNP4ZQECDS6IKKIGJO5LFV'
curl -fsS "https://horizon.stellar.org/accounts/$ACCOUNT" \
  | jq -r '.data.Name | @base64d'

В BSN имена хранятся в data entries аккаунта, а Horizon возвращает их значения в Base64, поэтому в примере есть декодирование. Провайдер сначала ищет Name; если такого тега нет, проверяет вариант name с маленькой буквы. Имя читается из основной сети Stellar, даже когда сам чат Onym работает с контрактом в тестовой сети.

Здесь я использую своё имя как пример. Если повторяете процесс для себя, подставьте адрес аккаунта, которым управляете, и проверьте его тег Name.

2. Как связать Stellar-аккаунт с идентичностью Onym

У идентичности Onym есть публичный ключ Ed25519, которым клиент подписывает сообщения и запросы. Из этого ключа получается Stellar-адрес, начинающийся с G. Его можно посмотреть в разделе «Моя идентичность». Именно этот адрес надо указать в BSN как значение тега OwnershipFull или его свободного пронумерованного варианта.

Получается следующая связка: в моём существующем Stellar-аккаунте записано, какой идентичности Onym разрешено использовать его имя, а клиент Onym подтверждает владение своим ключом подписью запроса. Для этой проверки не требуется заранее создавать или пополнять выведенный из ключа Onym Stellar-аккаунт, поскольку он используется как представление публичного ключа.

В веб-клиенте это делается через «Моя идентичность → Имя из BSN». Вставляете свой Stellar-адрес и нажимаете «Создать транзакцию привязки». Клиент заново загружает данные аккаунта, находит свободный тег и собирает готовую XDR-транзакцию. Когда мы проверяли мой адрес, первые три тега были заняты, поэтому выбирался OwnershipFull3. При следующем обращении свободный номер может оказаться другим.

В транзакции одна операция ManageData, которая добавляет выбранный тег со Stellar-адресом вашей идентичности Onym. На экране видны это значение, комиссия, дополнительный резерв под запись и время, до которого транзакция действует. Можно скопировать XDR, скачать файл или открыть ссылку в кошельке с поддержкой SEP-7, после чего подписать и отправить транзакцию своим Stellar-кошельком.

Для разработчика эта же подготовка выглядит так. Дальнейшие TypeScript-примеры рассчитаны на код внутри web/src нашего клиента, где переменная client — уже разблокированный экземпляр Client. Используемые функции есть в репозитории; запускать эти фрагменты в консоли браузера пользователю не требуется.

import { prepareBindingTransaction } from "./stellarBinding";

const stellarAccount =
  "GCPJUXPETZEIJNEAAEO2LGZIA6IQNNWGOHPNP4ZQECDS6IKKIGJO5LFV";

const transaction = await prepareBindingTransaction(
  stellarAccount,
  client.identity.stellarAccount,
);

// Показываем пользователю и передаём в его Stellar-кошелёк.
console.log(transaction.tag);   // Например, OwnershipFull3
console.log(transaction.xdr);   // Неподписанная транзакция
console.log(transaction.uri);   // Ссылка web+stellar:tx?...

XDR собирается в браузере с помощью официального Stellar SDK. Срок её действия — 15 минут. Если за это время с того же аккаунта отправили другую транзакцию, надо нажать «Сформировать заново», чтобы получить актуальный sequence number. После успешной отправки возвращаемся в Onym и нажимаем «Я отправил — проверить связь».

3. Что показывает предварительная проверка

У провайдера есть метод preview, который позволяет узнать найденное имя и проверить, есть ли нужный тег связи. Для него достаточно публичных данных. В поле subject передаётся строка onym:key: и Ed25519-ключ Onym в виде 64 шестнадцатеричных символов нижнего регистра. В интерфейсе нужный ключ подписан «Ed25519 — подпись».

BASE='https://atlas.predhit.com/bsn-np'
ACCOUNT='GCPJUXPETZEIJNEAAEO2LGZIA6IQNNWGOHPNP4ZQECDS6IKKIGJO5LFV'
# Подставьте свой публичный ключ из «Ed25519 — подпись».
PUBKEY='ВАШ_ED25519_КЛЮЧ_64_HEX_СИМВОЛА'
SUBJECT="onym:key:$PUBKEY"

jq -n --arg account "$ACCOUNT" --arg subject "$SUBJECT" \
  '{stellarAccount: $account, subject: $subject}' \
  | curl -fsS "$BASE/v1/preview" \
      -H 'Content-Type: application/json' --data-binary @-

Когда связи ещё нет, ответ будет примерно таким. Значение value здесь сокращено для чтения; настоящий API возвращает полный Stellar-адрес, который требуется записать в тег.

{
  "eligible": false,
  "tag": "OwnershipFull",
  "value": "G…адрес вашей идентичности Onym…",
  "name": "Valerij Utrosin"
}

После появления нужного тега eligible станет true, а в ответе будут displayName, nameTag, bindingTag и onymAccount. На этом этапе пользователь видит найденное имя и может перейти к его получению. Для отображения проверенного имени в чатах дальше понадобятся подписанная запись провайдера и подтверждение владельца.

4. Как получить подписанную запись имени

Сначала клиент читает манифест провайдера, где опубликованы его ключ, пространство имён, профиль и хеш политики выдачи. Посмотреть документы можно обычными GET-запросами:

curl -fsS "$BASE/manifest.json" | jq
curl -fsS "$BASE/profile.json" | jq
curl -fsS "$BASE/policy.json" | jq

В нашей веб-версии публичный ключ этого провайдера закреплён в коде. Функция namingManifest() проверяет ключ и подпись манифеста, поэтому при неожиданной замене ключа проверка остановится. Конкретный BSN-профиль основан на проекте Association Naming Onym; его HTTP-методы и правила описаны в нашей спецификации.

Затем клиент вызывает request-issuance. Запрос подписывается ключом текущей идентичности Onym и включает адрес Stellar-аккаунта, время создания, срок действия и случайный nonce, чтобы один и тот же подписанный запрос нельзя было выполнить повторно.

import { hex } from "./bytes";
import { limitedJson } from "./transport";
import {
  NAMING_URL, namingManifest, requestProof, verifyResolution,
} from "./naming";

const subject = "onym:key:" + hex(client.identity.signingPublic);
const manifest = await namingManifest();

const request = requestProof(
  "request-issuance",
  { stellarAccount },
  client.identity,
);

const rawOffer = await limitedJson(
  NAMING_URL + "v1/request-issuance",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify(request),
  },
);

const offer = verifyResolution(rawOffer, subject, manifest.policy);
const row = offer.records[0];
if (!row || row.status !== "unaccepted" ||
    row.record.stellarAccount !== stellarAccount ||
    Date.parse(row.record.expiresAt) <= Date.now()) {
  throw new Error("Предложение имени не прошло проверку");
}
const record = row.record;
// Показываем record.displayName и источник пользователю.

Провайдер проверит подпись, прочитает Stellar и убедится, что тег указывает на ключ подписавшего запрос. В результате появится AssociationRecord со статусом unaccepted, то есть предложение имени, ожидающее подтверждения. В записи будут субъект, имя для отображения, Stellar-аккаунт, номер версии, срок действия и подпись провайдера.

Есть деталь, которую важно учесть при интеграции: строка «Valerij Utrosin» находится в record.displayName. Поле record.name содержит полный Stellar-адрес, который используется как уникальная часть имени внутри провайдера. Поэтому одинаковые человеческие имена спокойно существуют у разных аккаунтов, а клиент может показать, к какому аккаунту относится каждое из них.

Для собственного клиента подписи собираются по следующему правилу: ключи JSON-объектов рекурсивно сортируются, JSON записывается компактно в UTF-8, поле signature исключается из подписываемого объекта. Перед ним добавляется строка onym-bsn-np-v1:<kind> и один перевод строки LF. Для запроса kind равен request, для подтверждения — acceptance. Алгоритм — Ed25519, результат передаётся в Base64. Хеш записи считается по полному каноническому объекту, включая подпись провайдера, и имеет вид sha256:<hex>.

5. Как пользователь подтверждает имя

Теперь пользователю показывается конкретное имя и предлагается его принять. Кнопка «Принять имя и опубликовать связь» создаёт SubjectAcceptance, в котором подписывается хеш именно этой записи. Так подтверждение привязано и к выбранному имени, и к сроку его действия, и к провайдеру, который его выдал.

Ниже пример того, как формируется второй запрос. Его выполняет обработчик явного подтверждения пользователя; переменные record, subject и manifest получены на предыдущем шаге.

import { ed25519 } from "@noble/curves/ed25519.js";
import { b64, utf8 } from "./bytes";
import { canonical, recordDigest } from "./naming";

const acceptanceBody = {
  acceptanceVersion: 1,
  record: recordDigest(record),
  subject,
  publish: true,
  acceptedAt: new Date().toISOString(),
  expiresAt: record.expiresAt,
};
const acceptance = {
  ...acceptanceBody,
  signature: b64(ed25519.sign(
    utf8("onym-bsn-np-v1:acceptance\n" + canonical(acceptanceBody)),
    client.identity.signingSecret,
  )),
};

const rawAccepted = await limitedJson(NAMING_URL + "v1/accept-record", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(requestProof("accept-record", {
    record: recordDigest(record),
    acceptance,
  }, client.identity)),
});

const accepted = verifyResolution(rawAccepted, subject, manifest.policy);
const active = accepted.records.find(r =>
  r.status === "active" && recordDigest(r.record) === recordDigest(record)
);
if (!active) throw new Error("Имя не активировано");

Поле publish: true разрешает провайдеру отдавать эту связь по публичному запросу. После подтверждения другой клиент сможет узнать, какое имя владелец принял для своего ключа Onym. Само предложение, которое ещё не принято, в такой выдаче не появляется. API также допускает publish: false, но текущий интерфейс подключения рассчитан на публичное разрешение имени в чатах.

В нашем клиенте весь этот шаг, вместе с сохранением настройки в зашифрованном хранилище, уже собран в await client.useName(record). В интеграции достаточно вызвать его после согласия пользователя; длинный пример выше показывает содержимое обмена с API.

6. Как имя появляется рядом с сообщением

Допустим, другой участник открыл чат со мной и включил показ проверенных имён BSN. В подтверждённом составе группы у него уже есть мой ключ подписи sending_pubkey, связанный с BLS-ключом участника. По нему клиент строит subject и обращается к провайдеру через resolve-subject. Для чтения публично принятого имени подпись запроса не требуется:

jq -n --arg subject "$SUBJECT" '{subject: $subject}' \
  | curl -fsS "$BASE/v1/resolve-subject" \
      -H 'Content-Type: application/json' --data-binary @-

Ответ содержит массив records, где у каждой строки есть запись провайдера, подтверждение владельца и текущий статус. Весь ответ тоже подписан и содержит время проверки. Получив его, клиент проверяет подписи провайдера и владельца, совпадение субъекта, хеш принятой записи, сроки действия и статус active.

В коде это можно собрать так. Переменная group здесь — уже проверенная группа, а message — сообщение, для которого клиент уже проверил отправителя.

import { unb64 } from "./bytes";
import { resolveName, NAMING_NS } from "./naming";

const member = group.member_profiles[message.sender_bls_pubkey_hex];
if (!member) throw new Error("Нет подтверждённого профиля отправителя");

const senderSubject = "onym:key:" + hex(unb64(member.sending_pubkey));
const currentManifest = await namingManifest();
const result = await resolveName(senderSubject, currentManifest.policy);
// resolveName уже проверяет подписи, принятие записи и свежесть ответа.
const named = result.records
  .filter(row => row.status === "active")
  .sort((a, b) => b.record.sequence - a.record.sequence)[0];

const displayName = named?.record.displayName ?? member.alias;
const source = named
  ? "@" + NAMING_NS + " · " + named.record.stellarAccount
  : "Локальное имя";
// Передаём displayName и source в текстовые элементы интерфейса.

В результате в чате видно «Valerij Utrosin», а рядом — источник @bsn.atlas.predhit.com и сокращённый Stellar-адрес. Это помогает различать людей с одинаковыми именами. При отсутствии действующего подтверждения клиент возвращается к локальному имени участника.

Провайдер при такой проверке получает публичные ключи, которые у него спрашивают, поэтому показ BSN-имён включается отдельно. Текущая веб-версия проверяет свою идентичность и до 19 других участников открытой группы, обновляя результат примерно раз в 30 секунд. Подписанный ответ пригоден для текущего отображения не дольше 60 секунд, и при недоступности проверки клиент убирает подтверждённое имя.

Если известен сам Stellar-аккаунт, доступен и прямой запрос resolve-name. В нём передаётся полное квалифицированное имя аккаунта:

jq -n --arg name "$ACCOUNT@bsn.atlas.predhit.com" '{name: $name}' \
  | curl -fsS "$BASE/v1/resolve-name" \
      -H 'Content-Type: application/json' --data-binary @-

Этот метод удобен для просмотра конкретной записи по аккаунту. Для отображения отправителя в нашей веб-версии используется resolve-subject, потому что ключ отправителя уже известен из группы. Приведённый выше verifyResolution тоже рассчитан на запрос по субъекту; интеграция прямого поиска по квалифицированному имени требует соответствующей проверки поля query.

7. Что происходит, если изменить имя или отключить связь

Имя меняется в теге Name Stellar-аккаунта. При следующей проверке провайдер увидит, что данные расходятся с прежней записью, и та перестанет подтверждаться. Пользователь снова запрашивает предложение и принимает новое имя. Такой же новый цикл потребуется после истечения семидневного срока записи; для получения следующего предложения у API есть метод renew-record с теми же полями запроса, что у request-issuance.

Если надо отказаться от принятого имени, в интерфейсе есть «Отозвать привязку имени». Клиент подписывает Disavowal и отправляет его через disavow-record. Для уже принятой записи вызов готовой функции выглядит так:

import { disavowName } from "./naming";

// Выполняется после выбора пользователем «Отозвать привязку имени».
await disavowName(recordDigest(record), client.identity);
// Метод отправит подписанные disavowal и запрос в v1/disavow-record.

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

Снять флажок «Показывать проверенные имена BSN» можно и без отзыва: тогда этот клиент прекращает запросы и показывает локальные имена, а опубликованная связь остаётся доступной другим. При удалении тега связи из Stellar провайдер также перестаёт подтверждать имя. Если исходные данные впоследствии восстановлены и запись ещё действует, проверка может снова пройти; явный отзыв конкретной записи окончателен.

Где это уже работает

Подключение и проверка реализованы в Onym Web. Чтобы собеседник увидел имя как проверенное, его клиенту нужна поддержка этого BSN-профиля и включённое отображение имён. В мобильных клиентах такая проверка сама по себе от подключения провайдера не появится, для неё потребуется соответствующая доработка.

Если будете подключать другой веб-клиент, учтите ещё один момент: сейчас CORS разрешён для onym.predhit.com и atlas.predhit.com. Запросы из терминала работают без Origin; для браузера на другом домене потребуется добавить его в конфигурацию провайдера. Примеры выше используют действующие методы и поля нашей реализации.

Исходники провайдера и веб-клиента опубликованы в GitHub. Там же можно посмотреть проверку подписей и подготовку XDR, а в описании HTTP-профиля собраны форматы объектов, ограничения и правила актуальности. О том, как устроены сами BSN-теги, подробнее написано в описании BSN.

Что можно проверить в коде

Для основных сервисов опубликованы исходники и работающие адреса; статус новых изменений preview указан выше. В процессе разработки проверялись подписи документов, доступ к резервным копиям, совместимость ответов Node-провайдера с клиентом, обработка приглашений и создание XDR-транзакции. Проверка транзакции выполнялась без её подписи и отправки от имени владельца аккаунта.

  • Atlas: тесты протокола и интеграции каталога.
  • Simple backup: сценарий проверки публичного API с временным тестовым владельцем и удалением только его копии.
  • Onym Web и BSN: тесты идентичности, приглашений, протокола имён и подготовки транзакции.
  • Android: проверка подписей и тестовых ответов провайдера, включая неверный ключ, просроченную запись и отсутствие согласия владельца.

Основой работы стали открытые проекты Onym, архитектура Onym Foundation и BSN. Мой вклад — каталог с пользовательским интерфейсом и управлением, развёртывание и адаптация оператора бэкапа, веб-клиент, конкретный API и реализация BSN naming provider, а также Android-интеграция.