First Ledger NFT
TạoĐang kiểm tra trạng thái đăng nhập

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 để /setup tạ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 take gử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ười

Gử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ười

Liệ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ười

Tả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ười

Liệ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ộc
NFTokenID của NFT, dài 64 ký tự.

/portfolio

Mọi người

Hiể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ười

Bậ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ộc
offer_received cho 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_sale cho giao dịch bán trong bộ sưu tập, hoặc listing_below cho 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ười

Tắt một thông báo.

kindbắt buộc
offer_received cho 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_sale cho giao dịch bán trong bộ sưu tập, hoặc listing_below cho 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ười

Liệt kê các thông báo của bạn.

/privacy allow

Mọi người

Cho 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ười

Ngừ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ười

Liệt kê các ứng dụng đối tác bạn đang chia sẻ.

/unlink

Mọi người

Xó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ười

Cho 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.
trait
Type: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ộc
xrp, token cho token phát hành trên XRP Ledger, mpt cho multi-purpose token, hoặc lp cho 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_expired và 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.
layout
full hoặc compact.

/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ộc
full hoặc compact.

/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ộc
floor, holders, volume cho khối lượng trong ngày, listed, hoặc role cho 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).
weighting
member: mỗi người một phiếu hoặc một lượt, hoặc nft: 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).
weighting
member: mỗi người một phiếu hoặc một lượt, hoặc nft: 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.

  • holds với collection, min và max (tùy chọn): sở hữu số NFT đó từ bộ sưu tập.
  • holds_trait với collection, traits (từ 1 đến 12, mỗi mục viết dạng Type:Value) và min: sở hữu số NFT đó có bất kỳ thuộc tính nào trong danh sách.
  • holds_any_verified với min: sở hữu số NFT đó từ các bộ sưu tập đã xác minh, bất kể bộ nào.
  • holds_non_transferable với collection và 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_for với collection, days (từ 1 đến 3.650) và min: đã giữ số NFT đó trong ít nhất số ngày đó.
  • rarity_rank với collection và max_rank: sở hữu một NFT có hạng hiếm bằng hoặc hiếm hơn mức đó.
  • listed_ratio với collection và 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_holders với collection và n (từ 1 đến 1.000): thuộc nhóm holder lớn nhất của bộ sưu tập.
  • is_creator với collection: một trong các ví của họ đã tạo hoặc phát hành bộ sưu tập.
  • royalty_compliant với collection: 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_balance với min: giữ ít nhất lượng XRP đó.
  • token_balance với issuer, currency (mã như RLUSD, hoặc dạng hex 40 ký tự) và min: giữ ít nhất lượng token đó.
  • mpt_balance với issuance_id (48 ký tự hex) và min: giữ ít nhất lượng token đa năng đó.
  • amm_lp_balance với amm_account và min: giữ ít nhất số token thanh khoản đó của pool.
  • wallet_in với addresses (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.