La testnet è attiva. Nessuna chiave, nessuna registrazione, nessuna lista d'attesa.

Guida rapida

1. Su quale chain mi trovo?

Fai prima questo. Gli indirizzi sono per-chain — uno finanziato sulla testnet non esiste su nessun'altra rete ZooBC.

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

height è la punta; confirmed_height la segue a distanza. Tutto ciò che è sopra confirmed_height è provvisorio. La mainnet non è ancora stata lanciata — quando lo sarà, servirà una propria copia della documentazione sul proprio dominio.

2. Unità

Interi atomici ovunque. 1 ZBC = 100.000.000 atomici. Ogni amount e fee in una transazione è un intero atomico. L'unica eccezione è il faucet, che accetta ZBC decimali.

3. Genera una chiave, offline

zbc-account-gen è incluso in ogni release, non richiede rete e stampa JSON. La stessa chiave produce indirizzi su più chain; ZooBC verifica ciascuno con lo schema di firma proprio di quella chain.

zbc-account-gen

4. Ottieni monete di test

curl -s -X POST https://zoobc.network/faucet/claim \
  -H 'Content-Type: application/json' \
  -d '{"address":"ZBC_...","amount":5}'

Il pagamento si dimezza man mano che prelevi. Leggi /faucet/stats prima di supporre che il faucet sia rotto — la scala conta quanto hai prelevato, non quante volte hai chiesto.

5. Invia valore

Due modi. Entrambi firmano localmente; la chain non vede mai una chiave privata.

CLI:

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

HTTP: disponi i byte, firma un digest vincolato alla chain, invia l'esadecimale con POST. Il digest è SHA3-256("ZBC-TX" ‖ genesis_hash ‖ bytes), quindi una firma è valida su esattamente una rete. Leggi genesis_hash da /api/v1/node/info. Il layout esatto dei byte, la forma firmabile rispetto a quella di trasporto, e il corpo JSON della transazione di invio sono documentati in agents.md §5.

6. Un riferimento funzionante in un unico file

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

Solo libreria standard, nessuna dipendenza, ~200 righe. Esegue l'intero ciclo — genera una chiave, richiede fondi dal faucet, attende che siano spendibili, chiede quale commissione è richiesta, costruisce i byte, firma, invia e conferma.

Verifica un download

Ogni binario pubblicato ha il proprio SHA-256 ancorato sulla chain. Trascina qualsiasi file scaricato in /verify e verrà controllato l'hash rispetto al consenso. Questo è il meccanismo da preferire alla fiducia in una pagina di download — inclusa questa.

Codice sorgente

Il software del nodo core non è ancora pubblico. Secondo la posizione dichiarata dalla Fondazione, il codice sorgente del nodo core verrà aperto entro sei mesi dal lancio della mainnet, o prima se l'adozione lo giustifica. Diverse utility e strumenti CLI verranno aperti prima della mainnet. Fino ad allora, usa il registro dei rilasci on-chain per verificare che i binari che stai eseguendo corrispondano a quanto pubblicato dal consenso.

Agenti su ZooBC

ZooBC offre primitive on-chain adatte ad agenti autonomi che transano tra loro:

• Trasferimenti programmati e con vesting — allowance che si rilasciano nel tempo.
• Escrow con timeout automatico — i fondi vengono restituiti se la controparte non agisce.
• Multisig N-su-M — un veto di spesa che nessuna singola parte può scavalcare.
• Dataset per account — piccoli stati strutturati che gli agenti possono leggere e scrivere.

A un agente può essere data un'allowance spendibile con un tetto imposto dal consenso, e ogni azione che compie lascia una traccia di audit permanente che un essere umano può ispezionare in seguito. È questo il caso di ZooBC come substrato per agenti IA che effettuano transazioni — la spesa è limitata dalla chain, non dalla fiducia nel runtime dell'agente.