First Ledger NFT
作成サインイン状態を確認中

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などのランク分けに使います。
trait
Type: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より大きい値)。
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

サーバー管理

ロールのルールを削除し、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 未満のものはスキップします。転送など価格のないアクティビティもスキップされます。
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} のいずれかを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日)。
weighting
member は1人1票・1エントリー、nft は保有 NFT 1つにつき1票。
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 は1人1票・1エントリー、nft は保有 NFT 1つにつき1票。
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 個まで含められます。

各条件はメンバーの連携済みウォレットすべてをまとめて判定し、連携ウォレットがない人は 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 を実行してください。