First Ledger NFT
SkapaKontrollerar om du är inloggad

Discord-boten

First Ledger-boten ger dina Discord-medlemmar roller för de NFTs och tokens de äger, postar din kollektions försäljningar direkt när de sker och sköter allowlists, omröstningar och utlottningar — för alla kollektioner på XRP Ledger.

Vad den gör

Innehavarroller: en medlem kopplar sina plånböcker en gång, och boten ger och tar bort roller när de köper och säljer, oftast inom några sekunder efter försäljningen.

Flöden: försäljningar, listningar, mints och bud för dina kollektioner, postade i de kanaler du väljer.

Verktyg för din server: floor och antal innehavare live i kanalnamn, ögonblicksbilder av innehavare, en granskningslogg och en webbpanel för admins.

Community: allowlists, omröstningar för innehavare, utlottningar, evenemang och personliga aviseringar.

Det är gratis: alla funktioner, för alla servrar och alla kollektioner.

Lägg till den på din server

Öppna botens sida på First Ledger och välj Lägg till i Discord. Du behöver behörigheten Hantera server på servern du lägger till den på.

Discord visar sedan de sex behörigheter boten ber om. Låt alla vara ikryssade: alla används.

  • Hantera roller ger och tar bort innehavarroller. Utan den delas inga roller ut.
  • Hantera kanaler låter /setup skapa kanalen #verify och håller floor och antal innehavare i kanalnamn uppdaterade.
  • Visa kanaler låter boten se kanalerna den postar i.
  • Skicka meddelanden postar flöden, verifieringspanelen, omröstningar, utlottningar och evenemang.
  • Bädda in länkar visar varje försäljning och listning som ett kort med NFT:ns bild och pris.
  • Bifoga filer låter /admin snapshot take skicka sin innehavarlista som en CSV-fil.

Den ber aldrig om Administratör, Hantera server eller rätt att kicka eller banna någon. Botens egen roll behöver inget utöver dessa sex, så låt allt annat vara avstängt.

Under Serverinställningar → Roller drar du botens roll ovanför alla roller du vill att den ska dela ut. Discord låter bara en bot ge roller under sin egen.

Kör /check-permissions. Varje rad ska ha en grön bock; varje röd visar vad som behöver åtgärdas.

Lägg till din kollektion med /admin collection add. Börja skriva namnet och välj den i listan.

Skapa en innehavarroll med /admin role set: välj roll, kollektion och, om du vill ha nivåer, ett minimum och maximum. Du kan också kräva en trait, eller att NFT:n har ägts ett visst antal dagar.

Posta verifieringspanelen med /setup. Den skapar en #verify-kanal, eller använder den du anger, med en Verifiera-knapp som medlemmar klickar på.

Allt här kan också göras i webbpanelen, där du loggar in med Discord och ser servrarna du hanterar.

Holder-roller

Efter antal: äg minst ett visst antal NFTs från en kollektion, och valfritt högst ett visst antal, så att du kan ha nivåer som Holder, Collector och Whale.

Efter egenskap: äg en NFT med en viss egenskap, till exempel Background: Gold.

Efter raritet eller rank: äg en NFT som rankas bland kollektionens topp N, eller var en av dess topp N-ägare.

Skapare: kollektionens skapar- eller utgivarplånbok.

Efter saldo: håll ett belopp i XRP, i en token utgiven på XRP Ledger (inklusive tokens lanserade på First Ledger) eller i en multi-purpose token. Ställ in dessa med /admin role token: välj roll, vad som ska kontrolleras och minimum, så summerar boten saldot över medlemmens länkade plånböcker.

Efter plånbok: en lista med adresser som du klistrar in.

Kombinerat: valfria av dessa kopplade med AND, OR och NOT i dashboardens avancerade redigerare – till exempel äger tre eller fler AND håller hundra XRP.

Alla plånböcker på en medlems First Ledger-konto räknas tillsammans, så att flytta en NFT mellan egna plånböcker kostar aldrig en roll.

NFT-baserade roller uppdateras inom sekunder efter en försäljning. Saldobaserade roller uppdateras vid den timvisa kontrollen, eller direkt när medlemmen kör /refresh.

Roller som bara XRP Ledger gör möjliga

Listade NFTs räknas fortfarande. På XRP Ledger stannar en NFT du listar till salu i din plånbok tills någon köper den, så en listning kostar aldrig en medlem rollen. Vill du belöna ägare som inte listar finns en regel för andelen listade NFTs.

Ägd i: en NFT som ägts i minst ett visst antal dagar. Fungerar som staking, utan att något låses.

Medlemspass: en NFT mintad utan transferable-flaggan kan bara gå tillbaka till skaparen och kan därför inte säljas. Ett sådant pass ger en medlemsroll som inte går att köpa.

Likviditetsgivare: håll LP-tokens från en AMM-pool, till exempel en pool för ditt projekts token. Detta ställs också in med /admin role token.

Royaltybetalande ägare: varje NFT i kollektionen köptes via mint eller i en försäljning som betalade skaparens royalty, i stället för att ges bort gratis.

Flöden och serververktyg

Starta ett flöde med /admin feed add: välj kanal, vilka typer av aktivitet som ska postas (försäljningar, listningar, mints, överföringar, burns, bud), ett minimipris och en full eller kompakt layout. Flera köp av samma köpare i samma ledger postas tillsammans som en sweep.

Priser visas i den valuta försäljningen gjordes i, med ett XRP-värde bredvid när det är känt.

Skapa en statistikkanal med /admin stat add: en kanal vars namn visar floor, ägare, antal listade, dagens volym eller antal medlemmar med en roll, uppdaterad var tionde minut.

Ta en snapshot med /admin snapshot take: alla ägare i en kollektion som ett kalkylark. Med Discord-id påslaget namnges bara medlemmar på din egen server.

Se varje roll boten gett eller tagit bort, och varför, med /admin audit.

Allowlists, omröstningar, utlottningar och evenemang

/allowlist create postar en Gå med-knapp. Medlemmar som uppfyller kravet går med med sin länkade plånbok; exportera listan som kalkylark när den stänger.

/poll create postar en omröstning. Röster kan räknas en per medlem eller en per ägd NFT.

/raffle create publicerar en Delta-knapp. Vinnarna dras utifrån hashen för en XRP Ledger-ledger som stängdes efter att anmälan stängt, och tillkännagivandet visar den, så att vem som helst kan kontrollera att dragningen var rättvis.

/event create publicerar ett evenemang som medlemmar kan OSA till, om du vill bara för innehavare och med ett maxantal.

Medlemmar kan slå på DM-aviseringar med /alerts: bud på deras NFTs, en varning när ett bud ser ut som bedrägeri, försäljningar i en kollektion eller listningar under ett pris.

För medlemmar: verifiering

Klicka på Verifiera i servern eller kör /verify. Boten svarar med en länk som bara du ser.

Länken öppnar First Ledger. Logga in med din wallet som vanligt och välj Fortsätt.

Discord ber dig bekräfta ditt konto. Bekräfta, så dyker dina roller upp inom några sekunder.

Har du lagt till en wallet i ditt First Ledger-konto sedan dess? Kör /verify igen och sedan /refresh.

Slutför aldrig en verifiering som någon annan skickat till dig. Varje länk tillhör den som körde kommandot och fungerar bara för hen.

Alla kommandon

Adminkommandon kräver behörigheten Hantera server, och Discord visar dem bara för dem som har den. De flesta svar syns bara för dig; /floor, /collection och /nft publiceras i kanalen för alla. Börja skriva en kollektions namn i valfritt kollektionsalternativ och välj den i listan: serverns kollektioner visas först, sedan marknadsplatsens.

För alla

/verify

Alla

Skickar en länk, synlig bara för dig, för att länka plånböckerna på ditt First Ledger-konto. Länken är bara din och gäller i tio minuter. Du signerar aldrig någon transaktion.

/wallets

Alla

Listar dina länkade plånböcker, var och en med länk till sin sida på First Ledger.

/refresh

Alla

Laddar om dina plånböcker från First Ledger och kontrollerar dina roller direkt. Använd det efter att du lagt till en plånbok, eller när en saldoroll inte hunnit uppdateras.

/roles

Alla

Listar serverns holder-roller och vad var och en kräver, och bockar för de du har.

/floor

Alla

Postar floorpriset, dess förändring senaste dygnet och antal listade, för en kollektion eller upp till 15 av serverns.

collection
En kollektion. Utelämna för alla serverns kollektioner.

/collection

Alla

Postar en kollektions statistik: floor, bästa bud, listade, holders, volym, försäljningar, royalty och om den är verifierad.

collectionobligatoriskt
Kollektionen.

/nft

Alla

Postar ett NFT-kort: bild, ägare, raritetsrank, pris om listad, royalty, flaggor och egenskaper.

idobligatoriskt
NFT:ns NFTokenID, 64 tecken lång.

/portfolio

Alla

Visar dina NFTs i dina länkade plånböcker, grupperade per kollektion.

/alerts add

Alla

Slår på en DM-avisering. Lägger du till samma typ för samma kollektion igen ersätts dess pris. Håll DM från servermedlemmar öppna, annars kan boten inte nå dig.

kindobligatoriskt
offer_received för bud på dina NFTs, suspicious_offer för en varning när ett bud ser ut som bedrägeri, collection_sale för försäljningar i en kollektion eller listing_below för listningar under ett pris.
collection
Krävs för aviseringar om försäljningar och listningar.
price
I XRP: minsta försäljning att avisera om, eller för listningar, högsta pris.

/alerts remove

Alla

Stänger av en avisering.

kindobligatoriskt
offer_received för bud på dina NFTs, suspicious_offer för en varning när ett bud ser ut som bedrägeri, collection_sale för försäljningar i en kollektion eller listing_below för listningar under ett pris.
collection
Krävs för aviseringar om försäljningar och listningar.

/alerts list

Alla

Listar dina aviseringar.

/privacy allow

Alla

Låter en partnerapp slå upp dina länkade plånböcker.

partnerobligatoriskt
Partnerappens namn.

/privacy revoke

Alla

Slutar dela med en partnerapp.

partnerobligatoriskt
Partnerappens namn.

/privacy status

Alla

Listar partnerapparna du delar med.

/unlink

Alla

Tar bort din länk och rollerna boten gett dig på alla servrar du delar med den.

/help

Alla

Visar om du är länkad, och en kort guide till de här kommandona.

Konfiguration

/setup

Hantera server

Publicerar Verify-panelen som medlemmar klickar på för att länka sina plånböcker och kommer ihåg kanalen. Utan kanal skapas #verify.

channel
Var panelen ska publiceras. Utelämna så skapar boten #verify, vilket kräver Hantera kanaler.

/check-permissions

Hantera server

Kontrollerar alla behörigheter boten behöver, alla rollregler (att rollen finns kvar och ligger under botens roll) och alla flödeskanaler, med bock eller kryss och vad som behöver åtgärdas. Varnar om boten har fått Administratör, vilket den inte behöver.

/admin collection add

Hantera server

Bevakar en kollektion så att dess aktivitet kan nå dina flöden och dess innehavare dina roller. Varnar om marknadsplatsen har flaggat kollektionen.

collectionobligatoriskt
Kollektionen.

/admin collection remove

Hantera server

Slutar bevaka en kollektion.

collectionobligatoriskt
Kollektionen.

/admin collection list

Hantera server

Listar kollektionerna som servern bevakar.

Innehavarroller

/admin role set

Hantera server

Ger en roll till medlemmar som äger tillräckligt av en kollektion. Om du ställer in den igen för samma roll ersätts regeln. Länkade medlemmar kontrolleras direkt.

roleobligatoriskt
En vanlig roll under botens egen. Boten nekar @everyone, roller som hanteras av en annan app och roller med admin- eller modereringsbehörighet.
collectionobligatoriskt
Kollektionen.
min
Minsta antal NFTs att äga, 1 till 100 000. Standard är 1.
max
Högsta antal, för nivåer som Holder, Collector och Whale.
trait
Type:Value, till exempel Background:Gold. Separera flera med | så räcker vilken som helst.
held-days
Kräv även att en NFT har ägts i minst så här många dagar, 1 till 3 650.

/admin role token

Hantera server

Ger en roll utifrån saldo, summerat över en medlems länkade plånböcker: XRP, en token utgiven på XRP Ledger, en multi-purpose token eller en AMM-pools likviditetstokens. Saldon kontrolleras varje timme eller när en medlem kör /refresh.

roleobligatoriskt
En vanlig roll under botens egen. Boten nekar @everyone, roller som hanteras av en annan app och roller med admin- eller modereringsbehörighet.
kindobligatoriskt
xrp, token för en token utgiven på XRP Ledger, mpt för en multi-purpose token eller lp för en AMM-pools likviditetstokens.
minobligatoriskt
Minsta saldo, över noll.
issuer
För token: utgivarens adress.
currency
För token: dess kod, till exempel RLUSD.
issuance-id
För mpt: emissionens id på 48 tecken.
pool
För lp: AMM-poolens kontoadress.

/admin role set-json

Hantera server

Ger en roll utifrån en regel skriven i JSON som kombinerar valfria villkor nedan.

roleobligatoriskt
En vanlig roll under botens egen. Boten nekar @everyone, roller som hanteras av en annan app och roller med admin- eller modereringsbehörighet.
ruleobligatoriskt
Regeln, högst 6 000 tecken.

/admin role remove

Hantera server

Raderar en rolls regel och tar bort rollen från medlemmarna som boten gav den till.

roleobligatoriskt
En vanlig roll under botens egen. Boten nekar @everyone, roller som hanteras av en annan app och roller med admin- eller modereringsbehörighet.

/admin role list

Hantera server

Listar alla rollregler i klartext och om de är på.

Flöden och serververktyg

/admin feed add

Hantera server

Publicerar aktivitet i en kanal. Boten skickar först ett testmeddelande så att du vet att den kan skriva där. Lägger du till ett flöde i en kanal som redan har ett uppdateras det.

channelobligatoriskt
En text- eller meddelandekanal.
kinds
Kommaseparerade, av sale, list, delist, mint, transfer, burn, buy_offer_created, buy_offer_cancelled, offer_expired och uri_modified. Standard är sale.
collection
En kollektion. Utelämna för alla serverns kollektioner.
min-price
Hoppa över allt under så här många XRP. Aktivitet utan pris, som en överföring, hoppas också över.
layout
full eller compact.

/admin feed layout

Hantera server

Växlar ett flöde mellan fullständig och kompakt layout.

channelobligatoriskt
Kanalen.
layoutobligatoriskt
full eller compact.

/admin feed remove

Hantera server

Raderar en kanals flöde.

channelobligatoriskt
Kanalen.

/admin feed list

Hantera server

Listar dina flöden, vad varje flöde publicerar och om det är på.

/admin stat add

Hantera server

Skapar en låst röstkanal vars namn visar ett live-värde, till exempel floor price. Den uppdateras när värdet ändras, högst var 10:e minut.

kindobligatoriskt
floor, holders, volume för dagens volym, listed eller role för antalet medlemmar med en roll.
collection
Krävs för alla typer utom role.
role
Krävs för role.
template
Kanalens namn, 3 till 90 tecken, med minst en av {floor} {holders} {listed} {supply} {volume24h} {sales24h} {bid} {count}.

/admin stat remove

Hantera server

Slutar uppdatera en statistikkanal. Själva kanalen finns kvar.

channelobligatoriskt
Kanalen.

/admin snapshot take

Hantera server

Skickar alla innehavare av en kollektion till dig som CSV-fil: adress, användarnamn, hur många de äger och deras andel.

collectionobligatoriskt
Kollektionen.
min
Bara innehavare av minst så här många.
with-discord
Lägg till en kolumn med Discord-id. Bara länkade medlemmar på den här servern namnges.

/admin snapshot list

Hantera server

Listar senaste ögonblicksbilderna.

/admin audit

Hantera server

Visar de senaste 25 roll- och regeländringarna och varför de skedde.

user
Bara den här medlemmens ändringar.

/admin reconcile

Hantera server

Kontrollerar alla länkade medlemmar nu. Ändringarna visas i /admin audit.

Allowlists, omröstningar, utlottningar och evenemang

/allowlist create

Hantera server

Publicerar en allowlist med en Gå med-knapp. En medlem som kvalificerar sig går med med sin första länkade plånbok.

nameobligatoriskt
Dess namn, högst 60 tecken, skilt från serverns andra allowlists.
max-entries
Max antal som kan gå med.
closes-in-hours
Stäng efter så här många timmar, högst 2 160 (90 dagar).
eligibility-collection
Bara innehavare av den här kollektionen kan delta. Utelämna för alla med en länkad plånbok.
eligibility-min
Hur många de måste äga. Standard är 1.
rule-json
Eller valfri regel i JSON, som för /admin role set-json.

/allowlist close

Hantera server

Stänger en allowlist nu.

nameobligatoriskt
Dess namn, högst 60 tecken, skilt från serverns andra allowlists.

/allowlist export

Hantera server

Skickar en allowlists anmälningar till dig som CSV-fil.

nameobligatoriskt
Dess namn, högst 60 tecken, skilt från serverns andra allowlists.

/allowlist list

Hantera server

Visar serverns allowlists med deras poster och när de stänger.

/poll create

Hantera server

Publicerar en omröstning med en knapp per alternativ. Medlemmar kan ändra sin röst tills den stänger.

questionobligatoriskt
Högst 200 tecken.
optionsobligatoriskt
2 till 10 alternativ åtskilda med |, vart och ett högst 80 tecken.
duration-hoursobligatoriskt
Hur länge den pågår, i timmar, högst 2 160 (90 dagar).
weighting
member en röst eller anmälan var, eller nft en per ägd NFT.
weight-collection
Vilken kollektion som ska räknas för nft.
eligibility-collection
Bara innehavare av den här kollektionen kan delta. Utelämna för alla med en länkad plånbok.
eligibility-min
Hur många de måste äga. Standard är 1.

/poll close

Hantera server

Stänger en omröstning direkt och publicerar resultatet.

idobligatoriskt
Id:t i inläggets sidfot.

/raffle create

Hantera server

Publicerar ett lotteri med en Delta-knapp.

prizeobligatoriskt
Upp till 200 tecken.
winnersobligatoriskt
1 till 100.
duration-hoursobligatoriskt
Hur länge den pågår, i timmar, högst 2 160 (90 dagar).
weighting
member en röst eller anmälan var, eller nft en per ägd NFT.
weight-collection
Vilken kollektion som ska räknas för nft.
eligibility-collection
Bara innehavare av den här kollektionen kan delta. Utelämna för alla med en länkad plånbok.
eligibility-min
Hur många de måste äga. Standard är 1.

/raffle draw

Hantera server

Stänger anmälan och drar vinnarna direkt. Dragningen seedas från hashen för en validerad ledger, och tillkännagivandet visar den, så vem som helst kan räkna om den.

idobligatoriskt
Id:t i inläggets sidfot.

/event create

Hantera server

Publicerar ett event som medlemmar kan anmäla sig till tills det börjar eller blir fullt.

titleobligatoriskt
Upp till 100 tecken.
startsobligatoriskt
Antal timmar från nu, t.ex. 48, eller datum och tid med tidszon, t.ex. 2026-12-01T18:00Z. Inom 90 dagar.
description
Upp till 1 000 tecken.
location
Upp till 200 tecken.
capacity
Max antal som kan anmäla sig.
eligibility-collection
Bara innehavare av den här kollektionen kan delta. Utelämna för alla med en länkad plånbok.
eligibility-min
Hur många de måste äga. Standard är 1.

/event cancel

Hantera server

Ställer in ett event och uppdaterar dess inlägg.

idobligatoriskt
Id:t i inläggets sidfot.

/event attendees

Hantera server

Visar vilka som kommer.

idobligatoriskt
Id:t i inläggets sidfot.

Avancerat: regler i JSON

/admin role set-json tar en regel skriven i JSON, för allt som /admin role set och /admin role token inte kan bygga. Dashboardens avancerade redigerare skriver samma regler åt dig.

Kombinera villkor med and eller or, som var och en tar 1 till 20 regler, och vänd ett villkor med not. En regel kan nästlas 6 nivåer djupt och innehålla upp till 30 villkor.

Varje villkor kontrolleras mot alla en medlems länkade wallets tillsammans och är falskt för den som saknar länkad wallet. Om boten inte kan kontrollera ett villkor, till exempel när ledgern inte går att nå, behåller medlemmen sina nuvarande roller.

Villkoren, efter JSON-typ. Kollektioner anges med sin slug på marknadsplatsen.

  • holds med collection, min och valfritt max: äger så många NFTs från kollektionen.
  • holds_trait med collection, traits (1 till 12, var och en skriven Type:Value) och min: äger så många NFTs med någon av egenskaperna.
  • holds_any_verified med min: äger så många NFTs från verifierade kollektioner, oavsett vilka.
  • holds_non_transferable med collection och min: äger så många av kollektionens soulbound-NFTs, de som inte kan säljas.
  • held_for med collection, days (1 till 3 650) och min: har ägt så många i minst så många dagar.
  • rarity_rank med collection och max_rank: äger en NFT med minst den sällsynthetsrangen.
  • listed_ratio med collection och max, en andel från noll till ett: har listat högst den andelen av sina NFTs. Falskt för den som inte äger några.
  • top_holders med collection och n (1 till 1 000): är en av kollektionens största ägare.
  • is_creator med collection: en av deras plånböcker skapade eller gav ut kollektionen.
  • royalty_compliant med collection: varje NFT de äger därifrån mintades eller köptes i en försäljning där royalty betalades.
  • xrp_balance med min: äger minst så mycket XRP.
  • token_balance med issuer, currency (en kod som RLUSD, eller dess hexform på 40 tecken) och min: äger minst så mycket av token.
  • mpt_balance med issuance_id (48 hextecken) och min: äger minst så mycket av multi-purpose-token.
  • amm_lp_balance med amm_account och min: äger minst så många av poolens likviditetstokens.
  • wallet_in med addresses (1 till 10 000): en av deras plånböcker finns på listan.

Gränser

  • 25 bevakade kollektioner per server.
  • 50 rollregler per server, en per roll.
  • 20 flöden per server, ett per kanal.
  • 10 statistikkanaler per server, byter namn högst var 10:e minut.
  • En ägarögonblicksbild per server var 10:e minut, med upp till cirka 100 000 ägare.
  • 25 aviseringar per medlem och högst 30 aviseringsmeddelanden till dem i timmen.
  • Omröstningar har 2 till 10 alternativ, utlottningar drar 1 till 100 vinnare, och allowlists, omröstningar, utlottningar och event kan pågå i upp till 90 dagar.
  • Varje medlem kan använda boten 20 gånger i minuten. Därefter ombeds de att sakta ner.

Integritet och säkerhet

Verifieringen delar adresserna till plånböckerna på ditt First Ledger-konto med boten. Den ser aldrig någon nyckel, och du ombeds aldrig signera en transaktion. Den som ber dig om det är inte den här boten.

Boten ber bara om de behörigheter den använder, och aldrig om Administratör. Den vägrar dela ut en roll med moderator- eller adminbehörigheter.

Den tar bara bort roller den själv gett. En roll som en moderator gett dig manuellt finns kvar.

Andra appar kan bara se dina länkade plånböcker om du tillåter dem med namn via /privacy allow, och du kan ta tillbaka det när som helst.

/unlink raderar din länk och tar bort rollerna boten gett dig på alla servrar.

Felsökning

Ingen roll efter verifiering: kör /refresh. Syns den fortfarande inte, be en admin köra /check-permissions; botens roll ligger troligen under holder-rollen.

Länken säger att den har gått ut: varje länk gäller i tio minuter och fungerar en gång. Kör /verify igen.

”Ett annat Discord-konto”: du bekräftade med ett annat Discord-konto än det som körde kommandot. Byt konto i Discord och kör /verify igen.

Ett flöde har tystnat: kör /admin feed list. Ett flöde som boten inte längre kunde posta i stängs av, och /admin audit visar varför.

En saldoroll ändrades inte: de uppdateras vid den kontroll som görs varje timme. Kör /refresh för att kontrollera nu.