ADAMANT v0.10.0: Новый старт для разработчиков в блокчейн-мессенджинге
Децентрализованный мессенджер имеет значение только тогда, когда разработчики могут на нём строить. Вместе с ADAMANT Node v0.10.0 полностью переработан опыт разработки: новая спецификация API, переписанная документация, локальная сеть, которую можно развернуть за минуты, и полностью перезапущенная тестовая сеть. Цель — сделать интеграцию с экосистемой блокчейн-мессенджинга ADAMANT быстрой, предсказуемой и удобной — будь вы создаёте кошелёк, бота, сервис уведомлений или что-то совершенно новое.
Современная, интерактивная спецификация API
Контракт API теперь представлен в виде чистой спецификации OpenAPI 3.2, опубликованной как интерактивный Swagger UI по адресу schema.adamant.im. Схема была проверена полностью по отношению к работающему узлу, поэтому то, что вы читаете, — это то, что сеть действительно возвращает: аккаунты, транзакции, чаты, делегаты, блоки, хранилище ключ-значение и конечные точки узла — всё в одном исследуемом справочнике.
Разработчики могут отправлять запросы прямо в браузере. Спецификация включает выбор сервера в реальном времени: интерфейс опрашивает каждый публичный узел, показывает его текущую версию API и автоматически выбирает работоспособный узел основной сети, чтобы запросы “попробовать” работали сразу. Вы можете искать по всем операциям по пути, методу, имени или описанию, а поскольку источником истины является реальный документ OpenAPI, вы можете генерировать типизированные клиенты (например, на TypeScript) напрямую из него. Собственный клиент adamant-api-jsclient от ADAMANT делает именно это.
Глубокая диагностика узла
Несколько нововведений в v0.10.0 — это небольшие поля с большой пользой. Транзакции теперь содержат поле timestampMs, предоставляющее временные метки с точностью до миллисекунд, наряду с существующим timestamp в секундах. Для мессенджера, где важен порядок сообщений, это позволяет клиентам сортировать сообщения и переводы с точностью менее одной секунды. Клиенты должны использовать timestampMs, если оно доступно, и возвращаться к timestamp * 1000 в противном случае.
Ответ о состоянии узла теперь включает nodeTimestampMs, unixTimestampMs и объект loader, сообщающий о ходе синхронизации (syncing, consensus, blocks, blocksCount), что позволяет операторам и инструментам мгновенно оценивать состояние здоровья и синхронизации узла. Новый эндпоинт GET /peers/get позволяет найти конкретного пира по IP и порту — полезно для создания мониторов сети и инструментов диагностики подключения. Запросы чатов и транзакций стали чище благодаря новым параметрам returnUnconfirmed и includeDirectTransfers, которые дают клиентам точный контроль над возвращаемыми данными. Эти дополнения совместимы с предыдущими версиями: существующие интеграции продолжают работать, а новые получают больше возможностей.
Документация, по которой реально можно строить
API — это только половина дела. Документация на docs.adamant.im была переписана и расширена, снабжена тегами версий, соответствующими релизу узла, чтобы руководства и сеть никогда не расходились. Новые и расширенные разделы охватывают консенсус и проверку транзакций — как достигается согласие по блокам и что делает транзакцию действительной — а также синхронизацию и эндпоинты загрузки/состояния, чтобы вы точно понимали, что делает узел при догонянии сети. Доступны руководства по установке (включая macOS), настройке, автозапуску, начальной загрузке и восстановлению узла, а также полная документация по семантике timestampMs, чтобы вы корректно обрабатывали время с первого дня.
Запустите сеть за минуты: localnet + testnet
Теперь вы можете развернуть полную сеть ADAMANT на своём компьютере с помощью localnet. Разрабатывайте и тестируйте на реальном блокчейне, не затрагивая публичную инфраструктуру, не ожидая подтверждений от загруженной сети и не тратя реальные ADM. Быстро итерируйте, свободно сбрасывайте состояние. Когда вы будете готовы выйти за пределы своего ноутбука, публичная testnet была полностью перезапущена и синхронизирована с v0.10.0 — это общая безопасная среда для проверки интеграций в реальных сетевых условиях перед запуском в основную сеть. Путь локально → тестовая сеть → основная сеть теперь гладкий и хорошо задокументированный, а не обрывистый обрыв.
Что вы можете создать
С типизированным API, запускаемыми сетями и реальной документацией открываются практические сценарии. ADAMANT — это полностью децентрализованный, зашифрованный с конца до конца мессенджер на собственном блокчейне, поэтому кошельки и мессенджеры могут отправлять зашифрованные сообщения и ценности в одном протоколе. Сервисы уведомлений и оповещений могут передавать события в блокчейне (платежи, сообщения) в ваши приложения. Интеграции с биржами и торговыми платформами получают программную обработку аккаунтов, балансов и переводов с точностью до миллисекунд. Боты и автоматизация — чат-боты, платёжные боты, боты мониторинга — все используют этот API, а экосистема ADAMANT уже включает торговых ботов и другие решения. Машинный обмен сообщениями и IoT получают устойчивый к цензуре, анонимный канал для координации и взаимных платежей устройств, а анонимная, бессерверная связь становится возможной там, где нет центрального сервера, который можно вызвать в суд, утечку или отключить.
Поскольку сообщения и платежи используют один протокол, многие из этих возможностей комбинируются: кошелёк, который ведёт чат, бот, который платит, устройство, которое отправляет сообщения и расплачивается — всё на одной платформе.
Ссылки
- Справка по API: schema.adamant.im
- Документация: docs.adamant.im
- Исходный код узла: github.com/Adamant-im/adamant
- JS-клиент: github.com/Adamant-im/adamant-api-jsclient