Не просто наблюдайте, как растёт следующая децентрализованная экосистема. Помогите её построить.
ZooBC открывает доступ к блокчейну через шлюзы и API, а кошелёк демонстрирует уже построенные вокруг него обмен, платежи, приложения, коммуникации, хранилище, бизнес-инструменты и средства управления инфраструктурой.
Почему этот символ?
Бобр превращает сырьё в обжитую среду. Он олицетворяет разработчиков и продуктовые команды, которые превращают протоколы в инструменты, мосты, приложения и места, которыми могут пользоваться люди.
Стройте на протоколе, который существует на самом деле, со всеми его острыми углами.
ZooBC предлагает широкий набор транзакций и приложений, но интеграция начинается с точного поведения на уровне формата передачи: какой сервис получает запрос, какие поля входят в подписанный конверт, какие суммы указываются в атомарных единицах, как рассчитываются комиссии и какой результат доказывает успех.
Выберите правильный сервис
Чтение блокчейна через /api/v1/ может обслуживаться из архивной истории. POST-запросы с транзакциями должны попадать на полный узел, потому что им нужен мемпул. Некоторые маршруты состояния приложений являются эндпоинтами узла, а не архивными эндпоинтами.
Смоделируйте подписанный конверт
Каждая транзакция оборачивает типизированное тело в общий конверт. Получатель и мемо могут находиться в конверте, а не в теле типа. Подписывайте весь неподписанный конверт по схеме, которую требует тип аккаунта.
Сохраняйте точность значений
Суммы в API указываются в атомарных единицах: 1 ZBC равен 100 000 000 атомарных единиц. Считывайте текущие параметры комиссий или оценивайте конкретную транзакцию, а не воспроизводите расчёт комиссии из старого интерфейса.
Проверьте результат
Успешная отправка не означает конец процесса. Сохраните идентификатор транзакции, найдите её включение в блок, изучите вызванные ею движения или изменения состояния и отличайте ответ узла о приёме от подтверждённого состояния блокчейна.
Относитесь к этому как к техническим контрактам.
Большинство сбоев интеграции возникает из-за нарушения границы, которую скрывает пользовательский интерфейс.
| Контракт | Требуемое поведение | Типичная ошибка |
|---|---|---|
| Маршрутизация чтения и записи | Используйте эндпоинт блокчейна с доступом на чтение для GET и маршрут к мемпулу полного узла для POST-запросов с транзакциями. | Трансляция в архивную историю и интерпретация её отказа как недействительной транзакции. |
| Атомарные суммы | Представляйте значения ZBC и токенов целыми числами в атомарных единицах; применяйте десятичные знаки токена только для отображения. | Отправка десятичного значения для отображения так, будто это сумма в формате передачи. |
| Расчёт комиссии | Считывайте https://zoobc.network/api/v1/blockchain/fee-params на публичном шлюзе TestNet или используйте точный оценщик комиссии для сериализованной транзакции. | Жёстко заданная комиссия, которая больше не соответствует размеру, хранилищу, длительности или шкале сетевых комиссий. |
| Конверт и тело | Сериализуйте общий конверт вместе с точным типизированным телом в порядке little-endian и необязательными модификаторами. | Размещение получателя, мемо, ID токена или временных данных не на том уровне. |
| Обращение с ключами | Подписывайте локально и не допускайте попадания закрытых данных в URL, логи, списки процессов, аналитику и на серверы. | Передача закрытого ключа как видимого аргумента командной строки или поля удалённой формы. |
| Интерпретация состояния | Используйте транзакции для подписанных действий, а движения или состояние приложений для их последствий на уровне протокола. | Предположение, что каждое вознаграждение, возврат, высвобождение по вестингу или результат приложения является новой пользовательской транзакцией. |
Сначала постройте один проверяемый вертикальный срез.
Прежде чем проектировать большой интерфейс, добейтесь сквозной работы одного чтения, одного подписанного действия в тестовой сети и одного подтверждённого результата.
- 01
Подтвердите подключение
Запросите статус блокчейна и сохраните полученную высоту. Прежде чем создавать аккаунты или запрашивать тестовые монеты, убедитесь в выборе целевой сети и в поведении шлюза.
- 02
Выберите один конкретный тип транзакции
Изучите его конверт, структуру тела, тип аккаунта, поведение комиссии, модификаторы и результат. Не выводите формат одной транзакции из другой только потому, что интерфейс выглядит похоже.
- 03
Соберите и подпишите локально
Сериализуйте целочисленные атомарные суммы, оцените точную комиссию и подпишите, не раскрывая закрытый ключ серверу, логу, URL, событию аналитики или истории командной оболочки.
- 04
Отправьте, подтвердите и сверьте
Отправьте транзакцию на полный узел, сохраните полученный идентификатор, найдите её включение в блок через обозреватель или API и изучите вызванные движения или состояние приложения, прежде чем сообщать об успехе.
Не переходите от тестовой сети к работе с реальной ценностью, пока интеграция может допускать утечку ключей, путать единицы отображения с атомарными единицами, жёстко прописывать устаревшие допущения о комиссиях, отправлять данные не тому сервису или выдавать приём узлом за окончательное подтверждение.
Используйте справочник, ближайший к нужному поведению.
Руководство разработчика объясняет топологию; документация API описывает маршруты; руководства документируют сериализацию и правила приложений; живые инструменты позволяют проверить весь путь.
Поведение шлюза, первые маршруты, отправка транзакций, выбор целевых узлов, эксплуатация и загрузки.
↗СПРАВОЧНИК МАРШРУТОВДокументация APIМетоды, пути, параметры, аутентификация, тела запросов и примеры ответов.
↗ФОРМАТ ПЕРЕДАЧИРуководство по транзакциямАнатомия конверта, подписи, атомарные единицы, оценка комиссий, модификаторы и все типы транзакций.
↗КОМАНДЫРуководство по CLIПоведение команд и поддерживаемые способы сборки транзакций для работы в тестовой сети.
↗ПРАВИЛА ПРИЛОЖЕНИЙРуководство по приложениямТела транзакций приложений, реестр, выплаты, случайность, каналы состояний, маршруты состояния и проверка.
↗ТЕСТОВЫЕ СРЕДСТВАКранПолучите тестовые ZBC без реальной ценности для поддерживаемой разработки и тестирования транзакций.
↗Делайте сбои явными, а ключи скучными.
Полезная интеграция точна в отношении состояния и неинтересна злоумышленнику.
- Храните закрытые данные для подписи локально и вне телеметрии.
- Используйте целочисленные атомарные единицы во всём слое данных.
- Оценивайте комиссии по живому интерфейсу протокола.
- Сохраняйте ID транзакций и сверяйте вызванные ими движения.
- Чётко различайте состояния: недоступно, в ожидании, отклонено, включено в блок и подтверждено.
- Не прописывайте жёстко старые комиссии, высоты, списки узлов или хеши релизов.
- Не отправляйте запись на маршруты, предназначенные только для архива.
- Не считайте ответ 200 доказательством подтверждённого состояния, не прочитав его тело и не отследив транзакцию.
- Не придумывайте недокументированные поля транзакций или поведение приложений.
- Не помещайте закрытые ключи в строки запросов, логи, скриншоты или сообщения в поддержку.
Это про вас?
Для разработчиков, команд приложений, инженеров протоколов, тестировщиков и технических контрибьюторов.
Вы создаёте приложения, протоколы, интеграции, инфраструктуру или инструменты для разработчиков.
Вы хотите тестировать новые функции, находить ошибки или улучшать документацию.
Для вас важны открытые системы, локальная подпись, проверяемое поведение и то, что пользователь сам владеет своим.
Вы умеете превращать технические возможности в то, чем люди действительно могут пользоваться.
Входите через настоящую дверь.
Каждый маршрут ниже ведёт на существующую страницу ZooBC, инструмент или актуальную площадку сообщества.
Руководство разработчика
Изучите модель шлюза, основные маршруты, отправку транзакций и границы ответственности оператора.
↗СПРАВОЧНИКДокументация API
Изучите методы, пути, требования к аутентификации, тела запросов и примеры.
↗ПОВЕДЕНИЕ ИСХОДНОГО КОДАРуководства по транзакциям
Разберитесь в типах транзакций, поведении кошелька, приложениях и командах CLI.
↗Следуйте за доказательствами.
Обращайтесь к источнику, который соответствует вопросу, а не полагайтесь на одну маркетинговую страницу.
От интереса к участию.
- 01Изучите техническую модель
- 02Пользуйтесь API и инструментами тестовой сети
- 03Принесите сборку, отчёт об ошибке, тест или техническое предложение
Не просто наблюдайте, как растёт следующая децентрализованная экосистема. Помогите её построить.
ZooBC открывает доступ к блокчейну через шлюзы и API, а кошелёк демонстрирует уже построенные вокруг него обмен, платежи, приложения, коммуникации, хранилище, бизнес-инструменты и средства управления инфраструктурой.