Discordボット
First Ledgerボットは、保有するNFTやトークンに応じてDiscordメンバーにロールを付与し、コレクションの販売をリアルタイムで投稿し、アローリスト、投票、抽選も運営します。XRP Ledger上のあらゆるコレクションに対応しています。
できること
ホルダーロール:メンバーが一度ウォレットを連携すれば、売買に応じてボットがロールを付与・解除します。通常は販売から数秒以内です。
フィード:コレクションの販売、出品、ミント、オファーを、選んだチャンネルに投稿します。
サーバー向けツール:チャンネル名へのフロア価格とホルダー数のリアルタイム表示、ホルダーのスナップショット、監査ログ、管理者用のWebダッシュボード。
コミュニティ:アローリスト、ホルダー投票、抽選、イベント、個人向けアラート。
無料です。すべての機能を、すべてのサーバーとコレクションで使えます。
サーバーに追加する
First Ledgerでボットのページを開き、「Discordに追加」を選びます。追加先のサーバーで「サーバー管理」権限が必要です。
Discordにボットが求める6つの権限が表示されます。すべてチェックしたままにしてください。どれも使用します。
- ロールの管理:ホルダーロールを付与・解除します。これがないとロールは付与されません。
- チャンネルの管理:
/setupで#verifyチャンネルを作成し、チャンネル名のフロア価格とホルダー数を最新に保ちます。 - チャンネルを見る:ボットが投稿先のチャンネルを見られるようにします。
- メッセージを送信:フィード、認証パネル、投票、抽選、イベントを投稿します。
- 埋め込みリンク:販売や出品を、NFTの画像と価格付きのカードで表示します。
- ファイルを添付:
/admin snapshot takeでホルダー一覧をCSVファイルとして送信できます。
管理者、サーバー管理、キックやBANの権限は一切求めません。ボットのロールにはこの6つ以外は不要なので、他はすべてオフのままにしてください。
サーバー設定 → ロールで、ボットのロールを付与させたいすべてのロールより上にドラッグします。Discordでは、ボットは自分より下のロールしか付与できません。
/check-permissionsを実行します。すべて緑のチェックになればOKです。赤い項目には修正方法が表示されます。
/admin collection addでコレクションを追加します。名前を入力し始めて、リストから選んでください。
/admin role setでホルダーロールを作成します。ロールとコレクションを選び、段階を設けたい場合は最小・最大数も指定します。特定の属性や、一定日数以上の保有を条件にすることもできます。
/setupで認証パネルを投稿します。#verifyチャンネルを作成するか指定したチャンネルを使い、メンバーがクリックする認証ボタンを設置します。
これらはすべてダッシュボードでも行えます。Discordでサインインすると、管理しているサーバーが一覧表示されます。
ホルダーロール
保有数:コレクションのNFTを一定数以上(任意で上限も)保有。Holder、Collector、Whaleのような段階を作れます。
トレイト:Background: Goldなど、指定したトレイトを持つNFTを保有。
レア度・ランク:コレクション内で上位N位以内のNFTを保有、または保有者ランキングの上位N人に入っている。
クリエイター:コレクションのクリエイターまたは発行者のウォレット。
残高:XRP、XRP Ledgerで発行されたトークン(First Ledgerでローンチされたトークンを含む)、またはマルチパーパストークンを一定量保有。/admin role tokenで設定します。ロール、確認する対象、最小値を選ぶと、Botがメンバーの連携ウォレット全体の残高を合算します。
ウォレット:貼り付けたアドレスのリスト。
組み合わせ:ダッシュボードの詳細エディタで、上記をAND、OR、NOTで組み合わせ。例:3個以上保有 AND 100 XRP保有。
メンバーのFirst Ledgerアカウントにある全ウォレットが合算されるため、自分のウォレット間でNFTを移動してもロールを失うことはありません。
NFTに基づくロールは、売買から数秒以内に更新されます。残高に基づくロールは1時間ごとの再チェック時、またはメンバーが/refreshを実行するとすぐに更新されます。
XRP Ledgerならではのロール
出品中のNFTもカウントされます。XRP Ledgerでは、出品したNFTは購入されるまでウォレットに残るため、出品してもロールを失いません。出品しないホルダーを優遇したい場合は、出品中NFTの割合に関するルールを使えます。
保有期間:NFTを一定日数以上保有。ロックなしのステーキングのように使えます。
メンバーシップパス:譲渡可能フラグなしでミントされたNFTはクリエイターにしか戻せず、売却できません。これを使えば、購入できないメンバーロールを作れます。
流動性プロバイダー:プロジェクトのトークンのプールなど、AMMプールの流動性トークンを保有。これも/admin role tokenで設定します。
ロイヤリティを支払ったホルダー:保有するコレクションのNFTがすべて、無償で受け取ったものではなく、ミントまたはクリエイターにロイヤリティを支払った売買で購入されたもの。
フィードとサーバーツール
/admin feed addでフィードを開始:チャンネル、投稿するアクティビティの種類(売買、出品、ミント、転送、バーン、オファー)、最低価格、フルまたはコンパクト表示を選べます。同じレジャー内での同一購入者による複数購入は、スイープとしてまとめて投稿されます。
価格は売買に使われた通貨で表示され、わかる場合はXRP換算額も併記されます。
/admin stat addで統計チャンネルを作成:チャンネル名にフロア価格、ホルダー数、出品数、当日の取引量、またはロール保有メンバー数を表示し、10分ごとに更新します。
/admin snapshot takeでスナップショットを取得:コレクションの全ホルダーをスプレッドシートで出力します。Discord IDをオンにしても、名前が表示されるのは自分のサーバーのメンバーのみです。
/admin auditで、Botが付与・削除したすべてのロールとその理由を確認できます。
アローリスト、投票、抽選、イベント
/allowlist createで参加ボタンを投稿します。条件を満たすメンバーは連携ウォレットで参加でき、締め切り後にリストをスプレッドシートで書き出せます。
/poll createで投票を投稿します。票数はメンバーごとに1票、または保有NFTごとに1票にできます。
/raffle create で「参加」ボタンを投稿します。当選者は応募締切後にクローズした XRP Ledger のレジャーのハッシュから抽選され、発表にそのハッシュが表示されるので、誰でも抽選が公正だったか確認できます。
/event create でメンバーが参加登録できるイベントを投稿します。ホルダー限定や定員の設定も可能です。
メンバーは /alerts で DM 通知をオンにできます:自分の NFT へのオファー、詐欺の疑いがあるオファーの警告、コレクション内の売買、指定価格を下回る出品など。
メンバー向け:認証
サーバー内の「認証」をクリックするか、/verify を実行します。ボットがあなただけに見えるリンクを返信します。
リンクから First Ledger が開きます。いつもどおりウォレットでサインインし、「続行」を選びます。
Discord がアカウントの確認を求めます。確認すると、数秒でロールが付与されます。
その後 First Ledger アカウントにウォレットを追加した場合は、/verify を再度実行してから /refresh を実行してください。
他人から送られた認証は絶対に完了しないでください。各リンクはコマンドを実行した本人専用で、その人しか使えません。
全コマンド
管理者コマンドには「サーバー管理」権限が必要で、Discord はその権限を持つ人にだけ表示します。ほとんどの返信はあなただけに表示されますが、/floor、/collection、/nft はチャンネルに全員向けに投稿されます。コレクションのオプションでは名前を入力し始めてリストから選択してください。サーバーのコレクションが先に、続いてマーケットプレイスのコレクションが表示されます。
全員向け
/verify
全員First Ledger アカウントのウォレットをリンクするためのリンクを、あなただけに表示されるかたちで送ります。リンクはあなた専用で、有効期限は10分です。トランザクションへの署名は不要です。
/wallets
全員リンク済みのウォレットを、First Ledger の各ページへのリンク付きで一覧表示します。
/refresh
全員First Ledger からウォレットを再読み込みし、すぐにロールを再チェックします。ウォレットを追加した後や、残高ロールが反映されないときに使ってください。
/roles
全員このサーバーのホルダーロールと各条件を一覧表示し、取得済みのものにチェックを付けます。
/floor
全員1つのコレクション、またはサーバーのコレクション最大15件について、フロア価格、過去1日の変動、出品数を投稿します。
collection- 対象のコレクション。省略するとサーバーの全コレクションが対象です。
/collection
全員コレクションの統計を投稿します:フロア、最高オファー、出品数、ホルダー数、取引量、販売数、ロイヤリティ、認証の有無。
collection必須- コレクション。
/nft
全員NFT のカードを投稿します:画像、所有者、レアリティ順位、出品中なら価格、ロイヤリティ、フラグ、属性。
id必須- NFTの
NFTokenID(64文字)。
/portfolio
全員リンク済みウォレットにあるあなたの NFT を、コレクションごとにまとめて表示します。
/alerts add
全員DM アラートをオンにします。同じコレクションに同じ種類を再度追加すると、価格が置き換わります。サーバーメンバーからの DM を許可しておかないと、ボットから通知が届きません。
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
サーバー管理Botに必要なすべての権限、すべてのロールルール(ロールが存在し、Botのロールより下にあるか)、すべてのフィードチャンネルを確認し、✓または✗と修正方法を表示します。Botに不要な管理者権限が付与されている場合は警告します。
/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)。複数指定は|で区切り、いずれか1つが一致すれば対象です。held-days- さらに、1つのNFTをこの日数以上保有していることを条件にします(1〜3,650)。
/admin role token
サーバー管理メンバーの連携ウォレット全体の合計残高に応じてロールを付与します。対象はXRP、XRP Ledgerで発行されたトークン、マルチパーパストークン、AMMプールの流動性トークンです。残高は1時間ごと、またはメンバーが/refreshを実行したときに再確認されます。
role必須- ボット自身のロールより下の一般ロール。@everyone、他のアプリが管理するロール、管理者やモデレーション権限を持つロールは使用できません。
kind必須xrp、XRP Ledgerで発行されたトークンはtoken、マルチパーパストークンはmpt、AMMプールの流動性トークンはlp。min必須- 最低残高(0より大きい値)。
issuertokenの場合:発行者のアドレス。currencytokenの場合:トークンコード(例:RLUSD)。issuance-idmptの場合:48文字の発行ID。poollpの場合:AMMプールのアカウントアドレス。
/admin role set-json
サーバー管理JSONで記述したルールでロールを付与します。以下の条件を自由に組み合わせられます。
role必須- ボット自身のロールより下の一般ロール。@everyone、他のアプリが管理するロール、管理者やモデレーション権限を持つロールは使用できません。
rule必須- ルール(最大6,000文字)。
/admin role remove
サーバー管理ロールのルールを削除し、Botが付与したメンバーからそのロールを外します。
role必須- ボット自身のロールより下の一般ロール。@everyone、他のアプリが管理するロール、管理者やモデレーション権限を持つロールは使用できません。
/admin role list
サーバー管理すべてのロールルールをわかりやすく一覧表示し、有効かどうかを示します。
フィードとサーバーツール
/admin feed add
サーバー管理アクティビティをチャンネルに投稿します。投稿できるか確認するため、Botは最初にテストメッセージを送信します。既存のフィードがあるチャンネルに追加すると更新されます。
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。collectionrole以外のすべての種類で必須。roleroleで必須。template- チャンネル名(3〜90文字)。
{floor} {holders} {listed} {supply} {volume24h} {sales24h} {bid} {count}のいずれかを1つ以上含めてください。
/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- または
/admin role set-jsonと同様に 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は1人1票・1エントリー、nftは保有 NFT 1つにつき1票。weight-collectionnftでカウントするコレクション。eligibility-collection- このコレクションのホルダーのみ参加できます。空欄にするとウォレット連携済みの全員が対象です。
eligibility-min- 必要な保有数。デフォルトは 1。
/poll close
サーバー管理投票を今すぐ締め切り、結果を投稿します。
id必須- 投稿のフッターにある ID。
/raffle create
サーバー管理「参加」ボタン付きの抽選を投稿します。
prize必須- 最大 200 文字。
winners必須- 1~100。
duration-hours必須- 実施期間(時間単位、最大2,160時間、90日)。
weightingmemberは1人1票・1エントリー、nftは保有 NFT 1つにつき1票。weight-collectionnftでカウントするコレクション。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 個まで含められます。
各条件はメンバーの連携済みウォレットすべてをまとめて判定し、連携ウォレットがない人は false になります。レジャーに接続できないときなど、ボットが条件を判定できない場合、メンバーは現在のロールを保持します。
JSON の type 別の条件一覧です。コレクションはマーケットプレイスの 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をその数だけ保有している。held_for(collection、days(1〜3,650)、min):その数を指定日数以上保有している。rarity_rank(collection、max_rank):そのランク以上にレアなNFTを保有している。listed_ratio(collection、maxは0〜1の割合):保有NFTのうち出品している割合がその値以下。1つも保有していない場合はfalse。top_holders(collection、n(1〜1,000)):コレクションの上位ホルダーである。is_creator(collection):いずれかのウォレットがコレクションを作成または発行した。royalty_compliant(collection):保有するそのコレクションのNFTがすべて、ミントまたはロイヤリティ支払い済みの売買で入手したもの。xrp_balance(min):XRPをその額以上保有している。token_balance(issuer、currency(RLUSDなどのコード、または40文字の16進形式)、min):そのトークンを指定量以上保有している。mpt_balance(issuance_id(16進48文字)、min):そのマルチパーパストークンを指定量以上保有している。amm_lp_balance(amm_account、min):プールの流動性トークンを指定量以上保有している。wallet_in(addresses(1〜10,000)):いずれかのウォレットがリストに含まれている。
制限
- 追跡コレクションは1サーバーあたり25件。
- ロールルールは1サーバーあたり50件(1ロールにつき1件)。
- フィードは1サーバーあたり20件(1チャンネルにつき1件)。
- 統計チャンネルは1サーバーあたり10件。名前の更新は最短10分ごと。
- ホルダースナップショットは1サーバーにつき10分ごとに1回、最大約100,000人まで。
- アラートはメンバー1人あたり25件、通知メッセージは1時間に最大30件。
- 投票の選択肢は2〜10個、抽選の当選者は1〜100人。許可リスト、投票、抽選、イベントの期間は最長90日です。
- 各メンバーはボットを1分間に20回まで使えます。超えるとペースを落とすよう案内されます。
プライバシーと安全性
認証では、First Ledger アカウントのウォレットアドレスをボットと共有します。ボットが鍵を見ることはなく、トランザクションへの署名を求めることもありません。署名を求めてくる相手は、このボットではありません。
ボットは使用する権限のみを要求し、管理者権限は決して求めません。モデレーションや管理者権限を持つロールの付与は拒否します。
ボットが削除するのは、自分が付与したロールだけです。モデレーターが手動で付与したロールはそのまま残ります。
他のアプリがあなたのリンク済みウォレットを見られるのは、/privacy allow で名前を指定して許可した場合のみです。許可はいつでも取り消せます。
/unlink でリンクを削除し、すべてのサーバーでボットが付与したロールを外します。
トラブルシューティング
認証後にロールが付かない:/refresh を実行してください。それでも付かない場合は、管理者に /check-permissions の実行を依頼してください。ボットのロールがホルダーロールより下にある可能性があります。
リンクの期限切れと表示される:各リンクの有効期限は10分で、使えるのは1回のみです。/verify をもう一度実行してください。
「別の Discord アカウント」と表示される:コマンドを実行したものとは別の Discord アカウントで承認しています。Discord でアカウントを切り替え、/verify をもう一度実行してください。
フィードが止まった:/admin feed list を実行してください。ボットが投稿できなくなったフィードはオフになります。理由は /admin audit で確認できます。
残高ロールが変わらない:残高ロールは1時間ごとの再チェックで更新されます。今すぐ確認するには /refresh を実行してください。