ZecHub
Inizia da qui
Inizia il tuo percorso alla scoperta di Zcash
Le risorse necessarie per sviluppare su Zcash, raggruppate in base allo scopo di ciascuna anziché elencate tutte insieme.
Lo stack è cambiato notevolmente nel 2026. zcashd, che ha gestito la rete per gran parte della sua storia, ha raggiunto la fine del ciclo di vita il 18 luglio 2026 all'altezza del blocco 3417100, e ogni nodo non modificato si è arrestato a tale altezza e rifiuterà di riavviarsi. Le guide scritte per zcashd appartengono ormai alla storia anziché costituire un punto di partenza, quindi questa pagina è organizzata attorno a ciò che lo ha sostituito.
| Livello | Cosa usare | Inizia da |
|---|---|---|
| Full node (nodo completo) | Zebra o Zakura | The Zebra Book, zakura.com |
| Portafoglio per full node | Zallet, in beta | The Zallet Book |
| Server per portafoglio leggero | Zaino o lightwalletd | Zaino, lightwalletd |
| Librerie per portafogli | I crate di librustzcash | librustzcash |
| Mobile | SDK Android e iOS | Android, iOS |
| Specifica | Specifica del protocollo e ZIP | zips.z.cash |
Un nodo convalida il consenso e conserva la chain. Esistono due implementazioni in sviluppo attivo.
Zebra è il nodo della Zcash Foundation, scritto in Rust, ed è quello presupposto dalla maggior parte delle guide attuali. The Zebra Book spiega come installarlo ed eseguirlo, mentre il repository è dove avviene lo sviluppo.
Zakura è un nodo più recente, descritto dai suoi autori come un "full node di Zcash compatibile con il consenso, realizzato per la scalabilità", con sincronizzazione più veloce, potatura dei blocchi e una modalità di compatibilità con zcashd. È guidato da Sean Bowe, cofondatore di Zcash, e Dev Ojha. È open source con licenza Apache 2.0 in zakura-core/zakura.
ZecHub dispone di una pagina Full node che illustra i compromessi tra le varie opzioni.
zcashd integrava un portafoglio nel nodo. Quel portafoglio non esiste più e Zallet ne è il sostituto. Il libro di Zallet lo descrive come "un portafoglio di Zcash per full node scritto in Rust", in fase di sviluppo "come sostituto del portafoglio zcashd".
Leggi l'avvertenza sulla sicurezza prima di affidarti a esso. Zallet è in beta, "non è stato completamente esaminato", potrebbero verificarsi modifiche incompatibili "in qualsiasi momento, richiedendoti di eliminare e ricreare il tuo portafoglio Zallet", e non tutti i metodi RPC di zcashd sono stati ancora portati.
Se stai migrando una configurazione esistente, ZecHub offre una guida alla migrazione da zcashd a Zebra e Zallet e un riferimento rapido di Zallet.
La maggior parte dei portafogli non esegue un nodo. Comunicano con un server che conserva la chain e ne restituisce una visualizzazione compatta.
lightwalletd è il servizio originale, scritto in Go, descritto come "un servizio backend che fornisce un'interfaccia efficiente in termini di larghezza di banda alla blockchain di Zcash". Zaino è l'indicizzatore più recente, scritto in Rust, e legge da un validatore completo anziché mantenere una propria copia della chain.
La documentazione del Protocollo dei client leggeri copre il protocollo stesso. La pagina Nodi Lightwallet illustra cosa questi server possono e non possono vedere di un utente, aspetto che vale la pena comprendere prima di sceglierne uno.
La maggior parte del lavoro sui portafogli avviene nei crate Rust di librustzcash, sui quali si basano gli SDK mobili e diversi portafogli desktop. Ogni crate è documentato su docs.rs.
| Crate | A cosa serve |
|---|---|
| zcash_client_backend | "API per creare client leggeri schermati per Zcash", inclusa la sincronizzazione e la costruzione delle transazioni |
| zcash_client_sqlite | "Un client leggero per Zcash basato su SQLite", il livello di archiviazione per quanto sopra |
| zcash_keys | "Gestione di chiavi e indirizzi Zcash" |
| zcash_primitives | "Implementazioni Rust delle primitive di Zcash" |
| zcash_protocol | "Costanti di rete e tipi di valore del protocollo Zcash" |
| orchard | "Il protocollo di transazione schermata Orchard" |
| sapling-crypto | "Libreria crittografica per Zcash Sapling" |
| pczt | "Strumenti per lavorare con transazioni di Zcash create parzialmente", usati per la firma hardware e su più dispositivi |
| zip321 | URI di richieste di pagamento, come specificato in ZIP 321 |
Per il mobile, l'SDK Android e l'SDK iOS racchiudono tali librerie. Il repository iOS si chiamava precedentemente ZcashLightClientKit, pertanto i link e gli articoli più vecchi usano quel nome.
La specifica del protocollo è l'autorità sul funzionamento di Zcash, incluse le codifiche di indirizzi e chiavi.
Gli ZIP sono il luogo in cui vengono proposte e specificate le modifiche, e l'indice mostra quali sono bozze e quali definitivi. Le modifiche al consenso vengono distribuite negli aggiornamenti di rete e ZecHub li traccia nella pagina Aggiornamenti di rete.
Per la crittografia sottostante, leggi The halo2 Book e The Orchard Book, insieme alla documentazione dei crate halo2 e orchard. The FROST Book tratta le firme a soglia e ZecHub dispone di una pagina FROST.
Testnet è una chain separata con monete prive di valore, chiamate TAZ. Sia Zebra sia Zakura possono essere eseguiti su di essa e la guida a testnet tratta la configurazione dei nodi.
testnet.zcashexplorer.app è un block explorer testnet funzionante, con una controparte mainnet su mainnet.zcashexplorer.app.
Ottenere TAZ è la parte più complicata, perché i faucet collegati dalla documentazione più vecchia hanno smesso di rispondere. zcashfaucet.jinolabs.xyz è un faucet gestito dalla comunità che esegue "il proprio nodo, portafoglio e miner", paga "piccole erogazioni z2z schermate" e limita le richieste con una "prova di lavoro del browser anziché un fornitore di captcha". È open source sotto licenza MIT. Se non è disponibile, chiedi nel Discord Zcash R&D, come suggerisce la stessa documentazione di Zcash.
La Documentazione Zcash è ancora la fonte unica più ampia e tratta concetti del protocollo, integrazione e mining. Leggila con una certa attenzione. È versionata rispetto a zcashd, perciò alcune sue parti descrivono un nodo che non è più in esecuzione, mentre le sezioni sul protocollo e sui light client restano utili. Vale la pena leggere il modello di minaccia dell'app portafoglio di Zcash disponibile lì prima di progettare qualunque cosa riguardi la privacy degli utenti.
Se sei nuovo alle blockchain in generale, Mastering Bitcoin è la raccomandazione abituale per i fondamenti condivisi ed è leggibile gratuitamente per intero. Non tratta le transazioni schermate.
Arti è l'implementazione Rust di Tor, usata da zcash_client_backend per instradare il traffico dei portafogli. Tailscale viene menzionato per connettersi a un nodo eseguito in proprio. warp2 è un'implementazione di sincronizzazione veloce di Hanh, sebbene non sia stata aggiornata dal 2023.
Il Discord Zcash R&D è il luogo in cui si discutono lo sviluppo del protocollo e dei portafogli, mentre il Forum della comunità di Zcash ospita proposte più dettagliate e discussioni di supporto.
I risultati dei recenti hackathon offrono un buon quadro di ciò che le persone stanno costruendo: ZecHub 2024, ZecHub 2025 e lo Zypherpunk Hackathon 2025.
Conservate perché gli articoli più vecchi vi rimandano e perché rimangono il riferimento per il comportamento del nodo ritirato. Non iniziare da qui.
The zcashd Book e il riferimento RPC di zcashd documentano software che ha raggiunto la fine del ciclo di vita nel luglio 2026. Il repository zcash/zcash è archiviato.
Se hai una risorsa da aggiungere, o individui qualcosa qui che non è più aggiornato, apri una issue o una pull request. I team non sempre hanno la capacità di mantenere tutto aggiornato e segnalare ciò che hai incontrato aiuta a orientare le guide.
Ultimo aggiornamento: agosto 2026
