CONSTRUA UM VISUALIZADOR DE COTAÇÕES STONfi ANTES DE CONSTRUIR UMA SWAP

A maioria dos tutoriais de swap corre direto para assinar. Um primeiro passo útil é criar um visualizador de cotações apenas leitura com TypeScript. Você aprende como o Omniston da STONfi se comporta antes que fundos entrem na imagem.

📡 A COTAÇÃO É UM STREAM, NÃO UM SNAPSHOT

O requestForQuote() do Omniston não é uma requisição REST normal que retorna um único preço e termina. Ele abre um stream ao vivo. O ack confirma que o RFQ foi aberto, o quoteUpdated entrega as cotações atuais, o noQuote significa que nenhuma fonte conectada consegue preencher a solicitação e o unsubscribed indica que o stream terminou.

A primeira cotação não é automaticamente a cotação final. Atualizações posteriores refletem mudanças de liquidez, então mantenha sempre o evento mais recente. A aplicação deve renderizar o resultado mais atual em vez de cachear o primeiro e tratá-lo como permanente.

🔢 METADADOS E UNIDADES FAZEM PARTE DA COTAÇÃO

O Omniston trabalha com unidades base da blockchain, enquanto os usuários pensam em quantidades normais de tokens. A API da STONfi fornece metadados como símbolos e decimais, para que o visualizador converta valores corretamente.

A precisão não é universal. A fonte observa que muitos jettons TON usam 9 decimais, enquanto USDT na TON usa 6. O JavaScript Number é outra armadilha: valores grandes em unidades base podem perder precisão além de 2^53. BigInt para aritmética e strings para transporte mantêm esses valores exatos.

🧠 POR QUE ESTE PEQUENO PROJETO IMPORTA

Um visualizador apenas leitura pode se tornar a base prática para uma interface de swap, monitor de preços, scanner de arbitragem, bot do Telegram ou fonte de dados. Depois que o ciclo de vida da cotação, tipos de liquidação e conversões de quantia forem entendidos, adicionar uma carteira vira um passo separado.

A arquitetura por trás desse fluxo: a API da STONfi te diz quais são os ativos, enquanto o Omniston encontra preços executáveis em pools da STONfi, outros DEXs da TON e resolvedores de RFQ.

Construa primeiro a camada somente leitura. Adicione execução apenas depois que o ciclo de vida da cotação fizer sentido.

NFA - DYOR

$BTC