First Ledger NFT
إنشاءجارٍ التحقق من تسجيل دخولك

بوت 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.
trait
Type: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. يُتخطّى أيضًا النشاط بلا سعر، مثل التحويل.
layout
full أو 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 أيام).
weighting
member صوت أو مشاركة واحدة لكل عضو، أو 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 أيام).
weighting
member صوت أو مشاركة واحدة لكل عضو، أو 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 للتحقق الآن.