Το πρόγραμμα Ανταμοιβών διανέμει tokens από ένα vault που ανήκει στο πρόγραμμα σε ένα σύνολο παραληπτών, ο καθένας με δικό του πρόγραμμα vesting. Μια αρχή χρηματοδοτεί το vault και ορίζει ποιος λαμβάνει τι. Οι παραλήπτες διεκδικούν τα κατοχυρωμένα tokens τους με την πάροδο του χρόνου, και η αρχή μπορεί να ανακαλέσει παραλήπτες ή να ανακτήσει τα εναπομείναντα tokens όταν η διανομή το επιτρέπει. Το πρόγραμμα είναι χτισμένο με το Pinocchio, συντηρείται από το Solana Foundation και λειτουργεί τόσο με mints SPL Token όσο και Token-2022, εκτός από tα mints Token-2022 με την επέκταση transfer hook.
Program ID (mainnet και devnet):
REWArDioXgQJ2fZKkfu9LCLjQfRwYWVVfsvcsR5hoXi
Το πρόγραμμα έχει ελεγχθεί από την OtterSec. Δείτε το AUDIT_STATUS.md για το commit έως το οποίο έχει γίνει έλεγχος.
Επιλέξτε τύπο διανομής
Το πρόγραμμα υποστηρίζει δύο τύπους διανομής. Και οι δύο χρησιμοποιούν τα ίδια προγράμματα vesting και τους ίδιους τρόπους ανάκλησης.
| Direct | Merkle | |
|---|---|---|
| Πώς λειτουργεί | Δημιουργεί έναν onchain λογαριασμό ανά παραλήπτη | Αποθηκεύει ένα μόνο merkle root onchain· οι παραλήπτες παρέχουν αποδείξεις (proofs) για να διεκδικήσουν |
| Αρχικό κόστος | Ο payer χρηματοδοτεί το rent για κάθε λογαριασμό παραλήπτη | Δεν υπάρχουν λογαριασμοί ανά παραλήπτη μέχρι να διεκδικήσει κάποιος |
| Κλίμακα | Πρακτικό έως μερικές χιλιάδες παραλήπτες | Κλιμακώνεται σε εκατομμύρια παραλήπτες· ο αποθηκευτικός χώρος αυξάνεται μόνο όσο διεκδικούν οι παραλήπτες |
| Μεταβλητότητα | Μπορούν να προστεθούν παραλήπτες μετά τη δημιουργία | Το σύνολο των παραληπτών είναι σταθερό από τη δημιουργία |
| Χρήση για | Μικρές διανομές που αλλάζουν με την πάροδο του χρόνου | Μεγάλες, σταθερές διανομές, όπως τα airdrops |
Προγράμματα vesting
Κάθε κατανομή ακολουθεί ένα από τέσσερα προγράμματα. Τα timestamps είναι σε δευτερόλεπτα Unix.
| Πρόγραμμα | Συμπεριφορά |
|---|---|
Immediate | Όλα τα tokens μπορούν να διεκδικηθούν αμέσως |
Linear | Τα tokens αποδεσμεύονται αναλογικά μεταξύ startTs και endTs |
Cliff | Τίποτα δεν αποδεσμεύεται μέχρι το cliffTs, και μετά αποδεσμεύονται όλα μαζί |
CliffLinear | Γραμμικό vesting από το startTs έως το endTs, χωρίς τίποτα διεκδικήσιμο μέχρι το cliffTs· η προηγούμενη συσσώρευση αποδεσμεύεται στο cliff |
Λογαριασμοί
| Λογαριασμός | PDA seeds | Αποθηκεύει |
|---|---|---|
DirectDistribution | ["direct_distribution", mint, authority, seed] | Authority, mint και συνολικά ποσά κατανομής |
DirectRecipient | ["direct_recipient", distribution, recipient] | Η κατανομή και το vesting ενός παραλήπτη |
MerkleDistribution | ["merkle_distribution", mint, authority, seed] | Authority, mint, σύνολα και το merkle root |
MerkleClaim | ["merkle_claim", distribution, claimant] | Το ποσό που έχει διεκδικήσει μέχρι στιγμής ένας διεκδικητής |
Revocation | ["revocation", distribution, user] | Δείκτης που αποκλείει έναν ανακληθέντα διεκδικητή merkle |
Το seed είναι η διεύθυνση ενός επιπλέον signer που περνά κατά τη δημιουργία, ώστε μία
αρχή να μπορεί να διαχειρίζεται πολλές διανομές για το ίδιο mint. Το vault κάθε διανομής
είναι το associated token account του PDA της διανομής για το mint της.
Εντολές
Direct διανομή
- Η αρχή καλεί το
CreateDirectDistributionγια να δημιουργήσει το PDA της διανομής και το vault της. - Η αρχή καλεί το
AddDirectRecipientμία φορά για κάθε παραλήπτη, με ένα ποσό και ένα πρόγραμμα vesting. Κάθε κλήση μεταφέρει αυτό το ποσό από το token account της αρχής στο vault. - Οι παραλήπτες καλούν το
ClaimDirectγια να αποσύρουν τα κατοχυρωμένα tokens. Περάστεamount: 0για να διεκδικήσετε όλα όσα είναι αυτή τη στιγμή κατοχυρωμένα. - Όταν ένας παραλήπτης έχει διεκδικήσει τα πάντα, ή η διανομή έχει κλείσει,
το
CloseDirectRecipientκλείνει τον λογαριασμό του παραλήπτη και επιστρέφει το rent στον λογαριασμό που το κατέβαλε. - Η αρχή καλεί το
CloseDirectDistributionγια να ανακτήσει το υπόλοιπο του vault και το rent. Αν έχει οριστεί τοclawbackTs, το κλείσιμο επιτρέπεται μόνο μετά από αυτή τη χρονική στιγμή.
Merkle διανομή
- Η αρχή δημιουργεί ένα merkle tree offchain. Κάθε φύλλο (leaf) δεσμεύεται σε έναν διεκδικητή, το συνολικό ποσό του διεκδικητή και ένα πρόγραμμα vesting.
- Η αρχή καλεί το
CreateMerkleDistributionμε το root, το συνολικό διεκδικήσιμο ποσό και έναclawbackTs, και χρηματοδοτεί το vault στην ίδια εντολή. - Οι διεκδικητές καλούν το
ClaimMerkleμε τα δεδομένα του φύλλου τους και την απόδειξη (proof). Η πρώτη διεκδίκηση δημιουργεί τον λογαριασμόMerkleClaimτου διεκδικητή. Περάστεamount: 0για να διεκδικήσετε όλα όσα είναι αυτή τη στιγμή κατοχυρωμένα. - Μετά το
clawbackTs, η αρχή καλεί τοCloseMerkleDistributionγια να ανακτήσει το υπόλοιπο του vault και το rent. - Αφού κλείσει η διανομή, οι διεκδικητές καλούν το
CloseMerkleClaimγια να ανακτήσουν το rent του λογαριασμού διεκδίκησής τους.
Το πρόγραμμα κατακερματίζει (hash) τα φύλλα με Keccak-256 ως
keccak256(0x00 || keccak256(claimant || totalAmount || schedule)), όπου
το totalAmount είναι ένας little-endian u64 και το schedule χρησιμοποιεί την ίδια κωδικοποίηση με
το όρισμα VestingSchedule της εντολής. Οι κόμβοι απόδειξης κατακερματίζονται ως ταξινομημένα
ζεύγη, με το μικρότερο hash πρώτο.
Ανάκληση
Η ανάκληση είναι προαιρετική. Η bitmask revocable που ορίζεται κατά τη δημιουργία επιλέγει ποιους
τρόπους μπορεί να χρησιμοποιήσει η αρχή: το bit 0 ενεργοποιεί το NonVested, το bit 1 ενεργοποιεί το Full,
και το 0 απενεργοποιεί την ανάκληση.
| Τρόπος | Εντολή | Αποτέλεσμα |
|---|---|---|
NonVested | RevokeDirectRecipient ή RevokeMerkleClaim | Τα κατοχυρωμένα, αδιεκδίκητα tokens πηγαίνουν στον χρήστη· τα μη κατοχυρωμένα tokens επιστρέφουν στην αρχή |
Full | RevokeDirectRecipient ή RevokeMerkleClaim | Όλα τα αδιεκδίκητα tokens, κατοχυρωμένα και μη, επιστρέφουν στην αρχή |
Η ανάκληση ενός διεκδικητή merkle δημιουργεί έναν δείκτη Revocation που αποκλείει μελλοντικές
διεκδικήσεις, ακόμη κι αν δεν έχει διεκδικήσει ποτέ. Η ανάκληση ενός direct παραλήπτη κλείνει
τον λογαριασμό του DirectRecipient και επιστρέφει το rent του.
Clients
Το αποθετήριο περιλαμβάνει clients @solana/kit και
Rust, που δημιουργούνται από το IDL του προγράμματος με το Codama, στο
clients/.
Ο client δεν έχει δημοσιευτεί ακόμη στο npm. Χτίστε τον από τον πηγαίο κώδικα με
just generate-clients.
Πόροι
- Πηγαίος κώδικας
- Αναφορά ελέγχου OtterSec
- Αναφορά προβλήματος
- Solana StackExchange, ετικέτα
rewards-program
Is this page helpful?