Το bot για Discord
Το bot του First Ledger δίνει στα μέλη του Discord σας ρόλους για τα NFT και τα tokens που κατέχουν, δημοσιεύει τις πωλήσεις της συλλογής σας τη στιγμή που γίνονται και διαχειρίζεται allowlists, ψηφοφορίες και κληρώσεις — για κάθε συλλογή στο XRP Ledger.
Τι κάνει
Ρόλοι κατόχων: το μέλος συνδέει τα wallet του μία φορά και το bot δίνει και αφαιρεί ρόλους καθώς αγοράζει και πουλάει, συνήθως μέσα σε δευτερόλεπτα από την πώληση.
Ροές: πωλήσεις, καταχωρίσεις, mint και προσφορές για τις συλλογές σας, στα κανάλια που επιλέγετε.
Εργαλεία για τον server σας: ζωντανή τιμή floor και αριθμός κατόχων στα ονόματα καναλιών, στιγμιότυπα κατόχων, αρχείο ελέγχου και web dashboard για διαχειριστές.
Κοινότητα: allowlists, ψηφοφορίες κατόχων, κληρώσεις, εκδηλώσεις και προσωπικές ειδοποιήσεις.
Είναι δωρεάν: κάθε λειτουργία, για κάθε server και κάθε συλλογή.
Προσθήκη στον server σας
Ανοίξτε τη σελίδα του bot στο First Ledger και επιλέξτε Προσθήκη στο Discord. Χρειάζεστε την άδεια Διαχείριση server στον server όπου το προσθέτετε.
Το Discord δείχνει μετά τις έξι άδειες που ζητά το bot. Αφήστε τις όλες επιλεγμένες: χρησιμοποιείται η καθεμία.
- Η Διαχείριση ρόλων δίνει και αφαιρεί ρόλους κατόχων. Χωρίς αυτήν, δεν δίνονται ρόλοι.
- Η Διαχείριση καναλιών επιτρέπει στο
/setupνα δημιουργήσει το κανάλι #verify και κρατά ενημερωμένα τη ζωντανή τιμή floor και τον αριθμό κατόχων στα ονόματα καναλιών. - Η Προβολή καναλιών επιτρέπει στο bot να βλέπει τα κανάλια όπου δημοσιεύει.
- Η Αποστολή μηνυμάτων δημοσιεύει ροές, το πάνελ επαλήθευσης, ψηφοφορίες, κληρώσεις και εκδηλώσεις.
- Η Ενσωμάτωση συνδέσμων δείχνει κάθε πώληση και καταχώριση ως κάρτα με την εικόνα και την τιμή του NFT.
- Η Επισύναψη αρχείων επιτρέπει στο
/admin snapshot takeνα στέλνει τη λίστα κατόχων ως αρχείο CSV.
Δεν ζητά ποτέ Διαχειριστή, Διαχείριση server ή δικαίωμα να αποβάλλει ή να αποκλείει κάποιον. Ο ρόλος του bot δεν χρειάζεται τίποτα πέρα από αυτές τις έξι, οπότε αφήστε όλα τα άλλα απενεργοποιημένα.
Στις Ρυθμίσεις server → Ρόλοι, σύρετε τον ρόλο του bot πάνω από κάθε ρόλο που θέλετε να δίνει. Το Discord επιτρέπει σε ένα bot να δίνει μόνο ρόλους κάτω από τον δικό του.
Εκτελέστε το /check-permissions. Κάθε γραμμή πρέπει να έχει πράσινο τικ· κάθε κόκκινη λέει τι να διορθώσετε.
Προσθέστε τη συλλογή σας με το /admin collection add. Αρχίστε να πληκτρολογείτε το όνομά της και επιλέξτε τη από τη λίστα.
Δημιουργήστε ρόλο κατόχου με το /admin role set: επιλέξτε τον ρόλο, τη συλλογή και, αν θέλετε βαθμίδες, ελάχιστο και μέγιστο. Μπορείτε επίσης να απαιτήσετε ένα χαρακτηριστικό ή να έχει διακρατηθεί το NFT για κάποιες ημέρες.
Δημοσιεύστε το πάνελ επαλήθευσης με το /setup. Δημιουργεί κανάλι #verify, ή χρησιμοποιεί αυτό που ορίζετε, με κουμπί Επαλήθευση για τα μέλη.
Όλα αυτά γίνονται και από το dashboard, όπου συνδέεστε με το Discord και βλέπετε τους servers που διαχειρίζεστε.
Ρόλοι κατόχων
Κατά πλήθος: κατοχή τουλάχιστον ενός αριθμού NFTs από μια συλλογή, και προαιρετικά το πολύ ενός αριθμού, ώστε να έχετε βαθμίδες Holder, Collector και Whale.
Κατά χαρακτηριστικό: κατοχή NFT με συγκεκριμένο χαρακτηριστικό, π.χ. Background: Gold.
Κατά σπανιότητα ή κατάταξη: κατοχή NFT στα top N της συλλογής ή θέση στους top N κατόχους της.
Δημιουργός: το πορτοφόλι του δημιουργού ή του εκδότη της συλλογής.
Κατά υπόλοιπο: κατοχή ποσού XRP, token που εκδόθηκε στο XRP Ledger (μαζί με tokens που ξεκίνησαν στο First Ledger) ή multi-purpose token. Ρυθμίστε τα με /admin role token: επιλέξτε τον ρόλο, τι θα ελέγχεται και το ελάχιστο, και το bot αθροίζει το υπόλοιπο σε όλα τα συνδεδεμένα πορτοφόλια του μέλους.
Κατά πορτοφόλι: μια λίστα διευθύνσεων που επικολλάτε.
Συνδυασμός: οποιοδήποτε από αυτά με AND, OR και NOT, στον προηγμένο επεξεργαστή του dashboard — π.χ. κατέχει τρία ή περισσότερα AND κατέχει εκατό XRP.
Όλα τα πορτοφόλια στον λογαριασμό First Ledger ενός μέλους μετράνε μαζί, οπότε η μεταφορά NFT μεταξύ των δικών του πορτοφολιών δεν του αφαιρεί ποτέ ρόλο.
Οι ρόλοι βάσει NFT ενημερώνονται σε δευτερόλεπτα μετά από πώληση. Οι ρόλοι βάσει υπολοίπου ενημερώνονται στον ωριαίο έλεγχο ή αμέσως όταν το μέλος εκτελέσει /refresh.
Ρόλοι που γίνονται εφικτοί μόνο στο XRP Ledger
Τα NFT σε αγγελία μετράνε κανονικά. Στο XRP Ledger ένα NFT που βάζετε προς πώληση μένει στο πορτοφόλι σας μέχρι να το αγοράσει κάποιος, οπότε η αγγελία δεν αφαιρεί ποτέ τον ρόλο. Αν θέλετε να ανταμείψετε κατόχους που δεν πουλάνε, υπάρχει κανόνας για το ποσοστό των NFT τους σε αγγελία.
Διάρκεια κατοχής: NFT που κατέχεται για τουλάχιστον έναν αριθμό ημερών. Λειτουργεί σαν staking, χωρίς τίποτα κλειδωμένο.
Κάρτες μέλους: ένα NFT που έγινε mint χωρίς τη σημαία μεταβιβασιμότητας μπορεί να επιστρέψει μόνο στον δημιουργό του, άρα δεν πωλείται. Μια τέτοια κάρτα δίνει ρόλο μέλους που δεν αγοράζεται.
Πάροχοι ρευστότητας: κατοχή tokens ρευστότητας ενός AMM pool, π.χ. pool για το token του project σας. Ρυθμίζεται επίσης με /admin role token.
Κάτοχοι που πλήρωσαν royalties: κάθε NFT της συλλογής αποκτήθηκε με mint ή σε πώληση που πλήρωσε το royalty του δημιουργού, όχι δωρεάν.
Feeds και εργαλεία server
Ξεκινήστε ένα feed με /admin feed add: επιλέξτε κανάλι, τύπους δραστηριότητας (πωλήσεις, αγγελίες, mints, μεταφορές, burns, προσφορές), ελάχιστη τιμή και πλήρη ή συμπαγή διάταξη. Πολλές αγορές ενός αγοραστή στο ίδιο ledger δημοσιεύονται μαζί ως sweep.
Οι τιμές εμφανίζονται στο νόμισμα της πώλησης, με την αξία σε XRP δίπλα όταν είναι γνωστή.
Δημιουργήστε κανάλι στατιστικών με /admin stat add: κανάλι με όνομα που δείχνει floor, κατόχους, πλήθος αγγελιών, ημερήσιο όγκο ή αριθμό μελών με ρόλο, με ανανέωση κάθε δέκα λεπτά.
Πάρτε snapshot με /admin snapshot take: όλοι οι κάτοχοι μιας συλλογής σε υπολογιστικό φύλλο. Με ενεργά τα Discord ids, εμφανίζονται ονόματα μόνο για μέλη του δικού σας server.
Δείτε κάθε ρόλο που έδωσε ή αφαίρεσε το bot, και γιατί, με /admin audit.
Allowlists, ψηφοφορίες, κληρώσεις και εκδηλώσεις
Το /allowlist create δημοσιεύει κουμπί συμμετοχής. Τα μέλη που πληρούν την προϋπόθεση μπαίνουν με το συνδεδεμένο πορτοφόλι τους· εξαγάγετε τη λίστα σε υπολογιστικό φύλλο όταν κλείσει.
Το /poll create δημοσιεύει ψηφοφορία. Οι ψήφοι μετράνε μία ανά μέλος ή μία ανά NFT που κατέχει.
Η εντολή /raffle create δημοσιεύει ένα κουμπί Συμμετοχής. Οι νικητές κληρώνονται από το hash ενός ledger του XRP Ledger που έκλεισε μετά τη λήξη των συμμετοχών, και η ανακοίνωση το εμφανίζει, ώστε όλοι να ελέγξουν ότι η κλήρωση ήταν δίκαιη.
Η εντολή /event create δημοσιεύει μια εκδήλωση στην οποία τα μέλη δηλώνουν συμμετοχή, προαιρετικά μόνο για κατόχους και με όριο θέσεων.
Τα μέλη μπορούν να ενεργοποιήσουν ειδοποιήσεις σε DM με /alerts: προσφορές στα NFT τους, προειδοποίηση όταν μια προσφορά μοιάζει με απάτη, πωλήσεις σε μια συλλογή ή καταχωρίσεις κάτω από μια τιμή.
Για μέλη: επαλήθευση
Πατήστε Επαλήθευση στον server ή εκτελέστε /verify. Το bot απαντά με έναν σύνδεσμο που βλέπετε μόνο εσείς.
Ο σύνδεσμος ανοίγει το First Ledger. Συνδεθείτε με το πορτοφόλι σας όπως συνήθως και επιλέξτε Συνέχεια.
Το Discord σάς ζητά να επιβεβαιώσετε τον λογαριασμό σας. Επιβεβαιώστε τον και οι ρόλοι σας θα εμφανιστούν σε λίγα δευτερόλεπτα.
Προσθέσατε στο μεταξύ πορτοφόλι στον λογαριασμό σας στο First Ledger; Εκτελέστε ξανά /verify και μετά /refresh.
Μην ολοκληρώνετε ποτέ επαλήθευση που σας έστειλε κάποιος άλλος. Κάθε σύνδεσμος ανήκει σε όποιον εκτέλεσε την εντολή και λειτουργεί μόνο για εκείνον.
Όλες οι εντολές
Οι εντολές διαχειριστή απαιτούν την άδεια Διαχείριση server και το Discord τις εμφανίζει μόνο σε όσους την έχουν. Οι περισσότερες απαντήσεις είναι ορατές μόνο σε εσάς· οι /floor, /collection και /nft δημοσιεύονται στο κανάλι για όλους. Σε κάθε επιλογή συλλογής, πληκτρολογήστε το όνομα της συλλογής και διαλέξτε την από τη λίστα: πρώτα εμφανίζονται οι συλλογές του server σας, μετά του marketplace.
Για όλους
/verify
ΌλοιΣου στέλνει έναν σύνδεσμο, ορατό μόνο σε σένα, για να συνδέσεις τα πορτοφόλια του λογαριασμού σου στο First Ledger. Ο σύνδεσμος είναι μόνο δικός σου και ισχύει δέκα λεπτά. Δεν υπογράφεις ποτέ συναλλαγή.
/wallets
ΌλοιΔείχνει τα συνδεδεμένα πορτοφόλια σου, το καθένα με σύνδεσμο στη σελίδα του στο First Ledger.
/refresh
ΌλοιΞαναφορτώνει τα πορτοφόλια σου από το First Ledger και ελέγχει αμέσως ξανά τους ρόλους σου. Χρησιμοποίησέ το αφού προσθέσεις πορτοφόλι ή όταν ένας ρόλος υπολοίπου δεν έχει ενημερωθεί.
/roles
ΌλοιΔείχνει τους ρόλους κατόχων αυτού του server και τι απαιτεί ο καθένας, τσεκάροντας όσους έχεις.
/floor
ΌλοιΔημοσιεύει την τιμή floor, τη μεταβολή της το τελευταίο 24ωρο και τον αριθμό των listings, για μία συλλογή ή έως 15 του server.
collection- Μία συλλογή. Άφησέ το κενό για όλες του server.
/collection
ΌλοιΔημοσιεύει τα στατιστικά μιας συλλογής: floor, καλύτερη προσφορά, listings, κάτοχοι, όγκος, πωλήσεις, royalty και αν είναι επαληθευμένη.
collectionυποχρεωτικό- Η συλλογή.
/nft
ΌλοιΔημοσιεύει την κάρτα ενός NFT: εικόνα, κάτοχος, κατάταξη σπανιότητας, τιμή αν είναι σε πώληση, royalty, flags και χαρακτηριστικά.
idυποχρεωτικό- Το
NFTokenIDτου NFT, μήκους 64 χαρακτήρων.
/portfolio
ΌλοιΔείχνει τα NFTs σου από όλα τα συνδεδεμένα πορτοφόλια, ανά συλλογή.
/alerts add
ΌλοιΕνεργοποιεί μια ειδοποίηση με DM. Αν προσθέσεις ξανά το ίδιο είδος για την ίδια συλλογή, αντικαθίσταται η τιμή της. Άφησε ανοιχτά τα DM από μέλη του server, αλλιώς το bot δεν μπορεί να σε βρει.
kindυποχρεωτικόoffer_receivedγια προσφορές στα NFT σου,suspicious_offerγια προειδοποίηση όταν μια προσφορά μοιάζει με απάτη,collection_saleγια πωλήσεις σε μια συλλογή ήlisting_belowγια καταχωρίσεις κάτω από μια τιμή.collection- Απαιτείται για ειδοποιήσεις πωλήσεων και καταχωρίσεων.
price- Σε XRP: η μικρότερη πώληση για την οποία θα ειδοποιείσαι ή, για καταχωρίσεις, η μέγιστη τιμή.
/alerts remove
ΌλοιΑπενεργοποιεί μια ειδοποίηση.
kindυποχρεωτικόoffer_receivedγια προσφορές στα NFT σου,suspicious_offerγια προειδοποίηση όταν μια προσφορά μοιάζει με απάτη,collection_saleγια πωλήσεις σε μια συλλογή ήlisting_belowγια καταχωρίσεις κάτω από μια τιμή.collection- Απαιτείται για ειδοποιήσεις πωλήσεων και καταχωρίσεων.
/alerts list
ΌλοιΔείχνει τις ειδοποιήσεις σου.
/privacy allow
ΌλοιΕπιτρέπει σε μια συνεργαζόμενη εφαρμογή να βλέπει τα συνδεδεμένα πορτοφόλια σου.
partnerυποχρεωτικό- Το όνομα της συνεργαζόμενης εφαρμογής.
/privacy revoke
ΌλοιΣταματά την κοινοποίηση σε μια συνεργαζόμενη εφαρμογή.
partnerυποχρεωτικό- Το όνομα της συνεργαζόμενης εφαρμογής.
/privacy status
ΌλοιΕμφανίζει τις συνεργαζόμενες εφαρμογές με τις οποίες κάνεις κοινοποίηση.
/unlink
ΌλοιΑφαιρεί τη σύνδεσή σου και τους ρόλους που σου έδωσε το bot σε κάθε server που μοιράζεστε.
/help
ΌλοιΔείχνει αν είσαι συνδεδεμένος και έναν σύντομο οδηγό για αυτές τις εντολές.
Ρύθμιση
/setup
Διαχείριση serverΔημοσιεύει τον πίνακα Επαλήθευσης, όπου τα μέλη πατούν για να συνδέσουν τα πορτοφόλια τους, και θυμάται το κανάλι του. Χωρίς κανάλι, δημιουργεί το #verify.
channel- Πού θα δημοσιευτεί το πάνελ. Αν το αφήσεις κενό, το bot δημιουργεί το #verify, που απαιτεί Manage Channels.
/check-permissions
Διαχείριση serverΕλέγχει κάθε άδεια που χρειάζεται το bot, κάθε κανόνα ρόλου (ότι ο ρόλος υπάρχει ακόμα και βρίσκεται κάτω από τον ρόλο του bot) και κάθε κανάλι ροής, με ✓ ή ✗ και τι πρέπει να διορθωθεί. Προειδοποιεί αν το bot έχει Administrator, που δεν το χρειάζεται.
/admin collection add
Διαχείριση serverΠαρακολουθεί μια συλλογή, ώστε η δραστηριότητά της να φτάνει στις ροές σου και οι κάτοχοί της στους ρόλους σου. Προειδοποιεί αν το marketplace έχει επισημάνει τη συλλογή.
collectionυποχρεωτικό- Η συλλογή.
/admin collection remove
Διαχείριση serverΣταματά την παρακολούθηση μιας συλλογής.
collectionυποχρεωτικό- Η συλλογή.
/admin collection list
Διαχείριση serverΕμφανίζει τις συλλογές που παρακολουθεί αυτός ο server.
Ρόλοι κατόχων
/admin role set
Διαχείριση serverΔίνει έναν ρόλο σε μέλη που κατέχουν αρκετά από μια συλλογή. Αν τον ορίσεις ξανά στον ίδιο ρόλο, ο κανόνας αντικαθίσταται. Τα συνδεδεμένα μέλη ελέγχονται ξανά αμέσως.
roleυποχρεωτικό- Ένας απλός ρόλος κάτω από τον ρόλο του bot. Το bot απορρίπτει το @everyone, ρόλους που διαχειρίζεται άλλη εφαρμογή και ρόλους με δικαιώματα διαχειριστή ή συντονισμού.
collectionυποχρεωτικό- Η συλλογή.
min- Ο ελάχιστος αριθμός NFT που πρέπει να κατέχει κάποιος, από 1 έως 100.000. Προεπιλογή: 1.
max- Ο μέγιστος, για βαθμίδες όπως Holder, Collector και Whale.
traitType:Value, π.χ.Background:Gold. Διαχώρισε πολλά με|και αρκεί οποιοδήποτε.held-days- Απαιτεί επίσης ένα NFT να διακρατείται για τουλάχιστον τόσες ημέρες, από 1 έως 3.650.
/admin role token
Διαχείριση serverΔίνει έναν ρόλο βάσει υπολοίπου, αθροισμένου σε όλα τα συνδεδεμένα πορτοφόλια ενός μέλους: XRP, token εκδομένο στο XRP Ledger, token πολλαπλών χρήσεων ή tokens ρευστότητας ενός AMM pool. Τα υπόλοιπα ελέγχονται ξανά κάθε ώρα ή όταν ένα μέλος εκτελεί /refresh.
roleυποχρεωτικό- Ένας απλός ρόλος κάτω από τον ρόλο του bot. Το bot απορρίπτει το @everyone, ρόλους που διαχειρίζεται άλλη εφαρμογή και ρόλους με δικαιώματα διαχειριστή ή συντονισμού.
kindυποχρεωτικόxrp,tokenγια token που εκδόθηκε στο XRP Ledger,mptγια multi-purpose token ήlpγια τα liquidity tokens ενός AMM pool.minυποχρεωτικό- Το ελάχιστο υπόλοιπο, πάνω από μηδέν.
issuer- Για
token: η διεύθυνση του εκδότη. currency- Για
token: ο κωδικός του, π.χ.RLUSD. issuance-id- Για
mpt: το αναγνωριστικό έκδοσης με 48 χαρακτήρες. pool- Για
lp: η διεύθυνση λογαριασμού του AMM pool.
/admin role set-json
Διαχείριση serverΔίνει έναν ρόλο βάσει κανόνα γραμμένου σε JSON, που συνδυάζει οποιαδήποτε από τις παρακάτω συνθήκες.
roleυποχρεωτικό- Ένας απλός ρόλος κάτω από τον ρόλο του bot. Το bot απορρίπτει το @everyone, ρόλους που διαχειρίζεται άλλη εφαρμογή και ρόλους με δικαιώματα διαχειριστή ή συντονισμού.
ruleυποχρεωτικό- Ο κανόνας, έως 6.000 χαρακτήρες.
/admin role remove
Διαχείριση serverΔιαγράφει τον κανόνα ενός ρόλου και αφαιρεί τον ρόλο από τα μέλη στα οποία τον έδωσε το bot.
roleυποχρεωτικό- Ένας απλός ρόλος κάτω από τον ρόλο του bot. Το bot απορρίπτει το @everyone, ρόλους που διαχειρίζεται άλλη εφαρμογή και ρόλους με δικαιώματα διαχειριστή ή συντονισμού.
/admin role list
Διαχείριση serverΕμφανίζει κάθε κανόνα ρόλου με λόγια και αν είναι ενεργός.
Ροές και εργαλεία server
/admin feed add
Διαχείριση serverΔημοσιεύει δραστηριότητα σε ένα κανάλι. Το bot στέλνει πρώτα ένα δοκιμαστικό μήνυμα, για να ξέρεις ότι μπορεί να δημοσιεύει εκεί. Αν προσθέσεις ροή σε κανάλι που ήδη έχει, αυτή ενημερώνεται.
channelυποχρεωτικό- Ένα κανάλι κειμένου ή ανακοινώσεων.
kinds- Χωρισμένα με κόμμα, από
sale,list,delist,mint,transfer,burn,buy_offer_created,buy_offer_cancelled,offer_expiredκαιuri_modified. Προεπιλογή:sale. collection- Μία συλλογή. Άφησέ το κενό για όλες του server.
min-price- Παράλειψη ό,τι είναι κάτω από αυτά τα XRP. Δραστηριότητα χωρίς τιμή, όπως μια μεταφορά, παραλείπεται επίσης.
layoutfullήcompact.
/admin feed layout
Διαχείριση serverΑλλάζει τη διάταξη μιας ροής μεταξύ πλήρους και συμπαγούς.
channelυποχρεωτικό- Το κανάλι.
layoutυποχρεωτικόfullήcompact.
/admin feed remove
Διαχείριση serverΔιαγράφει τη ροή ενός καναλιού.
channelυποχρεωτικό- Το κανάλι.
/admin feed list
Διαχείριση serverΕμφανίζει τις ροές σου, τι δημοσιεύει η καθεμία και αν είναι ενεργή.
/admin stat add
Διαχείριση serverΔημιουργεί ένα κλειδωμένο φωνητικό κανάλι με όνομα που δείχνει έναν ζωντανό αριθμό, όπως την τιμή floor. Ενημερώνεται όταν αλλάζει ο αριθμός, το πολύ κάθε 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
Διαχείριση serverΣταματά την ενημέρωση ενός καναλιού στατιστικών. Το ίδιο το κανάλι παραμένει.
channelυποχρεωτικό- Το κανάλι.
/admin snapshot take
Διαχείριση serverΣου στέλνει όλους τους κατόχους μιας συλλογής σε αρχείο CSV: διεύθυνση, όνομα χρήστη, πόσα κατέχουν και το ποσοστό τους.
collectionυποχρεωτικό- Η συλλογή.
min- Μόνο κάτοχοι με τουλάχιστον τόσα.
with-discord- Προσθήκη στήλης με Discord id. Εμφανίζονται ονόματα μόνο για συνδεδεμένα μέλη αυτού του server.
/admin snapshot list
Διαχείριση serverΕμφανίζει τα πρόσφατα στιγμιότυπα.
/admin audit
Διαχείριση serverΔείχνει τις τελευταίες 25 αλλαγές ρόλων και κανόνων και γιατί έγινε η καθεμία.
user- Μόνο οι αλλαγές αυτού του μέλους.
/admin reconcile
Διαχείριση serverΕλέγχει ξανά τώρα κάθε συνδεδεμένο μέλος. Οι αλλαγές εμφανίζονται στο /admin audit.
Allowlist, ψηφοφορίες, κληρώσεις και εκδηλώσεις
/allowlist create
Διαχείριση serverΔημοσιεύει μια allowlist με κουμπί Συμμετοχής. Ένα μέλος που πληροί τις προϋποθέσεις συμμετέχει με το πρώτο συνδεδεμένο πορτοφόλι του.
nameυποχρεωτικό- Το όνομά της, έως 60 χαρακτήρες, διαφορετικό από τις άλλες allowlist του server.
max-entries- Ο μέγιστος αριθμός συμμετεχόντων.
closes-in-hours- Κλείσιμο μετά από τόσες ώρες, έως 2.160 (90 ημέρες).
eligibility-collection- Μόνο κάτοχοι αυτής της συλλογής μπορούν να συμμετάσχουν. Αφήστε το κενό για όποιον έχει συνδεδεμένο πορτοφόλι.
eligibility-min- Πόσα πρέπει να κατέχουν. Προεπιλογή: 1.
rule-json- Ή οποιοσδήποτε κανόνας σε JSON, όπως στο
/admin role set-json.
/allowlist close
Διαχείριση serverΚλείνει μια allowlist τώρα.
nameυποχρεωτικό- Το όνομά της, έως 60 χαρακτήρες, διαφορετικό από τις άλλες allowlist του server.
/allowlist export
Διαχείριση serverΣου στέλνει τις συμμετοχές μιας allowlist σε αρχείο CSV.
nameυποχρεωτικό- Το όνομά της, έως 60 χαρακτήρες, διαφορετικό από τις άλλες allowlist του server.
/allowlist list
Διαχείριση serverΕμφανίζει τις allowlists του server, με τις καταχωρίσεις τους και πότε κλείνουν.
/poll create
Διαχείριση serverΔημοσιεύει μια ψηφοφορία με ένα κουμπί ανά επιλογή. Τα μέλη μπορούν να αλλάξουν ψήφο μέχρι να κλείσει.
questionυποχρεωτικό- Έως 200 χαρακτήρες.
optionsυποχρεωτικό- 2 έως 10 επιλογές χωρισμένες με
|, η καθεμία έως 80 χαρακτήρες. duration-hoursυποχρεωτικό- Διάρκεια σε ώρες, έως 2.160 (90 ημέρες).
weightingmemberμία ψήφος ή συμμετοχή ανά μέλος ήnftμία ανά NFT που κατέχει.weight-collection- Ποια συλλογή θα μετρηθεί, για
nft. eligibility-collection- Μόνο κάτοχοι αυτής της συλλογής μπορούν να συμμετάσχουν. Αφήστε το κενό για όποιον έχει συνδεδεμένο πορτοφόλι.
eligibility-min- Πόσα πρέπει να κατέχουν. Προεπιλογή: 1.
/poll close
Διαχείριση serverΚλείνει μια ψηφοφορία τώρα και δημοσιεύει τα αποτελέσματα.
idυποχρεωτικό- Το id στο υποσέλιδο της ανάρτησης.
/raffle create
Διαχείριση serverΔημοσιεύει μια κλήρωση με κουμπί Συμμετοχή.
prizeυποχρεωτικό- Έως 200 χαρακτήρες.
winnersυποχρεωτικό- 1 έως 100.
duration-hoursυποχρεωτικό- Διάρκεια σε ώρες, έως 2.160 (90 ημέρες).
weightingmemberμία ψήφος ή συμμετοχή ανά μέλος ήnftμία ανά NFT που κατέχει.weight-collection- Ποια συλλογή θα μετρηθεί, για
nft. eligibility-collection- Μόνο κάτοχοι αυτής της συλλογής μπορούν να συμμετάσχουν. Αφήστε το κενό για όποιον έχει συνδεδεμένο πορτοφόλι.
eligibility-min- Πόσα πρέπει να κατέχουν. Προεπιλογή: 1.
/raffle draw
Διαχείριση serverΚλείνει τις συμμετοχές και κληρώνει τους νικητές τώρα. Η κλήρωση βασίζεται στο hash ενός επικυρωμένου ledger, που εμφανίζεται στην ανακοίνωση, ώστε να μπορεί ο καθένας να την επαληθεύσει.
idυποχρεωτικό- Το id στο υποσέλιδο της ανάρτησης.
/event create
Διαχείριση serverΔημοσιεύει μια εκδήλωση στην οποία τα μέλη μπορούν να δηλώσουν συμμετοχή, μέχρι να ξεκινήσει ή να γεμίσει.
titleυποχρεωτικό- Έως 100 χαρακτήρες.
startsυποχρεωτικό- Ώρες από τώρα, π.χ.
48, ή ημερομηνία και ώρα με ζώνη ώρας, π.χ.2026-12-01T18:00Z. Εντός 90 ημερών. description- Έως 1.000 χαρακτήρες.
location- Έως 200 χαρακτήρες.
capacity- Ο μέγιστος αριθμός συμμετοχών (RSVP).
eligibility-collection- Μόνο κάτοχοι αυτής της συλλογής μπορούν να συμμετάσχουν. Αφήστε το κενό για όποιον έχει συνδεδεμένο πορτοφόλι.
eligibility-min- Πόσα πρέπει να κατέχουν. Προεπιλογή: 1.
/event cancel
Διαχείριση serverΑκυρώνει μια εκδήλωση και ενημερώνει τη δημοσίευσή της.
idυποχρεωτικό- Το id στο υποσέλιδο της ανάρτησης.
/event attendees
Διαχείριση serverΕμφανίζει ποιοι θα έρθουν.
idυποχρεωτικό- Το id στο υποσέλιδο της ανάρτησης.
Για προχωρημένους: κανόνες σε JSON
Η /admin role set-json δέχεται έναν κανόνα γραμμένο σε JSON, για ό,τι δεν μπορούν να φτιάξουν οι /admin role set και /admin role token. Ο προηγμένος επεξεργαστής του dashboard γράφει τους ίδιους κανόνες για εσάς.
Συνδυάστε συνθήκες με and ή or, καθένα με 1 έως 20 κανόνες, και αντιστρέψτε μία με not. Ένας κανόνας μπορεί να έχει έως 6 επίπεδα βάθους και έως 30 συνθήκες.
Κάθε συνθήκη ελέγχεται σε όλα τα συνδεδεμένα πορτοφόλια ενός μέλους μαζί και είναι ψευδής για όποιον δεν έχει συνδεδεμένο πορτοφόλι. Αν το bot δεν μπορεί να ελέγξει μια συνθήκη, για παράδειγμα όταν το ledger δεν είναι προσβάσιμο, το μέλος διατηρεί τους ρόλους που έχει.
Οι συνθήκες, ανά τύπο JSON. Οι συλλογές ορίζονται με το slug τους στο marketplace.
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: κατέχει τόσα soulbound NFTs της συλλογής, αυτά που δεν πωλούνται.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 που κατέχει από αυτήν έγινε mint ή αγοράστηκε σε πώληση που πλήρωσε royalty.xrp_balanceμεmin: κατέχει τουλάχιστον τόσα XRP.token_balanceμεissuer,currency(κωδικός όπωςRLUSDή η hex μορφή του με 40 χαρακτήρες) καιmin: κατέχει τουλάχιστον τόσο από το token.mpt_balanceμεissuance_id(48 hex χαρακτήρες) καιmin: κατέχει τουλάχιστον τόσο από το multi-purpose token.amm_lp_balanceμεamm_accountκαιmin: κατέχει τουλάχιστον τόσα liquidity tokens του pool.wallet_inμεaddresses(1 έως 10.000): ένα από τα πορτοφόλια του είναι στη λίστα.
Όρια
- 25 παρακολουθούμενες συλλογές ανά server.
- 50 κανόνες ρόλων ανά server, ένας ανά ρόλο.
- 20 feeds ανά server, ένα ανά κανάλι.
- 10 κανάλια στατιστικών ανά server, με μετονομασία το πολύ κάθε 10 λεπτά.
- Ένα snapshot κατόχων ανά server κάθε 10 λεπτά, έως περίπου 100.000 κατόχους.
- 25 ειδοποιήσεις ανά μέλος και το πολύ 30 μηνύματα ειδοποίησης την ώρα.
- Οι ψηφοφορίες έχουν 2 έως 10 επιλογές· οι κληρώσεις βγάζουν 1 έως 100 νικητές· allowlists, ψηφοφορίες, κληρώσεις και εκδηλώσεις διαρκούν έως 90 ημέρες.
- Κάθε μέλος μπορεί να χρησιμοποιεί το bot 20 φορές το λεπτό. Πέρα από αυτό, του ζητά να κάνει πιο αργά.
Απόρρητο και ασφάλεια
Η επαλήθευση μοιράζεται με το bot τις διευθύνσεις των πορτοφολιών του λογαριασμού σου στο First Ledger. Δεν βλέπει ποτέ κανένα κλειδί και δεν θα σου ζητηθεί ποτέ να υπογράψεις συναλλαγή. Όποιος σου το ζητήσει δεν είναι αυτό το bot.
Το bot ζητά μόνο τα δικαιώματα που χρησιμοποιεί και ποτέ δικαίωμα Administrator. Αρνείται να δώσει ρόλο που έχει δικαιώματα συντονισμού ή διαχείρισης.
Αφαιρεί μόνο ρόλους που έδωσε το ίδιο. Ένας ρόλος που σου έδωσε χειροκίνητα κάποιος συντονιστής παραμένει.
Άλλες εφαρμογές βλέπουν τα συνδεδεμένα πορτοφόλια σου μόνο αν τις επιτρέψεις ονομαστικά με /privacy allow, και μπορείς να το ανακαλέσεις οποιαδήποτε στιγμή.
Το /unlink διαγράφει τη σύνδεσή σου και αφαιρεί τους ρόλους που σου έδωσε το bot σε όλους τους servers.
Επίλυση προβλημάτων
Δεν πήρες ρόλο μετά την επαλήθευση: εκτέλεσε /refresh. Αν ακόμα δεν εμφανίζεται, ζήτα από έναν admin να εκτελέσει /check-permissions· ο ρόλος του bot είναι μάλλον κάτω από τον ρόλο κατόχου.
Ο σύνδεσμος λέει ότι έληξε: κάθε σύνδεσμος ισχύει δέκα λεπτά και λειτουργεί μία φορά. Εκτέλεσε ξανά /verify.
«Διαφορετικός λογαριασμός Discord»: επιβεβαίωσες με άλλον λογαριασμό Discord από αυτόν που εκτέλεσε την εντολή. Άλλαξε λογαριασμό στο Discord και εκτέλεσε ξανά /verify.
Ένα feed σταμάτησε: εκτέλεσε /admin feed list. Ένα feed όπου το bot δεν μπορεί πια να δημοσιεύει απενεργοποιείται, και το /admin audit εξηγεί γιατί.
Ένας ρόλος υπολοίπου δεν άλλαξε: αυτοί ενημερώνονται στον ωριαίο επανέλεγχο. Εκτέλεσε /refresh για έλεγχο τώρα.