Τεκμηρίωση Διαχειριστών Κόμβων Kora

Τι είναι ένας Διαχειριστής Κόμβου Kora;

Ως διαχειριστής κόμβου Kora, εκτελείτε μια υπηρεσία paymaster που χορηγεί τέλη συναλλαγών Solana για τους χρήστες σας. Ο κόμβος σας δέχεται πληρωμές σε SPL token και χρησιμοποιεί το SOL σας για να πληρώνει τα πραγματικά τέλη δικτύου, επιτρέποντας συναλλαγές χωρίς χρέωση gas για την εφαρμογή σας.

Γιατί να Εκτελέσετε έναν Κόμβο Kora;

Καλύτερη Εμπειρία Χρήστη: Οι χρήστες σας πραγματοποιούν συναλλαγές χωρίς να χρειάζονται SOL (απλοποιημένη ενσωμάτωση, καλύτερη διατήρηση κ.λπ.)
Ροή Εσόδων: Συλλέγετε τέλη σε token που προτιμά η επιχείρησή σας (USDC, BONK κ.λπ.)

Γρήγορη Έναρξη

Θέλετε να δοκιμάσετε πρώτα τοπικά; Εκκινήστε έναν τοπικό κόμβο Kora σε λίγα λεπτά: → Οδηγός Γρήγορης Έναρξης Τοπικά

Βασικές Έννοιες

Ως διαχειριστής κόμβου Kora, είστε υπεύθυνοι για την εκτέλεση μιας ασφαλούς υπηρεσίας paymaster που επιτρέπει συναλλαγές χωρίς χρέωση gas για τους χρήστες σας. Ο κόμβος σας έχει τέσσερις βασικές ευθύνες:

1. Επικύρωση Συναλλαγών

Διαμορφώστε τον κόμβο σας ώστε να δέχεται μόνο συναλλαγές που πληρούν τις επιχειρηματικές σας απαιτήσεις μέσω kora.toml:

Λίστες επιτρεπόμενων token: Ορίστε ποια SPL token δέχεστε ως πληρωμή (υποστηρίζει τόσο SPL όσο και Token-2022)
Λίστες επιτρεπόμενων προγραμμάτων: Προσθέστε σε λευκή λίστα με ποια προγράμματα Solana μπορούν να αλληλεπιδράσουν οι χρήστες
Όρια συναλλαγών: Ορίστε τα μέγιστα τέλη που είστε διατεθειμένοι να πληρώσετε και όρια υπογραφών
Λίστες αποκλεισμού λογαριασμών: Αποτρέψτε αλληλεπιδράσεις με προβληματικές διευθύνσεις
Oracles τιμολόγησης: Διαμορφώστε Jupiter ή προσομοιωμένη τιμολόγηση για υπολογισμούς τελών
Token πληρωμής: Προσδιορίστε ποιον τύπο token θα δέχεστε ως πληρωμή
Πολιτικές feepayer: Ελέγξτε ποιες λειτουργίες μπορεί να εκτελεί ο feepayer σας (μεταφορές, καταστροφές, εγκρίσεις κ.λπ.)
Επεκτάσεις Token-2022: Αποκλείστε συγκεκριμένες επεκτάσεις Token-2022 για ενισχυμένη ασφάλεια
Προσωρινή αποθήκευση: Ενεργοποιήστε την προσωρινή αποθήκευση Redis για να βελτιώσετε την απόδοση μειώνοντας τις κλήσεις RPC
Όρια χρήσης: Ορίστε όρια συναλλαγών ανά πορτοφόλι για να αποτρέψετε την κατάχρηση, να διασφαλίσετε τη δίκαιη χρήση ή να ανταμείψετε τους χρήστες με επιδοτούμενες συναλλαγές έως ένα συγκεκριμένο όριο

→ Πλήρης Αναφορά Διαμόρφωσης Kora.toml → Δείγμα kora.toml

2. Υπογραφή Συναλλαγών

Ο κόμβος σας χρειάζεται ζεύγη κλειδιών (keypairs) Solana για την υπογραφή συναλλαγών ως πληρωτής των τελών. Για παραγωγικές αναπτύξεις, το Kora υποστηρίζει διαμορφώσεις πολλαπλών υπογραφόντων για βελτιωμένη αξιοπιστία και κατανομή κλειδώματος λογαριασμών. Εξετάστε την εφαρμογή εναλλαγής κλειδιών, ελέγχων πρόσβασης, αντιγράφων ασφαλείας και άλλων στρατηγικών για την ασφάλεια των υπογραφόντων. Διαθέσιμες επιλογές υπογραφής:

Τοπικό Ιδιωτικό Κλειδί: Αποθηκεύστε το ιδιωτικό κλειδί απευθείας στο περιβάλλον του διακομιστή (ως base58, αρχείο .json ή πίνακας u8)
Turnkey: Διαχείριση ιδιωτικών κλειδιών με απλότητα. Δημιουργήστε πορτοφόλια, υπογράψτε συναλλαγές και αυτοματοποιήστε ενέργειες στην αλυσίδα.
Privy: Εύκολη υποδομή κρυπτονομισμάτων. Δημιουργήστε με ασφάλεια πορτοφόλια white-label και υπογράψτε συναλλαγές.
HashiCorp Vault: Διαχειριστείτε Μυστικά & Προστατέψτε Ευαίσθητα Δεδομένα

→ Πλήρης Οδηγός Διαμόρφωσης Υπογραφόντων

3. Πληρωμή Τελών Συναλλαγών

Διατηρήστε επαρκή SOL για την κάλυψη των τελών δικτύου για τον αναμενόμενο όγκο συναλλαγών σας:

Παρακολούθηση υπολοίπου: Παρακολουθήστε το υπόλοιπο SOL και ρυθμίστε ειδοποιήσεις χαμηλού υπολοίπου (το Kora παρέχει ενσωματωμένες μετρήσεις Prometheus - δείτε Παρακολούθηση)
Αυτοματισμός: Εφαρμόστε αυτόματες διαδικασίες ανανέωσης SOL για παραγωγικά περιβάλλοντα
Σχεδιασμός χωρητικότητας: Προγραμματίστε για την αναμενόμενη περίπτωση χρήσης, όγκο χρηστών κ.λπ.

Είναι σημαντικό να κατανοήσετε πώς το Kora εκτιμά τα τέλη και πώς να διαμορφώσετε τον κόμβο σας για να μεγιστοποιήσετε τα έσοδά σας. Δείτε τον Οδηγό Εκτίμησης Τελών για περισσότερες λεπτομέρειες.

4. Παρακολούθηση Λειτουργιών

Παρακολουθήστε συνεχώς την ασφάλεια, την απόδοση και τις επιχειρηματικές μετρήσεις του κόμβου σας:

Παρακολούθηση ασφάλειας: Ασυνήθιστα μοτίβα, αποτυχημένες επαληθεύσεις και παραβιάσεις ορίων ρυθμού
Επιχειρησιακές ειδοποιήσεις: Υγεία συστήματος, προειδοποιήσεις υπολοίπου και γεγονότα ασφαλείας
Οικονομική παρακολούθηση: Κόστος SOL έναντι εσόδων από tokens, ανάλυση κερδοφορίας
Παρακολούθηση υπολοίπου υπογραφόντων: Παρακολουθήστε το υπόλοιπο των υπογραφόντων και ρυθμίστε ειδοποιήσεις χαμηλού υπολοίπου

Το Kora παρέχει ένα προαιρετικό τελικό σημείο /metrics που προσφέρει δεδομένα απόδοσης σε πραγματικό χρόνο σε μορφή Prometheus.

→ Οδηγός Αναφοράς Παρακολούθησης Kora

5. Βελτιστοποίηση Απόδοσης (Προαιρετικά)

Για αναπτύξεις με υψηλή κίνηση, ενεργοποιήστε την προσωρινή αποθήκευση Redis για να μειώσετε τις κλήσεις RPC και να βελτιώσετε τους χρόνους απόκρισης:

Προσωρινή αποθήκευση λογαριασμών: Αποθηκεύστε προσωρινά δεδομένα λογαριασμών Solana με ρυθμιζόμενο χρόνο ζωής (TTL)
Αυτόματη εναλλακτική λύση: Επιστρέφει ομαλά σε άμεσες κλήσεις RPC εάν το Redis δεν είναι διαθέσιμο
Διαχείριση προσωρινής μνήμης: Αυτόματη λήξη και δυνατότητες εξαναγκασμένης ανανέωσης για κρίσιμες λειτουργίες

Kora CLI

Το kora-cli crate είναι ένα δυαδικό αρχείο Rust έτοιμο για παραγωγή που παρέχει όλα όσα χρειάζεστε για να εκτελέσετε έναν κόμβο paymaster Kora. Διανέμεται ως αυτόνομο εκτελέσιμο που μπορείτε να εγκαταστήσετε καθολικά ή να αναπτύξετε σε containers.

Επιλογές Εγκατάστασης

Καθολική Εγκατάσταση (συνιστάται για ανάπτυξη)

cargo install kora-cli

Ή δημιουργία από τον πηγαίο κώδικα (συνιστάται για συνεισφορά)

git clone https://github.com/solana-foundation/kora.git
cd kora
just install

Βασική Χρήση

Ο διακομιστής Kora RPC εκθέτει ένα τελικό σημείο JSON-RPC (προεπιλογή: http://localhost:8080). Εκκινήστε τον με την εντολή kora rpc:

# Run with specified kora.toml and signers.toml
kora --config path/to/kora.toml rpc start --signers-config path/to/signers.toml

# Help
kora rpc --help

Για περισσότερες πληροφορίες σχετικά με τη χρήση του Kora CLI, ανατρέξτε στον Οδηγό CLI.

Οι εφαρμογές μπορούν να έχουν πρόσβαση στον Διακομιστή Kora RPC μέσω του Kora TS SDK

Διαμόρφωση

Κάθε κόμβος Kora RPC πρέπει να διαμορφωθεί με τουλάχιστον:

ένα τελικό σημείο Solana RPC (καθορίζεται μέσω της σημαίας --rpc-url ή της μεταβλητής περιβάλλοντος RPC_URL) [προεπιλογή: http://127.0.0.1:8899]
διαμόρφωση υπογραφόντων Solana (καθορίζεται μέσω της σημαίας --signers-config signers.toml)
ένα αρχείο διαμόρφωσης, kora.toml (καθορίζεται μέσω της σημαίας --config path/to/kora.toml)

kora.toml

Πριν από την ανάπτυξη, θα χρειαστεί να δημιουργήσετε και να διαμορφώσετε ένα kora.toml για να καθορίσετε:

Περιορισμό ρυθμού και έλεγχο ταυτότητας
Διεύθυνση προορισμού πληρωμής
Διαθεσιμότητα μεθόδων RPC
Κανόνες επικύρωσης συναλλαγών
Πολιτικές ασφαλείας (λίστα επιτρεπόμενων ή απαγορευμένων για SPL tokens, προγράμματα, λογαριασμούς, επεκτάσεις token κ.λπ.)
Μοντέλα τιμολόγησης προμηθειών
Βελτιωμένες πολιτικές πληρωτή προμηθειών (προστασία έναντι ανεπιθύμητης συμπεριφοράς υπογράφοντος)
Συλλογή μετρήσεων
Διαμόρφωση προσωρινής αποθήκευσης Redis (προαιρετικά)

signers.toml

Θα χρειαστεί επίσης να δημιουργήσετε ένα αρχείο signers.toml για να καθορίσετε:

Υπογράφοντα(ες) για τον κόμβο σας
Στρατηγική επιλογής υπογράφοντος
Τη διαμόρφωση κάθε υπογράφοντος και τα εφαρμόσιμα κλειδιά

Ανάπτυξη σε Railway

Περισσότεροι οδηγοί ενσωμάτωσης σύντομα

Χρειάζεστε Βοήθεια;

Solana Stack Exchange - Κάντε ερωτήσεις/μοιραστείτε γνώσεις (φροντίστε να χρησιμοποιήσετε την ετικέτα kora)
GitHub Issues - Αναφέρετε σφάλματα ή λάβετε βοήθεια
Εκτελέστε kora rpc --help για να δείτε όλες τις διαθέσιμες σημαίες και επιλογές διαμόρφωσης