Non limitarti a guardare crescere il prossimo ecosistema decentralizzato. Aiuta a costruirlo.
ZooBC espone la chain tramite gateway e API, mentre il Wallet mostra lo scambio, i pagamenti, le applicazioni, la comunicazione, l'archiviazione, gli strumenti per le aziende e i controlli dell'infrastruttura già costruiti intorno a essa.
Perché questo simbolo?
Il castoro trasforma la materia prima in ambienti funzionanti. Rappresenta gli sviluppatori e i team di prodotto che trasformano i protocolli in strumenti, ponti, applicazioni e luoghi che le persone possono usare.
Sviluppa sul protocollo che esiste davvero, spigoli compresi.
ZooBC espone un'ampia superficie di transazioni e applicazioni, ma l'integrazione parte dal comportamento esatto a livello di protocollo: quale servizio riceve una richiesta, quali campi appartengono alla busta firmata, quali importi sono atomici, come si calcolano le commissioni e quale risultato dimostra il successo.
Scegli il servizio corretto
Le letture della chain sotto /api/v1/ possono essere servite dalla storia d'archivio. Le POST di transazioni devono raggiungere un nodo completo perché richiedono una mempool. Alcuni percorsi dello stato delle applicazioni sono endpoint del nodo anziché endpoint d'archivio.
Modella la busta firmata
Ogni transazione racchiude un corpo tipizzato in una busta comune. Destinatario e memo possono trovarsi nella busta anziché nel corpo del tipo. Firma l'intera busta non firmata usando lo schema richiesto dal tipo di account.
Mantieni i valori esatti
Gli importi dell'API usano unità atomiche: 1 ZBC equivale a 100.000.000 unità atomiche. Leggi i parametri attuali delle commissioni o stima la transazione esatta invece di riprodurre i calcoli delle commissioni da una vecchia interfaccia.
Verifica l'effetto
Un invio riuscito non è la fine del flusso. Conserva l'identificatore della transazione, trova la sua inclusione, esamina i movimenti o lo stato risultanti e distingui la risposta di accettazione di un nodo dallo stato confermato della chain.
Trattali come contratti tecnici.
La maggior parte dei fallimenti di integrazione deriva dalla violazione di un confine che l'interfaccia utente nasconde.
| Contratto | Comportamento richiesto | Errore comune |
|---|---|---|
| Instradamento di letture e scritture | Usa un endpoint della chain leggibile per le GET e un percorso verso la mempool di un nodo completo per le POST di transazioni. | Trasmettere alla storia d'archivio e interpretarne il rifiuto come una transazione non valida. |
| Importi atomici | Rappresenta i valori di ZBC e dei token come unità atomiche intere; applica i decimali dei token solo in visualizzazione. | Inviare un valore decimale di visualizzazione come se fosse l'importo trasmesso. |
| Calcolo delle commissioni | Leggi https://zoobc.network/api/v1/blockchain/fee-params sul gateway pubblico della TestNet, oppure usa lo stimatore esatto delle commissioni per la transazione serializzata. | Fissare nel codice una commissione che non corrisponde più a dimensione, archiviazione, durata o scala delle commissioni della rete. |
| Busta e corpo | Serializza la busta comune più l'esatto corpo tipizzato little-endian e i modificatori opzionali. | Collocare destinatario, memo, ID del token o dati temporali nel livello sbagliato. |
| Gestione delle chiavi | Firma in locale e tieni il materiale privato fuori da URL, log, elenchi dei processi, analytics e server. | Passare una chiave privata come argomento visibile da riga di comando o come campo di un modulo remoto. |
| Interpretazione dello stato | Usa le transazioni per le azioni firmate e i movimenti o lo stato delle applicazioni per gli effetti di protocollo che ne derivano. | Presumere che ogni ricompensa, rimborso, rilascio di vesting o esito di un'app sia una nuova transazione utente. |
Costruisci prima una singola sezione verticale verificabile.
Prima di progettare un'interfaccia complessa, fai funzionare da cima a fondo una lettura, un'azione firmata sulla testnet e un risultato confermato.
- 01
Dimostra la connessione
Interroga lo stato della blockchain e conserva l'altezza restituita. Conferma la rete di destinazione e il comportamento del gateway prima di creare account o richiedere monete di test.
- 02
Scegli un tipo di transazione preciso
Leggi la sua busta, la struttura del corpo, il tipo di account, il comportamento delle commissioni, i modificatori e il risultato. Non dedurre il formato di una transazione da un'altra solo perché l'interfaccia sembra simile.
- 03
Costruisci e firma in locale
Serializza importi atomici interi, stima la commissione esatta e firma senza esporre la chiave privata a un server, a un log, a un URL, a un evento di analytics o alla cronologia della shell.
- 04
Invia, conferma e riconcilia
Invia a un nodo completo, conserva l'identificatore restituito, trova l'inclusione tramite l'Explorer o l'API ed esamina eventuali movimenti o stati applicativi risultanti prima di segnalare il successo.
Non passare dalla testnet a un uso con valore reale finché l'integrazione può far trapelare chiavi, confondere le unità di visualizzazione con le unità atomiche, basarsi su commissioni superate fissate nel codice, inviare al servizio sbagliato o presentare l'accettazione da parte del nodo come conferma definitiva.
Usa il riferimento più vicino al comportamento.
La guida per sviluppatori spiega la topologia; la documentazione API descrive i percorsi; i manuali documentano la serializzazione e le regole delle applicazioni; gli strumenti live ti permettono di testare il percorso completo.
Comportamento del gateway, primi percorsi, invio delle transazioni, targeting dei nodi, operazioni e download.
↗RIFERIMENTO DEI PERCORSIDocumentazione APIMetodi, percorsi, parametri, autenticazione, corpi delle richieste ed esempi di risposta.
↗FORMATO DI TRASMISSIONEManuale delle transazioniAnatomia della busta, firme, unità atomiche, stima delle commissioni, modificatori e tutti i tipi di transazione.
↗COMANDIManuale della CLIComportamento dei comandi e percorsi supportati per costruire transazioni sulla testnet.
↗REGOLE DELLE APPLICAZIONIManuale delle appCorpi delle transazioni delle app, registro, pagamenti, casualità, state channel, percorsi di stato e verifica.
↗VALORE DI TESTFaucetOttieni ZBC di testnet privi di valore per lo sviluppo supportato e il test delle transazioni.
↗Rendi espliciti i fallimenti e noiose le chiavi.
Un'integrazione utile è precisa sullo stato e priva di interesse per un attaccante.
- Tieni il materiale privato di firma in locale e fuori dalla telemetria.
- Usa unità atomiche intere in tutto il livello dei dati.
- Stima le commissioni a partire dalla superficie live del protocollo.
- Conserva gli ID delle transazioni e riconcilia i movimenti risultanti.
- Mostra in modo distinto gli stati non disponibile, in attesa, rifiutato, incluso e confermato.
- Fissare nel codice vecchie commissioni, altezze, elenchi di nodi o hash di release.
- Inviare scritture a percorsi di sola archiviazione.
- Trattare una risposta 200 come prova di uno stato confermato senza leggerne il corpo e seguire la transazione.
- Inventare campi di transazione o comportamenti applicativi non documentati.
- Inserire chiavi private in query string, log, screenshot o messaggi all'assistenza.
Ti riconosci?
Per sviluppatori, team applicativi, ingegneri di protocollo, tester e contributori tecnici.
Sviluppi applicazioni, protocolli, integrazioni, infrastrutture o strumenti per sviluppatori.
Vuoi testare le funzionalità emergenti, trovare bug o migliorare la documentazione.
Ti stanno a cuore i sistemi aperti, la firma locale, un comportamento verificabile e la proprietà in mano agli utenti.
Sai trasformare le competenze tecniche in qualcosa che altre persone possono davvero usare.
Entra da una porta vera.
Ogni percorso qui sotto porta a una pagina, a uno strumento o a uno spazio della community di ZooBC già esistenti.
Guida per sviluppatori
Impara il modello del gateway, i percorsi principali, l'invio delle transazioni e i confini operativi.
↗RIFERIMENTODocumentazione API
Esamina metodi, percorsi, requisiti di autenticazione, corpi delle richieste ed esempi.
↗COMPORTAMENTO ALLA FONTEManuali delle transazioni
Comprendi i tipi di transazione, il comportamento del wallet, le applicazioni e i comandi della CLI.
↗Segui le prove.
Usa la fonte adatta alla domanda invece di affidarti a un'unica pagina di marketing.
Dall'interesse alla partecipazione.
- 01Leggi il modello tecnico
- 02Usa le API e gli strumenti della testnet
- 03Porta una build, una segnalazione di bug, un test o una proposta tecnica
Non limitarti a guardare crescere il prossimo ecosistema decentralizzato. Aiuta a costruirlo.
ZooBC espone la chain tramite gateway e API, mentre il Wallet mostra lo scambio, i pagamenti, le applicazioni, la comunicazione, l'archiviazione, gli strumenti per le aziende e i controlli dell'infrastruttura già costruiti intorno a essa.