Rewardsプログラムは、プログラムが所有するボールトから複数の受取人へトークンを配布し、各受取人にベスティングスケジュールを適用します。オーソリティがボールトに資金を供給し、誰が何を受け取るかを定義します。受取人は時間の経過とともにベスティング済みのトークンをクレームし、配布の設定で許可されている場合、オーソリティは受取人の権利を取り消したり、残りのトークンを回収したりできます。このプログラムはSolana Foundationがメンテナンスする Pinocchio で構築されており、SPL TokenとToken-2022のmintの両方に対応しています(transfer hook拡張機能を持つToken-2022のmintを除く)。
プログラムID(mainnetおよびdevnet):
REWArDioXgQJ2fZKkfu9LCLjQfRwYWVVfsvcsR5hoXi
このプログラムはOtterSecによる監査を受けています。監査対象のコミットについては、AUDIT_STATUS.mdを参照してください。
配布タイプを選択する
このプログラムは2種類の配布タイプをサポートしています。どちらも同じベスティングスケジュールと取り消しモードを使用します。
| Direct | Merkle | |
|---|---|---|
| 仕組み | 受取人ごとにオンチェーンアカウントを作成します | 単一のMerkleルートをオンチェーンに保存し、受取人は証明(proof)を提示してクレームします |
| 初期コスト | 支払者がすべての受取人アカウントのrentを負担します | 誰かがクレームするまで、受取人ごとのアカウントは作成されません |
| スケール | 受取人数が数千人程度までなら現実的です | 数百万人の受取人にまでスケールします。ストレージは受取人がクレームした分だけ増加します |
| 変更可否 | 作成後に受取人を追加できます | 受取人の集合は作成時に固定されます |
| 適した用途 | 時間とともに変化する小規模な配布 | エアドロップなど、大規模で固定的な配布 |
ベスティングスケジュール
各割り当てには、次の4つのスケジュールのいずれかが設定されます。タイムスタンプはUnix秒です。
| スケジュール | 動作 |
|---|---|
Immediate | すべてのトークンをすぐにクレームできます |
Linear | startTsからendTsまでの間、比例配分でトークンがアンロックされます |
Cliff | cliffTsまで何もアンロックされず、その時点ですべてが一度にアンロックされます |
CliffLinear | startTsからendTsまでのリニアベスティングで、cliffTsまではクレームできません。それ以前の累積分はクリフ時点でアンロックされます |
アカウント
| アカウント | PDA seed | 保存内容 |
|---|---|---|
DirectDistribution | ["direct_distribution", mint, authority, seed] | オーソリティ、mint、割り当て合計 |
DirectRecipient | ["direct_recipient", distribution, recipient] | 1人の受取人の割り当てとベスティング |
MerkleDistribution | ["merkle_distribution", mint, authority, seed] | オーソリティ、mint、合計、およびMerkleルート |
MerkleClaim | ["merkle_claim", distribution, claimant] | 1人のクレーム者がこれまでにクレームした量 |
Revocation | ["revocation", distribution, user] | 取り消されたMerkleクレーム者をブロックするマーカー |
seedは作成時に渡される追加の署名者のアドレスで、1つのオーソリティが同じmintに対して複数の配布を運用できるようにします。各配布のボールトは、そのmintに対する配布PDAのassociated token accountです。
instructions
Direct配布
- オーソリティが
CreateDirectDistributionを呼び出して、配布PDAとそのボールトを作成します。 - オーソリティは、受取人ごとに1回
AddDirectRecipientを呼び出し、金額とベスティングスケジュールを指定します。各呼び出しでは、その金額がオーソリティのtoken accountからボールトに転送されます。 - 受取人は
ClaimDirectを呼び出して、ベスティング済みのトークンを引き出します。amount: 0を渡すと、現時点でベスティング済みのすべてをクレームします。 - 受取人がすべてをクレームした後、または配布がクローズされた後に、
CloseDirectRecipientが受取人アカウントをクローズし、rentをその作成費用を支払ったアカウントに返金します。 - オーソリティは
CloseDirectDistributionを呼び出して、ボールトの残高とrentを回収します。clawbackTsが設定されている場合、クローズはその時刻以降にのみ可能です。
Merkle配布
- オーソリティはオフチェーンでMerkleツリーを構築します。各リーフには、クレーム者、そのクレーム者の合計金額、およびベスティングスケジュールがコミットされます。
- オーソリティは、ルート、クレーム可能な合計金額、
clawbackTsを指定してCreateMerkleDistributionを呼び出し、同じinstructionでボールトに資金を供給します。 - クレーム者は、自身のリーフデータと証明(proof)を指定して
ClaimMerkleを呼び出します。最初のクレームで、そのクレーム者のMerkleClaimアカウントが作成されます。amount: 0を渡すと、現時点でベスティング済みのすべてをクレームします。 clawbackTsの経過後、オーソリティはCloseMerkleDistributionを呼び出して、ボールトの残高とrentを回収します。- 配布がクローズされた後、クレーム者は
CloseMerkleClaimを呼び出して、自身のクレームアカウントのrentを回収します。
このプログラムは、Keccak-256を使用してkeccak256(0x00 || keccak256(claimant || totalAmount || schedule))の形式でリーフをハッシュします。ここでtotalAmountはリトルエンディアンのu64であり、scheduleはinstructionのVestingSchedule引数と同じエンコーディングを使用します。証明ノードは、ハッシュ値の小さい方を先にしたソート済みペアとしてハッシュされます。
取り消し
取り消しはオプトイン方式です。作成時に設定するrevocableビットマスクによって、オーソリティが使用できるモードが決まります。ビット0はNonVestedを、ビット1はFullを有効にし、0は取り消しを無効にします。
| モード | instruction | 結果 |
|---|---|---|
NonVested | RevokeDirectRecipientまたはRevokeMerkleClaim | ベスティング済みで未クレームのトークンはユーザーに渡され、未ベスティングのトークンはオーソリティに戻ります |
Full | RevokeDirectRecipientまたはRevokeMerkleClaim | ベスティング済みか未ベスティングかを問わず、未クレームのトークンはすべてオーソリティに戻ります |
Merkleクレーム者を取り消すとRevocationマーカーが作成され、まだ一度もクレームしていない場合でも、以後のクレームがブロックされます。Direct受取人を取り消すと、そのDirectRecipientアカウントがクローズされ、rentが返金されます。
クライアント
リポジトリのclients/には、Codamaでプログラムのidlから生成した@solana/kit用およびRust用のクライアントが含まれています。このクライアントはまだnpmに公開されていません。just generate-clientsを使用してソースからビルドしてください。
リソース
- ソースコード
- OtterSec監査レポート
- 問題を報告する
- Solana StackExchange、タグ
rewards-program
Is this page helpful?