Πρόγραμμα Ανταμοιβών

Το πρόγραμμα Ανταμοιβών διανέμει 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 και τους ίδιους τρόπους ανάκλησης.

DirectMerkle
Πώς λειτουργείΔημιουργεί έναν 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 διανομή

  1. Η αρχή καλεί το CreateDirectDistribution για να δημιουργήσει το PDA της διανομής και το vault της.
  2. Η αρχή καλεί το AddDirectRecipient μία φορά για κάθε παραλήπτη, με ένα ποσό και ένα πρόγραμμα vesting. Κάθε κλήση μεταφέρει αυτό το ποσό από το token account της αρχής στο vault.
  3. Οι παραλήπτες καλούν το ClaimDirect για να αποσύρουν τα κατοχυρωμένα tokens. Περάστε amount: 0 για να διεκδικήσετε όλα όσα είναι αυτή τη στιγμή κατοχυρωμένα.
  4. Όταν ένας παραλήπτης έχει διεκδικήσει τα πάντα, ή η διανομή έχει κλείσει, το CloseDirectRecipient κλείνει τον λογαριασμό του παραλήπτη και επιστρέφει το rent στον λογαριασμό που το κατέβαλε.
  5. Η αρχή καλεί το CloseDirectDistribution για να ανακτήσει το υπόλοιπο του vault και το rent. Αν έχει οριστεί το clawbackTs, το κλείσιμο επιτρέπεται μόνο μετά από αυτή τη χρονική στιγμή.

Merkle διανομή

  1. Η αρχή δημιουργεί ένα merkle tree offchain. Κάθε φύλλο (leaf) δεσμεύεται σε έναν διεκδικητή, το συνολικό ποσό του διεκδικητή και ένα πρόγραμμα vesting.
  2. Η αρχή καλεί το CreateMerkleDistribution με το root, το συνολικό διεκδικήσιμο ποσό και ένα clawbackTs, και χρηματοδοτεί το vault στην ίδια εντολή.
  3. Οι διεκδικητές καλούν το ClaimMerkle με τα δεδομένα του φύλλου τους και την απόδειξη (proof). Η πρώτη διεκδίκηση δημιουργεί τον λογαριασμό MerkleClaim του διεκδικητή. Περάστε amount: 0 για να διεκδικήσετε όλα όσα είναι αυτή τη στιγμή κατοχυρωμένα.
  4. Μετά το clawbackTs, η αρχή καλεί το CloseMerkleDistribution για να ανακτήσει το υπόλοιπο του vault και το rent.
  5. Αφού κλείσει η διανομή, οι διεκδικητές καλούν το 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 απενεργοποιεί την ανάκληση.

ΤρόποςΕντολήΑποτέλεσμα
NonVestedRevokeDirectRecipient ή RevokeMerkleClaimΤα κατοχυρωμένα, αδιεκδίκητα tokens πηγαίνουν στον χρήστη· τα μη κατοχυρωμένα tokens επιστρέφουν στην αρχή
FullRevokeDirectRecipient ή RevokeMerkleClaimΌλα τα αδιεκδίκητα tokens, κατοχυρωμένα και μη, επιστρέφουν στην αρχή

Η ανάκληση ενός διεκδικητή merkle δημιουργεί έναν δείκτη Revocation που αποκλείει μελλοντικές διεκδικήσεις, ακόμη κι αν δεν έχει διεκδικήσει ποτέ. Η ανάκληση ενός direct παραλήπτη κλείνει τον λογαριασμό του DirectRecipient και επιστρέφει το rent του.

Clients

Το αποθετήριο περιλαμβάνει clients @solana/kit και Rust, που δημιουργούνται από το IDL του προγράμματος με το Codama, στο clients/. Ο client δεν έχει δημοσιευτεί ακόμη στο npm. Χτίστε τον από τον πηγαίο κώδικα με just generate-clients.

Πόροι

Is this page helpful?

Πίνακας Περιεχομένων

Επεξεργασία Σελίδας
© 2026 Ίδρυμα Solana. Με επιφύλαξη παντός δικαιώματος.