Разработка
Тестовая сеть работает. Без ключа, без регистрации, без списка ожидания.
Тестовая сеть ZooBC работает по адресу zoobc.network. Публичный REST API — это 82 эндпоинта с Access-Control-Allow-Origin: *. CLI — это 76 инструментов, JSON на входе и JSON на выходе. Рабочий пример проведёт вас от свежесозданного ключа до подтверждённой транзакции примерно за 200 строк стандартной библиотеки Python.
Быстрый старт
1. На какой сети я нахожусь?
Сделайте это первым делом. Адреса привязаны к конкретной сети — адрес, пополненный в тестовой сети, не существует ни в какой другой сети ZooBC.
curl -s https://zoobc.network/api/v1/blockchain/status
height — это верхушка цепочки; confirmed_height отстаёт от неё. Всё выше confirmed_height считается предварительным. Основная сеть ещё не запущена — когда это произойдёт, она будет обслуживать собственную копию документации на собственном домене.
2. Единицы измерения
Атомарные целые числа везде. 1 ZBC = 100 000 000 атомарных единиц. Каждый amount и fee в транзакции — это атомарное целое число. Единственное исключение — кран, который принимает десятичные ZBC.
3. Создать ключ офлайн
zbc-account-gen входит в каждый релиз, не требует сети и выводит JSON. Один и тот же ключ создаёт адреса в нескольких блокчейнах; ZooBC проверяет каждый из них по собственной схеме подписи этой сети.
zbc-account-gen
4. Получить тестовые монеты
curl -s -X POST https://zoobc.network/faucet/claim \
-H 'Content-Type: application/json' \
-d '{"address":"ZBC_...","amount":5}'
Выплата уменьшается вдвое с каждым разом. Прежде чем решить, что кран сломан, прочитайте /faucet/stats — лестница считает то, что вы уже получили, а не сколько раз вы запрашивали.
5. Отправить средства
Два способа. Оба подписывают локально; цепочка никогда не видит приватный ключ.
CLI:
echo '{"sender_privkey":"…","recipient":"ZBC_…","amount":"100000000"}' \
| zbc-cli send-zbc --json-input
HTTP: сформируйте байты, подпишите их привязанный к сети дайджест и отправьте hex через POST. Дайджест — это SHA3-256("ZBC-TX" ‖ genesis_hash ‖ bytes), поэтому подпись действительна ровно для одной сети. Считайте genesis_hash из /api/v1/node/info. Точная раскладка байтов, форма для подписи в сравнении с транспортной и тело JSON транзакции отправки описаны в agents.md §5.
6. Рабочий пример в одном файле
curl -sO https://zoobc.network/dl/zoobc-agent-example.py python3 zoobc-agent-example.py --api https://zoobc.network
Только стандартная библиотека, никаких зависимостей, ~200 строк. Выполняет весь цикл целиком — создаёт ключ, запрашивает монеты из крана, ждёт, пока их можно будет потратить, узнаёт требуемую комиссию, формирует байты, подписывает, отправляет и подтверждает.
Проверить загрузку
SHA-256 каждого опубликованного бинарного файла закреплён в цепочке. Перетащите любой скачанный файл в /verify, и он сверит хеш с консенсусом. Это механизм, которому стоит доверять больше, чем странице загрузки — включая эту.
Исходный код
Исходный код основного программного обеспечения узла пока не публичен. Согласно заявленной позиции Фонда, исходный код основного узла откроется в течение шести месяцев после запуска основной сети, либо раньше, если это оправдано уровнем внедрения. Несколько утилит и инструментов CLI откроются ещё до запуска основной сети. До тех пор используйте ончейн-реестр релизов, чтобы проверить, что запускаемые вами бинарные файлы соответствуют тому, что было опубликовано по консенсусу.
Агенты в ZooBC
ZooBC поставляет ончейн-примитивы, подходящие для автономных агентов, взаимодействующих друг с другом:
- Отложенные и вестинговые переводы — лимиты, которые высвобождаются со временем.
- Эскроу с автоматическим тайм-аутом — средства возвращаются, если контрагент не предпринимает действий.
- Мультиподпись N-из-M — право вето на трату, которое не может отменить ни одна отдельная сторона.
- Наборы данных для каждого аккаунта — небольшое структурированное состояние, которое агенты могут читать и записывать.
Агенту можно выдать расходуемый лимит (allowance) с потолком, обеспеченным консенсусом, и каждое действие, которое он совершает, оставляет постоянный аудиторский след, который человек может впоследствии проверить. Это справедливо и для ZooBC как платформы для транзакций ИИ-агентов — траты ограничены цепочкой, а не доверием к среде выполнения агента.