Discord 机器人
First Ledger 机器人会根据成员持有的 NFT 和代币为其分配 Discord 身份组,实时发布你的系列成交动态,还能管理白名单、投票和抽奖,适用于 XRP Ledger 上的任何系列。
功能介绍
持有者身份组:成员只需关联一次钱包,机器人便会随其买卖自动授予或移除身份组,通常在成交后几秒内完成。
动态推送:将你系列的成交、挂单、铸造和出价发布到你指定的频道。
服务器工具:在频道名称中实时显示地板价和持有者数量,支持持有者快照、审计日志,以及供管理员使用的网页控制台。
社区功能:白名单、持有者投票、抽奖、活动和个人提醒。
完全免费:所有功能,适用于所有服务器和所有系列。
添加到你的服务器
在 First Ledger 上打开机器人页面,选择“添加到 Discord”。你需要在目标服务器中拥有“管理服务器”权限。
随后 Discord 会显示机器人请求的六项权限。请全部保持勾选:每一项都会用到。
- 管理身份组用于授予和移除持有者身份组。没有此权限,将无法分配任何身份组。
- 管理频道让
/setup能创建 #verify 频道,并实时更新频道名称中的地板价和持有者数量。 - 查看频道让机器人能看到它发布内容的频道。
- 发送消息用于发布动态、验证面板、投票、抽奖和活动。
- 嵌入链接将每笔成交和挂单显示为带有 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。
按稀有度或排名:持有合集中排名前 N 的 NFT,或位列持有者前 N 名。
创作者:合集的创作者或发行方钱包。
按余额:持有一定数量的 XRP、XRP Ledger 上发行的代币(包括在 First Ledger 上发行的代币)或多用途代币。用 /admin role token 设置:选择角色、检查项和最低数量,机器人会汇总成员所有已关联钱包的余额。
按钱包:粘贴一份地址列表。
组合条件:在控制台的高级编辑器中用 AND、OR 和 NOT 组合以上任意条件,例如持有 3 个及以上 AND 持有 100 XRP。
成员 First Ledger 账户下的所有钱包合并计算,在自己的钱包之间转移 NFT 不会失去角色。
基于 NFT 的角色在成交后几秒内更新。基于余额的角色在每小时复查时更新,成员运行 /refresh 时会立即更新。
只有 XRP Ledger 才能实现的角色
挂单中的 NFT 仍然计入。在 XRP Ledger 上,挂单出售的 NFT 在被买走前一直留在你的钱包里,所以挂单不会让成员失去角色。如果想奖励不挂单的持有者,可以按挂单 NFT 的占比设置规则。
持有时长:持有某个 NFT 至少一定天数。效果类似质押,但无需锁仓。
会员通行证:未设置可转让标志铸造的 NFT 只能退回给创作者,因此无法出售。这样的通行证可以用作无法购买的会员角色。
流动性提供者:持有某个 AMM 池的 LP 代币,例如你项目代币的池子。同样用 /admin role token 设置。
支付版税的持有者:合集中的每个 NFT 都是通过铸造或支付了创作者版税的交易获得的,而不是无偿转来的。
动态推送和服务器工具
用 /admin feed add 开启推送:选择频道、要发布的活动类型(成交、挂单、铸造、转移、销毁、出价)、最低价格,以及完整或紧凑布局。同一买家在同一账本中的多笔购买会合并为一次扫货发布。
价格以成交时使用的币种显示,如已知 XRP 价值会一并显示。
用 /admin stat add 创建统计频道:频道名称显示地板价、持有者数、挂单数、当日成交量或拥有某角色的成员数,每十分钟刷新一次。
用 /admin snapshot take 生成快照:以表格形式导出合集的所有持有者。开启 Discord ID 后,只会显示你自己服务器成员的名字。
用 /admin audit 查看机器人授予或移除的每个角色及原因。
白名单、投票、抽奖和活动
/allowlist create 会发布一个加入按钮。符合条件的成员用已关联钱包加入;结束后可将名单导出为表格。
/poll create 会发布投票。可设置每位成员一票,或每持有一个 NFT 一票。
/raffle create 会发布一个“参加”按钮。中奖者由报名截止后关闭的 XRP Ledger 账本哈希抽出,公告中会显示该哈希,任何人都能验证抽奖是否公平。
/event create 会发布一个成员可报名的活动,可选择仅限持有者参加并设置人数上限。
成员可通过 /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必填- 该 NFT 的
NFTokenID,长度为 64 个字符。
/portfolio
任何人按合集分组显示你所有关联钱包中的 NFT。
/alerts add
任何人开启私信提醒。对同一合集再次添加同类提醒会替换其价格。请允许服务器成员给你发私信,否则机器人无法联系你。
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
管理服务器为持有足够数量某合集的成员授予角色。对同一角色再次设置会替换原规则。已关联的成员会立即重新检查。
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 上发行的代币、多用途代币,或 AMM 池的流动性代币。余额每小时重新检查一次,成员运行 /refresh 时也会检查。
role必填- 一个低于机器人自身角色的普通角色。机器人不接受 @everyone、由其他应用管理的角色,以及任何拥有管理员或审核权限的角色。
kind必填xrp;token为 XRP Ledger 上发行的代币;mpt为多用途代币;lp为 AMM 池的流动性代币。min必填- 最低余额,须大于零。
issuer- 适用于
token:发行方地址。 currency- 适用于
token:代币代码,例如RLUSD。 issuance-id- 用于
mpt:48 个字符的发行 ID。 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
管理服务器创建一个锁定的语音频道,名称显示实时数字,例如地板价。数字变化时更新,最多每 10 分钟一次。
kind必填floor、holders、volume(当日交易量)、listed,或role(拥有某角色的成员数)。collection- 除
role外均为必填。 rolerole必填。template- 频道名称,3 到 90 个字符,须包含
{floor} {holders} {listed} {supply} {volume24h} {sales24h} {bid} {count}中至少一个。
/admin stat remove
管理服务器停止更新统计频道。频道本身会保留。
channel必填- 频道。
/admin snapshot take
管理服务器以 CSV 文件发送合集的所有持有者:地址、用户名、持有数量及占比。
collection必填- 合集。
min- 仅限持有至少此数量的用户。
with-discord- 添加 Discord ID 列。仅显示已关联的本服务器成员。
/admin snapshot list
管理服务器列出最近的快照。
/admin audit
管理服务器显示最近 25 次角色和规则变更及各自原因。
user- 仅显示该成员的更改。
/admin reconcile
管理服务器立即重新检查所有已关联成员。变更会显示在 /admin audit 中。
白名单、投票、抽奖和活动
/allowlist create
管理服务器发布带有加入按钮的白名单。符合条件的成员将使用其首个关联钱包加入。
name必填- 名称,最多 60 个字符,不得与本服务器其他白名单重名。
max-entries- 最多可加入人数。
closes-in-hours- 在此小时数后关闭,最多 2,160 小时(90 天)。
eligibility-collection- 仅该合集的持有者可参与。留空则所有已关联钱包的用户均可参与。
eligibility-min- 须持有的数量。默认为 1。
rule-json- 或使用任意 JSON 规则,格式同
/admin role set-json。
/allowlist close
管理服务器立即关闭白名单。
name必填- 名称,最多 60 个字符,不得与本服务器其他白名单重名。
/allowlist export
管理服务器以 CSV 文件发送白名单的报名记录。
name必填- 名称,最多 60 个字符,不得与本服务器其他白名单重名。
/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:持有指定数量的该合集灵魂绑定 NFT(即不可出售的 NFT)。held_for,配合collection、days(1 到 3,650)和min:已持有指定数量至少指定天数。rarity_rank,配合collection和max_rank:持有稀有度排名达到或高于该名次的 NFT。listed_ratio,配合collection和max(0 到 1 之间的比例):挂单的 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这样的代码,或其 40 位十六进制形式)和min:持有至少该数量的代币。mpt_balance,配合issuance_id(48 位十六进制字符)和min:持有至少该数量的多用途代币。amm_lp_balance,配合amm_account和min:持有至少该数量的资金池流动性代币。wallet_in,配合addresses(1 到 10,000 个):其某个钱包在列表中。
限制
- 每个服务器最多追踪 25 个合集。
- 每个服务器最多 50 条角色规则,每个角色一条。
- 每个服务器最多 20 个动态推送,每个频道一个。
- 每个服务器最多 10 个统计频道,最多每 10 分钟重命名一次。
- 每个服务器每 10 分钟可生成一次持有者快照,最多约 100,000 名持有者。
- 每位成员最多 25 个提醒,每小时最多收到 30 条提醒消息。
- 投票可设 2 到 10 个选项;抽奖可抽出 1 到 100 名中奖者;白名单、投票、抽奖和活动最长可持续 90 天。
- 每位成员每分钟可使用机器人 20 次,超出后会提示其放慢速度。
隐私与安全
验证时,机器人只会获取你 First Ledger 账户中钱包的地址。它不会接触任何密钥,也不会要求你签署交易。任何要求你签名的都不是本机器人。
机器人只申请它实际用到的权限,绝不申请管理员权限。它也不会发放带有审核或管理权限的身份组。
它只移除自己发放的身份组。管理员手动给你的身份组会保留。
只有你通过 /privacy allow 按名称授权后,其他应用才能看到你关联的钱包,你可以随时撤销。
/unlink 会删除你的关联,并移除机器人在所有服务器中给你的身份组。
故障排除
验证后没有身份组:运行 /refresh。如果仍未出现,请管理员运行 /check-permissions;很可能是机器人的身份组排在持有者身份组之下。
链接提示已过期:每个链接有效期为十分钟,且只能使用一次。请重新运行 /verify。
“另一个 Discord 账户”:你确认时使用的 Discord 账户与运行命令的账户不同。请在 Discord 中切换账户,然后重新运行 /verify。
推送停止了:运行 /admin feed list。机器人无法再发布的推送会被关闭,/admin audit 会说明原因。
余额身份组没有变化:这类身份组会在每小时复查时更新。运行 /refresh 可立即检查。