برنامج المكافآت

يوزّع برنامج Rewards الرموز من خزنة يملكها البرنامج على مجموعة من المستلمين، ولكلٍّ منهم جدول استحقاق. تموّل الجهة المخوَّلة الخزنة وتحدد من يحصل على ماذا. يطالب المستلمون برموزهم المستحقة بمرور الوقت، ويمكن للجهة المخوَّلة إلغاء استحقاق المستلمين أو استرداد الرموز المتبقية عندما يسمح التوزيع بذلك. بُني البرنامج باستخدام Pinocchio وتتولى صيانته مؤسسة سولانا، ويعمل مع حسابات mint الخاصة بـ SPL Token وToken-2022، باستثناء حسابات mint الخاصة بـ Token-2022 التي تستخدم امتداد transfer hook.

معرّف البرنامج (الشبكة الرئيسية وشبكة devnet):

REWArDioXgQJ2fZKkfu9LCLjQfRwYWVVfsvcsR5hoXi

دقّقت شركة OtterSec البرنامج. راجع AUDIT_STATUS.md لمعرفة الـ commit الذي شمله التدقيق.

اختر نوع التوزيع

يدعم البرنامج نوعين من التوزيع. يستخدم كلاهما جداول الاستحقاق نفسها وأوضاع الإلغاء نفسها.

مباشرMerkle
آلية العملينشئ حسابًا على السلسلة لكل مستلميخزّن جذر Merkle واحدًا على السلسلة؛ ويقدّم المستلمون إثباتات للمطالبة
التكلفة المسبقةيموّل الدافع rent لكل حساب مستلملا حسابات لكل مستلم إلى أن يطالب أحدهم
النطاقعملي حتى بضعة آلاف من المستلمينيتوسع إلى ملايين المستلمين؛ ولا ينمو التخزين إلا مع مطالبة المستلمين
قابلية التعديليمكن إضافة مستلمين بعد الإنشاءمجموعة المستلمين ثابتة عند الإنشاء
مناسب لـالتوزيعات الصغيرة التي تتغير بمرور الوقتالتوزيعات الكبيرة الثابتة مثل airdrops

جداول الاستحقاق

يرتبط كل تخصيص بأحد أربعة جداول. الطوابع الزمنية بثواني Unix.

الجدولالسلوك
Immediateجميع الرموز قابلة للمطالبة فورًا
Linearتُفتح الرموز تناسبيًا بين startTs وendTs
Cliffلا يُفتح شيء حتى cliffTs، ثم تُفتح جميع الرموز دفعة واحدة
CliffLinearاستحقاق خطي من startTs إلى endTs، مع عدم إتاحة أي شيء للمطالبة حتى cliffTs؛ ويُفتح ما تراكم سابقًا عند الـ cliff

الحسابات

الحسابPDA seedsالمحتوى
DirectDistribution["direct_distribution", mint, authority, seed]الجهة المخوَّلة، وmint، وإجماليات التخصيص
DirectRecipient["direct_recipient", distribution, recipient]تخصيص مستلم واحد واستحقاقه
MerkleDistribution["merkle_distribution", mint, authority, seed]الجهة المخوَّلة، وmint، والإجماليات، وجذر Merkle
MerkleClaim["merkle_claim", distribution, claimant]المبلغ الذي طالب به مطالب واحد حتى الآن
Revocation["revocation", distribution, user]علامة تمنع مطالبًا ضمن Merkle أُلغي استحقاقه

seed هو عنوان موقّع إضافي يُمرَّر عند الإنشاء، بحيث يمكن لجهة مخوَّلة واحدة تشغيل عدة توزيعات لنفس الـ mint. خزنة كل توزيع هي associated token account الخاصة بـ PDA التوزيع لذلك الـ mint.

التعليمات

التوزيع المباشر

  1. تستدعي الجهة المخوَّلة CreateDirectDistribution لإنشاء PDA التوزيع وخزنته.
  2. تستدعي الجهة المخوَّلة AddDirectRecipient مرة لكل مستلم مع تحديد المبلغ وجدول الاستحقاق. ينقل كل استدعاء ذلك المبلغ من token account الخاص بالجهة المخوَّلة إلى الخزنة.
  3. يستدعي المستلمون ClaimDirect لسحب الرموز المستحقة. مرّر amount: 0 للمطالبة بكل ما استُحق حاليًا.
  4. بمجرد أن يطالب المستلم بكل ما له، أو عند إغلاق التوزيع، يغلق CloseDirectRecipient حساب المستلم ويعيد rent إلى الحساب الذي دفعه.
  5. تستدعي الجهة المخوَّلة CloseDirectDistribution لاسترداد الرصيد المتبقي في الخزنة وrent. إذا حُدد clawbackTs، فلا يُسمح بالإغلاق إلا بعد ذلك الوقت.

توزيع Merkle

  1. تبني الجهة المخوَّلة شجرة Merkle خارج السلسلة. تلتزم كل ورقة بمطالب، وبإجمالي مبلغ ذلك المطالب، وبجدول الاستحقاق.
  2. تستدعي الجهة المخوَّلة CreateMerkleDistribution مع الجذر، وإجمالي المبلغ القابل للمطالبة، وقيمة clawbackTs، وتموّل الخزنة في التعليمة نفسها.
  3. يستدعي المطالبون ClaimMerkle مع بيانات ورقتهم وإثباتها. تنشئ المطالبة الأولى حساب MerkleClaim الخاص بالمطالب. مرّر amount: 0 للمطالبة بكل ما استُحق حاليًا.
  4. بعد clawbackTs، تستدعي الجهة المخوَّلة CloseMerkleDistribution لاسترداد الرصيد المتبقي في الخزنة وrent.
  5. بعد إغلاق التوزيع، يستدعي المطالبون CloseMerkleClaim لاسترداد rent حساب المطالبة الخاص بهم.

يجزّئ البرنامج الأوراق باستخدام Keccak-256 على النحو keccak256(0x00 || keccak256(claimant || totalAmount || schedule))، حيث totalAmount هو u64 بترتيب little-endian، ويستخدم schedule الترميز نفسه المستخدم في وسيط VestingSchedule الخاص بالتعليمة. تُجزَّأ عقد الإثبات كأزواج مرتبة، بحيث يأتي التجزئة الأصغر أولًا.

الإلغاء

الإلغاء اختياري. يحدد القناع الثنائي revocable المضبوط عند الإنشاء الأوضاع التي يجوز للجهة المخوَّلة استخدامها: يفعّل البت 0 الوضع NonVested، ويفعّل البت 1 الوضع Full، وتعطّل القيمة 0 الإلغاء.

الوضعالتعليمةالنتيجة
NonVestedRevokeDirectRecipient أو RevokeMerkleClaimتذهب الرموز المستحقة غير المطالَب بها إلى المستخدم؛ وتعود الرموز غير المستحقة إلى الجهة المخوَّلة
FullRevokeDirectRecipient أو RevokeMerkleClaimتعود جميع الرموز غير المطالَب بها، المستحقة وغير المستحقة، إلى الجهة المخوَّلة

يؤدي إلغاء استحقاق مطالب ضمن Merkle إلى إنشاء علامة Revocation تمنع المطالبات المستقبلية، حتى لو لم يطالب من قبل. أما إلغاء استحقاق مستلم مباشر فيغلق حساب DirectRecipient الخاص به ويعيد rent الخاص بالحساب.

العملاء

يتضمن المستودع عميلَي @solana/kit وRust المولَّدين من IDL الخاص بالبرنامج باستخدام Codama، في clients/. لم يُنشر العميل على npm بعد. ابنِه من المصدر باستخدام just generate-clients.

الموارد

Is this page helpful?

جدول المحتويات

تعديل الصفحة