El bot de Discord
El bot de First Ledger da a los miembros de tu Discord roles según los NFT y tokens que tienen, publica las ventas de tu colección al momento y gestiona allowlists, encuestas y sorteos, para cualquier colección del XRP Ledger.
Qué hace
Roles de holder: un miembro vincula sus wallets una vez y el bot le da y le quita roles según compra y vende, normalmente segundos después de la venta.
Feeds: ventas, listings, mints y ofertas de tus colecciones, publicados en los canales que elijas.
Herramientas para tu servidor: floor y número de holders en directo en los nombres de canal, snapshots de holders, un registro de auditoría y un panel web para admins.
Comunidad: allowlists, encuestas para holders, sorteos, eventos y alertas personales.
Es gratis: todas las funciones, para todos los servidores y todas las colecciones.
Añadirlo a tu servidor
Abre la página del bot en First Ledger y elige Añadir a Discord. Necesitas el permiso Gestionar servidor en el servidor donde lo añadas.
Después, Discord muestra los seis permisos que pide el bot. Déjalos todos marcados: se usan todos.
- Gestionar roles da y quita los roles de holder. Sin él, no se asigna ningún rol.
- Gestionar canales permite que
/setupcree el canal #verify y mantiene al día el floor y el número de holders en los nombres de canal. - Ver canales permite al bot ver los canales donde publica.
- Enviar mensajes publica feeds, el panel de verificación, encuestas, sorteos y eventos.
- Insertar enlaces muestra cada venta y listing como una tarjeta con la imagen y el precio del NFT.
- Adjuntar archivos permite que
/admin snapshot takeenvíe su lista de holders como archivo CSV.
Nunca pide Administrador, Gestionar servidor ni poder para expulsar o banear a nadie. El rol del bot no necesita nada más que estos seis, así que deja el resto desactivado.
En Ajustes del servidor → Roles, arrastra el rol del bot por encima de todos los roles que quieras que asigne. Discord solo deja que un bot asigne roles por debajo del suyo.
Ejecuta /check-permissions. Cada línea debería tener un tick verde; cada una en rojo indica qué corregir.
Añade tu colección con /admin collection add. Empieza a escribir su nombre y elígela de la lista.
Crea un rol de holder con /admin role set: elige el rol, la colección y, si quieres niveles, un mínimo y un máximo. También puedes exigir un rasgo o que el NFT se haya mantenido cierto número de días.
Publica el panel de verificación con /setup. Crea un canal #verify, o usa el que indiques, con un botón Verificar que pulsan los miembros.
Todo esto también se puede hacer en el panel, donde inicias sesión con Discord y ves los servidores que gestionas.
Roles de holder
Por cantidad: tener al menos un número de NFTs de una colección y, opcionalmente, como máximo otro, para crear niveles como Holder, Collector y Whale.
Por atributo: tener un NFT con un atributo concreto, como Background: Gold.
Por rareza o ranking: tener un NFT dentro del top N de la colección, o ser uno de sus N mayores holders.
Creador: la wallet creadora o emisora de la colección.
Por saldo: tener una cantidad de XRP, de un token emitido en el XRP Ledger (incluidos los lanzados en First Ledger) o de un token multipropósito. Configúralos con /admin role token: elige el rol, qué comprobar y el mínimo, y el bot suma el saldo de todas las wallets vinculadas del miembro.
Por wallet: una lista de direcciones que pegas.
Combinados: cualquiera de estos unidos con AND, OR y NOT, en el editor avanzado del panel; por ejemplo, tener tres o más AND tener cien XRP.
Todas las wallets de la cuenta de First Ledger de un miembro cuentan juntas, así que mover un NFT entre sus propias wallets nunca le hace perder un rol.
Los roles basados en NFTs se actualizan segundos después de una venta. Los basados en saldos se actualizan en la revisión de cada hora, o al momento cuando el miembro usa /refresh.
Roles que solo el XRP Ledger hace posibles
Los NFTs listados siguen contando. En el XRP Ledger, un NFT que pones a la venta sigue en tu wallet hasta que alguien lo compra, así que listar nunca hace perder el rol. Si quieres premiar a los holders que no listan, hay una regla para el porcentaje de sus NFTs listados.
Tiempo de tenencia: un NFT guardado al menos un número de días. Funciona como el staking, sin bloquear nada.
Pases de membresía: un NFT minteado sin el flag de transferible solo puede volver a su creador, así que no se puede vender. Un pase así crea un rol de miembro que no se puede comprar.
Proveedores de liquidez: tener los tokens de liquidez de un pool AMM, como uno del token de tu proyecto. También se configura con /admin role token.
Holders que pagan royalties: cada NFT de la colección se obtuvo por mint o en una venta que pagó el royalty del creador, no regalado.
Feeds y herramientas del servidor
Crea un feed con /admin feed add: elige el canal, qué tipos de actividad publicar (ventas, listados, mints, transferencias, quemas, ofertas), un precio mínimo y un formato completo o compacto. Varias compras de un mismo comprador en el mismo ledger se publican juntas como un sweep.
Los precios se muestran en la moneda de la venta, con su valor en XRP al lado cuando se conoce.
Crea un canal de estadísticas con /admin stat add: un canal cuyo nombre muestra el precio suelo, los holders, los listados, el volumen del día o los miembros con un rol, actualizado cada diez minutos.
Haz una snapshot con /admin snapshot take: todos los holders de una colección en una hoja de cálculo. Con los ids de Discord activados, solo se nombra a miembros de tu servidor.
Consulta cada rol que el bot dio o quitó, y por qué, con /admin audit.
Allowlists, encuestas, sorteos y eventos
/allowlist create publica un botón Unirse. Los miembros que cumplen el requisito se unen con su wallet vinculada; exporta la lista como hoja de cálculo al cerrarla.
/poll create publica una encuesta. Los votos pueden contar uno por miembro o uno por NFT.
/raffle create publica un botón Participar. Los ganadores se eligen a partir del hash de un ledger del XRP Ledger cerrado después de cerrar las inscripciones, y el anuncio lo muestra para que cualquiera pueda comprobar que el sorteo fue justo.
/event create publica un evento al que los miembros pueden apuntarse, opcionalmente solo para holders y con aforo.
Los miembros pueden activar alertas por MD con /alerts: ofertas sobre sus NFTs, un aviso cuando una oferta parece una estafa, ventas en una colección o listings por debajo de un precio.
Para miembros: verificación
Haz clic en Verificar en el servidor o ejecuta /verify. El bot responde con un enlace que solo tú puedes ver.
El enlace abre First Ledger. Inicia sesión con tu wallet como siempre y elige Continuar.
Discord te pide que confirmes tu cuenta. Confírmala y tus roles aparecerán en unos segundos.
¿Has añadido una wallet a tu cuenta de First Ledger desde entonces? Ejecuta /verify de nuevo y luego /refresh.
Nunca completes una verificación que te haya enviado otra persona. Cada enlace pertenece a quien ejecutó el comando y solo funciona para esa persona.
Todos los comandos
Los comandos de administración requieren el permiso Gestionar servidor, y Discord solo se los muestra a quienes lo tienen. La mayoría de las respuestas solo las ves tú; /floor, /collection y /nft se publican en el canal para todos. Empieza a escribir el nombre de una colección en cualquier opción de colección y elígela de la lista: primero salen las colecciones de tu servidor y luego las del marketplace.
Para todos
/verify
CualquieraTe envía un enlace, visible solo para ti, para vincular los wallets de tu cuenta de First Ledger. El enlace es solo tuyo y dura diez minutos. Nunca firmas ninguna transacción.
/wallets
CualquieraMuestra tus wallets vinculados, cada uno con enlace a su página en First Ledger.
/refresh
CualquieraRecarga tus wallets desde First Ledger y revisa tus roles al momento. Úsalo tras añadir un wallet o si un rol por saldo no se ha actualizado.
/roles
CualquieraMuestra los roles de holder de este servidor y qué requiere cada uno, marcando los que tienes.
/floor
CualquieraPublica el precio mínimo, su variación en el último día y el número en venta, de una colección o de hasta 15 del servidor.
collection- Una colección. Déjalo vacío para todas las del servidor.
/collection
CualquieraPublica las estadísticas de una colección: precio mínimo, mejor oferta, en venta, holders, volumen, ventas, royalty y si está verificada.
collectionobligatorio- La colección.
/nft
CualquieraPublica la ficha de un NFT: imagen, propietario, rango de rareza, precio si está en venta, royalty, flags y atributos.
idobligatorio- El
NFTokenIDdel NFT, de 64 caracteres.
/portfolio
CualquieraMuestra tus NFTs de todos tus wallets vinculados, agrupados por colección.
/alerts add
CualquieraActiva una alerta por MD. Si añades el mismo tipo para la misma colección, se sustituye su precio. Mantén abiertos los MD de miembros del servidor o el bot no podrá contactarte.
kindobligatoriooffer_receivedofertas sobre tus NFTs,suspicious_offerun aviso cuando una oferta parece una estafa,collection_saleventas en una colección olisting_belowlistados por debajo de un precio.collection- Necesario para alertas de ventas y listados.
price- En XRP: la venta mínima que se te notificará o, para listados, el precio máximo.
/alerts remove
CualquieraDesactiva una alerta.
kindobligatoriooffer_receivedofertas sobre tus NFTs,suspicious_offerun aviso cuando una oferta parece una estafa,collection_saleventas en una colección olisting_belowlistados por debajo de un precio.collection- Necesario para alertas de ventas y listados.
/alerts list
CualquieraMuestra tus alertas.
/privacy allow
CualquieraPermite que una app asociada consulte tus wallets vinculados.
partnerobligatorio- El nombre de la app asociada.
/privacy revoke
CualquieraDeja de compartir con una app asociada.
partnerobligatorio- El nombre de la app asociada.
/privacy status
CualquieraMuestra las apps asociadas con las que compartes.
/unlink
CualquieraElimina tu vínculo y los roles que el bot te asignó en todos los servidores que compartes con él.
/help
CualquieraMuestra si estás vinculado y una breve guía de estos comandos.
Configuración
/setup
Gestionar servidorPublica el panel Verificar, donde los miembros pulsan para vincular sus wallets, y recuerda su canal. Si no indicas canal, crea #verify.
channel- Dónde publicar el panel. Si lo dejas vacío, el bot crea #verify, lo que requiere Gestionar canales.
/check-permissions
Gestionar servidorComprueba cada permiso que necesita el bot, cada regla de rol (que el rol siga existiendo y esté por debajo del rol del bot) y cada canal de feed, con un tick o una cruz y qué corregir. Avisa si el bot tiene Administrador, que no necesita.
/admin collection add
Gestionar servidorSigue una colección para que su actividad llegue a tus feeds y sus holders a tus roles. Avisa si el marketplace ha marcado la colección.
collectionobligatorio- La colección.
/admin collection remove
Gestionar servidorDeja de seguir una colección.
collectionobligatorio- La colección.
/admin collection list
Gestionar servidorMuestra las colecciones que sigue este servidor.
Roles de holder
/admin role set
Gestionar servidorDa un rol a los miembros que tengan suficientes NFTs de una colección. Volver a configurarlo en el mismo rol sustituye la regla. Los miembros vinculados se revisan al momento.
roleobligatorio- Un rol simple por debajo del rol del bot. El bot rechaza @everyone, los roles gestionados por otra app y cualquier rol con permisos de administración o moderación.
collectionobligatorio- La colección.
min- El mínimo de NFTs que hay que tener, de 1 a 100.000. Por defecto, 1.
max- El máximo, para niveles como Holder, Collector y Whale.
traitType:Value, comoBackground:Gold. Separa varios con|y vale cualquiera.held-days- Exige además tener un NFT durante al menos estos días, de 1 a 3650.
/admin role token
Gestionar servidorDa un rol según el saldo, sumado entre las wallets vinculadas de un miembro: XRP, un token emitido en el XRP Ledger, un token multipropósito o los tokens de liquidez de un pool AMM. Los saldos se revisan cada hora o cuando un miembro usa /refresh.
roleobligatorio- Un rol simple por debajo del rol del bot. El bot rechaza @everyone, los roles gestionados por otra app y cualquier rol con permisos de administración o moderación.
kindobligatorioxrp,tokenpara un token emitido en el XRP Ledger,mptpara un token multipropósito olppara los tokens de liquidez de un pool AMM.minobligatorio- El saldo mínimo, mayor que cero.
issuer- Para
token: la dirección del emisor. currency- Para
token: su código, comoRLUSD. issuance-id- Para
mpt: el id de emisión de 48 caracteres. pool- Para
lp: la dirección de la cuenta del pool AMM.
/admin role set-json
Gestionar servidorDa un rol según una regla escrita en JSON que combine cualquiera de las condiciones siguientes.
roleobligatorio- Un rol simple por debajo del rol del bot. El bot rechaza @everyone, los roles gestionados por otra app y cualquier rol con permisos de administración o moderación.
ruleobligatorio- La regla, hasta 6000 caracteres.
/admin role remove
Gestionar servidorElimina la regla de un rol y quita el rol a los miembros a los que se lo dio el bot.
roleobligatorio- Un rol simple por debajo del rol del bot. El bot rechaza @everyone, los roles gestionados por otra app y cualquier rol con permisos de administración o moderación.
/admin role list
Gestionar servidorMuestra cada regla de rol en palabras y si está activa.
Feeds y herramientas del servidor
/admin feed add
Gestionar servidorPublica la actividad en un canal. El bot envía primero un mensaje de prueba para que sepas que puede publicar allí. Añadir un feed a un canal que ya tiene uno lo actualiza.
channelobligatorio- Un canal de texto o de anuncios.
kinds- Separados por comas, entre
sale,list,delist,mint,transfer,burn,buy_offer_created,buy_offer_cancelled,offer_expiredyuri_modified. Por defecto,sale. collection- Una colección. Déjalo vacío para todas las del servidor.
min-price- Omite todo lo que esté por debajo de esta cantidad de XRP. La actividad sin precio, como una transferencia, también se omite.
layoutfullocompact.
/admin feed layout
Gestionar servidorCambia un feed entre el diseño completo y el compacto.
channelobligatorio- El canal.
layoutobligatoriofullocompact.
/admin feed remove
Gestionar servidorElimina el feed de un canal.
channelobligatorio- El canal.
/admin feed list
Gestionar servidorMuestra tus feeds, qué publica cada uno y si está activo.
/admin stat add
Gestionar servidorCrea un canal de voz bloqueado cuyo nombre muestra un número en directo, como el precio suelo. Se actualiza cuando cambia el número, como mucho cada 10 minutos.
kindobligatoriofloor,holders,volumepara el volumen del día,listedorolepara el número de miembros con un rol.collection- Obligatorio para todos los tipos excepto
role. role- Obligatorio para
role. template- El nombre del canal, de 3 a 90 caracteres, con al menos uno de
{floor} {holders} {listed} {supply} {volume24h} {sales24h} {bid} {count}.
/admin stat remove
Gestionar servidorDeja de actualizar un canal de estadísticas. El canal se mantiene.
channelobligatorio- El canal.
/admin snapshot take
Gestionar servidorTe envía todos los holders de una colección en un archivo CSV: dirección, nombre de usuario, cuántos tienen y su porcentaje.
collectionobligatorio- La colección.
min- Solo quienes tengan al menos esta cantidad.
with-discord- Añade una columna con el id de Discord. Solo se nombra a los miembros vinculados de este servidor.
/admin snapshot list
Gestionar servidorMuestra las snapshots recientes.
/admin audit
Gestionar servidorMuestra los últimos 25 cambios de roles y reglas, y el motivo de cada uno.
user- Solo los cambios de este miembro.
/admin reconcile
Gestionar servidorRevisa ahora a todos los miembros vinculados. Los cambios aparecen en /admin audit.
Allowlists, encuestas, sorteos y eventos
/allowlist create
Gestionar servidorPublica una allowlist con un botón Unirse. Un miembro que cumpla los requisitos se une con su primera wallet vinculada.
nameobligatorio- Su nombre, hasta 60 caracteres, distinto de las demás allowlists del servidor.
max-entries- El máximo de personas que pueden unirse.
closes-in-hours- Cerrar tras estas horas, hasta 2160 (90 días).
eligibility-collection- Solo pueden participar quienes tengan NFTs de esta colección. Déjalo vacío para abrirlo a cualquiera con una wallet vinculada.
eligibility-min- Cuántos deben tener. Por defecto, 1.
rule-json- O cualquier regla en JSON, como en
/admin role set-json.
/allowlist close
Gestionar servidorCierra una allowlist ahora.
nameobligatorio- Su nombre, hasta 60 caracteres, distinto de las demás allowlists del servidor.
/allowlist export
Gestionar servidorTe envía las entradas de una allowlist en un archivo CSV.
nameobligatorio- Su nombre, hasta 60 caracteres, distinto de las demás allowlists del servidor.
/allowlist list
Gestionar servidorMuestra las allowlists del servidor, con sus entradas y cuándo cierran.
/poll create
Gestionar servidorPublica una encuesta con un botón por opción. Los miembros pueden cambiar su voto hasta que se cierre.
questionobligatorio- Hasta 200 caracteres.
optionsobligatorio- De 2 a 10 opciones separadas por
|, cada una de hasta 80 caracteres. duration-hoursobligatorio- Cuánto dura, en horas, hasta 2160 (90 días).
weightingmember: un voto o participación por persona;nft: uno por cada NFT que tenga.weight-collection- Qué colección contar, para
nft. eligibility-collection- Solo pueden participar quienes tengan NFTs de esta colección. Déjalo vacío para abrirlo a cualquiera con una wallet vinculada.
eligibility-min- Cuántos deben tener. Por defecto, 1.
/poll close
Gestionar servidorCierra una encuesta ahora y publica los resultados.
idobligatorio- El id que aparece al pie de la publicación.
/raffle create
Gestionar servidorPublica un sorteo con un botón Participar.
prizeobligatorio- Hasta 200 caracteres.
winnersobligatorio- De 1 a 100.
duration-hoursobligatorio- Cuánto dura, en horas, hasta 2160 (90 días).
weightingmember: un voto o participación por persona;nft: uno por cada NFT que tenga.weight-collection- Qué colección contar, para
nft. eligibility-collection- Solo pueden participar quienes tengan NFTs de esta colección. Déjalo vacío para abrirlo a cualquiera con una wallet vinculada.
eligibility-min- Cuántos deben tener. Por defecto, 1.
/raffle draw
Gestionar servidorCierra las inscripciones y elige a los ganadores ahora. El sorteo usa como semilla el hash de un ledger validado, que aparece en el anuncio, así que cualquiera puede recalcularlo.
idobligatorio- El id que aparece al pie de la publicación.
/event create
Gestionar servidorPublica un evento al que los miembros pueden apuntarse hasta que empiece o se llene.
titleobligatorio- Hasta 100 caracteres.
startsobligatorio- Horas a partir de ahora, como
48, o una fecha y hora con zona horaria, como2026-12-01T18:00Z. Dentro de 90 días. description- Hasta 1000 caracteres.
location- Hasta 200 caracteres.
capacity- Máximo de personas que pueden confirmar asistencia.
eligibility-collection- Solo pueden participar quienes tengan NFTs de esta colección. Déjalo vacío para abrirlo a cualquiera con una wallet vinculada.
eligibility-min- Cuántos deben tener. Por defecto, 1.
/event cancel
Gestionar servidorCancela un evento y actualiza su publicación.
idobligatorio- El id que aparece al pie de la publicación.
/event attendees
Gestionar servidorMuestra quién asiste.
idobligatorio- El id que aparece al pie de la publicación.
Avanzado: reglas en JSON
/admin role set-json acepta una regla escrita en JSON, para todo lo que /admin role set y /admin role token no pueden crear. El editor avanzado del panel escribe las mismas reglas por ti.
Combina condiciones con and o or, cada uno con entre 1 y 20 reglas, e invierte una con not. Una regla puede anidarse hasta 6 niveles y contener hasta 30 condiciones.
Cada condición se comprueba en todas las wallets vinculadas de un miembro a la vez, y es falsa para quien no tenga ninguna wallet vinculada. Si el bot no puede comprobar una condición, por ejemplo cuando no se puede acceder al ledger, el miembro conserva los roles que tiene.
Las condiciones, según su tipo JSON. Las colecciones se indican por su slug del marketplace.
holdsconcollection,miny unmaxopcional: tiene esa cantidad de NFTs de la colección.holds_traitconcollection,traits(de 1 a 12, cada uno escritoType:Value) ymin: tiene esa cantidad de NFTs con cualquiera de los atributos.holds_any_verifiedconmin: tiene esa cantidad de NFTs de colecciones verificadas, sean cuales sean.holds_non_transferableconcollectionymin: tiene esa cantidad de NFTs soulbound de la colección, los que no se pueden vender.held_forconcollection,days(de 1 a 3650) ymin: ha tenido esa cantidad durante al menos esos días.rarity_rankconcollectionymax_rank: tiene un NFT con ese rango de rareza o superior.listed_ratioconcollectionymax, una fracción de cero a uno: no ha listado más de esa proporción de sus NFTs. Falso si no tiene ninguno.top_holdersconcollectionyn(de 1 a 1000): está entre los mayores holders de la colección.is_creatorconcollection: uno de sus wallets creó o emitió la colección.royalty_compliantconcollection: todos los NFTs que tiene de ella se mintearon o compraron en una venta que pagó la royalty.xrp_balanceconmin: tiene al menos esa cantidad de XRP.token_balanceconissuer,currency(un código comoRLUSD, o su forma hex de 40 caracteres) ymin: tiene al menos esa cantidad del token.mpt_balanceconissuance_id(48 caracteres hex) ymin: tiene al menos esa cantidad del token multipropósito.amm_lp_balanceconamm_accountymin: tiene al menos esa cantidad de tokens de liquidez del pool.wallet_inconaddresses(de 1 a 10.000): uno de sus wallets está en la lista.
Límites
- 25 colecciones seguidas por servidor.
- 50 reglas de rol por servidor, una por rol.
- 20 feeds por servidor, uno por canal.
- 10 canales de estadísticas por servidor, renombrados como mucho cada 10 minutos.
- Una instantánea de holders por servidor cada 10 minutos, de hasta unos 100.000 holders.
- 25 alertas por miembro y como mucho 30 mensajes de alerta por hora.
- Las encuestas admiten de 2 a 10 opciones; los sorteos eligen de 1 a 100 ganadores; las allowlists, encuestas, sorteos y eventos pueden durar hasta 90 días.
- Cada miembro puede usar el bot 20 veces por minuto. Si se pasa, le pedirá que vaya más despacio.
Privacidad y seguridad
Al verificar, el bot recibe las direcciones de los wallets de tu cuenta de First Ledger. Nunca ve ninguna clave y nunca se te pedirá que firmes una transacción. Si alguien te lo pide, no es este bot.
El bot solo pide los permisos que usa y nunca el de Administrador. Se niega a asignar roles con permisos de moderación o administración.
Solo quita los roles que él asignó. Si un moderador te dio un rol manualmente, se mantiene.
Otras apps solo pueden ver tus wallets vinculados si las autorizas por nombre con /privacy allow, y puedes revocarlo cuando quieras.
/unlink elimina tu vínculo y quita los roles que el bot te asignó en todos los servidores.
Solución de problemas
No tienes rol tras verificar: ejecuta /refresh. Si sigue sin aparecer, pide a un admin que ejecute /check-permissions; probablemente el rol del bot está por debajo del rol de holder.
El enlace dice que ha caducado: cada enlace dura diez minutos y solo funciona una vez. Vuelve a ejecutar /verify.
«Otra cuenta de Discord»: confirmaste con una cuenta de Discord distinta a la que ejecutó el comando. Cambia de cuenta en Discord y vuelve a ejecutar /verify.
Un feed ha dejado de publicar: ejecuta /admin feed list. Si el bot ya no podía publicar en un feed, se desactiva, y /admin audit indica el motivo.
Un rol por saldo no ha cambiado: se actualizan en la revisión de cada hora. Ejecuta /refresh para comprobarlo ahora.