Guias

A blacklist da USDT, explicada

O USDT é emitido por uma empresa, e a empresa mantém um interruptor no contrato do seu token: qualquer endereço pode ser congelado. Para uma empresa que paga USDT em volume, a blacklist não é trivialidade — é um risco por destinatário que custa dinheiro de verdade quando é ignorado. Veja como funciona e como filtrar para ela.

O que é a blacklist

O contrato do USDT na TRON dá ao seu emissor, a Tether, o poder de colocar endereços na blacklist. Um endereço na blacklist fica congelado no token: o USDT que ele guarda não pode ser movido, e transferências envolvendo ele não passam. O congelamento se aplica só no nível do token — o endereço ainda pode guardar e mover TRX; é o USDT que para.

Todo congelamento é uma transação on-chain, então a lista é pública por construção: qualquer um pode checar qualquer endereço a qualquer momento. O que não é público de antemão é o momento — um endereço está bem até o instante em que deixa de estar.

Como endereços acabam nela

A Tether congela endereços em resposta a pedidos de autoridades e ordens judiciais, por exposição a sanções, e em torno da movimentação de fundos de hacks e golpes. Um congelamento não é um veredito judicial — enganos e congelamentos colaterais acontecem — mas para quem está prestes a enviar dinheiro a um endereço desses, a conclusão prática é a mesma: a transferência não consegue chegar.

Quanto custa um pagamento a um endereço congelado

A transferência falha on-chain. O que você gasta com ela não volta: a energia — ou o TRX queimado — paga pela tentativa, não pelo resultado.

Num lote o dano se multiplica em silêncio: um destinatário congelado entre quinhentos é invisível a olho nu, falha sozinho, e — se o seu pipeline tenta de novo as falhas — continua falhando pelo preço cheio. Filtrar antes de enviar não é teatro de compliance; é mais barato, todas as vezes.

Como filtrar antes de gastar um único TRX

Este serviço checa destinatários como parte do seu fluxo normal, e você também pode perguntar diretamente:

curl "https://api.nrg.market/v1/address-check?address=TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9" \
  -H "Authorization: Bearer $KEY"

{"activated": true, "holds_usdt": true, "blacklisted": false, "is_contract": false}

blacklisted é o próprio congelamento, lido da cadeia. Os outros três campos respondem perguntas vizinhas que decidem quanto uma transferência vai custar: activated — se o endereço existe on-chain; holds_usdt — se o destinatário já tem uma conta de token (se não, a transferência precisa de cerca do dobro da energia); is_contract — o destinatário é um contrato inteligente, cujo apetite por energia é o dele mesmo.

Uma estimativa de custo (POST /v1/estimate, até 500 destinatários de cada vez) marca todo destinatário problemático numa única passada — blacklisted, inactive_recipient, contract_recipient — sem reservar ou gastar nada. Um pedido que nomeia um destinatário na blacklist é recusado de imediato, com o erro blacklisted_recipient, antes de qualquer dinheiro se mover: uma transferência que não consegue chegar não é um serviço que vale a pena vender.

Listas de sanções são um assunto separado e mais amplo do que a blacklist do token; como destinos proibidos são tratados aqui está estabelecido na Política de Uso Aceitável.

Filtre um lote antes de pagar por ele. GET /v1/address-check responde para um endereço e POST /v1/estimate para até quinhentos, e nenhum dos dois reserva ou cobra nada. GET /v1/address-check na referência da API →

Perguntas que recebemos de verdade

Um endereço congelado pode ser descongelado?

Sim — o mesmo interruptor funciona nas duas direções, e a Tether já o usou assim. É inteiramente uma decisão do emissor, e reversões são a exceção, não algo para se planejar.

A blacklist afeta o TRX ou outros tokens?

Não. O congelamento vive dentro do contrato do USDT e alcança só o USDT. O endereço continua enviando e recebendo TRX e outros tokens normalmente.

Existe uma lista oficial para baixar?

O estado vive on-chain, e todo congelamento é uma transação pública. Na prática você consulta por endereço no momento do envio — que é o que o GET /v1/address-check faz — em vez de baixar uma foto que começa a envelhecer na mesma hora.

Enviamos para um endereço que foi congelado depois. A nossa transferência corre risco?

Uma transferência concluída é história e não desacontece. O congelamento impede o endereço de movimentar fundos a partir daquele momento — que é exatamente por que destinatários são filtrados no momento do envio, não uma vez por ano.