First Ledger NFT
创建正在检查登录状态

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 等等级。
trait
Type: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 数额的动态。无价格的动态(如转移)也会跳过。
layout
full 或 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 外均为必填。
role
role 必填。
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 天)。
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:持有指定数量的该合集灵魂绑定 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 可立即检查。