Le testnet est en ligne. Pas de clé, pas d'inscription, pas de liste d'attente.

Démarrage rapide

1. Sur quelle chaîne suis-je ?

Faites ceci en premier. Les adresses sont propres à chaque chaîne — une adresse financée sur le testnet n'existe sur aucun autre réseau ZooBC.

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

height est la pointe ; confirmed_height la suit avec retard. Tout ce qui est au-dessus de confirmed_height est provisoire. Le mainnet n'est pas encore lancé — lorsqu'il le sera, il servira sa propre copie de la documentation sur son propre domaine.

2. Unités

Des entiers atomiques partout. 1 ZBC = 100 000 000 unités atomiques. Chaque amount et fee dans une transaction est un entier atomique. La seule exception est le faucet, qui accepte des ZBC décimaux.

3. Générer une clé, hors ligne

zbc-account-gen est fourni avec chaque version, ne nécessite aucun réseau, et affiche du JSON. La même clé produit des adresses sur plusieurs chaînes ; ZooBC vérifie chacune avec le schéma de signature propre à cette chaîne.

zbc-account-gen

4. Obtenir des pièces de test

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

Le versement diminue de moitié à chaque prélèvement. Consultez /faucet/stats avant de supposer que le faucet est cassé — le palier compte ce que vous avez retiré, pas le nombre de fois où vous l'avez demandé.

5. Envoyer de la valeur

Deux façons. Les deux signent localement ; la chaîne ne voit jamais de clé privée.

CLI :

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

HTTP : disposer les octets, signer un condensé lié à la chaîne, envoyer en POST sous forme hexadécimale. Le condensé est SHA3-256("ZBC-TX" ‖ genesis_hash ‖ bytes), de sorte qu'une signature n'est valide que sur un seul réseau. Lisez genesis_hash depuis /api/v1/node/info. La disposition exacte des octets, la forme signable par rapport à la forme de transport, et le corps JSON de la transaction d'envoi sont documentés dans agents.md §5.

6. Une référence fonctionnelle en un seul fichier

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

Bibliothèque standard uniquement, aucune dépendance, ~200 lignes. Il exécute toute la boucle — générer une clé, réclamer au faucet, attendre qu'elle soit dépensable, demander quels frais sont requis, construire les octets, signer, publier, et confirmer.

Vérifier un téléchargement

Chaque binaire publié a son empreinte SHA-256 ancrée sur la chaîne. Glissez n'importe quel fichier téléchargé dans /verify et il vérifie l'empreinte par rapport au consensus. C'est le mécanisme à privilégier plutôt que de faire confiance à une page de téléchargement — y compris celle-ci.

Code source

Le logiciel du nœud principal n'est pas encore public. Selon la position énoncée par la Fondation, le code source du nœud principal s'ouvrira dans les six mois suivant le lancement du mainnet, ou plus tôt si l'adoption justifie une ouverture anticipée. Plusieurs utilitaires et outils CLI s'ouvriront avant le mainnet. D'ici là, utilisez le registre des publications on-chain pour vérifier que les binaires que vous exécutez correspondent à ce qui a été publié par consensus.

Agents sur ZooBC

ZooBC propose des primitives on-chain adaptées aux agents autonomes qui transigent entre eux :

• Virements programmés et à acquisition progressive — des allocations qui se libèrent avec le temps.
• Séquestre avec délai automatique — les fonds reviennent si la contrepartie n'agit pas.
• Multisignature N-sur-M — un droit de veto sur les dépenses qu'aucune partie seule ne peut outrepasser.
• Jeux de données par compte — un petit état structuré que les agents peuvent lire et écrire.

Un agent peut se voir attribuer une allocation dépensable avec un plafond appliqué par le consensus, et chaque action qu'il effectue laisse une trace d'audit permanente qu'un humain peut examiner ensuite. C'est le cas de ZooBC en tant que substrat pour les agents IA qui transigent — les dépenses sont bornées par la chaîne, pas par la confiance accordée à l'environnement d'exécution de l'agent.