Como fazer bridge de USDT entre redes com uma API

O que uma bridge de USDT realmente faz

Fazer bridge é mover um token de uma rede para outra — por exemplo, tirar USDT da BNB Chain e receber USDT na Polygon. É importante entender o que acontece por baixo, porque isso explica os estados que sua integração vai ver.

O USDT da BNB Chain é um contrato ERC-20 naquela rede. O USDT da Polygon é outro contrato, em outra rede. Não existe "mover" no sentido literal: existe entregar na origem e receber o equivalente no destino, com alguém garantindo a correspondência entre as duas pontas.

É por isso que a operação tem estados, e não um resultado imediato.

O fluxo, em quatro estados

Toda transferência passa pelo mesmo percurso, e sua interface deveria refletir isso:

1. Ordem criada. Você declara origem, destino, valor e endereço de recebimento. A ordem nasce com um identificador. 2. Depósito transmitido. O token sai da carteira de origem. Aqui existe um hash de transação na rede de origem. 3. Confirmação aguardada. A rede de origem precisa considerar aquele depósito final. Esse tempo não é escolha de ninguém: é propriedade da rede. 4. Entrega no destino. O valor equivalente é enviado na rede de destino, e há um segundo hash — esse é o que o usuário quer ver.

Mostrar esses quatro estados é a diferença entre uma integração que gera suporte e uma que não gera. O erro mais comum é exibir apenas "processando" e deixar o usuário sem saber se o dinheiro saiu.

O jeito curto

npm install @vkx/bridge

A chamada precisa de cinco coisas: sua chave, a rede de origem, a rede de destino, o valor e o endereço de destino. A VKX Bridge cria a ordem, transmite o depósito, acompanha a confirmação e devolve o hash do destino.

A chamada sai do seu servidor. A chave é secreta e não deve existir no aplicativo nem no navegador — é a mesma regra de qualquer credencial de pagamento.

Redes, direções e gás

Duas coisas mudam conforme a direção, e as duas afetam a experiência:

Saindo da Polygon, o depósito é patrocinado: a carteira de origem não precisa ter POL para pagar o gás do envio. Isso remove um pré-requisito que trava muita transferência — o usuário tem o USDT, mas não tem a moeda nativa.
Saindo da BNB Chain, o envio ERC-20 é pago pela origem, em BNB. A carteira precisa de um saldo mínimo de BNB para a transação de envio.

A lista atualizada de pares atendidos em cada direção está na página do produto. Vale conferir antes de assumir uma direção: não é simétrico — atender A para B não implica atender B para A.

Mínimos, taxa e o que checar antes de enviar

Três validações evitam a maior parte dos problemas de suporte:

Valor mínimo. Toda ponte tem um piso, porque abaixo dele o custo de rede consome a transferência. Cheque o mínimo da direção antes de deixar o usuário confirmar.
Endereço na rede correta. Endereço EVM tem o mesmo formato em todas as redes EVM, o que é conveniente e perigoso: um endereço válido pode ser de uma rede onde o usuário não controla nada. Se o destino for uma exchange, confirme que ela aceita depósitos naquela rede específica.
Saldo para o gás na origem, quando a direção exige.

Sobre taxa: é cobrada por transferência e depende do par e do valor. O número vigente está no produto, e vale calcular no momento da cotação em vez de fixar no seu código.

Erros comuns, e o que fazer

Depósito abaixo do mínimo. A ordem não completa. É por isso que a validação precisa acontecer antes do usuário assinar, não depois.
Rede errada no destino. Se o destino é uma carteira que você controla, é recuperável. Se é uma exchange que não suporta aquela rede, frequentemente não é. Avise antes.
Origem sem gás. A transação de envio nem sai. Mensagem clara aqui economiza muito suporte.
Falha no meio do percurso. Há reembolso. O usuário precisa ver isso na interface, e não descobrir por conta.

Sobre tempo

Não há prazo fixo. O tempo depende da finalidade da rede de origem e do congestionamento no momento. Prometer "em 30 segundos" seria impreciso — o que se pode fazer, e é melhor para o usuário, é mostrar o estado real da ordem a cada passo.

Perguntas frequentes

Preciso ter a moeda nativa da rede de origem? Saindo da Polygon, não — o depósito é patrocinado. Da BNB Chain, sim: o envio ERC-20 é pago em BNB.

A chamada pode sair do aplicativo? Não. A chave é secreta; a chamada nasce no seu servidor.

Quanto tempo leva? Depende da finalidade da rede de origem e da congestão. Não existe prazo fixo honesto; o estado da ordem é consultável durante todo o percurso.

E se eu enviar abaixo do mínimo? A ordem não completa. Valide o mínimo antes de o usuário confirmar.

Dá para atender qualquer par de redes? Não, e não é simétrico. Confira os pares atendidos em cada direção antes de assumir.

Serve para outros tokens além de USDT? O caso principal é stablecoin entre redes EVM. Os pares e ativos atendidos estão no produto.

Próximo passo

Se ainda está decidindo entre integrar e construir, vale ler por que uma ponte é difícil de manter. Se a decisão já está tomada, os pares e o preço estão na página do produto, e a documentação tem a referência da API.

Aviso: este conteúdo tem caráter informativo e educacional e não constitui recomendação de investimento.