Construir
La testnet está activa. Sin clave, sin registro, sin lista de espera.
La testnet de ZooBC se ejecuta en zoobc.network. La API REST pública tiene 82 endpoints con Access-Control-Allow-Origin: *. La CLI son 76 herramientas, con JSON de entrada y salida. Un ejemplo funcional te lleva de una clave nueva a una transacción confirmada en unas 200 líneas de biblioteca estándar de Python.
Guía rápida
1. ¿En qué cadena estoy?
Haz esto primero. Las direcciones son por cadena: una financiada en la testnet no existe en ninguna otra red ZooBC.
curl -s https://zoobc.network/api/v1/blockchain/status
height es la punta; confirmed_height va por detrás. Todo lo que esté por encima de confirmed_height es provisional. La mainnet todavía no se ha lanzado — cuando lo haga, servirá su propia copia de la documentación en su propio dominio.
2. Unidades
Enteros atómicos en todas partes. 1 ZBC = 100,000,000 unidades atómicas. Cada amount y fee de una transacción es un entero atómico. La única excepción es el faucet, que acepta ZBC decimal.
3. Genera una clave, sin conexión
zbc-account-gen se incluye en cada versión, no necesita red y imprime JSON. La misma clave produce direcciones en varias cadenas; ZooBC verifica cada una con el esquema de firma propio de esa cadena.
zbc-account-gen
4. Obtén monedas de prueba
curl -s -X POST https://zoobc.network/faucet/claim \
-H 'Content-Type: application/json' \
-d '{"address":"ZBC_...","amount":5}'
El pago se reduce a la mitad a medida que lo reclamas. Consulta /faucet/stats antes de asumir que el faucet está roto: la escala cuenta lo que has retirado, no cuántas veces lo has pedido.
5. Envía valor
Dos formas. Ambas firman localmente; la cadena nunca ve una clave privada.
CLI:
echo '{"sender_privkey":"…","recipient":"ZBC_…","amount":"100000000"}' \
| zbc-cli send-zbc --json-input
HTTP: dispón los bytes, firma un resumen (digest) vinculado a la cadena, envía el hexadecimal por POST. El resumen es SHA3-256("ZBC-TX" ‖ genesis_hash ‖ bytes), de modo que una firma es válida en exactamente una red. Lee genesis_hash desde /api/v1/node/info. El diseño exacto de los bytes, la forma firmable frente a la de transporte, y el cuerpo JSON de la transacción de envío están documentados en agents.md §5.
6. Una referencia funcional en un solo archivo
curl -sO https://zoobc.network/dl/zoobc-agent-example.py python3 zoobc-agent-example.py --api https://zoobc.network
Solo biblioteca estándar, sin dependencias, ~200 líneas. Ejecuta todo el ciclo: genera una clave, reclama del faucet, espera a que sea gastable, pregunta qué tarifa se requiere, construye los bytes, firma, publica y confirma.
Verificar una descarga
Cada binario publicado tiene su SHA-256 anclado en la cadena. Arrastra cualquier archivo descargado a /verify y se comprueba el hash contra el consenso. Este es el mecanismo que conviene preferir frente a confiar en una página de descargas, incluida esta.
Código fuente
El software principal del nodo todavía no es público. Según la postura declarada de la Fundación, el código del nodo principal se abrirá en un plazo de seis meses desde el lanzamiento de la mainnet, o antes si la adopción lo justifica. Varias utilidades y herramientas de línea de comandos se abrirán antes de la mainnet. Hasta entonces, usa el registro de publicaciones en cadena para verificar que los binarios que ejecutas coinciden con lo publicado por consenso.
Agentes en ZooBC
ZooBC incluye primitivas en cadena pensadas para que los agentes autónomos transaccionen entre sí:
- Transferencias programadas y con liberación gradual — asignaciones que se liberan con el tiempo.
- Depósito en garantía con plazo automático — los fondos se devuelven si la contraparte no actúa.
- Multifirma N de M — un veto de gasto que ninguna parte por sí sola puede anular.
- Conjuntos de datos por cuenta — un pequeño estado estructurado que los agentes pueden leer y escribir.
A un agente se le puede dar una asignación disponible con un techo impuesto por el consenso, y cada acción que realiza deja un rastro de auditoría permanente que una persona puede inspeccionar después. Ese es el caso de ZooBC como sustrato para que los agentes de IA transaccionen: el gasto está limitado por la cadena, no por la confianza en el entorno de ejecución del agente.