O que é um validador de endereço Solana?
Um validador de endereço Solana verifica se uma string é a codificação Base58 de exatamente 32 bytes, o tamanho de uma chave pública ed25519, e depois testa se esses bytes decodificam para um ponto na curva ed25519. Chaves on-curve pertencem a carteiras comuns; valores off-curve são endereços derivados de programa (PDAs). Endereços Solana não carregam checksum, então o teste de curva é a única detecção de erro de digitação disponível.
O que o resultado informa
- Válido, conta de carteira: a string decodifica para 32 bytes e a chave está na curva ed25519. É o que uma carteira Phantom, Solflare ou Backpack exibe como seu endereço.
- Válido, PDA / off-curve: corretamente formado, mas nenhuma chave privada pode existir para ele. Típico de contas de token e cofres de programas.
- Inválido: comprimento errado, caractere ilegal, ou a string é na verdade um endereço de outra rede.
Como funciona a verificação de curva
Uma chave pública ed25519 codifica a coordenada y de um ponto da curva mais um bit de sinal. A partir de y, a ferramenta calcula x² = (y² − 1) / (d·y² + 1) módulo 2²⁵⁵ − 19 e testa se x² tem raiz quadrada. Se tiver, existe um ponto e a chave pode ter uma chave privada; se não, o endereço é off-curve. A aritmética roda no seu navegador com BigInt.
Erros comuns com endereços Solana
- Último caractere faltando. Apps de chat às vezes truncam strings longas. Um endereço de 43 caracteres que deveria ter 44 vai decodificar para o comprimento errado e falhar.
- Confundir um mint com uma carteira. O endereço de mint do USDC EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v é um endereço válido, mas enviar tokens para ele os queima. Envie apenas para endereços que uma pessoa lhe deu como sua carteira.
- Colar um endereço Ethereum. 0x… não é Solana. Fora as bridges, ativos enviados entre formatos são perdidos.
Crie um código Solana Pay para um endereço verificado com o gerador de QR Solana Pay.