ZooBC CLI 매뉴얼

모든 ZooBC 트랜잭션을 생성하고, 서명하고, 제출하는 단 하나의 명령줄 도구입니다. 단순한 send-zbc부터 멀티시그, 노드 등록, 거래소, 온체인 스토리지, 거버넌스까지 50개 명령을 제공합니다. 기본적으로 기계 친화적(JSON 입력, JSON 출력)이며, 사람을 위한 대화형 모드도 있습니다.

01다운로드

Linux x86_64 빌드를 다운로드해 압축을 풀고 실행하세요. 설치도, 의존성도 필요 없습니다.

⬇ zoobc-cli 다운로드 (Linux x86_64)

# unpack and put it on your PATH
tar xzf zoobc-cli-linux-x86_64.tar.gz
sudo mv zoobc-cli /usr/local/bin/

# point it at any node or gateway (default: http://localhost:8080)
# https://zoobc.network is the public TestNet gateway, not MainNet
zoobc-cli list --api https://zoobc.network

다른 플랫폼도 준비 중입니다. 현재 빌드는 Ubuntu / Linux x86_64용입니다.

02세 가지 실행 방법

zoobc-cli send-zbc <privkey> ZBC_4HFG43GR_… 100000000 --api $API
→ {"transaction_hash":"a5f1…","amount":100000000, …}

zoobc-cli issue-token --verbose --api $API
Sender private key: … · Symbol: … · Name: … · Decimals: …

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

03보낼 내용 알아보기

두 가지 내장 명령이 모든 것을 알려 주므로 소스를 읽을 필요가 없습니다.

zoobc-cli list              # every command, grouped by category
zoobc-cli help multisig     # the JSON fields for ONE command

help <cmd>는 각 필드의 키, 필수 여부, 기본값, 그리고 바로 편집해 쓸 수 있는 샘플 JSON 객체를 출력합니다:

multisig, N-of-M multisig SendZBC (inner tx + participant signatures)  (tx type 5)
  sender_privkey    (required) Sender private key (64 hex)
  participants      (required) comma-separated participant ZBC addresses
  min_signatures    (required) required signatures (N of M)
  nonce             (optional) multisig account nonce  [default: 0]
  signer_privkeys   (required) participant keys that sign now
  recipient         (required) inner SendZBC recipient address
  amount            (required) inner SendZBC amount (atomic units)
  inner_fee         (optional) inner SendZBC fee (atomic)  [default: 10000000]
Sample: {"sender_privkey":"…","participants":"…", …}

04공통 플래그와 규칙

모든 금액과 가격은 아토믹 정수입니다(ZBC ×1e8, 토큰 금액 ×10^decimals, 주문 가격 ×1e8). 주소는 전체 ZBC_… 문자열이나 hex로 지정할 수 있습니다. 이 도구는 잘못된 입력에도 중단되지 않고 JSON 오류 객체를 반환합니다(--verbose 모드에서는 텍스트 오류).

05실전 예제

# transfer a colored token
zoobc-cli transfer-token $KEY ZBC_6FINNB6J_… <token_id> 500 --api $API

# register a validator node (owner signs; node key supplies the pubkey; PoOwnership is built for you)
zoobc-cli register-node $OWNER_KEY $NODE_KEY 100000000000 --api $API

# open an N-of-M multisig and sign with your key (others co-sign later)
zoobc-cli multisig $KEY "ZBC_A…,ZBC_B…,ZBC_C…" 2 0 "$KEY" ZBC_A… 100000000 5000000 --api $API

# schedule a vesting/recurring payment: 1 ZBC per fire, 12 fires, monthly
zoobc-cli scheduled-transfer $KEY ZBC_… 0 100000000 2592000 12 0 0 0 0 --api $API

06전체 50개 명령

모든 트랜잭션의 바이트 단위 바디 레이아웃은 트랜잭션 매뉴얼에 있습니다. 명령의 필드를 보려면 zoobc-cli help <cmd>를 실행하세요.