First Ledger NFT
СтворитиПеревіряємо, чи ви увійшли

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обов’язково
NFTokenID NFT, довжина — 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.
trait
Type: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. Активність без ціни, як-от переказ, теж пропускається.
layout
full або 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 дн.).
weighting
member — один голос чи заявка на учасника, або 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 дн.).
weighting
member — один голос чи заявка на учасника, або 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, щоб перевірити зараз.