Οδηγός γρήγορης αναφοράς Zallet
Με λίγα λόγια
- Το Zallet είναι ένα θωρακισμένο πορτοφόλι πλήρους κόμβου Zcash, γραμμένο σε Rust. Αντικαθιστά το πορτοφόλι που βρισκόταν παλαιότερα μέσα στο zcashd.
- Το zcashd έφτασε τη διακοπή End-of-Support στις 18 Ιουλίου 2026 και δεν εκτελείται πλέον. Το Zebra διαχειρίζεται πλέον την πλευρά του κόμβου· το Zallet διαχειρίζεται την πλευρά του πορτοφολιού.
- Χειρίζεσαι το Zallet από τη γραμμή εντολών με το
zallet rpc <command>, όπως χρησιμοποιούσες παλαιότερα το zcash-cli.
- Κάθε όρισμα μετά το όνομα της εντολής πρέπει να είναι έγκυρο JSON, πράγμα που σημαίνει ότι οι τιμές συμβολοσειρών διατηρούν τα διπλά εισαγωγικά τους.
- Το Zallet βρίσκεται σε beta. Οι εντολές μπορούν να αλλάζουν μεταξύ εκδόσεων και δεν έχει μεταφερθεί ακόμη κάθε RPC του zcashd.
Βασική επεξήγηση
Το Zallet εκθέτει τη λειτουργικότητά του μέσω JSON-RPC, το ίδιο στυλ διεπαφής που χρησιμοποιούσε το πορτοφόλι zcashd. Οτιδήποτε θέλεις να κάνει το πορτοφόλι — να ελέγξει ένα υπόλοιπο, να δημιουργήσει έναν λογαριασμό, να στείλει μια θωρακισμένη πληρωμή — είναι μια εντολή που δίνεις στο zallet rpc.
Δύο πράγματα διαφέρουν από την παλιά συνήθεια του zcash-cli και ευθύνονται για τα περισσότερα πρώιμα λάθη. Πρώτον, τα ορίσματα πρέπει να είναι έγκυρο JSON αντί για απλό κείμενο, επομένως ένα όρισμα συμβολοσειράς φέρει τα δικά του εισαγωγικά μέσα στα εισαγωγικά του shell. Δεύτερον, το σύνολο των διαθέσιμων εντολών εξαρτάται από την έκδοση beta που εκτελείς, επομένως η λίστα που είναι ενσωματωμένη στο binary σου είναι πιο αξιόπιστη από οποιαδήποτε γραπτή σελίδα, συμπεριλαμβανομένης αυτής.
Για να εμφανίσεις όλα τα διαθέσιμα RPC:
Code-highlight
zallet rpc help
Για να λάβεις λεπτομερή βοήθεια για ένα συγκεκριμένο RPC:
Code-highlight
zallet rpc help '"<command>"'
Σημαντικό: Κάθε όρισμα μετά το όνομα της μεθόδου πρέπει να είναι έγκυρο JSON.
Οι τιμές συμβολοσειρών πρέπει να γράφονται ως "value" (συμπεριλαμβανομένων των διπλών εισαγωγικών).
Συνηθισμένα λάθη
- Παράλειψη των εσωτερικών εισαγωγικών στα ορίσματα συμβολοσειρών. Το
zallet rpc validateaddress u1abc... αποτυγχάνει, επειδή η διεύθυνση πρέπει να φτάσει ως JSON. Πρέπει να γραφτεί ως '"u1abc..."'.
- Υπόθεση ότι κάθε RPC υπάρχει εδώ. Η μεταφορά βρίσκεται ακόμη σε εξέλιξη. Ορισμένες μέθοδοι συμπεριφέρονται πανομοιότυπα, ορισμένες χρειάζονται διαφορετική χρήση και ορισμένες δεν θα μεταφερθούν καθόλου.
- Αντιμετώπιση αυτής της σελίδας ως πιο έγκυρης από το binary σου. Το Zallet βρίσκεται σε beta και αλλάζει γρήγορα. Όταν μια εντολή εδώ δεν λειτουργεί, έλεγξε το
zallet rpc help προτού υποθέσεις ότι κάτι έχει χαλάσει.
- Αναμονή ότι το Zallet είναι κόμβος. Είναι το μισό του πορτοφολιού στο ζεύγος. Το Zebra εκτελεί τον κόμβο και το Zallet επικοινωνεί μαζί του.
Εντολές RPC
decoderawtransaction
Code-highlight
zallet rpc decoderawtransaction '"<hexstring>"'
| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
|---|
| hexstring | string | ναι | Δεκαεξαδική συμβολοσειρά συναλλαγής |
decodescript
Code-highlight
zallet rpc decodescript '"<hexstring>"'
| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
|---|
| hexstring | string | ναι | Δεκαεξαδικό script |
getrawtransaction
Code-highlight
zallet rpc getrawtransaction '"<txid>"' [verbose] ['"<blockhash>"']
| Παράμετρος | Τύπος | Απαιτείται | Προεπιλογή | Περιγραφή |
|---|
| txid | string | ναι | | Αναγνωριστικό συναλλαγής |
| verbose | number | όχι | 0 | 0 = hex, μη μηδενικό = αντικείμενο JSON |
| blockhash | string | όχι | | Περιορισμός αναζήτησης σε αυτό το μπλοκ |
getwalletinfo
Code-highlight
zallet rpc getwalletinfo
Χωρίς παραμέτρους.
getwalletstatus
Code-highlight
zallet rpc getwalletstatus
Χωρίς παραμέτρους.
listaddresses
Code-highlight
zallet rpc listaddresses
Χωρίς παραμέτρους.
rpc.discover
Code-highlight
zallet rpc rpc.discover
Χωρίς παραμέτρους. Επιστρέφει το σχήμα OpenRPC.
stop
Code-highlight
zallet rpc stop
Χωρίς παραμέτρους. (Μόνο Regtest)
validateaddress
Code-highlight
zallet rpc validateaddress '"<address>"'
| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
|---|
| address | string | ναι | Διαφανής διεύθυνση |
verifymessage
Code-highlight
zallet rpc verifymessage '"<address>"' '"<signature>"' '"<message>"'
| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
|---|
| address | string | ναι | Διαφανής διεύθυνση |
| signature | string | ναι | Υπογραφή Base64 |
| message | string | ναι | Αρχικό μήνυμα |
walletlock
Code-highlight
zallet rpc walletlock
Χωρίς παραμέτρους.
walletpassphrase
Code-highlight
zallet rpc walletpassphrase '"<passphrase>"' <timeout>
| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
|---|
| passphrase | string | ναι | Φράση πρόσβασης πορτοφολιού |
| timeout | number | ναι | Δευτερόλεπτα διατήρησης του πορτοφολιού ξεκλείδωτου |
z_converttex
Code-highlight
zallet rpc z_converttex '"<transparent_address>"'
| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
|---|
| transparent_address | string | ναι | Διεύθυνση P2PKH προς μετατροπή |
z_exportkey
Code-highlight
zallet rpc z_exportkey '"<sapling_address>"'
| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
|---|
| address | string | ναι | Διεύθυνση Sapling της οποίας θα εξαχθεί το spending key |
Το πορτοφόλι πρέπει να είναι ξεκλείδωτο. Εξάγει μόνο το spending key του Sapling.
z_getaccount
Code-highlight
zallet rpc z_getaccount '"<account_uuid>"'
| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
|---|
| account_uuid | string | ναι | UUID λογαριασμού |
z_getaddressforaccount
Code-highlight
zallet rpc z_getaddressforaccount <account> ['["p2pkh","sapling","orchard"]'] [<diversifier_index>]
| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
|---|
| account | string / number | ναι | UUID λογαριασμού ή δείκτης λογαριασμού ZIP-32 |
| receiver_types | array of string | όχι | Τύποι δεκτών προς συμπερίληψη |
| diversifier_index | number | όχι | Συγκεκριμένος δείκτης diversifier |
z_getbalanceforaccount
Code-highlight
zallet rpc z_getbalanceforaccount <account> [<minconf>]
| Παράμετρος | Τύπος | Απαιτείται | Προεπιλογή | Περιγραφή |
|---|
| account | string / number | ναι | | UUID λογαριασμού ή δείκτης ZIP-32 |
| minconf | number | όχι | 1 | Ελάχιστες επιβεβαιώσεις |
z_getbalances
Code-highlight
zallet rpc z_getbalances [<minconf>]
| Παράμετρος | Τύπος | Απαιτείται | Προεπιλογή | Περιγραφή |
|---|
| minconf | number | όχι | 1 | Ελάχιστες επιβεβαιώσεις |
z_getnewaccount
Code-highlight
zallet rpc z_getnewaccount '"<account_name>"' ['"<seedfp>"']
| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
|---|
| account_name | string | ναι | Όνομα αναγνώσιμο από άνθρωπο |
| seedfp | string | όχι | Απαιτείται αν το πορτοφόλι έχει πολλαπλά seeds |
z_getnotescount
Code-highlight
zallet rpc z_getnotescount [<minconf>] [<as_of_height>]
| Παράμετρος | Τύπος | Απαιτείται | Προεπιλογή | Περιγραφή |
|---|
| minconf | number | όχι | 1 | Ελάχιστες επιβεβαιώσεις |
| as_of_height | number | όχι | | Ερώτημα στο συγκεκριμένο ύψος (-1 = κορυφή) |
z_getoperationresult
Code-highlight
zallet rpc z_getoperationresult ['["opid1","opid2"]']
| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
|---|
| operationid | array of string | όχι | Αναγνωριστικά λειτουργίας (παράλειψέ το για όλες τις ολοκληρωμένες) |
z_getoperationstatus
Code-highlight
zallet rpc z_getoperationstatus ['["opid1","opid2"]']
| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
|---|
| operationid | array of string | όχι | Αναγνωριστικά λειτουργίας (παράλειψέ το για όλες) |
z_gettotalbalance
Code-highlight
zallet rpc z_gettotalbalance [<minconf>] [<include_watchonly>]
| Παράμετρος | Τύπος | Απαιτείται | Προεπιλογή | Περιγραφή |
|---|
| minconf | number | όχι | 1 | Ελάχιστες επιβεβαιώσεις |
| include_watchonly | boolean | όχι | false | Συμπερίληψη υπολοίπων μόνο για παρακολούθηση |
z_importaddress
Code-highlight
zallet rpc z_importaddress '"<account_uuid>"' '"<hex_data>"' [<rescan>]
| Παράμετρος | Τύπος | Απαιτείται | Προεπιλογή | Περιγραφή |
|---|
| account | string | ναι | | UUID λογαριασμού |
| hex_data | string | ναι | | Δημόσιο κλειδί hex ή redeem script |
| rescan | boolean | όχι | true | Επανασάρωση μετά την εισαγωγή |
z_importkey
Code-highlight
zallet rpc z_importkey '"<key>"' ['"<rescan>"'] [<start_height>]
| Παράμετρος | Τύπος | Απαιτείται | Προεπιλογή | Περιγραφή |
|---|
| key | string | ναι | | Εκτεταμένο spending key Sapling |
| rescan | string | όχι | "whenkeyisnew" | "yes", "no" ή "whenkeyisnew" |
| start_height | number | όχι | 0 | Αρχικό ύψος επανασάρωσης |
z_listaccounts
Code-highlight
zallet rpc z_listaccounts [<include_addresses>]
| Παράμετρος | Τύπος | Απαιτείται | Προεπιλογή | Περιγραφή |
|---|
| include_addresses | boolean | όχι | true | Επιστροφή και διευθύνσεων για κάθε λογαριασμό |
z_listoperationids
Code-highlight
zallet rpc z_listoperationids ['"<status>"']
| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
|---|
| status | string | όχι | Φιλτράρισμα κατά κατάσταση (π.χ. "success") |
z_listtransactions
Code-highlight
zallet rpc z_listtransactions ['"<account_uuid>"'] [<start_height>] [<end_height>] [<offset>] [<limit>]
| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
|---|
| account_uuid | string | όχι | Περιορισμός σε έναν λογαριασμό |
| start_height | number | όχι | Συμπεριληπτικό κάτω όριο |
| end_height | number | όχι | Αποκλειστικό άνω όριο |
| offset | number | όχι | Παράλειψη τόσων αποτελεσμάτων |
| limit | number | όχι | Μέγιστος αριθμός αποτελεσμάτων προς επιστροφή |
z_listunifiedreceivers
Code-highlight
zallet rpc z_listunifiedreceivers '"<unified_address>"'
| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
|---|
| unified_address | string | ναι | Ενοποιημένη διεύθυνση προς επιθεώρηση |
z_listunspent
Code-highlight
zallet rpc z_listunspent [<minconf>] [<maxconf>] [<include_watchonly>] ['["addr1","addr2"]'] [<as_of_height>]
| Παράμετρος | Τύπος | Απαιτείται | Προεπιλογή | Περιγραφή |
|---|
| minconf | number | όχι | 1 | Ελάχιστες επιβεβαιώσεις |
| maxconf | number | όχι | ∞ | Μέγιστες επιβεβαιώσεις |
| include_watchonly | boolean | όχι | false | Συμπερίληψη μόνο για παρακολούθηση |
| addresses | array of string | όχι | | Φιλτράρισμα σε αυτές τις διευθύνσεις |
| as_of_height | number | όχι | | Ερώτημα σε αυτό το ύψος |
z_recoveraccounts
Code-highlight
zallet rpc z_recoveraccounts '[{"name":"...","seedfp":"...","zip32_account_index":0,"birthday_height":123456}]'
| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
|---|
| accounts | array | ναι | Πίνακας αντικειμένων: name, seedfp, zip32_account_index, birthday_height |
z_sendmany
Code-highlight
zallet rpc z_sendmany '"<fromaddress>"' '[{"address":"...","amount":1.23,"memo":"..."}]' [<minconf>] [null] ['"<privacy_policy>"']
| Παράμετρος | Τύπος | Απαιτείται | Προεπιλογή | Περιγραφή |
|---|
| fromaddress | string | ναι | | Διεύθυνση προέλευσης ή "ANY_TADDR" |
| amounts | array of object | ναι | | Παραλήπτες (address, amount, προαιρετικό memo) |
| minconf | number | όχι | | Ελάχιστες επιβεβαιώσεις |
| fee | null | όχι | | Πρέπει να είναι null (μόνο ZIP-317) |
| privacy_policy | string | όχι | "FullPrivacy" | Συμβολοσειρά πολιτικής ιδιωτικότητας |
z_shieldcoinbase
Code-highlight
zallet rpc z_shieldcoinbase '"<fromaddress_or_account_uuid>"' '"<toaddress>"' [null] [<limit>] ['"<memo_hex>"'] ['"<privacy_policy>"']
| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
|---|
| fromaddress | string | ναι | Διαφανής διεύθυνση ή UUID λογαριασμού |
| toaddress | string | ναι | Θωρακισμένος προορισμός |
| fee | null | όχι | Πρέπει να είναι null |
| limit | number | όχι | Μέγιστος αριθμός UTXO coinbase προς θωράκιση |
| memo | string | όχι | Σημείωμα κωδικοποιημένο σε hex |
| privacy_policy | string | όχι | AllowRevealedSenders ή AllowLinkingAccountAddresses |
z_viewtransaction
Code-highlight
zallet rpc z_viewtransaction '"<txid>"'
| Παράμετρος | Τύπος | Απαιτείται | Περιγραφή |
|---|
| txid | string | ναι | Αναγνωριστικό συναλλαγής |
Σχετικές σελίδες