O bot do Discord
O bot da First Ledger dá aos membros do seu Discord cargos pelos NFTs e tokens que eles possuem, publica as vendas da sua coleção em tempo real e organiza allowlists, enquetes e sorteios — para qualquer coleção no XRP Ledger.
O que ele faz
Cargos de holder: o membro vincula as carteiras uma vez, e o bot dá e remove cargos conforme ele compra e vende, geralmente segundos após a venda.
Feeds: vendas, listagens, mints e ofertas das suas coleções, publicados nos canais que você escolher.
Ferramentas para o servidor: floor e número de holders ao vivo nos nomes dos canais, snapshots de holders, log de auditoria e um painel web para admins.
Comunidade: allowlists, enquetes para holders, sorteios, eventos e alertas pessoais.
É gratuito: todos os recursos, para todos os servidores e todas as coleções.
Como adicionar ao seu servidor
Abra a página do bot na First Ledger e escolha Adicionar ao Discord. Você precisa da permissão Gerenciar servidor no servidor em que vai adicioná-lo.
O Discord mostra então as seis permissões que o bot pede. Deixe todas marcadas: cada uma é usada.
- Gerenciar cargos dá e remove cargos de holder. Sem ela, nenhum cargo é atribuído.
- Gerenciar canais permite que
/setupcrie o canal #verify e mantém atualizados o floor e o número de holders nos nomes dos canais. - Ver canais permite que o bot veja os canais onde publica.
- Enviar mensagens publica feeds, o painel de verificação, enquetes, sorteios e eventos.
- Inserir links mostra cada venda e listagem como um card com a imagem e o preço do NFT.
- Anexar arquivos permite que
/admin snapshot takeenvie a lista de holders como arquivo CSV.
Ele nunca pede Administrador, Gerenciar servidor nem permissão para expulsar ou banir alguém. O cargo do bot não precisa de nada além dessas seis, então deixe o resto desativado.
Em Configurações do servidor → Cargos, arraste o cargo do bot para cima de todos os cargos que ele vai atribuir. O Discord só deixa um bot dar cargos abaixo do dele.
Execute /check-permissions. Todas as linhas devem ter um check verde; cada uma vermelha diz o que corrigir.
Adicione sua coleção com /admin collection add. Comece a digitar o nome e escolha-a na lista.
Crie um cargo de holder com /admin role set: escolha o cargo, a coleção e, se quiser níveis, um mínimo e um máximo. Você também pode exigir um atributo ou que o NFT esteja em posse há certo número de dias.
Publique o painel de verificação com /setup. Ele cria um canal #verify, ou usa o que você indicar, com um botão Verificar para os membros clicarem.
Tudo isso também pode ser feito no painel, que faz login com o Discord e lista os servidores que você gerencia.
Cargos de holder
Por quantidade: ter pelo menos um número de NFTs de uma coleção e, se quiser, no máximo um número, para criar níveis como Holder, Colecionador e Baleia.
Por atributo: ter um NFT com um atributo específico, como Background: Gold.
Por raridade ou rank: ter um NFT entre os N primeiros da coleção ou estar entre os N maiores holders.
Criador: a carteira criadora ou emissora da coleção.
Por saldo: ter uma quantia de XRP, de um token emitido no XRP Ledger (incluindo tokens lançados no First Ledger) ou de um token multiuso. Configure com /admin role token: escolha o cargo, o que verificar e o mínimo, e o bot soma o saldo de todas as carteiras vinculadas do membro.
Por carteira: uma lista de endereços que você cola.
Combinados: qualquer um destes unidos com AND, OR e NOT, no editor avançado do painel — por exemplo, ter três ou mais AND ter cem XRP.
Todas as carteiras da conta First Ledger de um membro contam juntas, então mover um NFT entre as próprias carteiras nunca faz ele perder um cargo.
Cargos baseados em NFTs são atualizados segundos após uma venda. Cargos baseados em saldo são atualizados na verificação de hora em hora, ou na hora quando o membro usa /refresh.
Cargos que só o XRP Ledger torna possíveis
NFTs listados continuam contando. No XRP Ledger, um NFT listado para venda fica na sua carteira até alguém comprar, então listar nunca faz um membro perder o cargo. Se quiser recompensar holders que não listam, existe uma regra para a parcela de NFTs listados.
Tempo de posse: um NFT mantido por pelo menos um número de dias. Funciona como staking, sem nada bloqueado.
Passes de membro: um NFT mintado sem a flag de transferível só pode voltar para o criador, então não pode ser vendido. Um passe assim cria um cargo de membro que não pode ser comprado.
Provedores de liquidez: ter os tokens de liquidez de uma pool AMM, como uma pool do token do seu projeto. Isso também é configurado com /admin role token.
Holders que pagam royalty: todo NFT da coleção foi comprado no mint ou em uma venda que pagou o royalty do criador, e não repassado de graça.
Feeds e ferramentas do servidor
Crie um feed com /admin feed add: escolha o canal, os tipos de atividade a postar (vendas, listagens, mints, transferências, queimas, ofertas), um preço mínimo e um layout completo ou compacto. Várias compras de um mesmo comprador no mesmo ledger são postadas juntas como uma varredura.
Os preços aparecem na moeda da venda, com o valor em XRP ao lado quando disponível.
Crie um canal de estatística com /admin stat add: um canal cujo nome mostra o floor, os holders, a quantidade listada, o volume do dia ou o número de membros com um cargo, atualizado a cada dez minutos.
Tire um snapshot com /admin snapshot take: todos os holders de uma coleção em uma planilha. Com os IDs do Discord ativados, só membros do seu servidor são identificados.
Veja todos os cargos que o bot deu ou removeu, e o motivo, com /admin audit.
Allowlists, enquetes, sorteios e eventos
/allowlist create posta um botão Entrar. Membros que cumprem o requisito entram com a carteira vinculada; exporte a lista como planilha quando ela fechar.
/poll create posta uma enquete. Os votos podem contar um por membro ou um por NFT.
/raffle create publica um botão Participar. Os vencedores são sorteados a partir do hash de um ledger do XRP Ledger fechado após o fim das inscrições, e o anúncio mostra esse ledger, para que qualquer pessoa confira se o sorteio foi justo.
/event create publica um evento em que os membros podem confirmar presença, opcionalmente só para holders e com limite de vagas.
Os membros podem ativar alertas por DM com /alerts: ofertas em seus NFTs, um aviso quando uma oferta parece golpe, vendas em uma coleção ou listagens abaixo de um preço.
Para membros: verificação
Clique em Verificar no servidor ou use /verify. O bot responde com um link que só você vê.
O link abre o First Ledger. Entre com sua carteira como de costume e escolha Continuar.
O Discord pede para confirmar sua conta. Confirme, e seus cargos aparecem em poucos segundos.
Adicionou uma carteira à sua conta do First Ledger depois disso? Use /verify de novo e depois /refresh.
Nunca conclua uma verificação enviada por outra pessoa. Cada link pertence a quem usou o comando e só funciona para essa pessoa.
Todos os comandos
Comandos de admin exigem a permissão Gerenciar servidor, e o Discord só os mostra para quem a tem. A maioria das respostas só você vê; /floor, /collection e /nft são publicados no canal para todos. Comece a digitar o nome de uma coleção em qualquer opção de coleção e escolha na lista: as coleções do seu servidor aparecem primeiro, depois as do marketplace.
Para todos
/verify
Qualquer pessoaEnvia um link, visível só para você, para vincular as carteiras da sua conta First Ledger. O link é só seu e dura dez minutos. Você nunca assina uma transação.
/wallets
Qualquer pessoaLista suas carteiras vinculadas, cada uma com link para a página dela na First Ledger.
/refresh
Qualquer pessoaRecarrega suas carteiras da First Ledger e verifica seus cargos na hora. Use depois de adicionar uma carteira ou quando um cargo de saldo não tiver atualizado.
/roles
Qualquer pessoaLista os cargos de holder deste servidor e o que cada um exige, marcando os que você tem.
/floor
Qualquer pessoaPosta o preço mínimo, a variação no último dia e o número de itens listados, para uma coleção ou até 15 das coleções do servidor.
collection- Uma coleção. Deixe em branco para todas as do servidor.
/collection
Qualquer pessoaPosta as estatísticas de uma coleção: preço mínimo, melhor oferta, listados, holders, volume, vendas, royalty e se é verificada.
collectionobrigatório- A coleção.
/nft
Qualquer pessoaPosta o card de um NFT: imagem, dono, ranking de raridade, preço se listado, royalty, flags e traits.
idobrigatório- O
NFTokenIDdo NFT, com 64 caracteres.
/portfolio
Qualquer pessoaMostra seus NFTs em todas as carteiras vinculadas, agrupados por coleção.
/alerts add
Qualquer pessoaAtiva um alerta por DM. Adicionar o mesmo tipo para a mesma coleção substitui o preço. Deixe as DMs de membros do servidor abertas, senão o bot não consegue te avisar.
kindobrigatóriooffer_receivedpara ofertas nos seus NFTs,suspicious_offerpara um aviso quando uma oferta parecer golpe,collection_salepara vendas em uma coleção oulisting_belowpara listagens abaixo de um preço.collection- Necessário para alertas de vendas e listagens.
price- Em XRP: a menor venda para avisar ou, para listagens, o preço máximo.
/alerts remove
Qualquer pessoaDesativa um alerta.
kindobrigatóriooffer_receivedpara ofertas nos seus NFTs,suspicious_offerpara um aviso quando uma oferta parecer golpe,collection_salepara vendas em uma coleção oulisting_belowpara listagens abaixo de um preço.collection- Necessário para alertas de vendas e listagens.
/alerts list
Qualquer pessoaLista seus alertas.
/privacy allow
Qualquer pessoaPermite que um app parceiro consulte suas carteiras vinculadas.
partnerobrigatório- O nome do app parceiro.
/privacy revoke
Qualquer pessoaPara de compartilhar com um app parceiro.
partnerobrigatório- O nome do app parceiro.
/privacy status
Qualquer pessoaLista os apps parceiros com quem você compartilha.
/unlink
Qualquer pessoaRemove seu vínculo e os cargos que o bot te deu em todos os servidores que você compartilha com ele.
/help
Qualquer pessoaMostra se você está vinculado e um guia rápido destes comandos.
Configuração
/setup
Gerenciar servidorPublica o painel Verificar, em que os membros clicam para vincular suas carteiras, e memoriza o canal. Sem um canal, cria o #verify.
channel- Onde publicar o painel. Se deixar em branco, o bot cria #verify, o que exige Gerenciar Canais.
/check-permissions
Gerenciar servidorVerifica cada permissão de que o bot precisa, cada regra de cargo (se o cargo ainda existe e está abaixo do cargo do bot) e cada canal de feed, com um visto ou um X e o que corrigir. Avisa se o bot recebeu Administrador, que ele não precisa.
/admin collection add
Gerenciar servidorAcompanha uma coleção, para que a atividade dela chegue aos seus feeds e os holders aos seus cargos. Avisa se o marketplace sinalizou a coleção.
collectionobrigatório- A coleção.
/admin collection remove
Gerenciar servidorPara de acompanhar uma coleção.
collectionobrigatório- A coleção.
/admin collection list
Gerenciar servidorLista as coleções que este servidor acompanha.
Cargos de holders
/admin role set
Gerenciar servidorDá um cargo a membros que têm o suficiente de uma coleção. Definir de novo no mesmo cargo substitui a regra. Membros vinculados são verificados na hora.
roleobrigatório- Um cargo simples abaixo do cargo do bot. O bot recusa @everyone, cargos gerenciados por outro app e qualquer cargo com permissões de admin ou moderação.
collectionobrigatório- A coleção.
min- O mínimo de NFTs a ter, de 1 a 100.000. O padrão é 1.
max- O máximo, para níveis como Holder, Collector e Whale.
traitType:Value, comoBackground:Gold. Separe vários com|; qualquer um vale.held-days- Exige também um NFT mantido por pelo menos esta quantidade de dias, de 1 a 3.650.
/admin role token
Gerenciar servidorDá um cargo pelo saldo somado nas carteiras vinculadas do membro: XRP, um token emitido no XRP Ledger, um token multiuso ou os tokens de liquidez de um pool AMM. Os saldos são verificados a cada hora ou quando o membro usa /refresh.
roleobrigatório- Um cargo simples abaixo do cargo do bot. O bot recusa @everyone, cargos gerenciados por outro app e qualquer cargo com permissões de admin ou moderação.
kindobrigatórioxrp,tokenpara um token emitido no XRP Ledger,mptpara um token multiuso oulppara os tokens de liquidez de um pool AMM.minobrigatório- O saldo mínimo, acima de zero.
issuer- Para
token: o endereço do emissor. currency- Para
token: o código, comoRLUSD. issuance-id- Para
mpt: o id de emissão com 48 caracteres. pool- Para
lp: o endereço da conta do pool AMM.
/admin role set-json
Gerenciar servidorDá um cargo por uma regra escrita em JSON, combinando quaisquer das condições abaixo.
roleobrigatório- Um cargo simples abaixo do cargo do bot. O bot recusa @everyone, cargos gerenciados por outro app e qualquer cargo com permissões de admin ou moderação.
ruleobrigatório- A regra, com até 6.000 caracteres.
/admin role remove
Gerenciar servidorExclui a regra de um cargo e remove o cargo dos membros a quem o bot o deu.
roleobrigatório- Um cargo simples abaixo do cargo do bot. O bot recusa @everyone, cargos gerenciados por outro app e qualquer cargo com permissões de admin ou moderação.
/admin role list
Gerenciar servidorLista cada regra de cargo por extenso e se está ativa.
Feeds e ferramentas do servidor
/admin feed add
Gerenciar servidorPublica a atividade em um canal. O bot envia antes uma mensagem de teste, para você saber que ele pode publicar lá. Adicionar um feed a um canal que já tem um o atualiza.
channelobrigatório- Um canal de texto ou de anúncios.
kinds- Separados por vírgula, entre
sale,list,delist,mint,transfer,burn,buy_offer_created,buy_offer_cancelled,offer_expiredeuri_modified. O padrão ésale. collection- Uma coleção. Deixe em branco para todas as do servidor.
min-price- Ignora tudo abaixo desta quantia em XRP. Atividades sem preço, como transferências, também são ignoradas.
layoutfulloucompact.
/admin feed layout
Gerenciar servidorAlterna um feed entre o layout completo e o compacto.
channelobrigatório- O canal.
layoutobrigatóriofulloucompact.
/admin feed remove
Gerenciar servidorExclui o feed de um canal.
channelobrigatório- O canal.
/admin feed list
Gerenciar servidorLista seus feeds, o que cada um publica e se está ativo.
/admin stat add
Gerenciar servidorCria um canal de voz bloqueado cujo nome mostra um número ao vivo, como o preço mínimo. Ele é atualizado quando o número muda, no máximo a cada 10 minutos.
kindobrigatóriofloor,holders,volumepara o volume do dia,listedourolepara o número de membros com um cargo.collection- Obrigatório para todos os tipos, exceto
role. role- Obrigatório para
role. template- O nome do canal, de 3 a 90 caracteres, com pelo menos um de
{floor} {holders} {listed} {supply} {volume24h} {sales24h} {bid} {count}.
/admin stat remove
Gerenciar servidorPara de atualizar um canal de estatística. O canal continua existindo.
channelobrigatório- O canal.
/admin snapshot take
Gerenciar servidorEnvia para você todos os holders de uma coleção em um arquivo CSV: endereço, nome de usuário, quantos possuem e sua participação.
collectionobrigatório- A coleção.
min- Só holders com pelo menos esta quantidade.
with-discord- Adiciona uma coluna com o id do Discord. Só membros vinculados deste servidor são identificados.
/admin snapshot list
Gerenciar servidorLista os snapshots recentes.
/admin audit
Gerenciar servidorMostra as últimas 25 alterações de cargos e regras e o motivo de cada uma.
user- Só as alterações deste membro.
/admin reconcile
Gerenciar servidorVerifica agora todos os membros vinculados. As alterações aparecem em /admin audit.
Allowlists, enquetes, sorteios e eventos
/allowlist create
Gerenciar servidorPublica uma allowlist com um botão Participar. Um membro que se qualifica entra com sua primeira carteira vinculada.
nameobrigatório- O nome dela, com até 60 caracteres, diferente das outras allowlists do servidor.
max-entries- O máximo de participantes.
closes-in-hours- Encerra após esta quantidade de horas, até 2.160 (90 dias).
eligibility-collection- Só holders desta coleção podem participar. Deixe em branco para liberar a qualquer pessoa com carteira vinculada.
eligibility-min- Quantos precisam ter. O padrão é 1.
rule-json- Ou qualquer regra em JSON, como em
/admin role set-json.
/allowlist close
Gerenciar servidorEncerra uma allowlist agora.
nameobrigatório- O nome dela, com até 60 caracteres, diferente das outras allowlists do servidor.
/allowlist export
Gerenciar servidorEnvia para você as inscrições de uma allowlist em um arquivo CSV.
nameobrigatório- O nome dela, com até 60 caracteres, diferente das outras allowlists do servidor.
/allowlist list
Gerenciar servidorLista as allowlists do servidor, com as entradas e quando fecham.
/poll create
Gerenciar servidorPublica uma enquete com um botão por opção. Os membros podem mudar o voto até ela fechar.
questionobrigatório- Até 200 caracteres.
optionsobrigatório- De 2 a 10 opções separadas por
|, cada uma com até 80 caracteres. duration-hoursobrigatório- Duração em horas, até 2.160 (90 dias).
weightingmember: um voto ou entrada por pessoa, ounft: um por NFT.weight-collection- Qual coleção contar, para
nft. eligibility-collection- Só holders desta coleção podem participar. Deixe em branco para liberar a qualquer pessoa com carteira vinculada.
eligibility-min- Quantos precisam ter. O padrão é 1.
/poll close
Gerenciar servidorEncerra uma enquete agora e publica os resultados.
idobrigatório- O id no rodapé da publicação.
/raffle create
Gerenciar servidorPublica um sorteio com um botão Participar.
prizeobrigatório- Até 200 caracteres.
winnersobrigatório- De 1 a 100.
duration-hoursobrigatório- Duração em horas, até 2.160 (90 dias).
weightingmember: um voto ou entrada por pessoa, ounft: um por NFT.weight-collection- Qual coleção contar, para
nft. eligibility-collection- Só holders desta coleção podem participar. Deixe em branco para liberar a qualquer pessoa com carteira vinculada.
eligibility-min- Quantos precisam ter. O padrão é 1.
/raffle draw
Gerenciar servidorEncerra as inscrições e sorteia os vencedores agora. O sorteio usa como semente o hash de um ledger validado, que aparece no anúncio, para qualquer pessoa poder recalcular.
idobrigatório- O id no rodapé da publicação.
/event create
Gerenciar servidorPublica um evento em que os membros podem confirmar presença até ele começar ou lotar.
titleobrigatório- Até 100 caracteres.
startsobrigatório- Horas a partir de agora, como
48, ou uma data e hora com fuso horário, como2026-12-01T18:00Z. Em até 90 dias. description- Até 1.000 caracteres.
location- Até 200 caracteres.
capacity- O máximo de pessoas que podem confirmar presença.
eligibility-collection- Só holders desta coleção podem participar. Deixe em branco para liberar a qualquer pessoa com carteira vinculada.
eligibility-min- Quantos precisam ter. O padrão é 1.
/event cancel
Gerenciar servidorCancela um evento e atualiza a publicação.
idobrigatório- O id no rodapé da publicação.
/event attendees
Gerenciar servidorLista quem vai.
idobrigatório- O id no rodapé da publicação.
Avançado: regras em JSON
/admin role set-json recebe uma regra escrita em JSON, para o que /admin role set e /admin role token não conseguem criar. O editor avançado do painel escreve as mesmas regras para você.
Combine condições com and ou or, cada um com 1 a 20 regras, e inverta uma com not. Uma regra pode ter até 6 níveis de aninhamento e até 30 condições.
Cada condição é verificada em todas as carteiras vinculadas do membro juntas e é falsa para quem não tem carteira vinculada. Se o bot não conseguir verificar uma condição, por exemplo quando o ledger está inacessível, o membro mantém os cargos que já tem.
As condições, pelo tipo em JSON. As coleções são identificadas pelo slug no marketplace.
holdscomcollection,mine ummaxopcional: tem essa quantidade de NFTs da coleção.holds_traitcomcollection,traits(de 1 a 12, cada um escritoType:Value) emin: tem essa quantidade de NFTs com qualquer um dos atributos.holds_any_verifiedcommin: tem essa quantidade de NFTs de coleções verificadas, sejam quais forem.holds_non_transferablecomcollectionemin: tem essa quantidade de NFTs soulbound da coleção, os que não podem ser vendidos.held_forcomcollection,days(de 1 a 3.650) emin: tem essa quantidade há pelo menos esse número de dias.rarity_rankcomcollectionemax_rank: tem um NFT com esse ranking de raridade ou mais raro.listed_ratiocomcollectionemax, uma fração de zero a um: listou no máximo essa parcela dos seus NFTs. Falso para quem não tem nenhum.top_holderscomcollectionen(de 1 a 1.000): está entre os maiores holders da coleção.is_creatorcomcollection: uma das carteiras da pessoa criou ou emitiu a coleção.royalty_compliantcomcollection: todo NFT da coleção que a pessoa tem foi mintado ou comprado em uma venda que pagou royalty.xrp_balancecommin: tem pelo menos essa quantidade de XRP.token_balancecomissuer,currency(um código comoRLUSDou sua forma hex de 40 caracteres) emin: tem pelo menos essa quantidade do token.mpt_balancecomissuance_id(48 caracteres hex) emin: tem pelo menos essa quantidade do token multiuso.amm_lp_balancecomamm_accountemin: tem pelo menos essa quantidade de tokens de liquidez do pool.wallet_incomaddresses(de 1 a 10.000): uma das carteiras da pessoa está na lista.
Limites
- 25 coleções monitoradas por servidor.
- 50 regras de cargo por servidor, uma por cargo.
- 20 feeds por servidor, um por canal.
- 10 canais de estatísticas por servidor, renomeados no máximo a cada 10 minutos.
- Um snapshot de holders por servidor a cada 10 minutos, de até cerca de 100.000 holders.
- 25 alertas por membro e no máximo 30 mensagens de alerta por hora para cada um.
- Enquetes têm de 2 a 10 opções; sorteios escolhem de 1 a 100 vencedores; allowlists, enquetes, sorteios e eventos podem durar até 90 dias.
- Cada membro pode usar o bot 20 vezes por minuto. Acima disso, o bot pede para ir mais devagar.
Privacidade e segurança
A verificação compartilha com o bot os endereços das carteiras da sua conta First Ledger. Ele nunca vê uma chave, e você nunca precisa assinar uma transação. Quem pedir isso não é este bot.
O bot pede só as permissões que usa, e nunca a de Administrador. Ele se recusa a dar um cargo com permissões de moderação ou de admin.
Ele só remove cargos que ele mesmo deu. Um cargo que um moderador te deu manualmente continua.
Outros apps só veem suas carteiras vinculadas se você autorizar cada um pelo nome com /privacy allow, e você pode revogar quando quiser.
/unlink apaga seu vínculo e remove os cargos que o bot te deu em todos os servidores.
Solução de problemas
Sem cargo após verificar: use /refresh. Se ainda não aparecer, peça a um admin para usar /check-permissions; o cargo do bot provavelmente está abaixo do cargo de holder.
O link diz que expirou: cada link dura dez minutos e funciona uma vez. Use /verify de novo.
“Uma conta do Discord diferente”: você confirmou com outra conta do Discord, não a que usou o comando. Troque de conta no Discord e use /verify de novo.
Um feed parou: use /admin feed list. Um feed em que o bot não consegue mais postar é desativado, e /admin audit mostra o motivo.
Um cargo de saldo não mudou: eles são atualizados na verificação de hora em hora. Use /refresh para verificar agora.