테스트넷이 운영 중입니다. 키도, 가입도, 대기자 명단도 필요 없습니다.

빠른 시작

1. 지금 어떤 체인에 있나요?

먼저 이 작업을 하세요. 주소는 체인별로 다릅니다 — 테스트넷에서 자금을 받은 주소는 다른 ZooBC 네트워크에는 존재하지 않습니다.

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

height는 최신 지점이며, confirmed_height는 그보다 뒤처집니다. confirmed_height보다 높은 것은 모두 잠정적입니다. 메인넷은 아직 출시되지 않았습니다 — 출시되면 자체 도메인에서 자체 문서 사본을 제공할 예정입니다.

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. 값 전송하기

두 가지 방법이 있습니다. 둘 다 로컬에서 서명하며, 체인은 개인 키를 절대 보지 않습니다.

CLI:

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

HTTP: 바이트를 구성하고, 체인에 종속된 다이제스트에 서명한 뒤 16진수로 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에 끌어다 놓으면 합의와 대조해 해시를 확인합니다. 이것이 이 페이지를 포함한 어떤 다운로드 페이지를 믿는 것보다 더 선호해야 할 방법입니다.

소스 코드

핵심 노드 소프트웨어는 아직 공개되지 않았습니다. 재단이 밝힌 입장에 따르면, 핵심 노드 소스는 메인넷 출시 후 6개월 이내에 공개되며, 채택 수준이 그보다 이른 공개를 정당화하면 더 빨리 공개될 수 있습니다. 여러 유틸리티와 CLI 도구는 메인넷 이전에 공개될 예정입니다. 그때까지는 온체인 릴리스 레지스트리를 사용해 실행 중인 바이너리가 합의에 의해 게시된 것과 일치하는지 검증하세요.

ZooBC의 에이전트

ZooBC는 자율 에이전트 간 거래에 적합한 온체인 기본 요소를 제공합니다:

• 예약 및 베스팅 전송 — 시간이 지남에 따라 지급되는 허용 한도.
• 자동 타임아웃이 있는 에스크로 — 상대방이 조치를 취하지 않으면 자금이 반환됩니다.
• N-of-M 멀티시그 — 단일 당사자가 뒤집을 수 없는 지출 거부권.
• 계정별 데이터셋 — 에이전트가 읽고 쓸 수 있는 작은 구조화된 상태.

에이전트에게는 합의로 강제되는 상한이 있는 사용 가능한 허용 한도를 부여할 수 있으며, 에이전트가 취하는 모든 행동은 사람이 나중에 검토할 수 있는 영구적인 감사 추적을 남깁니다. AI 에이전트가 거래하는 기반으로서 ZooBC가 바로 그런 경우입니다 — 지출은 에이전트 런타임에 대한 신뢰가 아니라 체인 자체에 의해 제한됩니다.