Discord बॉट
First Ledger बॉट आपके Discord मेंबर्स को उनके पास मौजूद NFTs और टोकन के हिसाब से रोल देता है, आपके कलेक्शन की सेल्स तुरंत पोस्ट करता है, और allowlist, पोल और रैफ़ल चलाता है — XRP Ledger के किसी भी कलेक्शन के लिए।
यह क्या करता है
होल्डर रोल: मेंबर एक बार अपने वॉलेट लिंक करता है, और खरीदने-बेचने पर बॉट रोल देता और हटाता है, आमतौर पर सेल के कुछ सेकंड में।
फ़ीड: आपके कलेक्शन की सेल्स, लिस्टिंग, मिंट और ऑफ़र, आपके चुने चैनलों में पोस्ट होते हैं।
आपके सर्वर के टूल: चैनल नामों में लाइव फ़्लोर और होल्डर संख्या, होल्डर स्नैपशॉट, ऑडिट लॉग और एडमिन के लिए वेब डैशबोर्ड।
कम्युनिटी: allowlist, होल्डर पोल, रैफ़ल, इवेंट और निजी अलर्ट।
यह मुफ़्त है: हर फ़ीचर, हर सर्वर और हर कलेक्शन के लिए।
इसे अपने सर्वर में जोड़ना
First Ledger पर बॉट का पेज खोलें और Add to Discord चुनें। जिस सर्वर में जोड़ रहे हैं, वहाँ आपके पास Manage Server अनुमति होनी चाहिए।
फिर Discord बॉट की माँगी गई छह अनुमतियाँ दिखाता है। सभी पर टिक रहने दें: हर एक का इस्तेमाल होता है।
- Manage Roles होल्डर रोल देता और हटाता है। इसके बिना कोई रोल नहीं दिया जाता।
- Manage Channels से
/setup#verify चैनल बना पाता है, और चैनल नामों में लाइव फ़्लोर और होल्डर संख्या अपडेट रहती है। - View Channels से बॉट उन चैनलों को देख पाता है जहाँ वह पोस्ट करता है।
- Send Messages से फ़ीड, वेरिफ़िकेशन पैनल, पोल, रैफ़ल और इवेंट पोस्ट होते हैं।
- Embed Links हर सेल और लिस्टिंग को NFT की इमेज और कीमत वाले कार्ड के रूप में दिखाता है।
- Attach Files से
/admin snapshot takeहोल्डर लिस्ट CSV फ़ाइल के रूप में भेज पाता है।
यह कभी Administrator, Manage Server या किसी को kick या ban करने की अनुमति नहीं माँगता। बॉट के रोल को इन छह के अलावा कुछ नहीं चाहिए, इसलिए बाकी सब बंद रखें।
Server Settings → Roles में बॉट के रोल को उन सभी रोल से ऊपर खींचें जो आप उससे दिलवाना चाहते हैं। Discord बॉट को सिर्फ़ अपने से नीचे के रोल देने देता है।
/check-permissions चलाएँ। हर लाइन पर हरा टिक होना चाहिए; हर लाल लाइन बताती है कि क्या ठीक करना है।
/admin collection add से अपना कलेक्शन जोड़ें। उसका नाम टाइप करना शुरू करें और लिस्ट से चुनें।
/admin role set से होल्डर रोल बनाएँ: रोल, कलेक्शन और टियर चाहिए तो न्यूनतम और अधिकतम चुनें। आप कोई trait या NFT को कुछ दिनों तक होल्ड करने की शर्त भी रख सकते हैं।
/setup से वेरिफ़िकेशन पैनल पोस्ट करें। यह #verify चैनल बनाता है, या आपका बताया चैनल इस्तेमाल करता है, जिसमें मेंबर्स के क्लिक करने के लिए Verify बटन होता है।
यह सब डैशबोर्ड में भी किया जा सकता है, जो Discord से साइन इन कराता है और आपके मैनेज किए सर्वर दिखाता है।
होल्डर रोल
संख्या के आधार पर: किसी कलेक्शन के कम से कम तय संख्या में NFTs रखें, और चाहें तो अधिकतम सीमा भी तय करें, ताकि Holder, Collector और Whale जैसे टियर बन सकें।
ट्रेट के आधार पर: किसी खास ट्रेट वाला NFT रखें, जैसे Background: Gold।
रेयरिटी या रैंक के आधार पर: कलेक्शन में टॉप N के भीतर रैंक वाला NFT रखें, या उसके टॉप 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। यह स्टेकिंग जैसा काम करता है, पर कुछ भी लॉक नहीं होता।
मेंबरशिप पास: ट्रांसफ़रेबल फ़्लैग के बिना मिंट किया गया NFT सिर्फ़ अपने क्रिएटर को वापस जा सकता है, इसलिए उसे बेचा नहीं जा सकता। ऐसे पास से ऐसा मेंबर रोल बनता है जिसे खरीदा नहीं जा सकता।
लिक्विडिटी प्रोवाइडर: किसी AMM पूल के लिक्विडिटी-पूल टोकन रखें, जैसे आपके प्रोजेक्ट के टोकन का पूल। इसे भी /admin role token से सेट किया जाता है।
रॉयल्टी देने वाले होल्डर: कलेक्शन का हर NFT मिंट से या ऐसी बिक्री में खरीदा गया हो जिसमें क्रिएटर की रॉयल्टी दी गई, मुफ़्त में सौंपा न गया हो।
फ़ीड और सर्वर टूल
/admin feed add से फ़ीड शुरू करें: चैनल चुनें, कौन-सी गतिविधि पोस्ट हो (बिक्री, लिस्टिंग, मिंट, ट्रांसफ़र, बर्न, ऑफ़र), न्यूनतम कीमत, और फ़ुल या कॉम्पैक्ट लेआउट। एक ही लेजर में एक खरीदार की कई खरीदें एक साथ स्वीप के रूप में पोस्ट होती हैं।
कीमतें उसी करेंसी में दिखती हैं जिसमें बिक्री हुई, और पता हो तो साथ में XRP मूल्य भी।
/admin stat add से स्टैट चैनल बनाएँ: ऐसा चैनल जिसका नाम फ़्लोर, होल्डर्स, लिस्टेड संख्या, दिन का वॉल्यूम या किसी रोल वाले सदस्यों की संख्या दिखाता है, हर दस मिनट में रिफ़्रेश होता है।
/admin snapshot take से स्नैपशॉट लें: कलेक्शन के सभी होल्डर्स एक स्प्रेडशीट में। Discord ids चालू होने पर सिर्फ़ आपके सर्वर के सदस्यों के नाम दिखते हैं।
बॉट ने कौन-से रोल दिए या हटाए, और क्यों, यह /admin audit से देखें।
अलाउलिस्ट, पोल, रैफ़ल और इवेंट
/allowlist create एक Join बटन पोस्ट करता है। शर्त पूरी करने वाले सदस्य अपने लिंक किए वॉलेट से जुड़ते हैं; बंद होने पर सूची को स्प्रेडशीट में एक्सपोर्ट करें।
/poll create एक पोल पोस्ट करता है। वोट प्रति सदस्य एक, या रखे गए हर NFT पर एक गिने जा सकते हैं।
/raffle create एक Enter बटन पोस्ट करता है। एंट्री बंद होने के बाद बंद हुए XRP Ledger लेजर के हैश से विजेता चुने जाते हैं, और घोषणा में वह हैश दिखता है, ताकि कोई भी जाँच सके कि ड्रॉ निष्पक्ष था।
/event create एक इवेंट पोस्ट करता है जिसमें सदस्य RSVP कर सकते हैं, चाहें तो सिर्फ़ होल्डर्स के लिए और सीमित क्षमता के साथ।
सदस्य /alerts से DM अलर्ट चालू कर सकते हैं: उनके NFTs पर ऑफ़र, कोई ऑफ़र स्कैम लगे तो चेतावनी, किसी कलेक्शन में बिक्री, या किसी कीमत से कम की लिस्टिंग।
सदस्यों के लिए: वेरिफ़िकेशन
सर्वर में Verify पर क्लिक करें, या /verify चलाएँ। बॉट एक लिंक भेजता है जो सिर्फ़ आपको दिखता है।
लिंक First Ledger खोलता है। हमेशा की तरह अपने वॉलेट से साइन इन करें और Continue चुनें।
Discord आपसे अपना अकाउंट कन्फ़र्म करने को कहता है। कन्फ़र्म करें, और कुछ ही सेकंड में आपके रोल दिख जाएँगे।
बाद में अपने First Ledger अकाउंट में कोई वॉलेट जोड़ा है? /verify फिर से चलाएँ, फिर /refresh।
किसी और का भेजा वेरिफ़िकेशन कभी पूरा न करें। हर लिंक उसी व्यक्ति का है जिसने कमांड चलाई, और सिर्फ़ उसी के लिए काम करता है।
सभी कमांड
एडमिन कमांड के लिए Manage Server अनुमति चाहिए, और Discord उन्हें सिर्फ़ उन्हीं लोगों को दिखाता है जिनके पास यह है। ज़्यादातर जवाब सिर्फ़ आपको दिखते हैं; /floor, /collection और /nft सबके लिए चैनल में पोस्ट होते हैं। किसी भी कलेक्शन विकल्प में कलेक्शन का नाम टाइप करना शुरू करें और सूची से चुनें: पहले आपके सर्वर के कलेक्शन आते हैं, फिर मार्केटप्लेस के।
सभी के लिए
/verify
कोई भीआपको एक लिंक भेजता है, जो सिर्फ़ आपको दिखता है, ताकि आप अपने First Ledger अकाउंट के वॉलेट लिंक कर सकें। लिंक सिर्फ़ आपका है और दस मिनट चलता है। आपको कभी ट्रांज़ैक्शन साइन नहीं करना पड़ता।
/wallets
कोई भीआपके लिंक किए गए वॉलेट दिखाता है, हर एक First Ledger पर उसके पेज से लिंक।
/refresh
कोई भीFirst Ledger से आपके वॉलेट फिर से लोड करता है और तुरंत आपके रोल दोबारा जाँचता है। वॉलेट जोड़ने के बाद, या जब कोई बैलेंस रोल अपडेट न हुआ हो, तब इस्तेमाल करें।
/roles
कोई भीइस सर्वर के होल्डर रोल और हर एक की शर्तें दिखाता है, और आपके पास मौजूद रोल पर टिक लगाता है।
/floor
कोई भीएक कलेक्शन या सर्वर के अधिकतम 15 कलेक्शन के लिए फ़्लोर प्राइस, पिछले दिन का बदलाव और लिस्टेड संख्या पोस्ट करता है।
collection- एक कलेक्शन। सर्वर के सभी कलेक्शन के लिए इसे खाली छोड़ें।
/collection
कोई भीकलेक्शन के आँकड़े पोस्ट करता है: फ़्लोर, सबसे अच्छा ऑफ़र, लिस्टेड, होल्डर, वॉल्यूम, बिक्री, रॉयल्टी और क्या यह वेरिफ़ाइड है।
collectionज़रूरी- कलेक्शन।
/nft
कोई भीNFT का कार्ड पोस्ट करता है: इमेज, मालिक, रैरिटी रैंक, लिस्टेड हो तो कीमत, रॉयल्टी, फ़्लैग और ट्रेट।
idज़रूरी- NFT का
NFTokenID, 64 अक्षर लंबा।
/portfolio
कोई भीआपके लिंक किए गए वॉलेट के NFTs, कलेक्शन के हिसाब से दिखाता है।
/alerts add
कोई भीDM अलर्ट चालू करता है। उसी कलेक्शन के लिए उसी तरह का अलर्ट दोबारा जोड़ने पर उसकी कीमत बदल जाती है। सर्वर सदस्यों से DM खुले रखें, वरना बॉट आप तक नहीं पहुँच पाएगा।
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
Manage ServerVerify पैनल पोस्ट करता है, जिस पर क्लिक करके सदस्य अपने वॉलेट लिंक करते हैं, और उसका चैनल याद रखता है। चैनल न दिया हो तो #verify बनाता है।
channel- पैनल कहाँ पोस्ट करना है। खाली छोड़ने पर बॉट #verify बनाता है, जिसके लिए Manage Channels चाहिए।
/check-permissions
Manage Serverबॉट को चाहिए हर अनुमति, हर रोल नियम (रोल अभी मौजूद है और बॉट के रोल से नीचे है) और हर फ़ीड चैनल की जाँच करता है, सही या गलत के निशान और सुधार के तरीके के साथ। अगर बॉट को Administrator दिया गया है तो चेतावनी देता है, क्योंकि उसकी ज़रूरत नहीं है।
/admin collection add
Manage Serverकिसी कलेक्शन को ट्रैक करता है, ताकि उसकी गतिविधि आपकी फ़ीड तक और उसके होल्डर आपके रोल तक पहुँच सकें। अगर मार्केटप्लेस ने कलेक्शन को फ़्लैग किया है तो चेतावनी देता है।
collectionज़रूरी- कलेक्शन।
/admin collection remove
Manage Serverकिसी कलेक्शन को ट्रैक करना बंद करता है।
collectionज़रूरी- कलेक्शन।
/admin collection list
Manage Serverइस सर्वर द्वारा ट्रैक किए गए कलेक्शन की सूची दिखाता है।
होल्डर रोल
/admin role set
Manage Serverकिसी कलेक्शन के पर्याप्त NFT रखने वाले सदस्यों को रोल देता है। उसी रोल पर दोबारा सेट करने से नियम बदल जाता है। लिंक किए गए सदस्यों की तुरंत दोबारा जाँच होती है।
roleज़रूरी- बॉट के अपने रोल से नीचे का एक साधारण रोल। बॉट @everyone, किसी दूसरे ऐप के मैनेज किए रोल, और एडमिन या मॉडरेशन अनुमति वाले किसी भी रोल को स्वीकार नहीं करता।
collectionज़रूरी- कलेक्शन।
min- रखने के लिए सबसे कम NFTs, 1 से 1,00,000 तक। डिफ़ॉल्ट 1 है।
max- सबसे ज़्यादा, Holder, Collector और Whale जैसे टियर के लिए।
traitType:Value, जैसेBackground:Gold। कई को|से अलग करें, कोई भी एक मान्य होगा।held-days- साथ ही कम से कम इतने दिनों से एक NFT रखा होना ज़रूरी है, 1 से 3,650 तक।
/admin role token
Manage Serverबैलेंस के आधार पर रोल देता है, जो सदस्य के सभी लिंक किए वॉलेट को जोड़कर गिना जाता है: XRP, XRP Ledger पर जारी टोकन, मल्टी-पर्पज़ टोकन, या AMM पूल के लिक्विडिटी टोकन। बैलेंस की जाँच हर घंटे होती है, या जब कोई सदस्य /refresh चलाता है।
roleज़रूरी- बॉट के अपने रोल से नीचे का एक साधारण रोल। बॉट @everyone, किसी दूसरे ऐप के मैनेज किए रोल, और एडमिन या मॉडरेशन अनुमति वाले किसी भी रोल को स्वीकार नहीं करता।
kindज़रूरीxrp, XRP Ledger पर जारी टोकन के लिएtoken, मल्टी-पर्पज़ टोकन के लिएmpt, या AMM पूल के लिक्विडिटी टोकन के लिएlp।minज़रूरी- सबसे कम बैलेंस, शून्य से ज़्यादा।
issuertokenके लिए: जारीकर्ता का पता।currencytokenके लिए: उसका कोड, जैसेRLUSD।issuance-idmptके लिए: 48 अक्षरों वाली issuance id।poollpके लिए: AMM पूल का अकाउंट पता।
/admin role set-json
Manage ServerJSON में लिखे नियम से रोल देता है, जिसमें नीचे दी गई कोई भी शर्तें जोड़ी जा सकती हैं।
roleज़रूरी- बॉट के अपने रोल से नीचे का एक साधारण रोल। बॉट @everyone, किसी दूसरे ऐप के मैनेज किए रोल, और एडमिन या मॉडरेशन अनुमति वाले किसी भी रोल को स्वीकार नहीं करता।
ruleज़रूरी- नियम, अधिकतम 6,000 अक्षर।
/admin role remove
Manage Serverकिसी रोल का नियम हटाता है, और बॉट ने जिन सदस्यों को वह रोल दिया था उनसे उसे हटा देता है।
roleज़रूरी- बॉट के अपने रोल से नीचे का एक साधारण रोल। बॉट @everyone, किसी दूसरे ऐप के मैनेज किए रोल, और एडमिन या मॉडरेशन अनुमति वाले किसी भी रोल को स्वीकार नहीं करता।
/admin role list
Manage Serverहर रोल नियम को शब्दों में दिखाता है, और बताता है कि वह चालू है या नहीं।
फ़ीड और सर्वर टूल
/admin feed add
Manage Serverकिसी चैनल में गतिविधि पोस्ट करता है। बॉट पहले एक टेस्ट मैसेज भेजता है, ताकि पता चले कि वह वहाँ पोस्ट कर सकता है। जिस चैनल में पहले से फ़ीड है, उसमें फ़ीड जोड़ने पर वह अपडेट हो जाती है।
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
Manage Serverफ़ीड को फ़ुल और कॉम्पैक्ट लेआउट के बीच बदलता है।
channelज़रूरी- चैनल।
layoutज़रूरीfullयाcompact।
/admin feed remove
Manage Serverकिसी चैनल की फ़ीड हटाता है।
channelज़रूरी- चैनल।
/admin feed list
Manage Serverआपकी फ़ीड, हर एक क्या पोस्ट करती है, और वह चालू है या नहीं, यह दिखाता है।
/admin stat add
Manage Serverएक लॉक्ड वॉइस चैनल बनाता है जिसके नाम में कोई लाइव संख्या दिखती है, जैसे फ़्लोर प्राइस। संख्या बदलने पर यह अपडेट होता है, ज़्यादा से ज़्यादा हर 10 मिनट में।
kindज़रूरीfloor,holders, दिन के वॉल्यूम के लिएvolume,listed, या किसी रोल वाले सदस्यों की संख्या के लिएrole।collectionroleको छोड़कर हर प्रकार के लिए ज़रूरी।roleroleके लिए ज़रूरी।template- चैनल का नाम, 3 से 90 अक्षर, जिसमें
{floor} {holders} {listed} {supply} {volume24h} {sales24h} {bid} {count}में से कम से कम एक हो।
/admin stat remove
Manage Serverस्टैट चैनल को अपडेट करना बंद करता है। चैनल बना रहता है।
channelज़रूरी- चैनल।
/admin snapshot take
Manage Serverकिसी कलेक्शन के सभी होल्डर की CSV फ़ाइल आपको भेजता है: पता, यूज़रनेम, उनके पास कितने हैं और उनका हिस्सा।
collectionज़रूरी- कलेक्शन।
min- केवल वे होल्डर जिनके पास कम से कम इतने हों।
with-discord- Discord id कॉलम जोड़ें। केवल इस सर्वर के लिंक किए गए सदस्यों के नाम दिखेंगे।
/admin snapshot list
Manage Serverहाल के स्नैपशॉट की सूची दिखाता है।
/admin audit
Manage Serverपिछले 25 रोल और नियम बदलाव दिखाता है, और हर एक क्यों हुआ।
user- केवल इस सदस्य के बदलाव।
/admin reconcile
Manage Serverसभी लिंक किए गए सदस्यों की अभी दोबारा जाँच करता है। बदलाव /admin audit में दिखते हैं।
अलाउलिस्ट, पोल, रैफ़ल और इवेंट
/allowlist create
Manage ServerJoin बटन के साथ एक allowlist पोस्ट करता है। योग्य सदस्य अपने पहले लिंक किए वॉलेट से जुड़ता है।
nameज़रूरी- इसका नाम, अधिकतम 60 अक्षर, सर्वर की बाकी allowlists से अलग।
max-entries- अधिकतम कितने लोग जुड़ सकते हैं।
closes-in-hours- इतने घंटों बाद बंद करें, अधिकतम 2,160 (90 दिन)।
eligibility-collection- केवल इस कलेक्शन के होल्डर हिस्सा ले सकते हैं। लिंक किए गए वॉलेट वाले सभी के लिए इसे खाली छोड़ें।
eligibility-min- उनके पास कितने होने चाहिए। डिफ़ॉल्ट 1 है।
rule-json- या JSON में कोई भी नियम, जैसे
/admin role set-jsonके लिए।
/allowlist close
Manage Serverकिसी allowlist को अभी बंद करता है।
nameज़रूरी- इसका नाम, अधिकतम 60 अक्षर, सर्वर की बाकी allowlists से अलग।
/allowlist export
Manage Serverकिसी allowlist की एंट्री CSV फ़ाइल के रूप में आपको भेजता है।
nameज़रूरी- इसका नाम, अधिकतम 60 अक्षर, सर्वर की बाकी allowlists से अलग।
/allowlist list
Manage Serverसर्वर की allowlists, उनकी एंट्री और बंद होने का समय दिखाता है।
/poll create
Manage Serverहर विकल्प के लिए एक बटन के साथ पोल पोस्ट करता है। सदस्य पोल बंद होने तक अपना वोट बदल सकते हैं।
questionज़रूरी- अधिकतम 200 अक्षर।
optionsज़रूरी|से अलग किए गए 2 से 10 विकल्प, हर एक अधिकतम 80 अक्षर।duration-hoursज़रूरी- यह कितने घंटे चलेगा, अधिकतम 2,160 (90 दिन)।
weightingmemberयानी हर सदस्य का एक वोट या एंट्री, याnftयानी हर रखे गए NFT पर एक।weight-collectionnftके लिए कौन-सा कलेक्शन गिना जाए।eligibility-collection- केवल इस कलेक्शन के होल्डर हिस्सा ले सकते हैं। लिंक किए गए वॉलेट वाले सभी के लिए इसे खाली छोड़ें।
eligibility-min- उनके पास कितने होने चाहिए। डिफ़ॉल्ट 1 है।
/poll close
Manage Serverपोल को अभी बंद करता है और नतीजे पोस्ट करता है।
idज़रूरी- पोस्ट के फ़ुटर में दी गई id।
/raffle create
Manage ServerEnter बटन के साथ रैफ़ल पोस्ट करता है।
prizeज़रूरी- अधिकतम 200 अक्षर।
winnersज़रूरी- 1 से 100 तक।
duration-hoursज़रूरी- यह कितने घंटे चलेगा, अधिकतम 2,160 (90 दिन)।
weightingmemberयानी हर सदस्य का एक वोट या एंट्री, याnftयानी हर रखे गए NFT पर एक।weight-collectionnftके लिए कौन-सा कलेक्शन गिना जाए।eligibility-collection- केवल इस कलेक्शन के होल्डर हिस्सा ले सकते हैं। लिंक किए गए वॉलेट वाले सभी के लिए इसे खाली छोड़ें।
eligibility-min- उनके पास कितने होने चाहिए। डिफ़ॉल्ट 1 है।
/raffle draw
Manage Serverएंट्री बंद करता है और अभी विजेता चुनता है। ड्रॉ एक validated ledger के हैश से seed होता है, और घोषणा में यह दिखता है, ताकि कोई भी इसे दोबारा जाँच सके।
idज़रूरी- पोस्ट के फ़ुटर में दी गई id।
/event create
Manage Serverएक इवेंट पोस्ट करता है, जिसमें सदस्य उसके शुरू होने या भर जाने तक RSVP कर सकते हैं।
titleज़रूरी- अधिकतम 100 अक्षर।
startsज़रूरी- अभी से कितने घंटे, जैसे
48, या टाइम ज़ोन के साथ तारीख और समय, जैसे2026-12-01T18:00Z। 90 दिनों के भीतर। description- अधिकतम 1,000 अक्षर।
location- अधिकतम 200 अक्षर।
capacity- ज़्यादा से ज़्यादा कितने लोग RSVP कर सकते हैं।
eligibility-collection- केवल इस कलेक्शन के होल्डर हिस्सा ले सकते हैं। लिंक किए गए वॉलेट वाले सभी के लिए इसे खाली छोड़ें।
eligibility-min- उनके पास कितने होने चाहिए। डिफ़ॉल्ट 1 है।
/event cancel
Manage Serverइवेंट रद्द करता है और उसकी पोस्ट अपडेट करता है।
idज़रूरी- पोस्ट के फ़ुटर में दी गई id।
/event attendees
Manage Serverदिखाता है कि कौन आ रहा है।
idज़रूरी- पोस्ट के फ़ुटर में दी गई id।
एडवांस्ड: JSON में नियम
/admin role set-json JSON में लिखा नियम लेता है, उन सबके लिए जो /admin role set और /admin role token नहीं बना सकते। डैशबोर्ड का एडवांस्ड एडिटर आपके लिए यही नियम लिखता है।
शर्तों को and या or से जोड़ें, हर एक में 1 से 20 नियम, और not से किसी को उलटें। एक नियम 6 स्तर तक नेस्ट हो सकता है और इसमें अधिकतम 30 शर्तें हो सकती हैं।
हर शर्त सदस्य के सभी लिंक किए वॉलेट पर एक साथ जाँची जाती है, और जिसके पास कोई लिंक किया वॉलेट नहीं, उसके लिए गलत होती है। अगर बॉट कोई शर्त नहीं जाँच पाता, जैसे जब लेजर तक पहुँच न हो, तो सदस्य के मौजूदा रोल बने रहते हैं।
शर्तें, उनके JSON टाइप के अनुसार। कलेक्शन उनके मार्केटप्लेस स्लग से पहचाने जाते हैं।
collection,minऔर वैकल्पिकmaxके साथholds: कलेक्शन के उतने NFTs रखता है।collection,traits(1 से 12, हर एकType:Valueके रूप में लिखा) औरminके साथholds_trait: इनमें से किसी भी trait वाले उतने NFTs रखता है।minके साथholds_any_verified: वेरिफ़ाइड कलेक्शन के उतने NFTs रखता है, कलेक्शन कोई भी हो।collectionऔरminके साथholds_non_transferable: कलेक्शन के उतने soulbound NFTs रखता है, यानी जो बेचे नहीं जा सकते।collection,days(1 से 3,650) औरminके साथheld_for: उतने NFTs कम से कम उतने दिनों से रखे हुए है।collectionऔरmax_rankके साथrarity_rank: उस रैंक जितना या उससे ज़्यादा rare NFT रखता है।collectionऔरmax(शून्य से एक के बीच का अंश) के साथlisted_ratio: अपने NFTs का उससे ज़्यादा हिस्सा लिस्ट नहीं किया है। जिसके पास कोई NFT नहीं, उसके लिए false।collectionऔरn(1 से 1,000) के साथtop_holders: कलेक्शन के टॉप होल्डर्स में से एक है।collectionके साथis_creator: उनके किसी वॉलेट ने कलेक्शन बनाया या जारी किया।collectionके साथroyalty_compliant: उसके हर NFT को उन्होंने mint किया या ऐसी बिक्री में खरीदा जिसमें रॉयल्टी दी गई।minके साथxrp_balance: कम से कम उतना XRP रखता है।issuer,currency(जैसेRLUSDकोड, या उसका 40-अक्षर वाला hex रूप) औरminके साथtoken_balance: कम से कम उतना टोकन रखता है।issuance_id(48 hex अक्षर) औरminके साथmpt_balance: कम से कम उतना multi-purpose token रखता है।amm_accountऔरminके साथamm_lp_balance: पूल के कम से कम उतने liquidity tokens रखता है।addresses(1 से 10,000) के साथwallet_in: उनका कोई वॉलेट लिस्ट में है।
सीमाएँ
- हर सर्वर पर 25 ट्रैक किए गए कलेक्शन।
- हर सर्वर पर 50 रोल नियम, हर रोल के लिए एक।
- हर सर्वर पर 20 फ़ीड, हर चैनल के लिए एक।
- हर सर्वर पर 10 स्टैट चैनल, जिनका नाम ज़्यादा से ज़्यादा हर 10 मिनट में बदलता है।
- हर सर्वर पर हर 10 मिनट में एक होल्डर स्नैपशॉट, लगभग 1,00,000 होल्डर्स तक।
- हर सदस्य के लिए 25 अलर्ट, और उन्हें एक घंटे में ज़्यादा से ज़्यादा 30 अलर्ट मैसेज।
- पोल में 2 से 10 विकल्प होते हैं; रैफ़ल में 1 से 100 विजेता चुने जाते हैं; allowlist, पोल, रैफ़ल और इवेंट 90 दिनों तक चल सकते हैं।
- हर सदस्य बॉट को एक मिनट में 20 बार इस्तेमाल कर सकता है। उससे ज़्यादा होने पर बॉट धीरे चलने को कहता है।
प्राइवेसी और सुरक्षा
वेरिफ़ाई करने पर आपके First Ledger अकाउंट के वॉलेट के पते बॉट के साथ शेयर होते हैं। बॉट कभी कोई key नहीं देखता, और आपसे कभी ट्रांज़ैक्शन साइन करने को नहीं कहा जाता। जो ऐसा करने को कहे, वह यह बॉट नहीं है।
बॉट सिर्फ़ वही अनुमतियाँ माँगता है जिनका वह इस्तेमाल करता है, Administrator कभी नहीं। वह मॉडरेशन या एडमिन अनुमतियों वाला रोल देने से मना कर देता है।
यह सिर्फ़ वही रोल हटाता है जो इसने दिए हैं। मॉडरेटर का हाथ से दिया रोल बना रहता है।
दूसरे ऐप आपके लिंक किए गए वॉलेट तभी देख सकते हैं जब आप /privacy allow से उन्हें नाम लेकर अनुमति दें, और आप यह अनुमति कभी भी वापस ले सकते हैं।
/unlink आपका लिंक मिटा देता है और हर सर्वर में बॉट के दिए रोल हटा देता है।
समस्या का समाधान
वेरिफ़ाई करने के बाद रोल नहीं मिला: /refresh चलाएँ। फिर भी न दिखे, तो किसी एडमिन से /check-permissions चलाने को कहें; शायद बॉट का रोल होल्डर रोल से नीचे है।
लिंक एक्सपायर बता रहा है: हर लिंक दस मिनट चलता है और एक ही बार काम करता है। /verify फिर से चलाएँ।
“कोई दूसरा Discord अकाउंट”: आपने कमांड चलाने वाले अकाउंट के बजाय किसी दूसरे Discord अकाउंट से पुष्टि की। Discord में अकाउंट बदलें और /verify फिर से चलाएँ।
कोई फ़ीड बंद हो गई: /admin feed list चलाएँ। जिस फ़ीड में बॉट पोस्ट नहीं कर पाता, वह बंद हो जाती है, और /admin audit वजह बताता है।
बैलेंस रोल नहीं बदला: ये हर घंटे की दोबारा जाँच में अपडेट होते हैं। अभी जाँचने के लिए /refresh चलाएँ।