Rewards 프로그램은 프로그램이 소유한 볼트에서 여러 수령자에게 토큰을 배포하며, 각 수령자에게는 베스팅 일정이 적용됩니다. authority가 볼트에 자금을 넣고 누가 얼마를 받을지 정의합니다. 수령자는 시간이 지남에 따라 베스팅된 토큰을 클레임하며, authority는 배포 설정이 허용하는 경우 수령자를 취소하거나 남은 토큰을 회수할 수 있습니다. 이 프로그램은 Solana Foundation이 관리하는 Pinocchio로 작성되었으며, transfer hook 확장이 적용된 Token-2022 민트를 제외한 SPL Token 및 Token-2022 민트 모두에서 작동합니다.
프로그램 ID(메인넷 및 데브넷):
REWArDioXgQJ2fZKkfu9LCLjQfRwYWVVfsvcsR5hoXi
이 프로그램은 OtterSec의 감사를 받았습니다. 감사가 완료된 커밋은 AUDIT_STATUS.md를 참조하세요.
배포 유형 선택
이 프로그램은 두 가지 배포 유형을 지원합니다. 두 유형 모두 동일한 베스팅 일정과 취소 모드를 사용합니다.
| Direct(직접) | Merkle(머클) | |
|---|---|---|
| 작동 방식 | 수령자마다 온체인 계정을 생성합니다 | 머클 루트 하나만 온체인에 저장하며, 수령자는 증명(proof)을 제출하여 클레임합니다 |
| 초기 비용 | 납부자가 모든 수령자 계정의 rent를 부담합니다 | 누군가 클레임하기 전까지는 수령자별 계정이 생성되지 않습니다 |
| 확장성 | 수천 명 규모의 수령자까지 현실적으로 사용할 수 있습니다 | 수백만 명의 수령자까지 확장할 수 있으며, 저장 공간은 수령자가 클레임할 때만 증가합니다 |
| 변경 가능성 | 생성 후에도 수령자를 추가할 수 있습니다 | 수령자 집합은 생성 시점에 고정됩니다 |
| 적합한 용도 | 시간이 지나면서 변경되는 소규모 배포 | 에어드롭과 같은 대규모 고정 배포 |
베스팅 일정
각 할당에는 네 가지 일정 중 하나가 적용됩니다. 타임스탬프는 Unix 초 단위입니다.
| 일정 | 동작 |
|---|---|
Immediate | 모든 토큰을 즉시 클레임할 수 있습니다 |
Linear | startTs와 endTs 사이에 토큰이 비례하여 잠금 해제됩니다 |
Cliff | cliffTs까지는 아무것도 잠금 해제되지 않다가, 그 시점에 전체가 한꺼번에 잠금 해제됩니다 |
CliffLinear | startTs부터 endTs까지 선형으로 베스팅되며, cliffTs 전까지는 클레임할 수 없습니다. 그 이전에 누적된 분량은 클리프 시점에 잠금 해제됩니다 |
계정
| 계정 | PDA seeds | 저장 내용 |
|---|---|---|
DirectDistribution | ["direct_distribution", mint, authority, seed] | authority, 민트, 할당 합계 |
DirectRecipient | ["direct_recipient", distribution, recipient] | 수령자 한 명의 할당 및 베스팅 정보 |
MerkleDistribution | ["merkle_distribution", mint, authority, seed] | authority, 민트, 합계, 머클 루트 |
MerkleClaim | ["merkle_claim", distribution, claimant] | 클레임자 한 명이 지금까지 클레임한 금액 |
Revocation | ["revocation", distribution, user] | 취소된 머클 클레임자를 차단하는 마커 |
seed는 생성 시 전달하는 추가 서명자의 주소이며, 이를 통해 하나의 authority가
동일한 민트에 대해 여러 배포를 운영할 수 있습니다. 각 배포의 볼트는 해당 민트에 대한
배포 PDA의 associated token account입니다.
인스트럭션
Direct 배포
- authority가
CreateDirectDistribution을 호출하여 배포 PDA와 해당 볼트를 생성합니다. - authority가 수령자마다 한 번씩
AddDirectRecipient를 호출하며, 금액과 베스팅 일정을 지정합니다. 각 호출은 해당 금액을 authority의 token account에서 볼트로 이체합니다. - 수령자는
ClaimDirect를 호출하여 베스팅된 토큰을 인출합니다.amount: 0을 전달하면 현재 베스팅된 전체 금액을 클레임합니다. - 수령자가 모든 토큰을 클레임했거나 배포가 종료되면
CloseDirectRecipient가 수령자 계정을 닫고, rent를 해당 계정의 비용을 지불한 계정으로 환불합니다. - authority가
CloseDirectDistribution을 호출하여 볼트에 남은 잔액과 rent를 회수합니다.clawbackTs가 설정된 경우, 해당 시각 이후에만 종료할 수 있습니다.
Merkle 배포
- authority가 오프체인에서 머클 트리를 구성합니다. 각 리프는 클레임자, 해당 클레임자의 총 금액, 베스팅 일정을 커밋합니다.
- authority가 루트, 총 클레임 가능 금액,
clawbackTs와 함께CreateMerkleDistribution을 호출하며, 같은 인스트럭션에서 볼트에 자금도 입금합니다. - 클레임자는 자신의 리프 데이터와 증명을 사용하여
ClaimMerkle을 호출합니다. 첫 클레임 시 클레임자의MerkleClaim계정이 생성됩니다.amount: 0을 전달하면 현재 베스팅된 전체 금액을 클레임합니다. clawbackTs이후 authority는CloseMerkleDistribution을 호출하여 볼트에 남은 잔액과 rent를 회수합니다.- 배포가 종료된 후, 클레임자는
CloseMerkleClaim을 호출하여 자신의 클레임 계정의 rent를 회수합니다.
프로그램은 리프를 Keccak-256으로
keccak256(0x00 || keccak256(claimant || totalAmount || schedule)) 형태로 해시하며,
여기서 totalAmount는 리틀 엔디언 u64이고 schedule은 인스트럭션의
VestingSchedule 인자와 동일한 인코딩을 사용합니다. 증명 노드는 정렬된 쌍으로
해시되며, 더 작은 해시가 앞에 옵니다.
취소
취소는 선택 사항입니다. 생성 시 설정하는 revocable 비트마스크가 authority가 사용할 수 있는
모드를 결정합니다. 비트 0은 NonVested를, 비트 1은 Full을 활성화하며,
0은 취소를 비활성화합니다.
| 모드 | 인스트럭션 | 결과 |
|---|---|---|
NonVested | RevokeDirectRecipient 또는 RevokeMerkleClaim | 베스팅되었지만 클레임되지 않은 토큰은 사용자에게 지급되고, 베스팅되지 않은 토큰은 authority에게 반환됩니다 |
Full | RevokeDirectRecipient 또는 RevokeMerkleClaim | 클레임되지 않은 모든 토큰(베스팅 여부와 무관)이 authority에게 반환됩니다 |
머클 클레임자를 취소하면 이후의 클레임을 차단하는 Revocation 마커가 생성되며,
한 번도 클레임한 적이 없는 경우에도 마찬가지입니다. Direct 수령자를 취소하면
해당 DirectRecipient 계정이 닫히고 rent가 환불됩니다.
클라이언트
저장소에는 Codama로 프로그램 IDL에서 생성한 @solana/kit 및
Rust 클라이언트가 clients/에 포함되어 있습니다.
이 클라이언트는 아직 npm에 게시되지 않았습니다. just generate-clients로
소스에서 빌드하세요.
리소스
- 소스 코드
- OtterSec 감사 보고서
- 이슈 신고
- Solana StackExchange, 태그
rewards-program
Is this page helpful?