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
/setupskapa 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 takeskicka 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
AllaSkickar 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
AllaListar dina länkade plånböcker, var och en med länk till sin sida på First Ledger.
/refresh
AllaLaddar 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
AllaListar serverns holder-roller och vad var och en kräver, och bockar för de du har.
/floor
AllaPostar 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
AllaPostar en kollektions statistik: floor, bästa bud, listade, holders, volym, försäljningar, royalty och om den är verifierad.
collectionobligatoriskt- Kollektionen.
/nft
AllaPostar ett NFT-kort: bild, ägare, raritetsrank, pris om listad, royalty, flaggor och egenskaper.
idobligatoriskt- NFT:ns
NFTokenID, 64 tecken lång.
/portfolio
AllaVisar dina NFTs i dina länkade plånböcker, grupperade per kollektion.
/alerts add
AllaSlå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.
kindobligatorisktoffer_receivedför bud på dina NFTs,suspicious_offerför en varning när ett bud ser ut som bedrägeri,collection_saleför försäljningar i en kollektion ellerlisting_belowfö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
AllaStänger av en avisering.
kindobligatorisktoffer_receivedför bud på dina NFTs,suspicious_offerför en varning när ett bud ser ut som bedrägeri,collection_saleför försäljningar i en kollektion ellerlisting_belowför listningar under ett pris.collection- Krävs för aviseringar om försäljningar och listningar.
/alerts list
AllaListar dina aviseringar.
/privacy allow
AllaLåter en partnerapp slå upp dina länkade plånböcker.
partnerobligatoriskt- Partnerappens namn.
/privacy revoke
AllaSlutar dela med en partnerapp.
partnerobligatoriskt- Partnerappens namn.
/privacy status
AllaListar partnerapparna du delar med.
/unlink
AllaTar bort din länk och rollerna boten gett dig på alla servrar du delar med den.
/help
AllaVisar om du är länkad, och en kort guide till de här kommandona.
Konfiguration
/setup
Hantera serverPublicerar 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 serverKontrollerar 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 serverBevakar 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 serverSlutar bevaka en kollektion.
collectionobligatoriskt- Kollektionen.
/admin collection list
Hantera serverListar kollektionerna som servern bevakar.
Innehavarroller
/admin role set
Hantera serverGer 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.
traitType:Value, till exempelBackground: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 serverGer 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.
kindobligatorisktxrp,tokenför en token utgiven på XRP Ledger,mptför en multi-purpose token ellerlpför en AMM-pools likviditetstokens.minobligatoriskt- Minsta saldo, över noll.
issuer- För
token: utgivarens adress. currency- För
token: dess kod, till exempelRLUSD. issuance-id- För
mpt: emissionens id på 48 tecken. pool- För
lp: AMM-poolens kontoadress.
/admin role set-json
Hantera serverGer 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 serverRaderar 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 serverListar alla rollregler i klartext och om de är på.
Flöden och serververktyg
/admin feed add
Hantera serverPublicerar 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_expiredochuri_modified. Standard ärsale. 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.
layoutfullellercompact.
/admin feed layout
Hantera serverVäxlar ett flöde mellan fullständig och kompakt layout.
channelobligatoriskt- Kanalen.
layoutobligatorisktfullellercompact.
/admin feed remove
Hantera serverRaderar en kanals flöde.
channelobligatoriskt- Kanalen.
/admin feed list
Hantera serverListar dina flöden, vad varje flöde publicerar och om det är på.
/admin stat add
Hantera serverSkapar 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.
kindobligatorisktfloor,holders,volumeför dagens volym,listedellerrolefö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 serverSlutar uppdatera en statistikkanal. Själva kanalen finns kvar.
channelobligatoriskt- Kanalen.
/admin snapshot take
Hantera serverSkickar 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 serverListar senaste ögonblicksbilderna.
/admin audit
Hantera serverVisar de senaste 25 roll- och regeländringarna och varför de skedde.
user- Bara den här medlemmens ändringar.
/admin reconcile
Hantera serverKontrollerar alla länkade medlemmar nu. Ändringarna visas i /admin audit.
Allowlists, omröstningar, utlottningar och evenemang
/allowlist create
Hantera serverPublicerar 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 serverStänger en allowlist nu.
nameobligatoriskt- Dess namn, högst 60 tecken, skilt från serverns andra allowlists.
/allowlist export
Hantera serverSkickar 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 serverVisar serverns allowlists med deras poster och när de stänger.
/poll create
Hantera serverPublicerar 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).
weightingmemberen röst eller anmälan var, ellernften 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 serverStänger en omröstning direkt och publicerar resultatet.
idobligatoriskt- Id:t i inläggets sidfot.
/raffle create
Hantera serverPublicerar 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).
weightingmemberen röst eller anmälan var, ellernften 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 serverStä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 serverPublicerar 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 serverStäller in ett event och uppdaterar dess inlägg.
idobligatoriskt- Id:t i inläggets sidfot.
/event attendees
Hantera serverVisar 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.
holdsmedcollection,minoch valfrittmax: äger så många NFTs från kollektionen.holds_traitmedcollection,traits(1 till 12, var och en skrivenType:Value) ochmin: äger så många NFTs med någon av egenskaperna.holds_any_verifiedmedmin: äger så många NFTs från verifierade kollektioner, oavsett vilka.holds_non_transferablemedcollectionochmin: äger så många av kollektionens soulbound-NFTs, de som inte kan säljas.held_formedcollection,days(1 till 3 650) ochmin: har ägt så många i minst så många dagar.rarity_rankmedcollectionochmax_rank: äger en NFT med minst den sällsynthetsrangen.listed_ratiomedcollectionochmax, 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_holdersmedcollectionochn(1 till 1 000): är en av kollektionens största ägare.is_creatormedcollection: en av deras plånböcker skapade eller gav ut kollektionen.royalty_compliantmedcollection: varje NFT de äger därifrån mintades eller köptes i en försäljning där royalty betalades.xrp_balancemedmin: äger minst så mycket XRP.token_balancemedissuer,currency(en kod somRLUSD, eller dess hexform på 40 tecken) ochmin: äger minst så mycket av token.mpt_balancemedissuance_id(48 hextecken) ochmin: äger minst så mycket av multi-purpose-token.amm_lp_balancemedamm_accountochmin: äger minst så många av poolens likviditetstokens.wallet_inmedaddresses(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.