No te limites a ver crecer el próximo ecosistema descentralizado. Ayuda a construirlo.
ZooBC expone la cadena a través de pasarelas y API, mientras que la billetera muestra el exchange, los pagos, las aplicaciones, la comunicación, el almacenamiento, las herramientas empresariales y los controles de infraestructura que ya se han construido a su alrededor.
¿Por qué este símbolo?
El castor convierte la materia prima en entornos que funcionan. Representa a los desarrolladores y equipos de producto que transforman protocolos en herramientas, puentes, aplicaciones y lugares que la gente puede usar.
Construye sobre el protocolo que existe, incluidas sus aristas.
ZooBC expone una amplia superficie de transacciones y aplicaciones, pero la integración empieza por el comportamiento exacto en la red: qué servicio recibe una solicitud, qué campos van en el sobre firmado, qué importes son atómicos, cómo se calculan las comisiones y qué resultado demuestra el éxito.
Elige el servicio correcto
Las lecturas de la cadena bajo /api/v1/ pueden servirse desde el historial de archivo. Los POST de transacciones deben llegar a un nodo completo porque requieren una mempool. Algunas rutas de estado de aplicaciones son endpoints de nodo y no de archivo.
Modela el sobre firmado
Cada transacción envuelve un cuerpo tipado en un sobre común. El destinatario y la nota pueden estar en el sobre en lugar de en el cuerpo del tipo. Firma el sobre completo sin firmar con el esquema que exige el tipo de cuenta.
Mantén los valores exactos
Los importes de la API usan unidades atómicas: 1 ZBC equivale a 100,000,000 unidades atómicas. Lee los parámetros de comisión actuales o estima la transacción exacta en lugar de reproducir el cálculo de comisiones de una interfaz antigua.
Verifica el efecto
Un envío correcto no es el final del flujo de trabajo. Conserva el identificador de la transacción, localiza su inclusión, inspecciona los movimientos o el estado resultantes y distingue la respuesta de aceptación de un nodo del estado confirmado de la cadena.
Trátalos como contratos técnicos.
La mayoría de los fallos de integración se deben a violar un límite que la interfaz de usuario oculta.
| Contrato | Comportamiento requerido | Fallo habitual |
|---|---|---|
| Enrutamiento de lecturas y escrituras | Usa un endpoint de cadena legible para los GET y una ruta a la mempool de un nodo completo para los POST de transacciones. | Difundir al historial de archivo e interpretar su rechazo como una transacción no válida. |
| Importes atómicos | Representa los valores de ZBC y de tokens como unidades atómicas enteras; aplica los decimales del token solo al mostrarlos. | Enviar un valor decimal de visualización como si fuera el importe que viaja por la red. |
| Cálculo de comisiones | Lee https://zoobc.network/api/v1/blockchain/fee-params en la pasarela pública de la TestNet o usa el estimador exacto de comisiones para la transacción serializada. | Fijar en el código una comisión que ya no corresponde al tamaño, el almacenamiento, la duración o la escala de comisiones de la red. |
| Sobre y cuerpo | Serializa el sobre común más el cuerpo tipado exacto en little-endian y los modificadores opcionales. | Colocar el destinatario, la nota, el ID del token o los datos de tiempo en la capa equivocada. |
| Manejo de claves | Firma localmente y mantén el material privado fuera de las URL, los registros, los listados de procesos, las analíticas y los servidores. | Pasar una clave privada como argumento visible de línea de comandos o como campo de un formulario remoto. |
| Interpretación del estado | Usa las transacciones para las acciones firmadas, y los movimientos o el estado de la aplicación para los efectos resultantes del protocolo. | Suponer que cada recompensa, reembolso, liberación gradual o resultado de una aplicación es una nueva transacción de usuario. |
Construye primero un corte vertical verificable.
Antes de diseñar una interfaz grande, haz que funcionen de principio a fin una lectura, una acción firmada en la testnet y un resultado confirmado.
- 01
Demuestra la conexión
Consulta el estado de la blockchain y conserva la altura devuelta. Confirma la red de destino y el comportamiento de la pasarela antes de crear cuentas o pedir monedas de prueba.
- 02
Elige un tipo de transacción exacto
Lee su sobre, la estructura del cuerpo, el tipo de cuenta, el comportamiento de las comisiones, los modificadores y el resultado. No deduzcas el formato de una transacción a partir de otra solo porque la interfaz se parezca.
- 03
Construye y firma localmente
Serializa los importes como unidades atómicas enteras, estima la comisión exacta y firma sin exponer la clave privada a un servidor, un registro, una URL, un evento de analítica o el historial de la shell.
- 04
Envía, confirma y concilia
Envía a un nodo completo, conserva el identificador devuelto, localiza la inclusión mediante el explorador o la API e inspecciona los movimientos o el estado de la aplicación resultantes antes de informar del éxito.
No pases de la testnet a un uso con valor real mientras la integración pueda filtrar claves, confundir unidades de visualización con unidades atómicas, fijar en el código supuestos de comisiones obsoletos, enviar al servicio equivocado o presentar la aceptación de un nodo como confirmación definitiva.
Usa la referencia más cercana al comportamiento.
La guía para desarrolladores explica la topología; la documentación de la API describe las rutas; los manuales documentan la serialización y las reglas de las aplicaciones; las herramientas en vivo te permiten probar la ruta completa.
Comportamiento de la pasarela, primeras rutas, envío de transacciones, selección de nodos, operaciones y descargas.
↗REFERENCIA DE RUTASDocumentación de la APIMétodos, rutas, parámetros, autenticación, cuerpos de solicitud y ejemplos de respuesta.
↗FORMATO DE TRANSMISIÓNManual de transaccionesAnatomía del sobre, firmas, unidades atómicas, estimación de comisiones, modificadores y todos los tipos de transacción.
↗COMANDOSManual de la CLIComportamiento de los comandos y rutas admitidas para construir transacciones en la testnet.
↗REGLAS DE LAS APLICACIONESManual de aplicacionesCuerpos de las transacciones de aplicaciones, registro, pagos, aleatoriedad, canales de estado, rutas de estado y verificación.
↗VALOR DE PRUEBAFaucetObtén ZBC de la testnet, sin valor, para el desarrollo admitido y las pruebas de transacciones.
↗Haz que los fallos sean explícitos y las claves, aburridas.
Una integración útil es precisa con el estado y poco interesante para un atacante.
- Mantén el material de firma privado en local y fuera de la telemetría.
- Usa unidades atómicas enteras en toda la capa de datos.
- Estima las comisiones a partir de la superficie en vivo del protocolo.
- Conserva los ID de transacción y concilia los movimientos resultantes.
- Muestra de forma diferenciada los estados no disponible, pendiente, rechazado, incluido y confirmado.
- Fijar en el código comisiones, alturas, listas de nodos o hashes de versiones antiguos.
- Enviar escrituras a rutas de solo archivo.
- Tomar una respuesta 200 como prueba de un estado confirmado sin leer su cuerpo ni seguir la transacción.
- Inventar campos de transacción o comportamientos de aplicaciones no documentados.
- Poner claves privadas en cadenas de consulta, registros, capturas de pantalla o mensajes al soporte.
¿Esto habla de ti?
Para desarrolladores, equipos de aplicaciones, ingenieros de protocolos, testers y contribuidores técnicos.
Construyes aplicaciones, protocolos, integraciones, infraestructura o herramientas para desarrolladores.
Quieres probar funciones emergentes, encontrar errores o mejorar la documentación.
Te importan los sistemas abiertos, la firma local, el comportamiento verificable y la propiedad del usuario.
Sabes convertir la capacidad técnica en algo que otras personas puedan usar de verdad.
Entra por una puerta real.
Cada una de las rutas siguientes lleva a una página, herramienta o destino de la comunidad de ZooBC que ya existe.
Guía para desarrolladores
Aprende el modelo de pasarela, las rutas principales, el envío de transacciones y los límites del operador.
↗REFERENCIADocumentación de la API
Inspecciona métodos, rutas, requisitos de autenticación, cuerpos de solicitud y ejemplos.
↗COMPORTAMIENTO DE ORIGENManuales de transacciones
Entiende los tipos de transacción, el comportamiento de la billetera, las aplicaciones y los comandos de la CLI.
↗Sigue las pruebas.
Usa la fuente que corresponde a cada pregunta en lugar de depender de una sola página de marketing.
Del interés a la participación.
- 01Lee el modelo técnico
- 02Usa las API y las herramientas de la testnet
- 03Aporta un desarrollo, un informe de errores, una prueba o una propuesta técnica
No te limites a ver crecer el próximo ecosistema descentralizado. Ayuda a construirlo.
ZooBC expone la cadena a través de pasarelas y API, mientras que la billetera muestra el exchange, los pagos, las aplicaciones, la comunicación, el almacenamiento, las herramientas empresariales y los controles de infraestructura que ya se han construido a su alrededor.