Het Rewards-programma distribueert tokens vanuit een vault die eigendom is van het programma aan een groep ontvangers, elk met een eigen vestingschema. Een authority vult de vault en bepaalt wie wat ontvangt. Ontvangers claimen hun geveste tokens in de loop van de tijd, en de authority kan ontvangers intrekken of overgebleven tokens terugvorderen wanneer de distributie dat toestaat. Het programma is gebouwd met Pinocchio, wordt onderhouden door de Solana Foundation en werkt met zowel SPL Token- als Token-2022-mints, behalve Token-2022-mints met de transfer hook-extensie.
Program-ID (mainnet en devnet):
REWArDioXgQJ2fZKkfu9LCLjQfRwYWVVfsvcsR5hoXi
Het programma is geaudit door OtterSec. Zie AUDIT_STATUS.md voor de commit waarop de audit betrekking heeft.
Kies een distributietype
Het programma ondersteunt twee distributietypen. Beide gebruiken dezelfde vestingschema's en intrekkingsmodi.
| Direct | Merkle | |
|---|---|---|
| Werking | Maakt per ontvanger een onchain account aan | Slaat één enkele merkle root onchain op; ontvangers leveren bewijzen aan om te claimen |
| Kosten vooraf | De betaler financiert de rent voor elk ontvangeraccount | Geen accounts per ontvanger totdat iemand claimt |
| Schaal | Praktisch tot enkele duizenden ontvangers | Schaalt naar miljoenen ontvangers; opslag groeit alleen naarmate ontvangers claimen |
| Wijzigbaarheid | Ontvangers kunnen na het aanmaken worden toegevoegd | De groep ontvangers ligt vast bij het aanmaken |
| Geschikt voor | Kleine distributies die in de loop van de tijd veranderen | Grote, vaste distributies zoals airdrops |
Vestingschema's
Elke toewijzing heeft een van de vier schema's. Tijdstempels zijn Unix-seconden.
| Schema | Gedrag |
|---|---|
Immediate | Alle tokens zijn direct claimbaar |
Linear | Tokens komen proportioneel vrij tussen startTs en endTs |
Cliff | Er komt niets vrij tot cliffTs, daarna komt alles in één keer vrij |
CliffLinear | Lineaire vesting van startTs tot endTs, waarbij niets claimbaar is tot cliffTs; eerder opgebouwde tokens komen vrij bij de cliff |
Accounts
| Account | PDA seeds | Bevat |
|---|---|---|
DirectDistribution | ["direct_distribution", mint, authority, seed] | Authority, mint en totalen van toewijzingen |
DirectRecipient | ["direct_recipient", distribution, recipient] | De toewijzing en vesting van één ontvanger |
MerkleDistribution | ["merkle_distribution", mint, authority, seed] | Authority, mint, totalen en de merkle root |
MerkleClaim | ["merkle_claim", distribution, claimant] | Tot nu toe door één claimer geclaimd bedrag |
Revocation | ["revocation", distribution, user] | Markering die een ingetrokken merkle-claimer blokkeert |
De seed is het adres van een extra ondertekenaar die bij het aanmaken wordt
meegegeven, zodat één authority meerdere distributies voor dezelfde mint kan
uitvoeren. De vault van elke distributie is het associated token account van de
distributie-PDA voor de bijbehorende mint.
Instructies
Directe distributie
- De authority roept
CreateDirectDistributionaan om de distributie-PDA en de bijbehorende vault aan te maken. - De authority roept
AddDirectRecipientaan, één keer per ontvanger, met een bedrag en een vestingschema. Elke aanroep draagt dat bedrag over van het token account van de authority naar de vault. - Ontvangers roepen
ClaimDirectaan om geveste tokens op te nemen. Geefamount: 0mee om alles te claimen wat op dat moment gevest is. - Zodra een ontvanger alles heeft geclaimd, of de distributie is gesloten,
sluit
CloseDirectRecipienthet ontvangeraccount en stort de rent terug aan het account dat ervoor heeft betaald. - De authority roept
CloseDirectDistributionaan om het resterende saldo van de vault en de rent terug te halen. AlsclawbackTsis ingesteld, is sluiten pas toegestaan na dat tijdstip.
Merkle-distributie
- De authority bouwt offchain een merkle tree. Elk blad (leaf) bevat een claimer, het totaalbedrag van die claimer en een vestingschema.
- De authority roept
CreateMerkleDistributionaan met de root, het totale claimbare bedrag en eenclawbackTs, en vult de vault in dezelfde instructie. - Claimers roepen
ClaimMerkleaan met hun leaf-gegevens en bewijs. De eerste claim maakt hetMerkleClaim-account van de claimer aan. Geefamount: 0mee om alles te claimen wat op dat moment gevest is. - Na
clawbackTsroept de authorityCloseMerkleDistributionaan om het resterende saldo van de vault en de rent terug te halen. - Nadat de distributie is gesloten, roepen claimers
CloseMerkleClaimaan om de rent voor hun claim-account terug te krijgen.
Het programma hasht leaves met Keccak-256 als
keccak256(0x00 || keccak256(claimant || totalAmount || schedule)), waarbij
totalAmount een little-endian u64 is en schedule dezelfde codering gebruikt als
het VestingSchedule-argument van de instructie. Proof-nodes worden gehasht als gesorteerde
paren, met de kleinste hash eerst.
Intrekking
Intrekking is opt-in. De revocable-bitmask die bij het aanmaken wordt ingesteld, bepaalt welke
modi de authority mag gebruiken: bit 0 schakelt NonVested in, bit 1 schakelt Full in,
en 0 schakelt intrekking uit.
| Modus | Instructie | Resultaat |
|---|---|---|
NonVested | RevokeDirectRecipient of RevokeMerkleClaim | Geveste, niet-geclaimde tokens gaan naar de gebruiker; niet-geveste tokens gaan terug naar de authority |
Full | RevokeDirectRecipient of RevokeMerkleClaim | Alle niet-geclaimde tokens, gevest en niet-gevest, gaan terug naar de authority |
Het intrekken van een merkle-claimer maakt een Revocation-markering aan die toekomstige
claims blokkeert, ook als de claimer nog nooit heeft geclaimd. Het intrekken van een directe ontvanger sluit
diens DirectRecipient-account en stort de rent terug.
Clients
De repository bevat @solana/kit- en
Rust-clients die met Codama zijn gegenereerd op basis van de IDL van het programma, in
clients/.
De client is nog niet gepubliceerd op npm. Bouw hem vanuit de broncode met
just generate-clients.
Bronnen
- Broncode
- OtterSec-auditrapport
- Een probleem melden
- Solana StackExchange, tag
rewards-program
Is this page helpful?