Program Rewards mendistribusikan token dari vault milik program kepada sekumpulan penerima, masing-masing dengan jadwal vesting. Seorang authority mendanai vault dan menentukan siapa yang menerima berapa. Penerima mengklaim token yang sudah vested seiring waktu, dan authority dapat mencabut penerima atau menarik kembali sisa token ketika distribusi mengizinkannya. Program ini dibangun dengan Pinocchio, dikelola oleh Solana Foundation, dan bekerja dengan mint SPL Token maupun Token-2022, kecuali mint Token-2022 dengan ekstensi transfer hook.
ID program (mainnet dan devnet):
REWArDioXgQJ2fZKkfu9LCLjQfRwYWVVfsvcsR5hoXi
Program ini telah diaudit oleh OtterSec. Lihat AUDIT_STATUS.md untuk commit yang telah diaudit.
Pilih jenis distribusi
Program ini mendukung dua jenis distribusi. Keduanya menggunakan jadwal vesting dan mode pencabutan yang sama.
| Direct | Merkle | |
|---|---|---|
| Cara kerja | Membuat akun onchain untuk setiap penerima | Menyimpan satu merkle root di onchain; penerima memberikan proof untuk mengklaim |
| Biaya di muka | Payer mendanai rent untuk setiap akun penerima | Tidak ada akun per penerima hingga seseorang mengklaim |
| Skala | Praktis hingga beberapa ribu penerima | Dapat diskalakan hingga jutaan penerima; penyimpanan bertambah hanya saat penerima mengklaim |
| Mutabilitas | Penerima dapat ditambahkan setelah pembuatan | Kumpulan penerima ditetapkan saat pembuatan |
| Cocok untuk | Distribusi kecil yang berubah seiring waktu | Distribusi besar dan tetap seperti airdrop |
Jadwal vesting
Setiap alokasi memiliki salah satu dari empat jadwal. Timestamp dalam detik Unix.
| Jadwal | Perilaku |
|---|---|
Immediate | Semua token dapat langsung diklaim |
Linear | Token terbuka secara proporsional antara startTs dan endTs |
Cliff | Tidak ada yang terbuka hingga cliffTs, lalu semuanya terbuka sekaligus |
CliffLinear | Vesting linear dari startTs hingga endTs, tanpa token yang dapat diklaim sampai cliffTs; akumulasi sebelumnya terbuka pada cliff |
Akun
| Akun | Seed PDA | Menyimpan |
|---|---|---|
DirectDistribution | ["direct_distribution", mint, authority, seed] | Authority, mint, dan total alokasi |
DirectRecipient | ["direct_recipient", distribution, recipient] | Alokasi dan vesting satu penerima |
MerkleDistribution | ["merkle_distribution", mint, authority, seed] | Authority, mint, total, dan merkle root |
MerkleClaim | ["merkle_claim", distribution, claimant] | Jumlah yang telah diklaim sejauh ini oleh satu claimant |
Revocation | ["revocation", distribution, user] | Penanda yang memblokir claimant merkle yang dicabut |
seed adalah alamat signer tambahan yang diteruskan saat pembuatan, sehingga satu
authority dapat menjalankan beberapa distribusi untuk mint yang sama. Vault setiap
distribusi adalah associated token account dari PDA distribusi untuk mint tersebut.
Instruksi
Distribusi Direct
- Authority memanggil
CreateDirectDistributionuntuk membuat PDA distribusi dan vault-nya. - Authority memanggil
AddDirectRecipientsatu kali per penerima dengan jumlah dan jadwal vesting. Setiap panggilan mentransfer jumlah tersebut dari token account milik authority ke dalam vault. - Penerima memanggil
ClaimDirectuntuk menarik token yang sudah vested. Berikanamount: 0untuk mengklaim semua yang saat ini sudah vested. - Setelah penerima mengklaim semuanya, atau distribusi ditutup,
CloseDirectRecipientmenutup akun penerima dan mengembalikan rent ke akun yang membayarnya. - Authority memanggil
CloseDirectDistributionuntuk memulihkan sisa saldo vault dan rent. JikaclawbackTsditetapkan, penutupan hanya diizinkan setelah waktu tersebut.
Distribusi Merkle
- Authority membangun merkle tree secara offchain. Setiap leaf berkomitmen pada seorang claimant, total jumlah claimant tersebut, dan jadwal vesting.
- Authority memanggil
CreateMerkleDistributiondengan root, total jumlah yang dapat diklaim, danclawbackTs, serta mendanai vault dalam instruksi yang sama. - Claimant memanggil
ClaimMerkledengan data leaf dan proof mereka. Klaim pertama membuat akunMerkleClaimmilik claimant. Berikanamount: 0untuk mengklaim semua yang saat ini sudah vested. - Setelah
clawbackTs, authority memanggilCloseMerkleDistributionuntuk memulihkan sisa saldo vault dan rent. - Setelah distribusi ditutup, claimant memanggil
CloseMerkleClaimuntuk memulihkan rent akun klaim mereka.
Program melakukan hash pada leaf dengan Keccak-256 sebagai
keccak256(0x00 || keccak256(claimant || totalAmount || schedule)), di mana
totalAmount adalah u64 little-endian dan schedule menggunakan encoding yang sama
dengan argumen VestingSchedule pada instruksi. Node proof di-hash sebagai
pasangan terurut, dengan hash yang lebih kecil lebih dulu.
Pencabutan
Pencabutan bersifat opt-in. Bitmask revocable yang ditetapkan saat pembuatan menentukan
mode mana yang boleh digunakan authority: bit 0 mengaktifkan NonVested, bit 1 mengaktifkan Full,
dan 0 menonaktifkan pencabutan.
| Mode | Instruksi | Hasil |
|---|---|---|
NonVested | RevokeDirectRecipient atau RevokeMerkleClaim | Token yang sudah vested dan belum diklaim diberikan kepada pengguna; token yang belum vested dikembalikan ke authority |
Full | RevokeDirectRecipient atau RevokeMerkleClaim | Semua token yang belum diklaim, baik yang sudah vested maupun belum, dikembalikan ke authority |
Mencabut claimant merkle akan membuat penanda Revocation yang memblokir klaim di
masa depan, bahkan jika mereka belum pernah mengklaim. Mencabut penerima direct akan menutup
akun DirectRecipient mereka dan mengembalikan rent-nya.
Klien
Repositori ini menyertakan klien @solana/kit dan
Rust yang dihasilkan dari IDL program dengan Codama, di
clients/.
Klien ini belum dipublikasikan ke npm. Bangun dari source dengan
just generate-clients.
Sumber Daya
- Kode sumber
- Laporan audit OtterSec
- Laporkan masalah
- Solana StackExchange, tag
rewards-program
Is this page helpful?