First Ledger NFT
CriarVerificando se você está conectado

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 /setup crie 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 take envie 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 pessoa

Envia 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 pessoa

Lista suas carteiras vinculadas, cada uma com link para a página dela na First Ledger.

/refresh

Qualquer pessoa

Recarrega 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 pessoa

Lista os cargos de holder deste servidor e o que cada um exige, marcando os que você tem.

/floor

Qualquer pessoa

Posta 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 pessoa

Posta 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 pessoa

Posta o card de um NFT: imagem, dono, ranking de raridade, preço se listado, royalty, flags e traits.

idobrigatório
O NFTokenID do NFT, com 64 caracteres.

/portfolio

Qualquer pessoa

Mostra seus NFTs em todas as carteiras vinculadas, agrupados por coleção.

/alerts add

Qualquer pessoa

Ativa 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ório
offer_received para ofertas nos seus NFTs, suspicious_offer para um aviso quando uma oferta parecer golpe, collection_sale para vendas em uma coleção ou listing_below para 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 pessoa

Desativa um alerta.

kindobrigatório
offer_received para ofertas nos seus NFTs, suspicious_offer para um aviso quando uma oferta parecer golpe, collection_sale para vendas em uma coleção ou listing_below para listagens abaixo de um preço.
collection
Necessário para alertas de vendas e listagens.

/alerts list

Qualquer pessoa

Lista seus alertas.

/privacy allow

Qualquer pessoa

Permite que um app parceiro consulte suas carteiras vinculadas.

partnerobrigatório
O nome do app parceiro.

/privacy revoke

Qualquer pessoa

Para de compartilhar com um app parceiro.

partnerobrigatório
O nome do app parceiro.

/privacy status

Qualquer pessoa

Lista os apps parceiros com quem você compartilha.

/unlink

Qualquer pessoa

Remove seu vínculo e os cargos que o bot te deu em todos os servidores que você compartilha com ele.

/help

Qualquer pessoa

Mostra se você está vinculado e um guia rápido destes comandos.

Configuração

/setup

Gerenciar servidor

Publica 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 servidor

Verifica 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 servidor

Acompanha 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 servidor

Para de acompanhar uma coleção.

collectionobrigatório
A coleção.

/admin collection list

Gerenciar servidor

Lista as coleções que este servidor acompanha.

Cargos de holders

/admin role set

Gerenciar servidor

Dá 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.
trait
Type:Value, como Background: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 servidor

Dá 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ório
xrp, token para um token emitido no XRP Ledger, mpt para um token multiuso ou lp para 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, como RLUSD.
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 servidor

Dá 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 servidor

Exclui 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 servidor

Lista cada regra de cargo por extenso e se está ativa.

Feeds e ferramentas do servidor

/admin feed add

Gerenciar servidor

Publica 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_expired e uri_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.
layout
full ou compact.

/admin feed layout

Gerenciar servidor

Alterna um feed entre o layout completo e o compacto.

channelobrigatório
O canal.
layoutobrigatório
full ou compact.

/admin feed remove

Gerenciar servidor

Exclui o feed de um canal.

channelobrigatório
O canal.

/admin feed list

Gerenciar servidor

Lista seus feeds, o que cada um publica e se está ativo.

/admin stat add

Gerenciar servidor

Cria 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ório
floor, holders, volume para o volume do dia, listed ou role para 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 servidor

Para de atualizar um canal de estatística. O canal continua existindo.

channelobrigatório
O canal.

/admin snapshot take

Gerenciar servidor

Envia 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 servidor

Lista os snapshots recentes.

/admin audit

Gerenciar servidor

Mostra 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 servidor

Verifica agora todos os membros vinculados. As alterações aparecem em /admin audit.

Allowlists, enquetes, sorteios e eventos

/allowlist create

Gerenciar servidor

Publica 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 servidor

Encerra uma allowlist agora.

nameobrigatório
O nome dela, com até 60 caracteres, diferente das outras allowlists do servidor.

/allowlist export

Gerenciar servidor

Envia 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 servidor

Lista as allowlists do servidor, com as entradas e quando fecham.

/poll create

Gerenciar servidor

Publica 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).
weighting
member: um voto ou entrada por pessoa, ou nft: 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 servidor

Encerra uma enquete agora e publica os resultados.

idobrigatório
O id no rodapé da publicação.

/raffle create

Gerenciar servidor

Publica 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).
weighting
member: um voto ou entrada por pessoa, ou nft: 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 servidor

Encerra 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 servidor

Publica 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, como 2026-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 servidor

Cancela um evento e atualiza a publicação.

idobrigatório
O id no rodapé da publicação.

/event attendees

Gerenciar servidor

Lista 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.

  • holds com collection, min e um max opcional: tem essa quantidade de NFTs da coleção.
  • holds_trait com collection, traits (de 1 a 12, cada um escrito Type:Value) e min: tem essa quantidade de NFTs com qualquer um dos atributos.
  • holds_any_verified com min: tem essa quantidade de NFTs de coleções verificadas, sejam quais forem.
  • holds_non_transferable com collection e min: tem essa quantidade de NFTs soulbound da coleção, os que não podem ser vendidos.
  • held_for com collection, days (de 1 a 3.650) e min: tem essa quantidade há pelo menos esse número de dias.
  • rarity_rank com collection e max_rank: tem um NFT com esse ranking de raridade ou mais raro.
  • listed_ratio com collection e max, uma fração de zero a um: listou no máximo essa parcela dos seus NFTs. Falso para quem não tem nenhum.
  • top_holders com collection e n (de 1 a 1.000): está entre os maiores holders da coleção.
  • is_creator com collection: uma das carteiras da pessoa criou ou emitiu a coleção.
  • royalty_compliant com collection: todo NFT da coleção que a pessoa tem foi mintado ou comprado em uma venda que pagou royalty.
  • xrp_balance com min: tem pelo menos essa quantidade de XRP.
  • token_balance com issuer, currency (um código como RLUSD ou sua forma hex de 40 caracteres) e min: tem pelo menos essa quantidade do token.
  • mpt_balance com issuance_id (48 caracteres hex) e min: tem pelo menos essa quantidade do token multiuso.
  • amm_lp_balance com amm_account e min: tem pelo menos essa quantidade de tokens de liquidez do pool.
  • wallet_in com addresses (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.