ADAMANT Wallet Metadata 2.6.0: Заметки для разработчиков по интеграции кошельков
ADAMANT Wallet Metadata 2.6.0 готов к выпуску. Это обновление в первую очередь актуально для разработчиков, которые интегрируют встроенные криптокошельки ADAMANT, метаданные кошельков, списки нод, определения сервисов или синхронизацию пользовательского интерфейса и конфигурации кошельков.
Что изменилось для разработчиков кошельков и сервисов
Репозиторий adamant-wallets является каноническим источником метаданных монет, токенов, блокчейнов, нод, сервисов, иконок и схем, используемых приложениями ADAMANT. Версия 2.6.0 обновляет как сами метаданные, так и документацию по тому, как потребители должны их обрабатывать.
Модель переопределения метаданных теперь задокументирована более чётко. Общие поля находятся в assets/general/<coin-or-token>/info.json, значения по умолчанию для блокчейнов — в assets/blockchains/<blockchain>/info.json, а специфические для блокчейна переопределения токенов — в assets/blockchains/<blockchain>/<token>/info.json. Файл README.md восстановлен и дополнен пояснениями к параметрам метаданных кошельков, включая ноды, сервисы, комиссии, точность, иконки, проверки работоспособности, флаги статуса и лимиты переводов. Файл specification/openapi.json охватывает больше полей метаданных кошельков и вложенных структур, что помогает SDK, валидаторам, потребителям схем и генерируемой документации точнее соответствовать реальной структуре JSON. Правила обслуживания репозитория, ожидания по валидации, соглашения по issue/PR и правила безопасности метаданных теперь задокументированы в AGENTS.md и .github/CONTRIBUTING.md.
Метаданные, требующие проверки на стороне потребителей
Если ваше приложение, сервис, SDK, бот или бэкенд напрямую использует метаданные кошельков ADAMANT или получает их через встроенные кошельки ADAMANT, проверьте следующие изменения.
Метаданные нод ADAMANT были обновлены, и три недоступные прокси-ноды ADM удалены: tauri.bbry.app, endless.bbry.app и debate.bbry.app. Обновлены метаданные Bitcoin, Dash и Dogecoin, исправлены примеры валидации адресов Dogecoin. Исправлена ссылка GitHub для DAI, обновлено наименование токена GT. Удалены устаревшие метаданные USDS и связанные с ними иконки. Также обновлены метаданные пакета, lock-файл зависимостей, информация о версии Node.js, скрипты валидации и ссылки на репозиторий.
Рекомендуемые проверки для интеграторов
Если вы используете этот репозиторий в кошельке, интеграции с биржей, сервисе мониторинга, мобильном приложении, PWA, SDK или кастомном бэкенде, выполните повторную синхронизацию метаданных кошельков после слияния 2.6.0 в master. Проверьте, нет ли в вашем коде жёстко заданных ссылок на удалённые метаданные USDS или удалённые прокси-ноды ADM, и повторно запустите валидацию метаданных по обновлённой схеме OpenAPI, если вы используете генерируемые типы, валидаторы или инструменты, учитывающие схему.
Проверьте поведение пользовательского интерфейса кошелька для полей status, defaultVisibility, defaultOrdinalLevel, decimals, cryptoTransferDecimals, minBalance, minTransferAmount, fixedFee, defaultFee и путей к иконкам. Перепроверьте логику выбора нод и сервисов, если ваше приложение использует поля nodes, services, healthCheck, minVersion, hasIndex, alt_ip, txFetchInfo, txConsistencyMaxTime, timeout или настройки надёжности. Убедитесь, что ваша интеграция обрабатывает метаданные как конфигурацию на основе списков и не привязывается к одному единственному endpoint, если только ваша собственная стратегия резервирования явно не определена.
Ссылки
- Release issue: https://github.com/Adamant-im/adamant-wallets/issues/137
- Release PR: https://github.com/Adamant-im/adamant-wallets/pull/138
- Repository: https://github.com/Adamant-im/adamant-wallets
- ADAMANT Improvement Proposals: https://aips.adamant.im/