Testnetは稼働中です。鍵も登録も順番待ちも不要です。

クイックスタート

1. どのチェーンにいるか？

まずこれを行ってください。アドレスはチェーンごとに異なります——testnetで資金を受け取ったアドレスは、他のZooBCネットワークには存在しません。

curl -s https://zoobc.network/api/v1/blockchain/status

heightは最先端のブロック高で、confirmed_heightはそれに遅れて追従します。confirmed_heightを超える部分は暫定的なものです。Mainnetはまだ開始していません——開始後は、独自のドメインで独自のドキュメントが提供されます。

2. 単位

あらゆる場所でatomic整数を使用します。1 ZBC = 100,000,000 atomic単位。トランザクション内のすべてのamountとfeeは、atomic整数です。唯一の例外はフォーセットで、こちらは小数の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. 値を送る

方法は2つです。どちらもローカルで署名を行い、秘密鍵がチェーンに渡ることは一切ありません。

CLI：

echo '{"sender_privkey":"…","recipient":"ZBC_…","amount":"100000000"}' \
  | zbc-cli send-zbc --json-input

HTTP： バイト列を組み立て、そのチェーンに紐づくダイジェストに署名し、16進数でPOSTします。ダイジェストはSHA3-256("ZBC-TX" ‖ genesis_hash ‖ bytes)であるため、署名はただ1つのネットワーク上でのみ有効です。genesis_hashは/api/v1/node/infoから取得してください。正確なバイト配置、署名用と送信用の形式の違い、送金トランザクションのJSON本文は、agents.md §5に記載されています。

6. 1ファイルで完結する動作リファレンス

curl -sO https://zoobc.network/dl/zoobc-agent-example.py
python3 zoobc-agent-example.py --api https://zoobc.network

標準ライブラリのみ、依存関係なし、約200行。鍵の生成、フォーセットからの取得、使用可能になるまでの待機、必要な手数料の確認、バイト列の構築、署名、送信、確認という一連の流れをすべて実行します。

ダウンロードを検証する

公開されるすべてのバイナリは、そのSHA-256ハッシュがチェーンに記録されています。ダウンロードしたファイルを/verifyにドラッグすると、ハッシュがコンセンサスと照合されます。これは、ダウンロードページを信用すること——このページも含め——よりも優先すべき仕組みです。

ソースコード

コアノードソフトウェアは、まだ公開されていません。財団が表明している方針では、コアノードのソースはMainnetの稼働開始から6か月以内に公開されます。普及状況によっては、それより早く公開されることもあります。いくつかのユーティリティとCLIツールは、Mainnetより前に公開されます。それまでの間は、オンチェーンのリリースレジストリを使って、実行しているバイナリがコンセンサスによって公開されたものと一致しているか確認してください。

ZooBC上のエージェント

ZooBCには、自律的なエージェント同士の取引に適したオンチェーンのプリミティブが用意されています。

• スケジュール送金とベスティング送金 — 時間をかけて解放される使用可能枠。
• 自動タイムアウト付きエスクロー — 相手が行動しない場合、資金は返還されます。
• N of M マルチシグ — 単独の当事者が覆せない、支出への拒否権。
• アカウントごとのデータセット — エージェントが読み書きできる、小さな構造化状態。

エージェントには、コンセンサスによって強制される上限付きの使用可能枠を与えることができ、その行動のすべては、後から人間が検証できる恒久的な監査証跡として残ります。これが、AIエージェントが取引を行うための基盤としてのZooBCの姿です——支出は、エージェントの実行環境への信頼によってではなく、チェーンによって制限されます。