Rewards-programma

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.

DirectMerkle
WerkingMaakt per ontvanger een onchain account aanSlaat één enkele merkle root onchain op; ontvangers leveren bewijzen aan om te claimen
Kosten voorafDe betaler financiert de rent voor elk ontvangeraccountGeen accounts per ontvanger totdat iemand claimt
SchaalPraktisch tot enkele duizenden ontvangersSchaalt naar miljoenen ontvangers; opslag groeit alleen naarmate ontvangers claimen
WijzigbaarheidOntvangers kunnen na het aanmaken worden toegevoegdDe groep ontvangers ligt vast bij het aanmaken
Geschikt voorKleine distributies die in de loop van de tijd veranderenGrote, vaste distributies zoals airdrops

Vestingschema's

Elke toewijzing heeft een van de vier schema's. Tijdstempels zijn Unix-seconden.

SchemaGedrag
ImmediateAlle tokens zijn direct claimbaar
LinearTokens komen proportioneel vrij tussen startTs en endTs
CliffEr komt niets vrij tot cliffTs, daarna komt alles in één keer vrij
CliffLinearLineaire vesting van startTs tot endTs, waarbij niets claimbaar is tot cliffTs; eerder opgebouwde tokens komen vrij bij de cliff

Accounts

AccountPDA seedsBevat
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

  1. De authority roept CreateDirectDistribution aan om de distributie-PDA en de bijbehorende vault aan te maken.
  2. De authority roept AddDirectRecipient aan, éé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.
  3. Ontvangers roepen ClaimDirect aan om geveste tokens op te nemen. Geef amount: 0 mee om alles te claimen wat op dat moment gevest is.
  4. Zodra een ontvanger alles heeft geclaimd, of de distributie is gesloten, sluit CloseDirectRecipient het ontvangeraccount en stort de rent terug aan het account dat ervoor heeft betaald.
  5. De authority roept CloseDirectDistribution aan om het resterende saldo van de vault en de rent terug te halen. Als clawbackTs is ingesteld, is sluiten pas toegestaan na dat tijdstip.

Merkle-distributie

  1. De authority bouwt offchain een merkle tree. Elk blad (leaf) bevat een claimer, het totaalbedrag van die claimer en een vestingschema.
  2. De authority roept CreateMerkleDistribution aan met de root, het totale claimbare bedrag en een clawbackTs, en vult de vault in dezelfde instructie.
  3. Claimers roepen ClaimMerkle aan met hun leaf-gegevens en bewijs. De eerste claim maakt het MerkleClaim-account van de claimer aan. Geef amount: 0 mee om alles te claimen wat op dat moment gevest is.
  4. Na clawbackTs roept de authority CloseMerkleDistribution aan om het resterende saldo van de vault en de rent terug te halen.
  5. Nadat de distributie is gesloten, roepen claimers CloseMerkleClaim aan 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.

ModusInstructieResultaat
NonVestedRevokeDirectRecipient of RevokeMerkleClaimGeveste, niet-geclaimde tokens gaan naar de gebruiker; niet-geveste tokens gaan terug naar de authority
FullRevokeDirectRecipient of RevokeMerkleClaimAlle 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

Is this page helpful?

Inhoudsopgave

Pagina Bewerken
© 2026 Solana Foundation. Alle rechten voorbehouden.