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 組合上述任一條件,例如持有三個以上 AND 持有一百 XRP。

成員 First Ledger 帳戶中的所有錢包會合併計算,因此在自己的錢包之間轉移 NFT 不會失去身分組。

以 NFT 為條件的身分組會在成交後數秒內更新。以餘額為條件的身分組會在每小時重新檢查時更新,成員執行 /refresh 時則立即更新。

只有 XRP Ledger 才能實現的身分組

已上架的 NFT 仍會計算。在 XRP Ledger 上,上架出售的 NFT 在售出前都會留在你的錢包中,因此上架不會讓成員失去身分組。若想獎勵不上架的持有者,可設定已上架 NFT 比例的規則。

持有天數:持有 NFT 達一定天數。效果類似質押,但不需鎖倉。

會員通行證:鑄造時未設定可轉移標記的 NFT 只能退回創作者,因此無法出售。這類通行證可打造無法用錢買到的會員身分組。

流動性提供者:持有 AMM 池的流動性代幣,例如你專案代幣的池子。同樣用 /admin role token 設定。

支付版稅的持有者:系列中每個 NFT 都是透過鑄造或支付創作者版稅的交易取得,而非免費轉讓。

動態通知與伺服器工具

用 /admin feed add 建立動態通知:選擇頻道、要發布的活動類型(成交、上架、鑄造、轉移、銷毀、出價)、最低價格,以及完整或精簡版面。同一買家在同一 ledger 中的多筆購買會合併為一則掃貨通知。

價格以成交時使用的幣別顯示,若有 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
面板的發布位置。留空則 bot 會建立 #verify,需要「管理頻道」權限。

/check-permissions

管理伺服器

檢查機器人所需的每項權限、每條身分組規則(身分組仍存在,且位於機器人的身分組之下)及每個動態頻道,以勾或叉標示,並說明如何修正。若機器人被授予不需要的「管理員」權限,會發出警告。

/admin collection add

管理伺服器

追蹤收藏系列,讓其動態傳到你的動態頻道,持有者取得你的身分組。若市集已標記該收藏系列,會發出警告。

collection必填
系列。

/admin collection remove

管理伺服器

停止追蹤收藏系列。

collection必填
系列。

/admin collection list

管理伺服器

列出此伺服器追蹤的收藏系列。

持有者身分組

/admin role set

管理伺服器

將身分組給予持有足夠數量收藏系列的成員。對同一身分組再次設定會取代原規則。已連結的成員會立即重新檢查。

role必填
低於 bot 自身角色的一般角色。bot 不接受 @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必填
低於 bot 自身角色的一般角色。bot 不接受 @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必填
低於 bot 自身角色的一般角色。bot 不接受 @everyone、由其他應用程式管理的角色,以及具有管理員或管理權限的角色。
rule必填
規則,最多 6,000 個字元。

/admin role remove

管理伺服器

刪除身分組的規則,並從機器人給予該身分組的成員身上移除它。

role必填
低於 bot 自身角色的一般角色。bot 不接受 @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

管理伺服器

立即截止報名並抽出得獎者。抽獎以已驗證 ledger 的雜湊值作為種子,公告中會顯示,任何人都能重新驗算。

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 可立即檢查。