Assinatura legível

Muitas carteiras ainda mostram dados crus para qualquer contrato que não reconhecem, e a “assinatura às cegas” — aprovar chamadas que você não consegue ler de verdade — é uma das formas pelas quais carteiras são esvaziadas. A resposta da Vela é a assinatura legível: antes de você assinar, a transação é decodificada em algo que você consegue entender, até onde isso é possível.

O que você vê

Em vez de calldata crua, a Vela mostra:

Intenção — o que a transação faz: Enviar, Aprovar, Trocar e assim por diante.
O essencial — os valores e os endereços envolvidos, com os valores de tokens em unidades reais e os destinatários identificados por nome, quando existe um.
Os detalhes — nonce, prazos e a calldata crua, disponíveis quando você quiser, em vez de jogados na sua cara.
Uma indicação de risco, com cores, para que as ações perigosas se destaquem.

Como funciona (ERC-7730)

A Vela decodifica tanto chamadas de contrato quanto dados tipados EIP-712 usando descritores ERC-7730 — definições pequenas e compartilháveis do que as funções de um contrato significam.

A Vela procura um descritor nesta ordem:

Integrado ao app — descritores de contratos muito usados: os roteadores do Uniswap, PancakeSwap e SushiSwap, WETH, o pool do Aave v3, 1inch, Lido e wstETH, e Seaport.
Buscado no servidor de dados de chain da Vela, que republica o registro público do ERC-7730.
Formatos padrão — tokens ERC-20, NFTs ERC-721 e ERC-1155, cofres ERC-4626 e permits ERC-2612 —, para que a maioria das ações do dia a dia continue sendo decodificada.

Verificado é reservado à primeira fonte. Uma transação só recebe o rótulo verificado quando a descrição veio de um descritor embutido no app que você está usando — ou veio do servidor de dados de chain e é idêntica à cópia embutida, o que prova que nada foi alterado no caminho. Todo o resto que o servidor manda continua sendo decodificado e continua sendo mostrado, com uma linha dizendo que veio do serviço de descritores e que nada o autenticou. Esse serviço não é assinado, então é tão confiável quanto quem o opera — e esse é um dos motivos pelos quais você pode rodar o seu.

Os valores de tokens são formatados com as casas decimais reais do token on-chain. Se a Vela não consegue confirmar as casas decimais de um token, ela mostra o valor como se o token tivesse 18 e o marca como não verificado, para que um número errado nunca pareça conferido.

Níveis de risco

Toda transação decodificada recebe um nível de risco, para que os padrões perigosos se destaquem:

Atenção para aprovações e permits — você está concedendo poder de gasto.
Perigo para o que é arriscado de verdade, como uma aprovação ilimitada de token.
Risco menor para ações rotineiras, como staking ou depósito.

Uma aprovação “ilimitada” aparece em vermelho, com a opção de limitá-la

Uma aprovação on-chain de valor ilimitado é uma das formas mais comuns de os fundos serem esvaziados mais tarde. Quando um dApp pede uma (approve, increaseAllowance ou o approve do Permit2) no nível “ilimitado” — 2^200 ou mais (2^152 no Permit2), que é o que os dApps usam para “ilimitado” —, a Vela a mostra em vermelho e oferece um limite: um valor específico, o seu saldo (quando dá para lê-lo) ou — exceto no increaseAllowance — uma revogação. A menos que você escolha um deles, ela é enviada exatamente como o dApp a montou: o Permit2 foi projetado em torno de uma aprovação permanente, e o lote de uma conta inteligente gasta essa permissão na mesma transação, então um limite abaixo desse gasto faz o lote inteiro falhar. Dentro de um lote, cada aprovação ilimitada pode receber o seu próprio limite do mesmo jeito (um valor ou uma revogação). Uma última verificação antes do envio lê a calldata crua, então uma aprovação ilimitada que a tela de aprovação nunca mostrou não tem como sair. Uma aprovação finita alta (mesmo muito acima do seu saldo) aparece com um alerta. Permits assinados (assinaturas EIP-2612 e Permit2) não podem ser limitados — o dApp envia a própria cópia —, então são assinados como foram pedidos ou recusados: um ilimitado aparece em vermelho, um limitado, com um alerta. Um pedido para conceder um setApprovalForAll de NFT sobre uma coleção inteira ainda não pode ser aprovado nos apps.

Quando a Vela não consegue decodificar uma chamada

Quando não existe descritor ERC-7730, mas a função aparece num banco de dados público de seletores, a Vela decodifica a chamada de forma genérica e a marca como melhor esforço — decodificada, mas não verificada — sob um banner de atenção. Se nem isso funcionar, ou se a Vela só conseguir decodificar parte de uma transação, ela não finge que entende.

Por que isso importa

Autocustódia significa que ninguém pode reverter uma transação ruim por você. A defesa não é uma central de suporte — é entender o que você aprova antes de aprovar. A assinatura legível é a forma como a Vela tenta mostrar isso, e ela tem limites: só pode ser tão honesta quanto o app que a exibe, e é por isso que uma conferência independente importa. Veja o whitepaper para entender onde ela se encaixa no modelo de segurança da Vela.