First Ledger NFT
CriarA verificar se tem sessão iniciada

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

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

Lista as tuas carteiras associadas, cada uma com link para a sua página no First Ledger.

/refresh

Qualquer pessoa

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

Lista os cargos de holder deste servidor e os requisitos de cada um, assinalando os que tens.

/floor

Qualquer pessoa

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

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

Publica 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 NFTokenID do NFT, com 64 caracteres.

/portfolio

Qualquer pessoa

Mostra os teus NFTs nas tuas carteiras associadas, 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. Mantém as DMs de membros do servidor abertas, ou o bot não te consegue contactar.

kindobrigatório
offer_received para ofertas nos teus NFTs, suspicious_offer para um aviso quando uma oferta parece burla, collection_sale para vendas numa 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 venda mínima a notificar ou, para listagens, o preço máximo.

/alerts remove

Qualquer pessoa

Desativa um alerta.

kindobrigatório
offer_received para ofertas nos teus NFTs, suspicious_offer para um aviso quando uma oferta parece burla, collection_sale para vendas numa 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 os teus alertas.

/privacy allow

Qualquer pessoa

Permite que uma app parceira consulte as tuas carteiras associadas.

partnerobrigatório
O nome da app parceira.

/privacy revoke

Qualquer pessoa

Deixa de partilhar com uma app parceira.

partnerobrigatório
O nome da app parceira.

/privacy status

Qualquer pessoa

Lista as apps parceiras com que partilhas.

/unlink

Qualquer pessoa

Remove a tua associação e os cargos que o bot te deu em todos os servidores que partilhas com ele.

/help

Qualquer pessoa

Mostra se tens associação feita e um guia rápido destes comandos.

Configuração

/setup

Gerir servidor

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

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

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

Deixa de acompanhar uma coleção.

collectionobrigatório
A coleção.

/admin collection list

Gerir servidor

Lista as coleções que este servidor acompanha.

Cargos de holders

/admin role set

Gerir servidor

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

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

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

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

Lista todas as regras de cargos por extenso e se estão ativas.

Feeds e ferramentas do servidor

/admin feed add

Gerir servidor

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

/admin feed layout

Gerir servidor

Alterna um feed entre o formato completo e o compacto.

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

/admin feed remove

Gerir servidor

Elimina o feed de um canal.

channelobrigatório
O canal.

/admin feed list

Gerir servidor

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

/admin stat add

Gerir servidor

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

Deixa de atualizar um canal de estatísticas. O canal mantém-se.

channelobrigatório
O canal.

/admin snapshot take

Gerir servidor

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

Lista os snapshots recentes.

/admin audit

Gerir servidor

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

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

Allowlists, sondagens, sorteios e eventos

/allowlist create

Gerir servidor

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

Fecha uma allowlist agora.

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

/allowlist export

Gerir servidor

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

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

/poll create

Gerir servidor

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

Fecha uma sondagem agora e publica os resultados.

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

/raffle create

Gerir 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 participação por pessoa, ou nft: 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 servidor

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

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

Cancela um evento e atualiza a publicação.

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

/event attendees

Gerir servidor

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

  • holds com collection, min e um max opcional: detém esse número de NFTs da coleção.
  • holds_trait com collection, traits (de 1 a 12, cada um escrito Type:Value) e min: detém esse número de NFTs com qualquer um dos atributos.
  • holds_any_verified com min: detém esse número de NFTs de coleções verificadas, sejam quais forem.
  • holds_non_transferable com collection e min: detém esse número 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: detém esse número há pelo menos esse número de dias.
  • rarity_rank com collection e max_rank: detém um NFT com essa raridade ou superior.
  • listed_ratio com collection e max, 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_holders com collection e n (de 1 a 1.000): é um dos maiores detentores da coleção.
  • is_creator com collection: uma das suas carteiras criou ou emitiu a coleção.
  • royalty_compliant com collection: todos os NFTs que detém dela foram mintados ou comprados numa venda que pagou a royalty.
  • xrp_balance com min: detém pelo menos essa quantidade de XRP.
  • token_balance com issuer, currency (um código como RLUSD, ou a sua forma hex de 40 caracteres) e min: detém pelo menos essa quantidade do token.
  • mpt_balance com issuance_id (48 caracteres hex) e min: detém pelo menos essa quantidade do token multiúso.
  • amm_lp_balance com amm_account e min: detém pelo menos esse número de tokens de liquidez da pool.
  • wallet_in com addresses (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.