Ne vous contentez pas de regarder grandir le prochain écosystème décentralisé. Aidez à le construire.
ZooBC expose la chaîne via des passerelles et des API, tandis que le portefeuille illustre l'échange, les paiements, les applications, la communication, le stockage, les outils professionnels et les contrôles d'infrastructure déjà construits autour d'elle.
Pourquoi ce symbole ?
Le castor transforme la matière brute en environnements fonctionnels. Il représente les développeurs et les équipes produit qui transforment des protocoles en outils, en ponts, en applications et en lieux que les gens peuvent utiliser.
Développer pour le protocole tel qu'il existe, y compris ses aspérités.
ZooBC expose une large surface de transactions et d'applications, mais l'intégration commence par le comportement exact sur le fil : quel service reçoit une requête, quels champs appartiennent à l'enveloppe signée, quels montants sont atomiques, comment les frais sont calculés et quel résultat prouve la réussite.
Choisir le bon service
Les lectures de la chaîne sous /api/v1/ peuvent être servies depuis l'historique d'archive. Les POST de transaction doivent atteindre un nœud complet, car ils nécessitent une mempool. Certaines routes d'état applicatif sont des points de terminaison de nœud plutôt que d'archive.
Modéliser l'enveloppe signée
Chaque transaction place un corps typé dans une enveloppe commune. Le destinataire et le mémo peuvent se trouver dans l'enveloppe plutôt que dans le corps du type. Signez l'enveloppe non signée complète avec le schéma exigé par le type de compte.
Garder des valeurs exactes
Les montants de l'API utilisent des unités atomiques : 1 ZBC équivaut à 100 000 000 unités atomiques. Lisez les paramètres de frais actuels ou estimez la transaction exacte au lieu de reproduire le calcul des frais d'une ancienne interface.
Vérifier l'effet
Une soumission réussie ne marque pas la fin du processus. Conservez l'identifiant de la transaction, retrouvez son inclusion, examinez les mouvements ou l'état qui en résultent, et distinguez une réponse d'acceptation par un nœud d'un état confirmé sur la chaîne.
Traitez-les comme des contrats techniques.
La plupart des échecs d'intégration viennent de la violation d'une frontière que l'interface utilisateur masque.
| Contrat | Comportement requis | Erreur fréquente |
|---|---|---|
| Routage lecture / écriture | Utilisez un point de terminaison de chaîne lisible pour les GET et une route vers la mempool d'un nœud complet pour les POST de transaction. | Diffuser vers l'historique d'archive et interpréter son rejet comme une transaction invalide. |
| Montants atomiques | Représentez les valeurs en ZBC et en jetons comme des unités atomiques entières ; n'appliquez les décimales du jeton que pour l'affichage. | Envoyer une valeur d'affichage décimale comme s'il s'agissait du montant transmis. |
| Calcul des frais | Lisez https://zoobc.network/api/v1/blockchain/fee-params sur la passerelle publique du TestNet, ou utilisez l'estimateur de frais exact pour la transaction sérialisée. | Coder en dur des frais qui ne correspondent plus à la taille, au stockage, à la durée ou à l'échelle de frais du réseau. |
| Enveloppe et corps | Sérialisez l'enveloppe commune, puis le corps typé exact en little-endian et les modificateurs facultatifs. | Placer le destinataire, le mémo, l'ID du jeton ou les données temporelles dans la mauvaise couche. |
| Gestion des clés | Signez localement et tenez les éléments privés à l'écart des URL, des journaux, des listes de processus, des outils d'analyse et des serveurs. | Passer une clé privée comme argument visible en ligne de commande ou dans un champ de formulaire distant. |
| Interprétation de l'état | Utilisez les transactions pour les actions signées, et les mouvements ou l'état applicatif pour les effets du protocole qui en résultent. | Supposer que chaque récompense, remboursement, libération du déblocage progressif ou résultat d'application est une nouvelle transaction utilisateur. |
Construisez d'abord une tranche verticale vérifiable.
Avant de concevoir une grande interface, faites fonctionner de bout en bout une lecture, une action signée sur le testnet et un résultat confirmé.
- 01
Prouver la connexion
Interrogez l'état de la blockchain et conservez la hauteur renvoyée. Confirmez le réseau cible et le comportement de la passerelle avant de créer des comptes ou de demander des ZBC de test.
- 02
Choisir un type de transaction précis
Lisez son enveloppe, la structure de son corps, le type de compte, le comportement des frais, les modificateurs et le résultat. Ne déduisez pas le format d'une transaction de celui d'une autre simplement parce que l'interface se ressemble.
- 03
Construire et signer localement
Sérialisez des montants atomiques entiers, estimez les frais exacts et signez sans exposer la clé privée à un serveur, un journal, une URL, un événement d'analyse ou l'historique du shell.
- 04
Soumettre, confirmer et rapprocher
Soumettez à un nœud complet, conservez l'identifiant renvoyé, retrouvez l'inclusion via l'explorateur ou l'API, et examinez les mouvements ou l'état applicatif qui en résultent avant d'annoncer une réussite.
Ne passez pas du testnet à un usage impliquant de la valeur tant que l'intégration peut divulguer des clés, confondre unités d'affichage et unités atomiques, coder en dur des hypothèses de frais périmées, soumettre au mauvais service ou présenter l'acceptation par un nœud comme une confirmation définitive.
Utilisez la référence la plus proche du comportement.
Le guide du développeur explique la topologie ; la documentation de l'API décrit les routes ; les manuels documentent la sérialisation et les règles applicatives ; les outils en direct vous permettent de tester le chemin complet.
Comportement de la passerelle, premières routes, soumission de transactions, ciblage des nœuds, exploitation et téléchargements.
↗RÉFÉRENCE DES ROUTESDocumentation de l'APIMéthodes, chemins, paramètres, authentification, corps de requête et exemples de réponse.
↗FORMAT DE TRANSMISSIONManuel des transactionsAnatomie de l'enveloppe, signatures, unités atomiques, estimation des frais, modificateurs et tous les types de transactions.
↗COMMANDESManuel de la CLIComportement des commandes et voies de construction de transactions prises en charge pour le travail sur le testnet.
↗RÈGLES APPLICATIVESManuel des applicationsCorps des transactions d'application, registre, versements, aléa, canaux d'état, routes d'état et vérification.
↗VALEUR DE TESTFaucetObtenez des ZBC de testnet sans valeur pour le développement et les tests de transactions pris en charge.
↗Rendez les échecs explicites et les clés ennuyeuses.
Une intégration utile est précise sur l'état et sans intérêt pour un attaquant.
- Garder les éléments de signature privés en local et hors de la télémétrie.
- Utiliser des unités atomiques entières dans toute la couche de données.
- Estimer les frais à partir de l'interface en direct du protocole.
- Conserver les ID de transaction et rapprocher les mouvements qui en résultent.
- Afficher distinctement les états indisponible, en attente, rejeté, inclus et confirmé.
- Coder en dur d'anciens frais, hauteurs, listes de nœuds ou hash de versions.
- Envoyer des écritures à des routes réservées à l'archive.
- Considérer une réponse 200 comme la preuve d'un état confirmé sans lire son corps ni suivre la transaction.
- Inventer des champs de transaction ou des comportements applicatifs non documentés.
- Mettre des clés privées dans des chaînes de requête, des journaux, des captures d'écran ou des messages au support.
Cela vous ressemble ?
Pour les développeurs, les équipes applicatives, les ingénieurs protocole, les testeurs et les contributeurs techniques.
Vous développez des applications, des protocoles, des intégrations, des infrastructures ou des outils pour développeurs.
Vous voulez tester des fonctionnalités émergentes, trouver des bugs ou améliorer la documentation.
Vous tenez aux systèmes ouverts, à la signature locale, à un comportement vérifiable et à la propriété des utilisateurs.
Vous savez transformer une capacité technique en quelque chose que d'autres peuvent réellement utiliser.
Entrez par une vraie porte.
Chaque parcours ci-dessous mène à une page, un outil ou un espace communautaire ZooBC existant.
Guide du développeur
Découvrez le modèle de passerelle, les routes principales, la soumission de transactions et les limites côté opérateur.
↗RÉFÉRENCEDocumentation de l'API
Examinez les méthodes, les chemins, les exigences d'authentification, les corps de requête et les exemples.
↗COMPORTEMENT À LA SOURCEManuels des transactions
Comprenez les types de transactions, le comportement du portefeuille, les applications et les commandes de la CLI.
↗Suivez les preuves.
Utilisez la source adaptée à la question au lieu de vous fier à une seule page marketing.
De l'intérêt à la participation.
- 01Lire le modèle technique
- 02Utiliser les API et les outils du testnet
- 03Apporter un développement, un rapport de bug, un test ou une proposition technique
Ne vous contentez pas de regarder grandir le prochain écosystème décentralisé. Aidez à le construire.
ZooBC expose la chaîne via des passerelles et des API, tandis que le portefeuille illustre l'échange, les paiements, les applications, la communication, le stockage, les outils professionnels et les contrôles d'infrastructure déjà construits autour d'elle.