Discord-бот
Бот First Ledger видає учасникам вашого Discord ролі за NFT і токени, якими вони володіють, публікує продажі вашої колекції в реальному часі та проводить allowlist, опитування й розіграші — для будь-якої колекції на XRP Ledger.
Що він уміє
Ролі власників: учасник один раз прив’язує свої гаманці, а бот видає й забирає ролі, коли той купує і продає, зазвичай за лічені секунди після продажу.
Стрічки: продажі, лістинги, мінти й пропозиції для ваших колекцій у вибраних вами каналах.
Інструменти для сервера: актуальні floor і кількість власників у назвах каналів, знімки власників, журнал аудиту та вебпанель для адмінів.
Спільнота: allowlist, опитування власників, розіграші, події та персональні сповіщення.
Це безкоштовно: усі функції, для кожного сервера й кожної колекції.
Як додати бота на сервер
Відкрийте сторінку бота на First Ledger і виберіть «Додати в Discord». Потрібен дозвіл «Керувати сервером» на сервері, куди ви його додаєте.
Далі Discord покаже шість дозволів, які запитує бот. Залиште всі позначеними: кожен із них використовується.
- Керувати ролями — видає й забирає ролі власників. Без цього ролі не видаватимуться.
- Керувати каналами — дає змогу
/setupстворити канал #verify та оновлювати floor і кількість власників у назвах каналів. - Переглядати канали — бот бачить канали, у яких публікує.
- Надсилати повідомлення — публікує стрічки, панель верифікації, опитування, розіграші й події.
- Вбудовувати посилання — показує кожен продаж і лістинг карткою із зображенням NFT і ціною.
- Прикріплювати файли — дає змогу
/admin snapshot takeнадіслати список власників у CSV-файлі.
Бот ніколи не просить прав адміністратора, керування сервером чи можливості виганяти або банити. Його ролі не потрібно нічого понад ці шість, тож решту залиште вимкненим.
У налаштуваннях сервера → Ролі перетягніть роль бота вище за всі ролі, які він має видавати. Discord дозволяє боту видавати лише ролі, нижчі за його власну.
Виконайте /check-permissions. Кожен рядок має бути із зеленою галочкою; кожен червоний підкаже, що виправити.
Додайте колекцію через /admin collection add. Почніть вводити назву й виберіть її зі списку.
Створіть роль власника через /admin role set: виберіть роль, колекцію і, якщо потрібні рівні, мінімум і максимум. Також можна вимагати певну рису або щоб NFT утримувався певну кількість днів.
Опублікуйте панель верифікації через /setup. Вона створить канал #verify або використає вказаний вами, з кнопкою «Верифікація» для учасників.
Усе це можна зробити й у вебпанелі: вхід через Discord, там будуть сервери, якими ви керуєте.
Ролі для власників
За кількістю: мати щонайменше певну кількість NFT з колекції, а за бажанням — не більше певної кількості, щоб створити рівні Holder, Collector і Whale.
За ознакою: мати NFT із певною ознакою, наприклад Background: Gold.
За рідкісністю або рангом: мати NFT із топ N колекції або бути одним із її топ N власників.
Творець: гаманець творця або емітента колекції.
За балансом: мати певну суму XRP, токена, випущеного в XRP Ledger (зокрема токенів, запущених на First Ledger), або багатоцільового токена. Налаштуйте це командою /admin role token: виберіть роль, що перевіряти і мінімум, а бот підсумує баланс на всіх прив’язаних гаманцях учасника.
За гаманцем: список адрес, які ви вставите.
Комбіновані: будь-які з цих умов, поєднані через AND, OR і NOT у розширеному редакторі панелі — наприклад, має три або більше AND має сто XRP.
Усі гаманці в акаунті First Ledger учасника рахуються разом, тож переміщення NFT між власними гаманцями ніколи не позбавить його ролі.
Ролі на основі NFT оновлюються за лічені секунди після продажу. Ролі на основі балансу оновлюються під час щогодинної перевірки або одразу, коли учасник запускає /refresh.
Ролі, можливі лише в XRP Ledger
Виставлені NFT теж рахуються. У XRP Ledger виставлений на продаж NFT залишається у вашому гаманці, доки його не куплять, тож лістинг ніколи не позбавляє учасника ролі. Щоб винагородити власників, які не виставляють NFT, є правило для частки їхніх виставлених NFT.
Тривалість володіння: NFT, яким володіють щонайменше певну кількість днів. Працює як стейкінг, але нічого не блокується.
Членські пропуски: NFT, змінчений без прапорця передачі, можна повернути лише творцю, тож його не продати. Такий пропуск дає роль учасника, яку неможливо купити.
Постачальники ліквідності: мати LP-токени пулу AMM, наприклад пулу токена вашого проєкту. Це теж налаштовується через /admin role token.
Власники, що платять роялті: кожен NFT колекції отримано через мінт або куплено з оплатою роялті творцю, а не передано безкоштовно.
Стрічки та інструменти сервера
Запустіть стрічку командою /admin feed add: виберіть канал, типи активності (продажі, лістинги, мінти, передачі, спалення, пропозиції), мінімальну ціну та повний чи компактний вигляд. Кілька покупок одного покупця в одному леджері публікуються разом як sweep.
Ціни показано у валюті продажу, а поруч — вартість у XRP, якщо вона відома.
Створіть канал статистики командою /admin stat add: його назва показує floor, кількість власників, виставлених NFT, денний обсяг або кількість учасників із роллю й оновлюється кожні десять хвилин.
Зробіть знімок командою /admin snapshot take: усі власники колекції у вигляді таблиці. Якщо ввімкнено Discord ID, указано лише учасників вашого сервера.
Переглядайте всі ролі, які бот видав чи забрав, і причини — командою /admin audit.
Allowlist, опитування, розіграші та події
/allowlist create публікує кнопку «Приєднатися». Учасники, що відповідають вимогам, приєднуються з прив’язаним гаманцем; після закриття експортуйте список як таблицю.
/poll create публікує опитування. Голоси можна рахувати по одному на учасника або по одному на кожен NFT.
/raffle create публікує кнопку «Взяти участь». Переможців визначають за хешем леджера XRP Ledger, закритого після завершення реєстрації, і він є в оголошенні, тож будь-хто може перевірити чесність розіграшу.
/event create публікує подію, на яку учасники можуть зареєструватися; за бажанням — лише для власників і з обмеженням місць.
Учасники можуть увімкнути сповіщення в DM через /alerts: офери на їхні NFT, попередження про підозрілі офери, продажі в колекції або лістинги нижче заданої ціни.
Для учасників: верифікація
Натисніть «Верифікувати» на сервері або виконайте /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обов’язковоNFTokenIDNFT, довжина — 64 символів.
/portfolio
Будь-хтоПоказує ваші NFT з усіх привʼязаних гаманців, згруповані за колекціями.
/alerts add
Будь-хтоВмикає сповіщення в DM. Повторне додавання того самого типу для тієї ж колекції замінює ціну. Не закривайте DM від учасників сервера, інакше бот не зможе вам написати.
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
Будь-хтоВидаляє вашу привʼязку та ролі, які бот видав вам, на всіх спільних з ним серверах.
/help
Будь-хтоПоказує, чи є у вас привʼязка, і коротку довідку з цих команд.
Налаштування
/setup
Керувати серверомПублікує панель верифікації, через яку учасники прив’язують гаманці, і запам’ятовує її канал. Якщо канал не вказано, створює #verify.
channel- Куди опублікувати панель. Якщо не вказати, бот створить #verify — для цього потрібен дозвіл «Керувати каналами».
/check-permissions
Керувати серверомПеревіряє всі дозволи, потрібні боту, кожне правило ролі (роль існує і стоїть нижче ролі бота) та кожен канал стрічки — з галочкою чи хрестиком і порадою, що виправити. Попереджає, якщо бот має права адміністратора, які йому не потрібні.
/admin collection add
Керувати серверомВідстежує колекцію, щоб її активність потрапляла у ваші стрічки, а власники — у ваші ролі. Попереджає, якщо маркетплейс позначив колекцію.
collectionобов’язково- Колекція.
/admin collection remove
Керувати серверомПрипиняє відстежувати колекцію.
collectionобов’язково- Колекція.
/admin collection list
Керувати серверомПоказує колекції, які відстежує цей сервер.
Ролі власників
/admin role set
Керувати серверомВидає роль учасникам, які мають достатньо NFT з колекції. Повторне налаштування для тієї ж ролі замінює правило. Учасників із прив’язаними гаманцями перевіряють одразу.
roleобов’язково- Звичайна роль, нижча за роль бота. Бот не приймає @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
Керувати серверомВидає роль за балансом, сумованим по всіх прив’язаних гаманцях учасника: XRP, токен, випущений у XRP Ledger, багатоцільовий токен або LP-токени пулу AMM. Баланси перевіряються щогодини або коли учасник запускає /refresh.
roleобов’язково- Звичайна роль, нижча за роль бота. Бот не приймає @everyone, ролі інших застосунків і ролі з правами адміністратора чи модерації.
kindобов’язковоxrp,token— токен, випущений на XRP Ledger,mpt— багатоцільовий токен, абоlp— 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
Керувати серверомСтворює закритий голосовий канал, назва якого показує актуальне число, наприклад floor price. Оновлюється, коли число змінюється, не частіше ніж раз на 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: адреса, ім’я користувача, скільки NFT має і частка.
collectionобов’язково- Колекція.
min- Лише власники щонайменше такої кількості.
with-discord- Додати стовпець з Discord id. Імена показуються лише для підключених учасників цього сервера.
/admin snapshot list
Керувати серверомПоказує останні знімки.
/admin audit
Керувати серверомПоказує останні зміни ролей і правил (25) і причину кожної.
user- Лише зміни цього учасника.
/admin reconcile
Керувати серверомНегайно перевіряє всіх учасників із прив’язаними гаманцями. Зміни з’являться в /admin audit.
Allowlist, опитування, розіграші та події
/allowlist create
Керувати серверомПублікує allowlist із кнопкою «Приєднатися». Учасник, який відповідає умовам, приєднується з першим прив’язаним гаманцем.
nameобов’язково- Назва, до 60 символів, відмінна від інших allowlist сервера.
max-entries- Максимальна кількість учасників.
closes-in-hours- Закрити через стільки годин, до 2 160 (90 дн.).
eligibility-collection- Брати участь можуть лише власники цієї колекції. Залиште порожнім для всіх із підключеним гаманцем.
eligibility-min- Скільки потрібно мати. За замовчуванням 1.
rule-json- Або будь-яке правило в JSON, як для
/admin role set-json.
/allowlist close
Керувати серверомНегайно закриває allowlist.
nameобов’язково- Назва, до 60 символів, відмінна від інших allowlist сервера.
/allowlist export
Керувати серверомНадсилає вам записи allowlist у файлі CSV.
nameобов’язково- Назва, до 60 символів, відмінна від інших allowlist сервера.
/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обов’язково- 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обов’язково- 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обов’язково- Id у футері допису.
/event attendees
Керувати серверомПоказує, хто прийде.
idобов’язково- 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: має стільки NFT з колекції.holds_traitзcollection,traits(від 1 до 12, кожна у форматіType:Value) іmin: має стільки NFT з будь-якою з цих ознак.holds_any_verifiedзmin: має стільки NFT з будь-яких верифікованих колекцій.holds_non_transferableзcollectionіmin: має стільки soulbound NFT колекції, тобто тих, які не можна продати.held_forзcollection,days(від 1 до 3 650) іmin: тримає стільки NFT щонайменше стільки днів.rarity_rankзcollectionіmax_rank: має NFT із таким або рідкіснішим рангом.listed_ratioзcollectionіmax— часткою від нуля до одиниці: виставив на продаж не більше такої частки своїх NFT. Хибно, якщо NFT немає.top_holdersзcollectionіn(від 1 до 1 000): входить до топ-власників колекції.is_creatorзcollection: один з його гаманців створив або випустив колекцію.royalty_compliantзcollection: кожен його NFT з колекції був змінчений або куплений з оплатою роялті.xrp_balanceзmin: має щонайменше стільки XRP.token_balanceзissuer,currency(код на кшталтRLUSDабо його hex-форма з 40 символів) іmin: має щонайменше стільки цього токена.mpt_balanceзissuance_id(48 hex-символів) іmin: має щонайменше стільки цього багатоцільового токена.amm_lp_balanceзamm_accountіmin: має щонайменше стільки LP-токенів пулу.wallet_inзaddresses(від 1 до 10 000): один з його гаманців є у списку.
Ліміти
- Відстежуваних колекцій на сервер: 25.
- Правил ролей на сервер: 50, одне на роль.
- Стрічок на сервер: 20, одна на канал.
- Каналів статистики на сервер: 10; перейменування не частіше ніж раз на 10 хв.
- Один знімок власників на сервер раз на 10 хв, до приблизно 100 000 власників.
- Сповіщень на учасника: 25; не більше 30 повідомлень зі сповіщеннями на годину.
- Опитування мають від 2 до 10 варіантів; розіграші визначають від 1 до 100 переможців; allowlist, опитування, розіграші й події тривають до 90 днів.
- Кожен учасник може використовувати бота 20 раз на хвилину. Понад це бот попросить зачекати.
Конфіденційність і безпека
Під час верифікації бот отримує лише адреси гаманців вашого акаунта First Ledger. Він ніколи не бачить ключів, і вас ніколи не попросять підписати транзакцію. Якщо хтось просить — це не цей бот.
Бот запитує лише ті дозволи, якими користується, і ніколи не просить права адміністратора. Він відмовляється видавати ролі з правами модерації чи адміністрування.
Бот знімає лише ті ролі, які видав сам. Роль, яку вам вручну дав модератор, залишиться.
Інші застосунки бачать ваші привʼязані гаманці, лише якщо ви дозволите їм поіменно через /privacy allow. Дозвіл можна відкликати будь-коли.
/unlink видаляє привʼязку й знімає ролі, які бот видав вам на всіх серверах.
Вирішення проблем
Немає ролі після верифікації: виконайте /refresh. Якщо роль так і не зʼявилася, попросіть адміністратора виконати /check-permissions — імовірно, роль бота нижча за роль власника.
Посилання прострочене: кожне діє десять хвилин і лише один раз. Виконайте /verify ще раз.
«Інший акаунт Discord»: ви підтвердили вхід не тим акаунтом Discord, яким виконали команду. Змініть акаунт у Discord і виконайте /verify ще раз.
Стрічка замовкла: виконайте /admin feed list. Стрічку, у яку бот більше не може публікувати, вимкнено, а /admin audit покаже причину.
Роль за балансом не змінилася: такі ролі оновлюються під час щогодинної перевірки. Виконайте /refresh, щоб перевірити зараз.