리워드 프로그램

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모든 토큰을 즉시 클레임할 수 있습니다
LinearstartTs와 endTs 사이에 토큰이 비례하여 잠금 해제됩니다
CliffcliffTs까지는 아무것도 잠금 해제되지 않다가, 그 시점에 전체가 한꺼번에 잠금 해제됩니다
CliffLinearstartTs부터 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 배포

  1. authority가 CreateDirectDistribution을 호출하여 배포 PDA와 해당 볼트를 생성합니다.
  2. authority가 수령자마다 한 번씩 AddDirectRecipient를 호출하며, 금액과 베스팅 일정을 지정합니다. 각 호출은 해당 금액을 authority의 token account에서 볼트로 이체합니다.
  3. 수령자는 ClaimDirect를 호출하여 베스팅된 토큰을 인출합니다. amount: 0을 전달하면 현재 베스팅된 전체 금액을 클레임합니다.
  4. 수령자가 모든 토큰을 클레임했거나 배포가 종료되면 CloseDirectRecipient가 수령자 계정을 닫고, rent를 해당 계정의 비용을 지불한 계정으로 환불합니다.
  5. authority가 CloseDirectDistribution을 호출하여 볼트에 남은 잔액과 rent를 회수합니다. clawbackTs가 설정된 경우, 해당 시각 이후에만 종료할 수 있습니다.

Merkle 배포

  1. authority가 오프체인에서 머클 트리를 구성합니다. 각 리프는 클레임자, 해당 클레임자의 총 금액, 베스팅 일정을 커밋합니다.
  2. authority가 루트, 총 클레임 가능 금액, clawbackTs와 함께 CreateMerkleDistribution을 호출하며, 같은 인스트럭션에서 볼트에 자금도 입금합니다.
  3. 클레임자는 자신의 리프 데이터와 증명을 사용하여 ClaimMerkle을 호출합니다. 첫 클레임 시 클레임자의 MerkleClaim 계정이 생성됩니다. amount: 0을 전달하면 현재 베스팅된 전체 금액을 클레임합니다.
  4. clawbackTs 이후 authority는 CloseMerkleDistribution을 호출하여 볼트에 남은 잔액과 rent를 회수합니다.
  5. 배포가 종료된 후, 클레임자는 CloseMerkleClaim을 호출하여 자신의 클레임 계정의 rent를 회수합니다.

프로그램은 리프를 Keccak-256으로 keccak256(0x00 || keccak256(claimant || totalAmount || schedule)) 형태로 해시하며, 여기서 totalAmount는 리틀 엔디언 u64이고 schedule은 인스트럭션의 VestingSchedule 인자와 동일한 인코딩을 사용합니다. 증명 노드는 정렬된 쌍으로 해시되며, 더 작은 해시가 앞에 옵니다.

취소

취소는 선택 사항입니다. 생성 시 설정하는 revocable 비트마스크가 authority가 사용할 수 있는 모드를 결정합니다. 비트 0은 NonVested를, 비트 1은 Full을 활성화하며, 0은 취소를 비활성화합니다.

모드인스트럭션결과
NonVestedRevokeDirectRecipient 또는 RevokeMerkleClaim베스팅되었지만 클레임되지 않은 토큰은 사용자에게 지급되고, 베스팅되지 않은 토큰은 authority에게 반환됩니다
FullRevokeDirectRecipient 또는 RevokeMerkleClaim클레임되지 않은 모든 토큰(베스팅 여부와 무관)이 authority에게 반환됩니다

머클 클레임자를 취소하면 이후의 클레임을 차단하는 Revocation 마커가 생성되며, 한 번도 클레임한 적이 없는 경우에도 마찬가지입니다. Direct 수령자를 취소하면 해당 DirectRecipient 계정이 닫히고 rent가 환불됩니다.

클라이언트

저장소에는 Codama로 프로그램 IDL에서 생성한 @solana/kit 및 Rust 클라이언트가 clients/에 포함되어 있습니다. 이 클라이언트는 아직 npm에 게시되지 않았습니다. just generate-clients로 소스에서 빌드하세요.

리소스

Is this page helpful?

목차

페이지 편집