Bot Discord
Bot First Ledger cấp vai trò cho thành viên Discord theo NFT và token họ nắm giữ, đăng giao dịch của bộ sưu tập ngay khi diễn ra, và quản lý allowlist, bình chọn, rút thăm — cho mọi bộ sưu tập trên XRP Ledger.
Bot làm được gì
Vai trò holder: thành viên liên kết ví một lần, bot sẽ cấp và thu hồi vai trò khi họ mua bán, thường chỉ vài giây sau giao dịch.
Feed: giao dịch, niêm yết, mint và offer của bộ sưu tập, đăng vào kênh bạn chọn.
Công cụ cho server: giá sàn và số holder cập nhật trực tiếp trên tên kênh, snapshot holder, nhật ký kiểm tra và bảng điều khiển web cho admin.
Cộng đồng: allowlist, bình chọn cho holder, rút thăm, sự kiện và thông báo cá nhân.
Hoàn toàn miễn phí: mọi tính năng, cho mọi server và mọi bộ sưu tập.
Thêm bot vào server
Mở trang của bot trên First Ledger và chọn Thêm vào Discord. Bạn cần quyền Quản lý máy chủ trong server muốn thêm bot.
Discord sẽ hiển thị sáu quyền bot yêu cầu. Hãy giữ nguyên tất cả: quyền nào cũng được dùng.
- Quản lý vai trò để cấp và thu hồi vai trò holder. Thiếu quyền này, bot không cấp được vai trò nào.
- Quản lý kênh để
/setuptạo kênh #verify, và cập nhật giá sàn cùng số holder trên tên kênh. - Xem kênh để bot thấy các kênh nó đăng bài.
- Gửi tin nhắn để đăng feed, bảng xác minh, bình chọn, rút thăm và sự kiện.
- Nhúng liên kết để hiển thị mỗi giao dịch và niêm yết dạng thẻ kèm hình ảnh và giá NFT.
- Đính kèm tập tin để
/admin snapshot takegửi danh sách holder dạng tệp CSV.
Bot không bao giờ yêu cầu quyền Quản trị viên, Quản lý máy chủ hay quyền đuổi, cấm thành viên. Vai trò của bot chỉ cần sáu quyền này, hãy tắt mọi quyền khác.
Trong Cài đặt máy chủ → Vai trò, kéo vai trò của bot lên trên mọi vai trò bạn muốn bot cấp. Discord chỉ cho bot cấp vai trò thấp hơn vai trò của nó.
Chạy /check-permissions. Mọi dòng nên có dấu tích xanh; dòng đỏ sẽ cho biết cần sửa gì.
Thêm bộ sưu tập bằng /admin collection add. Gõ tên và chọn từ danh sách.
Tạo vai trò holder bằng /admin role set: chọn vai trò, bộ sưu tập và, nếu muốn chia cấp, số lượng tối thiểu và tối đa. Bạn cũng có thể yêu cầu một trait, hoặc NFT phải được giữ trong số ngày nhất định.
Đăng bảng xác minh bằng /setup. Lệnh sẽ tạo kênh #verify, hoặc dùng kênh bạn chỉ định, với nút Xác minh để thành viên bấm.
Mọi thao tác ở đây cũng làm được trên bảng điều khiển, nơi bạn đăng nhập bằng Discord và thấy các server bạn quản lý.
Vai trò holder
Theo số lượng: nắm giữ tối thiểu một số NFT của bộ sưu tập, và tùy chọn tối đa một số, để bạn có các cấp Holder, Collector và Whale.
Theo thuộc tính: nắm giữ NFT có thuộc tính nhất định, ví dụ Background: Gold.
Theo độ hiếm hoặc thứ hạng: nắm giữ NFT nằm trong top N của bộ sưu tập, hoặc là một trong top N holder.
Nhà sáng tạo: ví của nhà sáng tạo hoặc bên phát hành bộ sưu tập.
Theo số dư: nắm giữ một lượng XRP, token phát hành trên XRP Ledger (kể cả token ra mắt trên First Ledger) hoặc multi-purpose token. Thiết lập bằng /admin role token: chọn vai trò, thứ cần kiểm tra và mức tối thiểu, bot sẽ cộng số dư trên các ví đã liên kết của thành viên.
Theo ví: danh sách địa chỉ bạn dán vào.
Kết hợp: nối bất kỳ điều kiện nào bằng AND, OR và NOT trong trình chỉnh sửa nâng cao của dashboard — ví dụ, giữ từ ba NFT trở lên AND giữ một trăm XRP.
Mọi ví trong tài khoản First Ledger của thành viên được tính chung, nên chuyển NFT giữa các ví của chính họ không bao giờ làm mất vai trò.
Vai trò theo NFT cập nhật trong vài giây sau giao dịch bán. Vai trò theo số dư cập nhật ở lần kiểm tra lại hằng giờ, hoặc ngay khi thành viên chạy /refresh.
Vai trò chỉ XRP Ledger mới làm được
NFT đang niêm yết vẫn được tính. Trên XRP Ledger, NFT bạn niêm yết bán vẫn nằm trong ví cho đến khi có người mua, nên niêm yết không bao giờ làm thành viên mất vai trò. Nếu muốn thưởng holder không niêm yết, có quy tắc theo tỷ lệ NFT họ đang niêm yết.
Thời gian nắm giữ: giữ NFT tối thiểu một số ngày. Giống staking nhưng không khóa gì cả.
Thẻ thành viên: NFT mint không có cờ transferable chỉ có thể trả về nhà sáng tạo, nên không thể bán. Thẻ như vậy tạo ra vai trò thành viên không thể mua được.
Nhà cung cấp thanh khoản: nắm giữ token pool thanh khoản của một AMM pool, ví dụ pool cho token dự án của bạn. Cũng thiết lập bằng /admin role token.
Holder trả phí bản quyền: mọi NFT trong bộ sưu tập đều được mua qua mint hoặc giao dịch có trả phí bản quyền cho nhà sáng tạo, không phải được cho không.
Feed và công cụ server
Tạo feed bằng /admin feed add: chọn kênh, loại hoạt động cần đăng (bán, niêm yết, mint, chuyển, đốt, offer), giá tối thiểu và bố cục đầy đủ hoặc gọn. Nhiều giao dịch mua của một người trong cùng ledger được đăng chung thành một sweep.
Giá hiển thị theo loại tiền dùng trong giao dịch, kèm giá trị XRP nếu có.
Tạo kênh thống kê bằng /admin stat add: tên kênh hiển thị giá sàn, số holder, số đang niêm yết, khối lượng trong ngày hoặc số thành viên có vai trò, làm mới mỗi mười phút.
Chụp snapshot bằng /admin snapshot take: mọi holder của bộ sưu tập dưới dạng bảng tính. Khi bật Discord id, chỉ thành viên trong server của bạn mới được ghi tên.
Xem mọi vai trò bot đã cấp hoặc gỡ, kèm lý do, bằng /admin audit.
Allowlist, bình chọn, rút thăm và sự kiện
/allowlist create đăng nút Tham gia. Thành viên đủ điều kiện tham gia bằng ví đã liên kết; xuất danh sách thành bảng tính khi đóng.
/poll create đăng một cuộc bình chọn. Phiếu có thể tính một phiếu mỗi thành viên, hoặc một phiếu mỗi NFT nắm giữ.
/raffle create đăng nút Tham gia. Người thắng được chọn từ hash của một ledger XRP Ledger đóng sau khi hết hạn tham gia, và thông báo sẽ hiển thị ledger đó để ai cũng có thể kiểm tra kết quả công bằng.
/event create đăng một sự kiện để thành viên đăng ký tham dự, có thể giới hạn cho holder và số lượng chỗ.
Thành viên có thể bật thông báo DM bằng /alerts: offer cho NFT của họ, cảnh báo khi offer có dấu hiệu lừa đảo, giao dịch bán trong một bộ sưu tập, hoặc listing dưới một mức giá.
Dành cho thành viên: xác minh
Bấm Xác minh trong server, hoặc chạy /verify. Bot sẽ trả lời bằng một liên kết chỉ bạn thấy được.
Liên kết sẽ mở First Ledger. Đăng nhập bằng ví như bình thường và chọn Tiếp tục.
Discord sẽ yêu cầu bạn xác nhận tài khoản. Xác nhận xong, vai trò của bạn sẽ xuất hiện sau vài giây.
Đã thêm ví vào tài khoản First Ledger sau đó? Chạy lại /verify, rồi /refresh.
Đừng bao giờ hoàn tất xác minh do người khác gửi cho bạn. Mỗi liên kết thuộc về người đã chạy lệnh và chỉ dùng được cho họ.
Tất cả lệnh
Lệnh quản trị cần quyền Quản lý máy chủ, và Discord chỉ hiển thị chúng cho người có quyền đó. Hầu hết phản hồi chỉ bạn thấy; /floor, /collection và /nft được đăng công khai trong kênh. Gõ tên bộ sưu tập vào bất kỳ tùy chọn bộ sưu tập nào và chọn từ danh sách: bộ sưu tập của server bạn hiện trước, sau đó là của marketplace.
Dành cho mọi người
/verify
Mọi ngườiGửi cho bạn một liên kết chỉ bạn thấy để liên kết các ví trong tài khoản First Ledger. Liên kết chỉ dành riêng cho bạn và có hiệu lực mười phút. Bạn không bao giờ phải ký giao dịch.
/wallets
Mọi ngườiLiệt kê các ví đã liên kết, mỗi ví dẫn đến trang của nó trên First Ledger.
/refresh
Mọi ngườiTải lại ví của bạn từ First Ledger và kiểm tra lại vai trò ngay. Dùng sau khi thêm ví hoặc khi vai trò theo số dư chưa cập nhật.
/roles
Mọi ngườiLiệt kê các vai trò holder của server này và điều kiện của từng vai trò, đánh dấu những vai trò bạn có.
/floor
Mọi ngườiĐăng giá sàn, mức thay đổi trong ngày qua và số lượng đang niêm yết của một bộ sưu tập hoặc tối đa 15 bộ sưu tập của server.
collection- Một bộ sưu tập. Bỏ trống để chọn tất cả của server.
/collection
Mọi ngườiĐăng thống kê bộ sưu tập: giá sàn, offer tốt nhất, số niêm yết, holder, khối lượng, doanh số, phí bản quyền và trạng thái xác minh.
collectionbắt buộc- Bộ sưu tập.
/nft
Mọi ngườiĐăng thẻ NFT: hình ảnh, chủ sở hữu, hạng độ hiếm, giá nếu đang niêm yết, phí bản quyền, cờ và thuộc tính.
idbắt buộcNFTokenIDcủa NFT, dài 64 ký tự.
/portfolio
Mọi ngườiHiển thị NFT của bạn trên các ví đã liên kết, nhóm theo bộ sưu tập.
/alerts add
Mọi ngườiBật thông báo qua DM. Thêm lại cùng loại cho cùng bộ sưu tập sẽ thay giá cũ. Hãy mở DM từ thành viên server, nếu không bot không liên lạc được với bạn.
kindbắt buộcoffer_receivedcho offer trên NFT của bạn,suspicious_offerđể cảnh báo khi offer có dấu hiệu lừa đảo,collection_salecho giao dịch bán trong bộ sưu tập, hoặclisting_belowcho listing dưới một mức giá.collection- Cần cho cảnh báo bán và listing.
price- Tính bằng XRP: giá bán nhỏ nhất cần báo, hoặc với listing là giá cao nhất.
/alerts remove
Mọi ngườiTắt một thông báo.
kindbắt buộcoffer_receivedcho offer trên NFT của bạn,suspicious_offerđể cảnh báo khi offer có dấu hiệu lừa đảo,collection_salecho giao dịch bán trong bộ sưu tập, hoặclisting_belowcho listing dưới một mức giá.collection- Cần cho cảnh báo bán và listing.
/alerts list
Mọi ngườiLiệt kê các thông báo của bạn.
/privacy allow
Mọi ngườiCho phép ứng dụng đối tác tra cứu các ví đã liên kết của bạn.
partnerbắt buộc- Tên ứng dụng đối tác.
/privacy revoke
Mọi ngườiNgừng chia sẻ với một ứng dụng đối tác.
partnerbắt buộc- Tên ứng dụng đối tác.
/privacy status
Mọi ngườiLiệt kê các ứng dụng đối tác bạn đang chia sẻ.
/unlink
Mọi ngườiXóa liên kết của bạn và các vai trò bot đã cấp cho bạn ở mọi server bạn có chung với bot.
/help
Mọi ngườiCho biết bạn đã liên kết chưa, kèm hướng dẫn ngắn về các lệnh này.
Thiết lập
/setup
Quản lý máy chủĐăng bảng Xác minh để thành viên nhấn vào và liên kết ví, đồng thời ghi nhớ kênh của bảng. Nếu không chọn kênh, bot sẽ tạo #verify.
channel- Nơi đăng bảng điều khiển. Bỏ trống thì bot sẽ tạo #verify, cần quyền Manage Channels.
/check-permissions
Quản lý máy chủKiểm tra mọi quyền bot cần, mọi quy tắc vai trò (vai trò còn tồn tại và nằm dưới vai trò của bot) và mọi kênh feed, kèm dấu tích hoặc dấu gạch chéo cùng cách khắc phục. Bot sẽ cảnh báo nếu được cấp quyền Administrator, vốn không cần thiết.
/admin collection add
Quản lý máy chủTheo dõi một bộ sưu tập để hoạt động của nó hiện trên feed và người nắm giữ nhận được vai trò. Bot sẽ cảnh báo nếu sàn đã gắn cờ bộ sưu tập này.
collectionbắt buộc- Bộ sưu tập.
/admin collection remove
Quản lý máy chủNgừng theo dõi một bộ sưu tập.
collectionbắt buộc- Bộ sưu tập.
/admin collection list
Quản lý máy chủLiệt kê các bộ sưu tập máy chủ này đang theo dõi.
Vai trò holder
/admin role set
Quản lý máy chủCấp vai trò cho thành viên nắm giữ đủ số lượng của một bộ sưu tập. Thiết lập lại trên cùng vai trò sẽ thay thế quy tắc cũ. Thành viên đã liên kết được kiểm tra lại ngay.
rolebắt buộc- Một role thường nằm dưới role của bot. Bot từ chối @everyone, role do ứng dụng khác quản lý và mọi role có quyền admin hoặc kiểm duyệt.
collectionbắt buộc- Bộ sưu tập.
min- Số NFT tối thiểu cần giữ, từ 1 đến 100.000. Mặc định là 1.
max- Số tối đa, cho các hạng như Holder, Collector và Whale.
traitType:Value, ví dụBackground:Gold. Phân tách nhiều giá trị bằng|, khớp một là đủ.held-days- Yêu cầu thêm một NFT được giữ ít nhất số ngày này, từ 1 đến 3.650.
/admin role token
Quản lý máy chủCấp vai trò theo số dư, cộng dồn trên các ví đã liên kết của thành viên: XRP, token phát hành trên XRP Ledger, token đa năng, hoặc token thanh khoản của pool AMM. Số dư được kiểm tra lại mỗi giờ, hoặc khi thành viên chạy /refresh.
rolebắt buộc- Một role thường nằm dưới role của bot. Bot từ chối @everyone, role do ứng dụng khác quản lý và mọi role có quyền admin hoặc kiểm duyệt.
kindbắt buộcxrp,tokencho token phát hành trên XRP Ledger,mptcho multi-purpose token, hoặclpcho token thanh khoản của pool AMM.minbắt buộc- Số dư tối thiểu, lớn hơn 0.
issuer- Với
token: địa chỉ của bên phát hành. currency- Với
token: mã token, ví dụRLUSD. issuance-id- Với
mpt: id phát hành gồm 48 ký tự. pool- Với
lp: địa chỉ tài khoản của pool AMM.
/admin role set-json
Quản lý máy chủCấp vai trò theo quy tắc viết bằng JSON, kết hợp bất kỳ điều kiện nào dưới đây.
rolebắt buộc- Một role thường nằm dưới role của bot. Bot từ chối @everyone, role do ứng dụng khác quản lý và mọi role có quyền admin hoặc kiểm duyệt.
rulebắt buộc- Quy tắc, tối đa 6.000 ký tự.
/admin role remove
Quản lý máy chủXóa quy tắc của một vai trò và gỡ vai trò đó khỏi những thành viên đã được bot cấp.
rolebắt buộc- Một role thường nằm dưới role của bot. Bot từ chối @everyone, role do ứng dụng khác quản lý và mọi role có quyền admin hoặc kiểm duyệt.
/admin role list
Quản lý máy chủLiệt kê mọi quy tắc vai trò bằng lời, kèm trạng thái bật hay tắt.
Feed và công cụ server
/admin feed add
Quản lý máy chủĐăng hoạt động vào một kênh. Bot sẽ gửi tin nhắn thử trước để bạn biết bot đăng được ở đó. Thêm feed vào kênh đã có feed sẽ cập nhật feed đó.
channelbắt buộc- Kênh văn bản hoặc kênh thông báo.
kinds- Phân tách bằng dấu phẩy, chọn từ
sale,list,delist,mint,transfer,burn,buy_offer_created,buy_offer_cancelled,offer_expiredvàuri_modified. Mặc định làsale. collection- Một bộ sưu tập. Bỏ trống để chọn tất cả của server.
min-price- Bỏ qua mọi hoạt động dưới mức XRP này. Hoạt động không có giá, như chuyển nhượng, cũng bị bỏ qua.
layoutfullhoặccompact.
/admin feed layout
Quản lý máy chủChuyển feed giữa bố cục đầy đủ và thu gọn.
channelbắt buộc- Kênh.
layoutbắt buộcfullhoặccompact.
/admin feed remove
Quản lý máy chủXóa feed của một kênh.
channelbắt buộc- Kênh.
/admin feed list
Quản lý máy chủLiệt kê các feed của bạn, nội dung mỗi feed đăng và trạng thái bật hay tắt.
/admin stat add
Quản lý máy chủTạo một kênh thoại bị khóa có tên hiển thị một con số trực tiếp, như giá sàn. Tên được cập nhật khi con số thay đổi, tối đa 10 phút một lần.
kindbắt buộcfloor,holders,volumecho khối lượng trong ngày,listed, hoặcrolecho số thành viên có một vai trò.collection- Bắt buộc với mọi loại trừ
role. role- Bắt buộc với
role. template- Tên kênh, từ 3 đến 90 ký tự, chứa ít nhất một trong
{floor} {holders} {listed} {supply} {volume24h} {sales24h} {bid} {count}.
/admin stat remove
Quản lý máy chủNgừng cập nhật một kênh thống kê. Bản thân kênh vẫn được giữ lại.
channelbắt buộc- Kênh.
/admin snapshot take
Quản lý máy chủGửi cho bạn danh sách mọi người nắm giữ một bộ sưu tập dưới dạng tệp CSV: địa chỉ, tên người dùng, số lượng nắm giữ và tỷ lệ.
collectionbắt buộc- Bộ sưu tập.
min- Chỉ người nắm giữ ít nhất số lượng này.
with-discord- Thêm cột id Discord. Chỉ hiển thị tên thành viên đã liên kết của server này.
/admin snapshot list
Quản lý máy chủLiệt kê các snapshot gần đây.
/admin audit
Quản lý máy chủHiển thị 25 thay đổi vai trò và quy tắc gần nhất, cùng lý do của từng thay đổi.
user- Chỉ thay đổi của thành viên này.
/admin reconcile
Quản lý máy chủKiểm tra lại mọi thành viên đã liên kết ngay bây giờ. Các thay đổi sẽ hiện trong /admin audit.
Allowlist, bình chọn, rút thăm và sự kiện
/allowlist create
Quản lý máy chủĐăng một allowlist kèm nút Tham gia. Thành viên đủ điều kiện sẽ tham gia bằng ví liên kết đầu tiên của họ.
namebắt buộc- Tên, tối đa 60 ký tự, không trùng với các allowlist khác của server.
max-entries- Số người tham gia tối đa.
closes-in-hours- Đóng sau số giờ này, tối đa 2.160 (90 ngày).
eligibility-collection- Chỉ người nắm giữ bộ sưu tập này được tham gia. Bỏ trống để mở cho mọi người có ví đã liên kết.
eligibility-min- Số lượng cần nắm giữ. Mặc định là 1.
rule-json- Hoặc bất kỳ quy tắc nào dạng JSON, như với
/admin role set-json.
/allowlist close
Quản lý máy chủĐóng allowlist ngay bây giờ.
namebắt buộc- Tên, tối đa 60 ký tự, không trùng với các allowlist khác của server.
/allowlist export
Quản lý máy chủGửi cho bạn các lượt đăng ký allowlist dưới dạng tệp CSV.
namebắt buộc- Tên, tối đa 60 ký tự, không trùng với các allowlist khác của server.
/allowlist list
Quản lý máy chủLiệt kê các allowlist của server, kèm danh sách mục và thời điểm đóng.
/poll create
Quản lý máy chủĐăng bình chọn với một nút cho mỗi lựa chọn. Thành viên có thể đổi phiếu cho đến khi bình chọn đóng.
questionbắt buộc- Tối đa 200 ký tự.
optionsbắt buộc- Từ 2 đến 10 lựa chọn, phân tách bằng
|, mỗi lựa chọn tối đa 80 ký tự. duration-hoursbắt buộc- Thời gian diễn ra, tính bằng giờ, tối đa 2.160 (90 ngày).
weightingmember: mỗi người một phiếu hoặc một lượt, hoặcnft: một phiếu cho mỗi NFT nắm giữ.weight-collection- Bộ sưu tập dùng để đếm, cho
nft. eligibility-collection- Chỉ người nắm giữ bộ sưu tập này được tham gia. Bỏ trống để mở cho mọi người có ví đã liên kết.
eligibility-min- Số lượng cần nắm giữ. Mặc định là 1.
/poll close
Quản lý máy chủĐóng bình chọn ngay và đăng kết quả.
idbắt buộc- ID ở cuối bài đăng.
/raffle create
Quản lý máy chủĐăng một raffle có nút Tham gia.
prizebắt buộc- Tối đa 200 ký tự.
winnersbắt buộc- Từ 1 đến 100.
duration-hoursbắt buộc- Thời gian diễn ra, tính bằng giờ, tối đa 2.160 (90 ngày).
weightingmember: mỗi người một phiếu hoặc một lượt, hoặcnft: một phiếu cho mỗi NFT nắm giữ.weight-collection- Bộ sưu tập dùng để đếm, cho
nft. eligibility-collection- Chỉ người nắm giữ bộ sưu tập này được tham gia. Bỏ trống để mở cho mọi người có ví đã liên kết.
eligibility-min- Số lượng cần nắm giữ. Mặc định là 1.
/raffle draw
Quản lý máy chủĐóng đăng ký và quay chọn người thắng ngay. Kết quả quay dựa trên hash của một ledger đã xác thực và được hiển thị trong thông báo, nên ai cũng có thể tính lại.
idbắt buộc- ID ở cuối bài đăng.
/event create
Quản lý máy chủĐăng sự kiện để thành viên đăng ký tham gia, cho đến khi bắt đầu hoặc đủ chỗ.
titlebắt buộc- Tối đa 100 ký tự.
startsbắt buộc- Số giờ kể từ bây giờ, ví dụ
48, hoặc ngày giờ kèm múi giờ, ví dụ2026-12-01T18:00Z. Trong vòng 90 ngày. description- Tối đa 1.000 ký tự.
location- Tối đa 200 ký tự.
capacity- Số người tối đa có thể đăng ký tham gia.
eligibility-collection- Chỉ người nắm giữ bộ sưu tập này được tham gia. Bỏ trống để mở cho mọi người có ví đã liên kết.
eligibility-min- Số lượng cần nắm giữ. Mặc định là 1.
/event cancel
Quản lý máy chủHủy sự kiện và cập nhật bài đăng.
idbắt buộc- ID ở cuối bài đăng.
/event attendees
Quản lý máy chủLiệt kê những người sẽ tham gia.
idbắt buộc- ID ở cuối bài đăng.
Nâng cao: quy tắc bằng JSON
/admin role set-json nhận một quy tắc viết bằng JSON, cho những gì /admin role set và /admin role token không tạo được. Trình chỉnh sửa nâng cao trên dashboard cũng tạo các quy tắc này giúp bạn.
Kết hợp điều kiện bằng and hoặc or, mỗi loại nhận từ 1 đến 20 quy tắc, và đảo ngược bằng not. Một quy tắc có thể lồng sâu 6 cấp và chứa tối đa 30 điều kiện.
Mỗi điều kiện được kiểm tra trên tất cả ví đã liên kết của thành viên cùng lúc, và là sai với người chưa liên kết ví nào. Nếu bot không kiểm tra được điều kiện, ví dụ khi không kết nối được ledger, thành viên sẽ giữ nguyên vai trò hiện có.
Các điều kiện, theo kiểu JSON. Bộ sưu tập được gọi bằng slug trên marketplace.
holdsvớicollection,minvàmax(tùy chọn): sở hữu số NFT đó từ bộ sưu tập.holds_traitvớicollection,traits(từ 1 đến 12, mỗi mục viết dạngType:Value) vàmin: sở hữu số NFT đó có bất kỳ thuộc tính nào trong danh sách.holds_any_verifiedvớimin: sở hữu số NFT đó từ các bộ sưu tập đã xác minh, bất kể bộ nào.holds_non_transferablevớicollectionvàmin: sở hữu số NFT soulbound đó của bộ sưu tập, tức là loại không thể bán.held_forvớicollection,days(từ 1 đến 3.650) vàmin: đã giữ số NFT đó trong ít nhất số ngày đó.rarity_rankvớicollectionvàmax_rank: sở hữu một NFT có hạng hiếm bằng hoặc hiếm hơn mức đó.listed_ratiovớicollectionvàmax, một tỷ lệ từ 0 đến 1: đã niêm yết không quá tỷ lệ đó trên số NFT của họ. Sai nếu họ không giữ NFT nào.top_holdersvớicollectionvàn(từ 1 đến 1.000): thuộc nhóm holder lớn nhất của bộ sưu tập.is_creatorvớicollection: một trong các ví của họ đã tạo hoặc phát hành bộ sưu tập.royalty_compliantvớicollection: mọi NFT họ giữ từ bộ sưu tập đều được mint hoặc mua qua giao dịch có trả phí bản quyền.xrp_balancevớimin: giữ ít nhất lượng XRP đó.token_balancevớiissuer,currency(mã nhưRLUSD, hoặc dạng hex 40 ký tự) vàmin: giữ ít nhất lượng token đó.mpt_balancevớiissuance_id(48 ký tự hex) vàmin: giữ ít nhất lượng token đa năng đó.amm_lp_balancevớiamm_accountvàmin: giữ ít nhất số token thanh khoản đó của pool.wallet_invớiaddresses(từ 1 đến 10.000): một trong các ví của họ có trong danh sách.
Giới hạn
- 25 bộ sưu tập theo dõi mỗi server.
- 50 quy tắc vai trò mỗi server, mỗi vai trò một quy tắc.
- 20 feed mỗi server, mỗi kênh một feed.
- 10 kênh thống kê mỗi server, đổi tên tối đa mỗi 10 phút một lần.
- Mỗi server một snapshot holder mỗi 10 phút, tối đa khoảng 100.000 holder.
- 25 cảnh báo mỗi thành viên, và tối đa 30 tin nhắn cảnh báo gửi cho họ mỗi giờ.
- Bình chọn có từ 2 đến 10 lựa chọn; rút thăm chọn từ 1 đến 100 người thắng; allowlist, bình chọn, rút thăm và sự kiện có thể kéo dài tối đa 90 ngày.
- Mỗi thành viên có thể dùng bot 20 lần mỗi phút. Vượt quá, bot sẽ nhắc họ chậm lại.
Quyền riêng tư và an toàn
Khi xác minh, bot sẽ nhận địa chỉ các ví trong tài khoản First Ledger của bạn. Bot không bao giờ thấy khóa và bạn không bao giờ phải ký giao dịch. Ai yêu cầu bạn ký thì đó không phải bot này.
Bot chỉ yêu cầu những quyền nó dùng và không bao giờ yêu cầu quyền Administrator. Bot từ chối cấp vai trò có quyền kiểm duyệt hoặc quản trị.
Bot chỉ gỡ những vai trò do nó cấp. Vai trò do moderator cấp thủ công cho bạn vẫn được giữ.
Ứng dụng khác chỉ xem được các ví đã liên kết của bạn nếu bạn cho phép đích danh bằng /privacy allow, và bạn có thể thu hồi bất cứ lúc nào.
/unlink xóa liên kết của bạn và gỡ các vai trò bot đã cấp cho bạn ở mọi server.
Khắc phục sự cố
Không có vai trò sau khi xác minh: chạy /refresh. Nếu vẫn không có, hãy nhờ admin chạy /check-permissions; có thể vai trò của bot đang nằm dưới vai trò holder.
Liên kết báo đã hết hạn: mỗi liên kết dùng được một lần trong mười phút. Hãy chạy lại /verify.
“Một tài khoản Discord khác”: bạn đã xác nhận bằng tài khoản Discord khác với tài khoản đã chạy lệnh. Hãy đổi tài khoản trong Discord và chạy lại /verify.
Một feed ngừng đăng: chạy /admin feed list. Feed mà bot không thể đăng được nữa sẽ bị tắt, và /admin audit cho biết lý do.
Vai trò theo số dư không thay đổi: các vai trò này cập nhật khi kiểm tra lại hằng giờ. Chạy /refresh để kiểm tra ngay.