Chương trình Rewards phân phối token từ một vault do chương trình sở hữu đến một nhóm người nhận, mỗi người theo một lịch vesting riêng. Một authority nạp token vào vault và xác định ai nhận bao nhiêu. Người nhận claim số token đã vest theo thời gian, và authority có thể thu hồi quyền của người nhận hoặc lấy lại số token còn dư khi cấu hình phân phối cho phép. Chương trình được xây dựng bằng Pinocchio, do Solana Foundation duy trì, và hoạt động với cả mint SPL Token lẫn Token-2022, ngoại trừ các mint Token-2022 có extension transfer hook.
Program ID (mainnet và devnet):
REWArDioXgQJ2fZKkfu9LCLjQfRwYWVVfsvcsR5hoXi
Chương trình đã được OtterSec kiểm toán. Xem AUDIT_STATUS.md để biết commit đã được kiểm toán.
Chọn loại phân phối
Chương trình hỗ trợ hai loại phân phối. Cả hai dùng chung lịch vesting và các chế độ thu hồi.
| Direct | Merkle | |
|---|---|---|
| Cách hoạt động | Tạo một tài khoản onchain cho mỗi người nhận | Lưu một merkle root duy nhất onchain; người nhận cung cấp proof để claim |
| Chi phí ban đầu | Bên trả phí chi trả rent cho mọi tài khoản người nhận | Không có tài khoản riêng cho từng người nhận cho đến khi có người claim |
| Quy mô | Phù hợp thực tế với tối đa vài nghìn người nhận | Mở rộng đến hàng triệu người nhận; dung lượng lưu trữ chỉ tăng khi người nhận claim |
| Khả năng thay đổi | Có thể thêm người nhận sau khi tạo | Danh sách người nhận được cố định khi tạo |
| Dùng cho | Các đợt phân phối nhỏ thay đổi theo thời gian | Các đợt phân phối lớn, cố định như airdrop |
Lịch vesting
Mỗi phần phân bổ áp dụng một trong bốn lịch. Timestamp tính theo giây Unix.
| Lịch | Hành vi |
|---|---|
Immediate | Toàn bộ token có thể claim ngay lập tức |
Linear | Token được mở khóa theo tỷ lệ giữa startTs và endTs |
Cliff | Không có gì được mở khóa cho đến cliffTs, sau đó toàn bộ được mở khóa cùng một lúc |
CliffLinear | Vesting tuyến tính từ startTs đến endTs, không thể claim gì cho đến cliffTs; phần tích lũy trước đó được mở khóa tại cliff |
Tài khoản
| Tài khoản | PDA seeds | Lưu trữ |
|---|---|---|
DirectDistribution | ["direct_distribution", mint, authority, seed] | Authority, mint và tổng số phân bổ |
DirectRecipient | ["direct_recipient", distribution, recipient] | Phần phân bổ và vesting của một người nhận |
MerkleDistribution | ["merkle_distribution", mint, authority, seed] | Authority, mint, tổng số và merkle root |
MerkleClaim | ["merkle_claim", distribution, claimant] | Số lượng một claimant đã claim cho đến nay |
Revocation | ["revocation", distribution, user] | Marker chặn một claimant merkle đã bị thu hồi |
seed là địa chỉ của một signer bổ sung được truyền vào khi tạo, để một
authority có thể chạy nhiều đợt phân phối cho cùng một mint. Vault của mỗi đợt phân phối
là associated token account của PDA phân phối tương ứng với mint của nó.
Các instruction
Phân phối Direct
- Authority gọi
CreateDirectDistributionđể tạo PDA phân phối và vault của nó. - Authority gọi
AddDirectRecipientmột lần cho mỗi người nhận, kèm số lượng và lịch vesting. Mỗi lần gọi chuyển số lượng đó từ token account của authority vào vault. - Người nhận gọi
ClaimDirectđể rút số token đã vest. Truyềnamount: 0để claim toàn bộ số token hiện đã vest. - Khi người nhận đã claim hết, hoặc đợt phân phối đã đóng,
CloseDirectRecipientđóng tài khoản người nhận và hoàn lại rent cho tài khoản đã trả khoản đó. - Authority gọi
CloseDirectDistributionđể thu hồi số dư vault còn lại và rent. Nếu đặtclawbackTs, chỉ được đóng sau thời điểm đó.
Phân phối Merkle
- Authority xây dựng một cây merkle offchain. Mỗi leaf cam kết một claimant, tổng số lượng của claimant đó và một lịch vesting.
- Authority gọi
CreateMerkleDistributionvới root, tổng số lượng có thể claim vàclawbackTs, đồng thời nạp token vào vault trong cùng một instruction. - Claimant gọi
ClaimMerklekèm dữ liệu leaf và proof của mình. Lần claim đầu tiên tạo tài khoảnMerkleClaimcủa claimant. Truyềnamount: 0để claim toàn bộ số token hiện đã vest. - Sau
clawbackTs, authority gọiCloseMerkleDistributionđể thu hồi số dư vault còn lại và rent. - Sau khi đợt phân phối đóng, claimant gọi
CloseMerkleClaimđể thu hồi rent của tài khoản claim của mình.
Chương trình băm các leaf bằng Keccak-256 theo công thức
keccak256(0x00 || keccak256(claimant || totalAmount || schedule)), trong đó
totalAmount là u64 little-endian và schedule dùng cùng cách mã hóa với
đối số VestingSchedule của instruction. Các proof node được băm theo
từng cặp đã sắp xếp, hash nhỏ hơn đứng trước.
Thu hồi
Thu hồi là tùy chọn chủ động bật. Bitmask revocable được đặt khi tạo quyết định authority
được dùng chế độ nào: bit 0 bật NonVested, bit 1 bật Full,
và 0 tắt tính năng thu hồi.
| Chế độ | Instruction | Kết quả |
|---|---|---|
NonVested | RevokeDirectRecipient hoặc RevokeMerkleClaim | Token đã vest nhưng chưa claim được chuyển cho người dùng; token chưa vest được trả về authority |
Full | RevokeDirectRecipient hoặc RevokeMerkleClaim | Toàn bộ token chưa claim, cả đã vest lẫn chưa vest, được trả về authority |
Thu hồi một claimant merkle sẽ tạo một marker Revocation chặn các lần
claim sau này, kể cả khi họ chưa từng claim. Thu hồi một người nhận direct sẽ đóng
tài khoản DirectRecipient của họ và hoàn lại rent của tài khoản đó.
Client
Repository bao gồm các client @solana/kit và
Rust được tạo từ IDL của chương trình bằng Codama, trong
clients/.
Client này chưa được xuất bản lên npm. Hãy build từ mã nguồn bằng
just generate-clients.
Tài nguyên
- Mã nguồn
- Báo cáo kiểm toán của OtterSec
- Báo cáo sự cố
- Solana StackExchange, thẻ
rewards-program
Is this page helpful?