O bot do Discord
O bot da First Ledger dá aos membros do teu Discord cargos pelos NFTs e tokens que detêm, publica as vendas da tua coleção em tempo real e gere allowlists, sondagens e sorteios — para qualquer coleção no XRP Ledger.
O que faz
Cargos de holder: o membro associa as carteiras uma vez e o bot atribui e retira cargos à medida que compra e vende, normalmente segundos após a venda.
Feeds: vendas, listagens, mints e ofertas das tuas coleções, publicados nos canais que escolheres.
Ferramentas para o teu servidor: preço mínimo e número de holders em tempo real nos nomes dos canais, snapshots de holders, um registo de auditoria e um painel web para administradores.
Comunidade: allowlists, sondagens para holders, sorteios, eventos e alertas pessoais.
É gratuito: todas as funcionalidades, para todos os servidores e todas as coleções.
Adicionar ao teu servidor
Abre a página do bot na First Ledger e escolhe Adicionar ao Discord. Precisas da permissão Gerir servidor no servidor onde o vais adicionar.
O Discord mostra depois as seis permissões que o bot pede. Deixa-as todas marcadas: todas são usadas.
- Gerir cargos atribui e retira cargos de holder. Sem ela, não são atribuídos cargos.
- Gerir canais permite que
/setupcrie o canal #verify e mantém atualizados o preço mínimo e o número de holders nos nomes dos canais. - Ver canais permite ao bot ver os canais onde publica.
- Enviar mensagens publica feeds, o painel de verificação, sondagens, sorteios e eventos.
- Incorporar links mostra cada venda e listagem como um cartão com a imagem e o preço do NFT.
- Anexar ficheiros permite que
/admin snapshot takeenvie a lista de holders como ficheiro CSV.
Nunca pede Administrador, Gerir servidor nem poder para expulsar ou banir alguém. O cargo do próprio bot não precisa de mais do que estas seis, por isso deixa tudo o resto desativado.
Em Definições do servidor → Cargos, arrasta o cargo do bot para cima de todos os cargos que queres que atribua. O Discord só deixa um bot atribuir cargos abaixo do seu.
Executa /check-permissions. Todas as linhas devem ter um visto verde; cada vermelha indica o que corrigir.
Adiciona a tua coleção com /admin collection add. Começa a escrever o nome e escolhe-a na lista.
Cria um cargo de holder com /admin role set: escolhe o cargo, a coleção e, se quiseres níveis, um mínimo e um máximo. Também podes exigir um atributo ou que o NFT seja detido há um certo número de dias.
Publica o painel de verificação com /setup. Cria um canal #verify, ou usa o que indicares, com um botão Verificar em que os membros clicam.
Tudo isto também pode ser feito no painel, onde entras com o Discord e vês os servidores que geres.
Cargos de holder
Por quantidade: ter pelo menos um número de NFTs de uma coleção e, opcionalmente, 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 ranking: ter um NFT entre os N primeiros da coleção, ou ser um dos N maiores holders.
Criador: a carteira do criador ou emissor da coleção.
Por saldo: ter uma quantidade de XRP, de um token emitido no XRP Ledger (incluindo tokens lançados na 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 associadas do membro.
Por carteira: uma lista de endereços que cola.
Combinado: qualquer um destes ligado com AND, OR e NOT, no editor avançado do painel — por exemplo, tem três ou mais AND tem cem XRP.
Todas as carteiras da conta First Ledger de um membro contam em conjunto, por isso mover um NFT entre as suas próprias carteiras nunca lhe tira um cargo.
Os cargos baseados em NFTs atualizam segundos após uma venda. Os cargos baseados em saldos atualizam na verificação de hora a hora, ou de imediato quando o membro executa /refresh.
Cargos que só o XRP Ledger torna possíveis
Os NFTs listados continuam a contar. No XRP Ledger, um NFT listado para venda fica na sua carteira até alguém o comprar, por isso listar nunca tira o cargo a um membro. Se quiser recompensar holders que não listam, há uma regra para a percentagem de NFTs listados.
Tempo de posse: um NFT detido durante 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 ao criador, por isso não pode ser vendido. Um passe assim cria um cargo de membro que não se pode comprar.
Fornecedores de liquidez: ter os tokens de liquidez de uma pool AMM, como uma pool do token do seu projeto. Também se configura com /admin role token.
Holders que pagam royalties: todos os NFTs da coleção foram obtidos por mint ou numa venda que pagou a royalty do criador, e não oferecidos a custo zero.
Feeds e ferramentas do servidor
Crie um feed com /admin feed add: escolha o canal, os tipos de atividade a publicar (vendas, listagens, mints, transferências, burns, ofertas), um preço mínimo e um formato completo ou compacto. Várias compras do mesmo comprador no mesmo ledger são publicadas juntas como um sweep.
Os preços aparecem na moeda em que a venda foi feita, com o valor em XRP ao lado quando é conhecido.
Crie um canal de estatísticas com /admin stat add: um canal cujo nome mostra o floor, os holders, o número de listagens, 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 numa folha de cálculo. Com os ids do Discord ativados, só são identificados membros do seu servidor.
Veja todos os cargos que o bot atribuiu ou removeu, e porquê, com /admin audit.
Allowlists, sondagens, sorteios e eventos
/allowlist create publica um botão Aderir. Os membros que cumprem o requisito aderem com a carteira associada; exporte a lista como folha de cálculo quando fechar.
/poll create publica uma sondagem. Os votos podem contar um por membro ou um por NFT detido.
/raffle create publica um botão Participar. Os vencedores são sorteados a partir do hash de um ledger do XRP Ledger fechado depois do fim das inscrições, e o anúncio mostra-o, para que qualquer pessoa possa confirmar que o sorteio foi justo.
/event create publica um evento a que os membros podem confirmar presença, opcionalmente só para holders e com lotação.
Os membros podem ativar alertas por DM com /alerts: ofertas nos seus NFTs, um aviso quando uma oferta parece burla, vendas numa coleção ou listagens abaixo de um preço.
Para membros: verificação
Clique em Verificar no servidor ou execute /verify. O bot responde com um link que só você vê.
O link abre a First Ledger. Inicie sessão com a sua carteira como habitualmente e escolha Continuar.
O Discord pede-lhe que confirme a sua conta. Confirme e os seus cargos aparecem em poucos segundos.
Adicionou entretanto uma carteira à sua conta First Ledger? Execute /verify novamente e depois /refresh.
Nunca conclua uma verificação enviada por outra pessoa. Cada link pertence a quem executou o comando e só funciona para essa pessoa.
Todos os comandos
Os comandos de administração exigem a permissão Gerir servidor, e o Discord só os mostra a quem a tem. A maioria das respostas só é visível para si; /floor, /collection e /nft publicam no canal para todos. Comece a escrever o nome de uma coleção em qualquer opção de coleção e escolha-a da lista: primeiro aparecem as coleções do seu servidor, depois as do marketplace.
Para todos
/verify
Qualquer pessoaEnvia-te um link, visível só para ti, para associar as carteiras da tua conta First Ledger. O link é só teu e dura dez minutos. Nunca assinas uma transação.
/wallets
Qualquer pessoaLista as tuas carteiras associadas, cada uma com link para a sua página no First Ledger.
/refresh
Qualquer pessoaRecarrega as tuas carteiras do First Ledger e volta a verificar os teus cargos de imediato. Usa-o depois de adicionar uma carteira ou quando um cargo de saldo não estiver atualizado.
/roles
Qualquer pessoaLista os cargos de holder deste servidor e os requisitos de cada um, assinalando os que tens.
/floor
Qualquer pessoaPublica o preço mínimo, a sua variação no último dia e o número de listagens, para uma coleção ou até 15 das do servidor.
collection- Uma coleção. Omite para todas as do servidor.
/collection
Qualquer pessoaPublica as estatísticas de uma coleção: preço mínimo, melhor oferta, listados, holders, volume, vendas, royalty e se está verificada.
collectionobrigatório- A coleção.
/nft
Qualquer pessoaPublica o cartão de um NFT: imagem, proprietário, posição de raridade, preço se estiver listado, royalty, flags e atributos.
idobrigatório- O
NFTokenIDdo NFT, com 64 caracteres.
/portfolio
Qualquer pessoaMostra os teus NFTs nas tuas carteiras associadas, 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. Mantém as DMs de membros do servidor abertas, ou o bot não te consegue contactar.
kindobrigatóriooffer_receivedpara ofertas nos teus NFTs,suspicious_offerpara um aviso quando uma oferta parece burla,collection_salepara vendas numa coleção, oulisting_belowpara listagens abaixo de um preço.collection- Necessário para alertas de vendas e listagens.
price- Em XRP: a venda mínima a notificar ou, para listagens, o preço máximo.
/alerts remove
Qualquer pessoaDesativa um alerta.
kindobrigatóriooffer_receivedpara ofertas nos teus NFTs,suspicious_offerpara um aviso quando uma oferta parece burla,collection_salepara vendas numa coleção, oulisting_belowpara listagens abaixo de um preço.collection- Necessário para alertas de vendas e listagens.
/alerts list
Qualquer pessoaLista os teus alertas.
/privacy allow
Qualquer pessoaPermite que uma app parceira consulte as tuas carteiras associadas.
partnerobrigatório- O nome da app parceira.
/privacy revoke
Qualquer pessoaDeixa de partilhar com uma app parceira.
partnerobrigatório- O nome da app parceira.
/privacy status
Qualquer pessoaLista as apps parceiras com que partilhas.
/unlink
Qualquer pessoaRemove a tua associação e os cargos que o bot te deu em todos os servidores que partilhas com ele.
/help
Qualquer pessoaMostra se tens associação feita e um guia rápido destes comandos.
Configuração
/setup
Gerir servidorPublica o painel Verificar, onde os membros clicam para associar as carteiras, e memoriza o respetivo canal. Sem canal, cria #verify.
channel- Onde publicar o painel. Se omitires, o bot cria #verify, o que requer Gerir canais.
/check-permissions
Gerir servidorVerifica todas as permissões de que o bot precisa, todas as regras de cargos (o cargo ainda existe e está abaixo do cargo do bot) e todos os canais de feed, com um visto ou uma cruz e o que corrigir. Avisa se o bot recebeu Administrador, de que não precisa.
/admin collection add
Gerir servidorAcompanha uma coleção, para que a atividade chegue aos teus feeds e os detentores aos teus cargos. Avisa se o marketplace sinalizou a coleção.
collectionobrigatório- A coleção.
/admin collection remove
Gerir servidorDeixa de acompanhar uma coleção.
collectionobrigatório- A coleção.
/admin collection list
Gerir servidorLista as coleções que este servidor acompanha.
Cargos de holders
/admin role set
Gerir servidorAtribui um cargo aos membros que detêm o suficiente de uma coleção. Definir de novo no mesmo cargo substitui a regra. Os membros associados são verificados de imediato.
roleobrigatório- Um cargo simples abaixo do cargo do bot. O bot recusa @everyone, cargos geridos por outra app e qualquer cargo com permissões de administração ou moderação.
collectionobrigatório- A coleção.
min- O mínimo de NFTs a deter, de 1 a 100.000. Predefinição: 1.
max- O máximo, para níveis como Holder, Collector e Whale.
traitType:Value, comoBackground:Gold. Separa vários com|; qualquer um conta.held-days- Exige também um NFT detido há pelo menos este número de dias, de 1 a 3.650.
/admin role token
Gerir servidorAtribui um cargo por saldo, somado em todas as carteiras associadas de um membro: XRP, um token emitido no XRP Ledger, um token multiuso ou os tokens de liquidez de uma pool AMM. Os saldos são verificados de hora a hora, ou quando um membro executa /refresh.
roleobrigatório- Um cargo simples abaixo do cargo do bot. O bot recusa @everyone, cargos geridos por outra app e qualquer cargo com permissões de administração ou moderação.
kindobrigatórioxrp,tokenpara um token emitido no XRP Ledger,mptpara um token multiusos, oulppara os tokens de liquidez de uma 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 da pool AMM.
/admin role set-json
Gerir servidorAtribui um cargo por uma regra escrita em JSON, combinando qualquer das condições abaixo.
roleobrigatório- Um cargo simples abaixo do cargo do bot. O bot recusa @everyone, cargos geridos por outra app e qualquer cargo com permissões de administração ou moderação.
ruleobrigatório- A regra, até 6.000 caracteres.
/admin role remove
Gerir servidorElimina a regra de um cargo e retira o cargo aos membros a quem o bot o atribuiu.
roleobrigatório- Um cargo simples abaixo do cargo do bot. O bot recusa @everyone, cargos geridos por outra app e qualquer cargo com permissões de administração ou moderação.
/admin role list
Gerir servidorLista todas as regras de cargos por extenso e se estão ativas.
Feeds e ferramentas do servidor
/admin feed add
Gerir servidorPublica a atividade num canal. O bot envia primeiro uma mensagem de teste, para saberes que consegue publicar lá. Adicionar um feed a um canal que já tem um atualiza-o.
channelobrigatório- Um canal de texto ou de anúncios.
kinds- Separados por vírgulas, entre
sale,list,delist,mint,transfer,burn,buy_offer_created,buy_offer_cancelled,offer_expiredeuri_modified. Por predefinição,sale. collection- Uma coleção. Omite para todas as do servidor.
min-price- Ignora tudo abaixo deste valor em XRP. A atividade sem preço, como uma transferência, também é ignorada.
layoutfulloucompact.
/admin feed layout
Gerir servidorAlterna um feed entre o formato completo e o compacto.
channelobrigatório- O canal.
layoutobrigatóriofulloucompact.
/admin feed remove
Gerir servidorElimina o feed de um canal.
channelobrigatório- O canal.
/admin feed list
Gerir servidorLista os teus feeds, o que cada um publica e se está ativo.
/admin stat add
Gerir servidorCria um canal de voz bloqueado cujo nome mostra um número em tempo real, como o preço mínimo. Atualiza 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- Necessário para todos os tipos exceto
role. role- Necessá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
Gerir servidorDeixa de atualizar um canal de estatísticas. O canal mantém-se.
channelobrigatório- O canal.
/admin snapshot take
Gerir servidorEnvia-te todos os detentores de uma coleção num ficheiro CSV: endereço, nome de utilizador, quantos detêm e a sua percentagem.
collectionobrigatório- A coleção.
min- Apenas detentores de pelo menos esta quantidade.
with-discord- Adiciona uma coluna de id do Discord. Só são indicados os membros associados deste servidor.
/admin snapshot list
Gerir servidorLista os snapshots recentes.
/admin audit
Gerir servidorMostra as últimas 25 alterações de cargos e regras e o motivo de cada uma.
user- Apenas as alterações deste membro.
/admin reconcile
Gerir servidorVerifica agora todos os membros associados. As alterações aparecem em /admin audit.
Allowlists, sondagens, sorteios e eventos
/allowlist create
Gerir servidorPublica uma allowlist com um botão Entrar. Um membro elegível entra com a primeira carteira associada.
nameobrigatório- O nome, até 60 caracteres, diferente das outras allowlists do servidor.
max-entries- O número máximo de participantes.
closes-in-hours- Fecha após este número de horas, até 2.160 (90 dias).
eligibility-collection- Só os detentores desta coleção podem participar. Deixa em branco para qualquer pessoa com uma carteira associada.
eligibility-min- Quantos têm de deter. Por predefinição, 1.
rule-json- Ou qualquer regra em JSON, como em
/admin role set-json.
/allowlist close
Gerir servidorFecha uma allowlist agora.
nameobrigatório- O nome, até 60 caracteres, diferente das outras allowlists do servidor.
/allowlist export
Gerir servidorEnvia-te as inscrições de uma allowlist num ficheiro CSV.
nameobrigatório- O nome, até 60 caracteres, diferente das outras allowlists do servidor.
/allowlist list
Gerir servidorLista as allowlists do servidor, com as entradas e quando fecham.
/poll create
Gerir servidorPublica uma sondagem com um botão por opção. Os membros podem mudar o voto até 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 participação por pessoa, ounft: um por cada NFT detido.weight-collection- A coleção a contar para
nft. eligibility-collection- Só os detentores desta coleção podem participar. Deixa em branco para qualquer pessoa com uma carteira associada.
eligibility-min- Quantos têm de deter. Por predefinição, 1.
/poll close
Gerir servidorFecha uma sondagem agora e publica os resultados.
idobrigatório- O id no rodapé da publicação.
/raffle create
Gerir 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 participação por pessoa, ounft: um por cada NFT detido.weight-collection- A coleção a contar para
nft. eligibility-collection- Só os detentores desta coleção podem participar. Deixa em branco para qualquer pessoa com uma carteira associada.
eligibility-min- Quantos têm de deter. Por predefinição, 1.
/raffle draw
Gerir servidorFecha as participações e sorteia os vencedores agora. O sorteio usa como semente o hash de um ledger validado, indicado no anúncio, para que qualquer pessoa o possa recalcular.
idobrigatório- O id no rodapé da publicação.
/event create
Gerir servidorPublica um evento ao qual os membros podem confirmar presença, até começar ou ficar cheio.
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. No máximo 90 dias. description- Até 1.000 caracteres.
location- Até 200 caracteres.
capacity- O número máximo de pessoas que podem confirmar presença.
eligibility-collection- Só os detentores desta coleção podem participar. Deixa em branco para qualquer pessoa com uma carteira associada.
eligibility-min- Quantos têm de deter. Por predefinição, 1.
/event cancel
Gerir servidorCancela um evento e atualiza a publicação.
idobrigatório- O id no rodapé da publicação.
/event attendees
Gerir servidorLista quem vai.
idobrigatório- O id no rodapé da publicação.
Avançado: regras em JSON
/admin role set-json aceita uma regra escrita em JSON, para tudo o que /admin role set e /admin role token não conseguem criar. O editor avançado do painel escreve as mesmas regras por si.
Combine condições com and ou or, cada uma com 1 a 20 regras, e inverta uma com not. Uma regra pode ter até 6 níveis de profundidade e até 30 condições.
Cada condição é verificada em conjunto em todas as carteiras associadas de um membro, e é falsa para quem não tem nenhuma carteira associada. 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 tem.
As condições, por tipo JSON. As coleções são identificadas pelo seu slug no marketplace.
holdscomcollection,mine ummaxopcional: detém esse número de NFTs da coleção.holds_traitcomcollection,traits(de 1 a 12, cada um escritoType:Value) emin: detém esse número de NFTs com qualquer um dos atributos.holds_any_verifiedcommin: detém esse número de NFTs de coleções verificadas, sejam quais forem.holds_non_transferablecomcollectionemin: detém esse número de NFTs soulbound da coleção, os que não podem ser vendidos.held_forcomcollection,days(de 1 a 3.650) emin: detém esse número há pelo menos esse número de dias.rarity_rankcomcollectionemax_rank: detém um NFT com essa raridade ou superior.listed_ratiocomcollectionemax, uma fração de zero a um: não listou mais do que essa parte dos seus NFTs. Falso para quem não tem nenhum.top_holderscomcollectionen(de 1 a 1.000): é um dos maiores detentores da coleção.is_creatorcomcollection: uma das suas carteiras criou ou emitiu a coleção.royalty_compliantcomcollection: todos os NFTs que detém dela foram mintados ou comprados numa venda que pagou a royalty.xrp_balancecommin: detém pelo menos essa quantidade de XRP.token_balancecomissuer,currency(um código comoRLUSD, ou a sua forma hex de 40 caracteres) emin: detém pelo menos essa quantidade do token.mpt_balancecomissuance_id(48 caracteres hex) emin: detém pelo menos essa quantidade do token multiúso.amm_lp_balancecomamm_accountemin: detém pelo menos esse número de tokens de liquidez da pool.wallet_incomaddresses(de 1 a 10.000): uma das suas carteiras está na lista.
Limites
- 25 coleções acompanhadas por servidor.
- 50 regras de cargos 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 detentores por servidor a cada 10 minutos, com até cerca de 100.000 detentores.
- 25 alertas por membro e no máximo 30 mensagens de alerta por hora.
- As votações têm de 2 a 10 opções; os sorteios escolhem de 1 a 100 vencedores; allowlists, votações, sorteios e eventos podem durar até 90 dias.
- Cada membro pode usar o bot 20 vezes por minuto. Acima disso, o bot pede-lhe que abrande.
Privacidade e segurança
A verificação partilha com o bot os endereços das carteiras da tua conta First Ledger. O bot nunca vê uma chave e nunca te pede para assinar uma transação. Quem te pedir isso não é este bot.
O bot pede apenas as permissões que usa e nunca a de Administrador. Recusa-se a atribuir um cargo com permissões de moderação ou de administração.
Só remove os cargos que atribuiu. Um cargo que um moderador te deu manualmente mantém-se.
Outras apps só podem ver as tuas carteiras associadas se as autorizares pelo nome com /privacy allow, e podes revogar isso a qualquer momento.
/unlink apaga a tua associação e remove os cargos que o bot te deu em todos os servidores.
Resolução de problemas
Sem cargo após a verificação: executa /refresh. Se continuar sem aparecer, pede a um admin que execute /check-permissions; o cargo do bot está provavelmente abaixo do cargo de holder.
O link diz que expirou: cada link dura dez minutos e só funciona uma vez. Executa /verify novamente.
“Uma conta Discord diferente”: confirmaste com outra conta Discord que não a que executou o comando. Muda de conta no Discord e executa /verify novamente.
Um feed deixou de publicar: executa /admin feed list. Um feed onde o bot já não consegue publicar é desativado, e /admin audit indica o motivo.
Um cargo de saldo não mudou: estes são atualizados na verificação de hora a hora. Executa /refresh para verificar agora.