بوت Discord
يمنح بوت First Ledger أعضاء خادمك على Discord أدوارًا حسب الـ NFTs والرموز التي يحملونها، وينشر مبيعات مجموعتك فور حدوثها، ويدير القوائم المسموحة والاستطلاعات والسحوبات — لأي مجموعة على XRP Ledger.
ماذا يفعل
أدوار الحاملين: يربط العضو محافظه مرة واحدة، ويمنح البوت الأدوار ويسحبها عند الشراء والبيع، عادةً خلال ثوانٍ من البيع.
الموجزات: المبيعات والإدراجات وعمليات السكّ والعروض لمجموعاتك، تُنشر في القنوات التي تختارها.
أدوات لخادمك: سعر الأرضية وعدد الحاملين مباشرةً في أسماء القنوات، ولقطات للحاملين، وسجل تدقيق، ولوحة تحكم ويب للمشرفين.
المجتمع: قوائم مسموحة، واستطلاعات للحاملين، وسحوبات، وفعاليات، وتنبيهات شخصية.
إنه مجاني: كل الميزات، لكل خادم ولكل مجموعة.
إضافته إلى خادمك
افتح صفحة البوت على First Ledger واختر «إضافة إلى Discord». تحتاج إلى صلاحية «إدارة الخادم» في الخادم الذي تضيفه إليه.
يعرض Discord بعدها الصلاحيات الست التي يطلبها البوت. اتركها كلها محددة: فكل واحدة منها مستخدمة.
- إدارة الأدوار لمنح أدوار الحاملين وسحبها. بدونها لا تُمنح أي أدوار.
- إدارة القنوات تتيح لـ
/setupإنشاء قناة #verify، وتُبقي سعر الأرضية وعدد الحاملين في أسماء القنوات محدّثة. - عرض القنوات تتيح للبوت رؤية القنوات التي ينشر فيها.
- إرسال الرسائل لنشر الموجزات ولوحة التحقق والاستطلاعات والسحوبات والفعاليات.
- تضمين الروابط تعرض كل عملية بيع وإدراج كبطاقة بصورة الـ NFT وسعره.
- إرفاق الملفات تتيح لـ
/admin snapshot takeإرسال قائمة الحاملين كملف CSV.
لا يطلب أبدًا صلاحية المسؤول أو إدارة الخادم أو طرد أي أحد أو حظره. لا يحتاج دور البوت إلى أكثر من هذه الست، فاترك كل ما عداها معطّلًا.
في إعدادات الخادم ← الأدوار، اسحب دور البوت فوق كل دور تريده أن يمنحه. لا يسمح Discord للبوت إلا بمنح الأدوار التي تقع تحت دوره.
شغّل /check-permissions. يجب أن يكون كل سطر علامة خضراء؛ وكل علامة حمراء توضح ما يجب إصلاحه.
أضف مجموعتك باستخدام /admin collection add. ابدأ بكتابة اسمها واخترها من القائمة.
أنشئ دورًا للحاملين باستخدام /admin role set: اختر الدور والمجموعة، وحدًا أدنى وأقصى إن أردت مستويات. يمكنك أيضًا اشتراط سمة معيّنة، أو أن يكون الـ NFT محتفظًا به لعدد من الأيام.
انشر لوحة التحقق باستخدام /setup. تُنشئ قناة #verify، أو تستخدم القناة التي تحددها، مع زر «تحقق» يضغطه الأعضاء.
يمكن تنفيذ كل ذلك أيضًا من لوحة التحكم، التي تسجّل دخولك عبر Discord وتعرض الخوادم التي تديرها.
أدوار الحاملين
حسب العدد: امتلاك عدد أدنى من NFTs من مجموعة، ويمكن تحديد حد أقصى أيضًا، لتنشئ مستويات مثل حامل وجامع وحوت.
حسب السمة: امتلاك NFT بسمة معيّنة، مثل Background: Gold.
حسب الندرة أو الترتيب: امتلاك NFT ضمن أعلى N في المجموعة، أو أن تكون من أكبر N حاملين لها.
المنشئ: محفظة منشئ المجموعة أو مُصدِرها.
حسب الرصيد: امتلاك كمية من XRP، أو من توكن صادر على XRP Ledger (بما فيها التوكنات التي أُطلقت على First Ledger)، أو من توكن متعدد الأغراض. أعِدّ ذلك عبر /admin role token: اختر الدور وما يجب التحقق منه والحد الأدنى، ويجمع البوت الرصيد عبر المحافظ المرتبطة بالعضو.
حسب المحفظة: قائمة عناوين تلصقها.
مُركّب: أيٌّ مما سبق مربوطًا بـ AND وOR وNOT في المحرر المتقدم بلوحة التحكم — مثلًا: يملك ثلاثة أو أكثر AND يملك مئة XRP.
تُحتسب كل المحافظ في حساب العضو على First Ledger معًا، لذا لا يفقد دوره أبدًا عند نقل NFT بين محافظه.
تتحدّث الأدوار المبنية على NFTs خلال ثوانٍ من البيع. أما المبنية على الأرصدة فتتحدّث مع الفحص كل ساعة، أو فورًا عندما يشغّل العضو /refresh.
أدوار لا يتيحها إلا XRP Ledger
الـ NFTs المعروضة للبيع تبقى محتسبة. على XRP Ledger يبقى الـ NFT المعروض في محفظتك حتى يشتريه أحد، لذا لا يفقد العضو دوره بسبب العرض. وإن أردت مكافأة من لا يعرضون، فهناك قاعدة لنسبة الـ NFTs المعروضة لديهم.
مدة الامتلاك: امتلاك NFT لعدد أدنى من الأيام. يشبه الـ staking دون قفل أي شيء.
بطاقات العضوية: الـ NFT الذي يُسكّ دون علامة قابلية النقل لا يمكن إرجاعه إلا لمنشئه، فلا يمكن بيعه. بطاقة كهذه تصنع دور عضوية لا يُشترى.
مزوّدو السيولة: امتلاك توكنات مجمّع سيولة AMM، مثل مجمّع لتوكن مشروعك. يُعَدّ هذا أيضًا عبر /admin role token.
حاملون دفعوا الإتاوات: كل NFT من المجموعة اشتُري بالسكّ أو في بيع دفع إتاوة المنشئ، لا أنه مُنح مجانًا.
الخلاصات وأدوات الخادم
ابدأ خلاصة عبر /admin feed add: اختر القناة وأنواع النشاط المنشور (المبيعات، العروض، السكّ، التحويلات، الحرق، العروض المقدّمة)، وحدًا أدنى للسعر، وتنسيقًا كاملًا أو مختصرًا. تُنشر مشتريات المشتري الواحد في نفس الـ ledger معًا كعملية sweep.
تُعرض الأسعار بالعملة التي تمّ بها البيع، مع قيمتها بـ XRP بجانبها إن كانت معروفة.
أنشئ قناة إحصاءات عبر /admin stat add: قناة يعرض اسمها سعر الأرضية أو عدد الحاملين أو عدد المعروض أو حجم تداول اليوم أو عدد الأعضاء ذوي دور ما، وتتحدّث كل عشر دقائق.
التقط لقطة عبر /admin snapshot take: كل حاملي المجموعة في جدول بيانات. عند تفعيل معرّفات Discord، لا تظهر إلا أسماء أعضاء خادمك.
اطّلع على كل دور منحه البوت أو أزاله، وسبب ذلك، عبر /admin audit.
القوائم المسموحة والاستطلاعات والسحوبات والفعاليات
ينشر /allowlist create زر انضمام. ينضم الأعضاء المستوفون للشرط بمحفظتهم المرتبطة، وصدِّر القائمة كجدول بيانات عند إغلاقها.
ينشر /poll create استطلاعًا. يمكن احتساب صوت واحد لكل عضو، أو صوت لكل NFT يملكه.
ينشر /raffle create زر «اشترك». يُختار الفائزون من تجزئة (hash) سجلّ في XRP Ledger أُغلق بعد إغلاق الاشتراكات، ويظهر في الإعلان، ليتمكّن أي شخص من التحقق من نزاهة السحب.
ينشر /event create فعالية يمكن للأعضاء تأكيد حضورها، مع إمكانية قصرها على الحاملين وتحديد سعة.
يمكن للأعضاء تفعيل تنبيهات الرسائل الخاصة عبر /alerts: العروض على NFTs الخاصة بهم، وتحذير عندما يبدو العرض احتيالًا، والمبيعات في مجموعة، أو الإدراجات بأقل من سعر معيّن.
للأعضاء: التحقق
انقر «تحقق» في الخادم، أو شغّل /verify. سيرد البوت برابط لا يراه غيرك.
يفتح الرابط First Ledger. سجّل الدخول بمحفظتك كالمعتاد واختر «متابعة».
سيطلب منك Discord تأكيد حسابك. أكّده، وستظهر أدوارك خلال ثوانٍ.
أضفت محفظة إلى حسابك في First Ledger بعد ذلك؟ شغّل /verify مجددًا، ثم /refresh.
لا تُكمل أبدًا تحققًا أرسله لك شخص آخر. كل رابط يخص من شغّل الأمر، ولا يعمل إلا له.
كل الأوامر
تتطلب أوامر المشرفين صلاحية «إدارة الخادم»، ولا يعرضها Discord إلا لمن يملكها. معظم الردود لا يراها غيرك؛ أما /floor و/collection و/nft فتُنشر في القناة للجميع. ابدأ بكتابة اسم المجموعة في أي خيار للمجموعة واخترها من القائمة: تظهر مجموعات خادمك أولًا، ثم مجموعات السوق.
للجميع
/verify
الجميعيرسل إليك رابطًا تراه أنت فقط لربط المحافظ في حسابك على First Ledger. الرابط خاص بك وحدك وصالح لعشر دقائق. لن توقّع أي معاملة.
/wallets
الجميعيعرض محافظك المرتبطة، ولكل منها رابط إلى صفحتها على First Ledger.
/refresh
الجميعيعيد تحميل محافظك من First Ledger ويفحص أدوارك فورًا. استخدمه بعد إضافة محفظة، أو إذا لم يُحدَّث دور الرصيد.
/roles
الجميعيعرض أدوار الحاملين في هذا الخادم ومتطلبات كل منها، مع تحديد ما لديك.
/floor
الجميعينشر سعر الأرضية وتغيّره خلال آخر يوم وعدد المعروض، لمجموعة واحدة أو حتى 15 من مجموعات الخادم.
collection- مجموعة واحدة. اتركه فارغًا لكل مجموعات الخادم.
/collection
الجميعينشر إحصاءات المجموعة: الأرضية، وأفضل عرض، والمعروض، والحاملين، والحجم، والمبيعات، والإتاوة، وما إذا كانت موثّقة.
collectionمطلوب- المجموعة.
/nft
الجميعينشر بطاقة NFT: الصورة، والمالك، وترتيب الندرة، والسعر إن كان معروضًا، والإتاوة، والعلامات، والسمات.
idمطلوبNFTokenIDالخاص بالـ NFT، وطوله 64 حرفًا.
/portfolio
الجميعيعرض NFTs الخاصة بك في محافظك المرتبطة، مجمّعة حسب المجموعة.
/alerts add
الجميعيفعّل تنبيهًا عبر الرسائل الخاصة. إضافة النوع نفسه للمجموعة نفسها مجددًا تستبدل سعره. أبقِ الرسائل الخاصة من أعضاء الخادم مفتوحة، وإلا فلن يتمكن البوت من الوصول إليك.
kindمطلوبoffer_receivedللعروض على NFTs الخاصة بك، وsuspicious_offerللتحذير عندما يبدو العرض احتيالًا، وcollection_saleللمبيعات في مجموعة، أوlisting_belowللإدراجات دون سعر معيّن.collection- مطلوب لتنبيهات المبيعات والإدراجات.
price- بعملة XRP: أصغر عملية بيع تريد إشعارًا بها، أو أعلى سعر للإدراجات.
/alerts remove
الجميعيوقف تنبيهًا.
kindمطلوبoffer_receivedللعروض على NFTs الخاصة بك، وsuspicious_offerللتحذير عندما يبدو العرض احتيالًا، وcollection_saleللمبيعات في مجموعة، أوlisting_belowللإدراجات دون سعر معيّن.collection- مطلوب لتنبيهات المبيعات والإدراجات.
/alerts list
الجميعيعرض تنبيهاتك.
/privacy allow
الجميعيتيح لتطبيق شريك الاطلاع على محافظك المرتبطة.
partnerمطلوب- اسم التطبيق الشريك.
/privacy revoke
الجميعيوقف المشاركة مع تطبيق شريك.
partnerمطلوب- اسم التطبيق الشريك.
/privacy status
الجميعيعرض التطبيقات الشريكة التي تشارك معها.
/unlink
الجميعيزيل ربطك والأدوار التي منحك إياها البوت في كل خادم تشترك فيه معه.
/help
الجميعيعرض ما إذا كنت مرتبطًا، مع دليل قصير لهذه الأوامر.
الإعداد
/setup
إدارة الخادمينشر لوحة التحقق التي ينقر عليها الأعضاء لربط محافظهم، ويحفظ قناتها. إذا لم تحدد قناة، ينشئ #verify.
channel- مكان نشر اللوحة. إن تركته فارغًا ينشئ البوت #verify، وهذا يتطلب صلاحية إدارة القنوات.
/check-permissions
إدارة الخادميتحقق من كل صلاحية يحتاجها البوت، ومن كل قاعدة دور (أن الدور لا يزال موجودًا وأنه أدنى من دور البوت) ومن كل قناة تغذية، مع علامة صح أو خطأ وما يجب إصلاحه. ويُنبّه إذا مُنح البوت صلاحية Administrator، فهو لا يحتاجها.
/admin collection add
إدارة الخادميتتبع مجموعة، لتصل نشاطاتها إلى قنوات التغذية ويحصل حاملوها على أدوارك. ويُنبّه إذا كانت المنصة قد وضعت علامة على المجموعة.
collectionمطلوب- المجموعة.
/admin collection remove
إدارة الخادميوقف تتبع مجموعة.
collectionمطلوب- المجموعة.
/admin collection list
إدارة الخادميعرض المجموعات التي يتتبعها هذا الخادم.
أدوار الحاملين
/admin role set
إدارة الخادميمنح دورًا للأعضاء الذين يملكون ما يكفي من مجموعة. تعيينه مجددًا على الدور نفسه يستبدل القاعدة. يُعاد فحص الأعضاء المرتبطين فورًا.
roleمطلوب- دور عادي أدنى من دور البوت. يرفض البوت @everyone والأدوار التي يديرها تطبيق آخر وأي دور له صلاحيات إدارية أو إشرافية.
collectionمطلوب- المجموعة.
min- أقل عدد من NFTs يجب امتلاكه، من 1 إلى 100,000. الافتراضي 1.
max- الحد الأقصى، لمستويات مثل Holder وCollector وWhale.
traitType:Value، مثلBackground:Gold. افصل بين عدة قيم بـ|ويكفي تحقق أي منها.held-days- يشترط أيضًا امتلاك NFT واحد لعدد الأيام هذا على الأقل، من 1 إلى 3,650.
/admin role token
إدارة الخادميمنح دورًا حسب الرصيد، مجموعًا عبر محافظ العضو المرتبطة: XRP، أو رمز مُصدر على XRP Ledger، أو رمز متعدد الأغراض، أو رموز سيولة مجمع AMM. يُعاد فحص الأرصدة كل ساعة، أو عندما ينفّذ العضو /refresh.
roleمطلوب- دور عادي أدنى من دور البوت. يرفض البوت @everyone والأدوار التي يديرها تطبيق آخر وأي دور له صلاحيات إدارية أو إشرافية.
kindمطلوبxrp، أوtokenلتوكن صادر على XRP Ledger، أوmptلتوكن متعدد الأغراض، أوlpلتوكنات السيولة في مجمّع AMM.minمطلوب- أقل رصيد، أكبر من الصفر.
issuer- لـ
token: عنوان الجهة المُصدِرة. currency- لـ
token: رمزه، مثلRLUSD. issuance-id- لـ
mpt: معرّف الإصدار المكوّن من 48 حرفًا. pool- لـ
lp: عنوان حساب مجمّع AMM.
/admin role set-json
إدارة الخادميمنح دورًا وفق قاعدة مكتوبة بصيغة JSON، تجمع أيًا من الشروط أدناه.
roleمطلوب- دور عادي أدنى من دور البوت. يرفض البوت @everyone والأدوار التي يديرها تطبيق آخر وأي دور له صلاحيات إدارية أو إشرافية.
ruleمطلوب- القاعدة، حتى 6,000 حرف.
/admin role remove
إدارة الخادميحذف قاعدة الدور، ويزيل الدور من الأعضاء الذين منحهم البوت إياه.
roleمطلوب- دور عادي أدنى من دور البوت. يرفض البوت @everyone والأدوار التي يديرها تطبيق آخر وأي دور له صلاحيات إدارية أو إشرافية.
/admin role list
إدارة الخادميعرض كل قواعد الأدوار بالكلمات، وما إذا كانت مفعّلة.
الموجزات وأدوات الخادم
/admin feed add
إدارة الخادمينشر النشاط في قناة. يرسل البوت رسالة تجريبية أولًا لتتأكد أنه يستطيع النشر فيها. إضافة تغذية إلى قناة لديها تغذية تُحدّثها.
channelمطلوب- قناة نصية أو قناة إعلانات.
kinds- مفصولة بفواصل، من بين
saleوlistوdelistوmintوtransferوburnوbuy_offer_createdوbuy_offer_cancelledوoffer_expiredوuri_modified. الافتراضيsale. collection- مجموعة واحدة. اتركه فارغًا لكل مجموعات الخادم.
min-price- تخطَّ كل ما يقل عن هذا العدد من XRP. يُتخطّى أيضًا النشاط بلا سعر، مثل التحويل.
layoutfullأوcompact.
/admin feed layout
إدارة الخادميبدّل تخطيط التغذية بين الكامل والمختصر.
channelمطلوب- القناة.
layoutمطلوبfullأوcompact.
/admin feed remove
إدارة الخادميحذف تغذية القناة.
channelمطلوب- القناة.
/admin feed list
إدارة الخادميعرض قنوات التغذية، وما تنشره كل منها، وما إذا كانت مفعّلة.
/admin stat add
إدارة الخادمينشئ قناة صوتية مقفلة يعرض اسمها رقمًا مباشرًا، مثل سعر الأرضية. يتحدث عند تغيّر الرقم، مرة كل 10 دقيقة كحد أقصى.
kindمطلوبfloor، أوholders، أوvolumeلحجم تداول اليوم، أوlisted، أوroleلعدد الأعضاء الذين لديهم دور.collection- مطلوب لكل الأنواع عدا
role. role- مطلوب لـ
role. template- اسم القناة، من 3 إلى 90 حرف، ويتضمن واحدًا على الأقل من
{floor} {holders} {listed} {supply} {volume24h} {sales24h} {bid} {count}.
/admin stat remove
إدارة الخادميوقف تحديث قناة الإحصاء. تبقى القناة نفسها.
channelمطلوب- القناة.
/admin snapshot take
إدارة الخادميرسل إليك كل حاملي المجموعة في ملف CSV: العنوان، واسم المستخدم، وعدد ما يملكونه، وحصتهم.
collectionمطلوب- المجموعة.
min- فقط من يملكون هذا العدد على الأقل.
with-discord- أضف عمود معرّف Discord. لا تظهر إلا أسماء الأعضاء المرتبطين في هذا الخادم.
/admin snapshot list
إدارة الخادميعرض اللقطات الأخيرة.
/admin audit
إدارة الخادميعرض آخر 25 تغيير في الأدوار والقواعد، وسبب كل منها.
user- تغييرات هذا العضو فقط.
/admin reconcile
إدارة الخادميعيد فحص كل الأعضاء المرتبطين الآن. تظهر التغييرات في /admin audit.
قوائم السماح والاستطلاعات والسحوبات والفعاليات
/allowlist create
إدارة الخادمينشر قائمة سماح مع زر انضمام. ينضم العضو المؤهل بأول محفظة ربطها.
nameمطلوب- اسمها، حتى 60 حرف، ومختلف عن أسماء قوائم السماح الأخرى في الخادم.
max-entries- الحد الأقصى لعدد المنضمين.
closes-in-hours- الإغلاق بعد هذا العدد من الساعات، حتى 2,160 (90 أيام).
eligibility-collection- المشاركة لحاملي هذه المجموعة فقط. اتركه فارغًا للسماح لأي شخص لديه محفظة مرتبطة.
eligibility-min- العدد الذي يجب امتلاكه. الافتراضي 1.
rule-json- أو أي قاعدة بصيغة JSON، كما في
/admin role set-json.
/allowlist close
إدارة الخادميغلق قائمة السماح الآن.
nameمطلوب- اسمها، حتى 60 حرف، ومختلف عن أسماء قوائم السماح الأخرى في الخادم.
/allowlist export
إدارة الخادميرسل إليك إدخالات قائمة السماح في ملف CSV.
nameمطلوب- اسمها، حتى 60 حرف، ومختلف عن أسماء قوائم السماح الأخرى في الخادم.
/allowlist list
إدارة الخادميعرض قوائم السماح في الخادم مع إدخالاتها وموعد إغلاقها.
/poll create
إدارة الخادمينشر استطلاعًا بزر لكل خيار. يمكن للأعضاء تغيير تصويتهم حتى يُغلق.
questionمطلوب- حتى 200 حرف.
optionsمطلوب- من 2 إلى 10 خيارات مفصولة بـ
|، كل منها حتى 80 حرف. duration-hoursمطلوب- مدة التشغيل بالساعات، حتى 2,160 (90 أيام).
weightingmemberصوت أو مشاركة واحدة لكل عضو، أوnftواحد لكل NFT مملوك.weight-collection- المجموعة التي تُحتسب لـ
nft. eligibility-collection- المشاركة لحاملي هذه المجموعة فقط. اتركه فارغًا للسماح لأي شخص لديه محفظة مرتبطة.
eligibility-min- العدد الذي يجب امتلاكه. الافتراضي 1.
/poll close
إدارة الخادميُغلق الاستطلاع الآن وينشر النتائج.
idمطلوب- المعرّف الموجود في تذييل المنشور.
/raffle create
إدارة الخادمينشر سحبًا مع زر «مشاركة».
prizeمطلوب- حتى 200 حرفًا.
winnersمطلوب- من 1 إلى 100.
duration-hoursمطلوب- مدة التشغيل بالساعات، حتى 2,160 (90 أيام).
weightingmemberصوت أو مشاركة واحدة لكل عضو، أوnftواحد لكل NFT مملوك.weight-collection- المجموعة التي تُحتسب لـ
nft. eligibility-collection- المشاركة لحاملي هذه المجموعة فقط. اتركه فارغًا للسماح لأي شخص لديه محفظة مرتبطة.
eligibility-min- العدد الذي يجب امتلاكه. الافتراضي 1.
/raffle draw
إدارة الخادميُغلق المشاركات ويسحب الفائزين الآن. يعتمد السحب على تجزئة دفتر أستاذ مُعتمد، ويظهر في الإعلان ليتمكن أي شخص من إعادة حسابه.
idمطلوب- المعرّف الموجود في تذييل المنشور.
/event create
إدارة الخادمينشر فعالية يمكن للأعضاء تأكيد حضورها حتى تبدأ أو تمتلئ.
titleمطلوب- حتى 100 حرفًا.
startsمطلوب- عدد الساعات من الآن، مثل
48، أو تاريخ ووقت مع منطقة زمنية، مثل2026-12-01T18:00Z. خلال 90 يومًا. description- حتى 1,000 حرفًا.
location- حتى 200 حرفًا.
capacity- الحد الأقصى لعدد من يمكنهم تأكيد الحضور.
eligibility-collection- المشاركة لحاملي هذه المجموعة فقط. اتركه فارغًا للسماح لأي شخص لديه محفظة مرتبطة.
eligibility-min- العدد الذي يجب امتلاكه. الافتراضي 1.
/event cancel
إدارة الخادميلغي فعالية ويحدّث منشورها.
idمطلوب- المعرّف الموجود في تذييل المنشور.
/event attendees
إدارة الخادميعرض قائمة الحاضرين.
idمطلوب- المعرّف الموجود في تذييل المنشور.
متقدم: قواعد بصيغة JSON
يقبل /admin role set-json قاعدة مكتوبة بصيغة JSON، لأي شيء لا يستطيع /admin role set و/admin role token إنشاءه. ويكتب المحرر المتقدم في لوحة التحكم القواعد نفسها نيابةً عنك.
اربط الشروط بـ and أو or، ويقبل كلٌّ منهما من 1 إلى 20 قواعد، واعكس شرطًا بـ not. يمكن أن تتداخل القاعدة حتى 6 مستويات وأن تضم حتى 30 شروط.
يُفحص كل شرط على جميع محافظ العضو المرتبطة معًا، ويكون خاطئًا لمن ليس لديه محفظة مرتبطة. إذا تعذّر على البوت فحص شرط، مثلًا عند تعذّر الوصول إلى السجلّ، يحتفظ العضو بأدواره الحالية.
الشروط حسب نوعها في JSON. تُسمّى المجموعات بمعرّفها (slug) في السوق.
holdsمعcollectionوminوmaxاختياريًا: يملك هذا العدد من NFTs من المجموعة.holds_traitمعcollectionوtraits(من 1 إلى 12، تُكتب كل واحدةType:Value) وmin: يملك هذا العدد من NFTs بأيٍّ من هذه السمات.holds_any_verifiedمعmin: يملك هذا العدد من NFTs من مجموعات موثّقة، أيًّا كانت.holds_non_transferableمعcollectionوmin: يملك هذا العدد من NFTs المرتبطة بالمالك (soulbound) في المجموعة، أي التي لا يمكن بيعها.held_forمعcollectionوdays(من 1 إلى 3,650) وmin: احتفظ بهذا العدد لهذه المدة من الأيام على الأقل.rarity_rankمعcollectionوmax_rank: يملك NFT بهذه الندرة أو أندر.listed_ratioمعcollectionوmax، وهو كسر من صفر إلى واحد: لم يعرض للبيع أكثر من هذه النسبة من NFTs التي يملكها. خطأ لمن لا يملك أيًّا منها.top_holdersمعcollectionوn(من 1 إلى 1,000): من كبار حاملي المجموعة.is_creatorمعcollection: إحدى محافظه أنشأت المجموعة أو أصدرتها.royalty_compliantمعcollection: كل NFT يملكه منها سُكّ أو اشتُري في عملية بيع دُفعت فيها الإتاوة.xrp_balanceمعmin: يملك هذا القدر من XRP على الأقل.token_balanceمعissuerوcurrency(رمز مثلRLUSDأو صيغته الست عشرية من 40 حرفًا) وmin: يملك هذا القدر من التوكن على الأقل.mpt_balanceمعissuance_id(48 حرفًا ست عشريًا) وmin: يملك هذا القدر من التوكن متعدد الأغراض على الأقل.amm_lp_balanceمعamm_accountوmin: يملك هذا العدد على الأقل من توكنات السيولة في المجمّع.wallet_inمعaddresses(من 1 إلى 10,000): إحدى محافظه موجودة في القائمة.
الحدود
- 25 مجموعة متتبَّعة لكل خادم.
- 50 قاعدة أدوار لكل خادم، قاعدة واحدة لكل دور.
- 20 موجز لكل خادم، موجز واحد لكل قناة.
- 10 قناة إحصاءات لكل خادم، يُعاد تسميتها مرة كل 10 دقيقة على الأكثر.
- لقطة واحدة للحاملين لكل خادم كل 10 دقيقة، لما يصل إلى نحو 100,000 حامل.
- 25 تنبيه لكل عضو، و30 رسالة تنبيه له في الساعة كحد أقصى.
- تضم الاستطلاعات من 2 إلى 10 خيارات، وتختار السحوبات من 1 إلى 100 فائزين، ويمكن أن تستمر قوائم السماح والاستطلاعات والسحوبات والفعاليات حتى 90 يومًا.
- يمكن لكل عضو استخدام البوت 20 مرة في الدقيقة. بعد ذلك يطلب منه التمهّل.
الخصوصية والأمان
يشارك التحقق عناوين المحافظ المرتبطة بحسابك على First Ledger مع البوت. لا يرى البوت أي مفتاح، ولن يُطلب منك أبدًا توقيع أي معاملة. أي جهة تطلب منك ذلك ليست هذا البوت.
يطلب البوت فقط الصلاحيات التي يستخدمها، ولا يطلب صلاحية المسؤول أبدًا. ويرفض منح أي دور يحمل صلاحيات إشراف أو إدارة.
يزيل البوت فقط الأدوار التي منحها. أما الدور الذي منحك إياه مشرف يدويًا فيبقى.
لا يمكن للتطبيقات الأخرى رؤية محافظك المرتبطة إلا إذا سمحت لها بالاسم عبر /privacy allow، ويمكنك سحب هذا الإذن في أي وقت.
يحذف /unlink ربطك ويزيل الأدوار التي منحك إياها البوت في كل الخوادم.
حل المشكلات
لم تحصل على دور بعد التحقق: شغّل /refresh. إن لم يظهر بعد، اطلب من مسؤول تشغيل /check-permissions؛ غالبًا ما يكون دور البوت أدنى من دور الحاملين.
الرابط يقول إنه انتهت صلاحيته: كل رابط صالح لعشر دقائق ولمرة واحدة. شغّل /verify مجددًا.
«حساب Discord مختلف»: أكّدت بحساب Discord غير الحساب الذي شغّل الأمر. بدّل الحساب في Discord وشغّل /verify مجددًا.
توقّف أحد الخلاصات: شغّل /admin feed list. تُوقَف الخلاصة التي لم يعد البوت قادرًا على النشر فيها، ويوضح /admin audit السبب.
لم يتغير دور الرصيد: تُحدَّث هذه الأدوار في الفحص الدوري كل ساعة. شغّل /refresh للتحقق الآن.