A KyberSwap é uma plataforma de trading descentralizada cujo agregador de DEX já facilitou mais de US$ 150 bilhões em transações para mais de 5 milhões de usuários. Quando o time unificou o frontend com Wagmi v3 e Viem, substituiu o código artesanal de detecção da MetaMask pelo conector oficial metaMask() do MetaMask Connect. Este estudo de caso mostra por que a KyberSwap fez essa mudança, o que mudou na web mobile e como a integração com o Connect convive com o papel separado da KyberSwap de fornecer taxas de swap para os usuários da MetaMask.
O trabalho da KyberSwap é oferecer a melhor taxa em cada trade
O DEX Aggregator da KyberSwap é uma solução de trading descentralizada criada para oferecer as melhores taxas e uma execução confiável em cada trade. Ele funciona com o Smart Settlement, um algoritmo de roteamento inteligente criado para maximizar o valor recebido e minimizar o slippage, acessando liquidez profunda em várias redes. Ao redor desse núcleo, há ordens limitadas, swaps entre redes (crosschain) em 23 redes e o Kyber Earn, para oportunidades de rendimento.
Uma plataforma construída em torno da qualidade de execução tem uma exigência simples para a sua porta de entrada: conectar uma carteira não deve exigir nenhum esforço mental.
Código artesanal de carteira é uma conta de manutenção
A configuração anterior da KyberSwap combinava Wagmi v2 com ethers.js e uma camada ad hoc de conectores injetados, incluindo código personalizado para detectar a MetaMask e se conectar a ela. Ao migrar para Wagmi v3 e Viem, o time decidiu abandonar esse código e adotar o conector oficial do MetaMask Connect.
Três fatores motivaram a decisão. Agora, um único conector cobre tanto a extensão de navegador no desktop quanto o fluxo de deep link e relay na web mobile. Há menos código personalizado de detecção de carteira para manter. E seguir o caminho oficialmente suportado pela MetaMask mantém a KyberSwap alinhada à medida que o EIP-6963 e o MetaMask Wallet Protocol (MWP) se tornam o padrão para carteiras e dapps se encontrarem.
Antes | Com o MetaMask Connect |
Wagmi v2, ethers.js e uma configuração ad hoc de conectores injetados | Wagmi v3 e Viem com o conector oficial metaMask() |
Código artesanal de detecção e conexão da MetaMask para manter | Detecção e conexão feitas pelo conector |
A web mobile dependia de um QR code do WalletConnect | Conexão nativa por deep link com o app da MetaMask por meio do relay do MWP |
Código personalizado para acompanhar os padrões de descoberta de carteiras | Alinhamento com o EIP-6963 e o MWP por meio do caminho suportado pela MetaMask |
Acertando a transição para o mobile
Na web mobile, o QR code é um caminho incômodo: o usuário já está no celular. O MetaMask Connect oferece à KyberSwap um fluxo de conexão por deep link que abre o app da MetaMask por meio do relay do MWP, para que quem está operando pelo celular se conecte sem precisar escanear nada.
A KyberSwap dedicou um esforço especial à transição no iOS. O objetivo era que os usuários chegassem direto à tela de aprovação da MetaMask, sem nenhuma etapa extra entre tocar em conectar e aprovar. O resultado é a mesma experiência de conexão, seja o trader vindo pela extensão no desktop ou pelo app mobile.
A stack
Camada | Componentes |
Trading | KyberSwap DEX Aggregator, Smart Settlement, Limit Orders, swaps crosschain (23 redes), Kyber Earn |
Frontend | Wagmi v3, Viem |
Conexão de carteira | MetaMask Connect (connect-evm), conector metaMask() |
Descoberta e transporte | EIP-6963, relay do MetaMask Wallet Protocol |
Carteira | Extensão de navegador da MetaMask (desktop), app mobile da MetaMask |
Impacto até agora
Desde a adoção do MetaMask Connect, a KyberSwap relata que a conexão tem sido confiável para os usuários, que a implantação foi tranquila desde o primeiro dia e que não houve reclamações nem problemas.
O resultado para o usuário, nas palavras da KyberSwap, é que conectar e operar agora parecem uma única etapa. O trader se conecta pela MetaMask e vai direto para um swap com a melhor taxa, sem nada no meio do caminho. O MetaMask Connect cuida da porta de entrada desse fluxo, e o Smart Settlement cuida do resto.
Duas integrações, uma só parceria
A integração com o Connect é uma metade da relação da KyberSwap com a MetaMask. A outra metade segue na direção oposta: a Aggregator API da KyberSwap fornece taxas de swap e execução entre redes para os usuários da MetaMask. O MetaMask Connect leva usuários da MetaMask para a KyberSwap, e a Aggregator API leva o roteamento da KyberSwap para dentro da MetaMask.
“A MetaMask tem sido uma parceira valiosa em duas frentes. O MetaMask Connect simplificou a forma como os traders se conectam à KyberSwap, oferecendo uma experiência confiável e consistente, seja na extensão ou no app mobile. Ao mesmo tempo, a KyberSwap Aggregator API entrega aos usuários da MetaMask as melhores taxas de swap e a melhor execução disponíveis entre redes. É uma parceria baseada no princípio que mais valorizamos: tornar o trading em DeFi mais simples, fluido e eficiente para todos.” — Ken Tran, Business Development Manager, KyberSwap
Conselhos da KyberSwap para quem desenvolve
Apoie-se na documentação oficial. Ela mantém sua integração alinhada ao padrão e torna a transição mais limpa do que trabalhar a partir de exemplos antigos ou de implementações personalizadas.
Migre a conexão de carteira como parte de uma limpeza maior da stack. A KyberSwap substituiu seu código da MetaMask ao migrar para o Wagmi v3 e o Viem, então a troca do conector foi uma peça de uma consolidação planejada, não um projeto separado.
Teste a transição para o mobile de ponta a ponta. O detalhe que importa para os usuários é onde eles chegam depois de tocar em conectar. A KyberSwap verificou que os usuários de iOS chegam diretamente à tela de aprovação da MetaMask.
Avalie com base na sua própria arquitetura. A migração correu bem para a configuração da KyberSwap, mas a stack de cada equipe é diferente, e a decisão certa depende das necessidades do seu produto.
Desenvolva com o MetaMask Connect: uma única integração que funciona para todos os usuários, não importa como escolham se conectar.