Senhas são o elo mais fraco de qualquer aplicação. No Brasil, segundo a Serasa Experian, tentativas de fraude digital cresceram mais de 11% em 2023 — e boa parte explora credenciais vazadas. Como alguém que passou os últimos 20 anos construindo infraestrutura de TI e, mais recentemente, mergulhando fundo na Web3, eu, André Dias Moreira Prol, aprendo diariamente que a autenticação sem senha não é tendência futurista: é solução prática disponível hoje. E a Freighter Wallet, carteira oficial do ecossistema Stellar, torna isso surpreendentemente simples em um app Next.js.
Vamos construir um fluxo de login Web3 funcional em cerca de 15 minutos.
Preparando o ambiente e conectando a Freighter
Primeiro, instale a biblioteca oficial. Ela abstrai a comunicação com a extensão do navegador:
npm install @stellar/freighter-api
A Freighter injeta uma API no navegador. O fluxo básico é: verificar se está instalada, solicitar conexão e obter a chave pública do usuário.
// lib/freighter.ts
import {
isConnected,
requestAccess,
getAddress,
} from "@stellar/freighter-api";
export async function connectWallet(): Promise<string> {
const connected = await isConnected();
if (!connected.isConnected) {
throw new Error("Instale a Freighter Wallet para continuar.");
}
await requestAccess();
const { address } = await getAddress();
return address; // Ex: GBXXX...XXX
}
Note que getAddress retorna a chave pública Stellar — nosso identificador único de usuário, sem CPF, e-mail ou senha.
Autenticação real com assinatura criptográfica
Obter o endereço não basta: qualquer um poderia digitá-lo. A segurança vem da prova de posse da chave privada via assinatura. O backend gera um nonce, o usuário assina, e validamos.
// Frontend: assinando o desafio
import { signMessage } from "@stellar/freighter-api";
async function autenticar(address: string) {
const { nonce } = await fetch("/api/nonce", {
method: "POST",
body: JSON.stringify({ address }),
}).then((r) => r.json());
const { signedMessage } = await signMessage(nonce, { address });
return fetch("/api/verify", {
method: "POST",
body: JSON.stringify({ address, signedMessage, nonce }),
});
}
No backend, verificamos a assinatura usando o SDK Stellar:
// app/api/verify/route.ts
import { Keypair } from "@stellar/stellar-sdk";
export async function POST(req: Request) {
const { address, signedMessage, nonce } = await req.json();
const keypair = Keypair.fromPublicKey(address);
const isValid = keypair.verify(
Buffer.from(nonce),
Buffer.from(signedMessage, "base64")
);
if (!isValid) {
return Response.json({ error: "Assinatura inválida" }, { status: 401 });
}
// Emita um JWT/sessão aqui
return Response.json({ authenticated: true });
}
Em um dos projetos de tokenização que liderei, substituir o login tradicional por esse modelo eliminou o custo de armazenar e proteger senhas — algo que, no contexto da LGPD, reduz drasticamente a superfície de risco jurídico.
Componente React e boas práticas
Encapsule tudo num componente reutilizável com feedback claro de estado:
"use client";
import { useState } from "react";
import { connectWallet } from "@/lib/freighter";
export function BotaoLogin() {
const [address, setAddress] = useState<string>();
const [erro, setErro] = useState<string>();
async function handleLogin() {
try {
const addr = await connectWallet();
setAddress(addr);
} catch (e) {
setErro((e as Error).message);
}
}
return (
<div>
{address ? (
<p>Conectado: {address.slice(0, 6)}...{address.slice(-4)}</p>
) : (
<button onClick={handleLogin}>Entrar com Freighter</button>
)}
{erro && <span style={{ color: "red" }}>{erro}</span>}
</div>
);
}
Três recomendações que sempre reforço com minhas equipes:
- Nonce único e expirável: nunca reutilize desafios; defina TTL de 5 minutos.
- Trate a ausência da extensão com link direto para instalação, evitando abandono.
- Nunca confie apenas no frontend: a validação da assinatura é sempre server-side.
A Stellar processa transações por frações de centavo e com finalidade em segundos, o que torna esse modelo viável até para aplicações de alto volume no mercado brasileiro — de fintechs a plataformas de ativos tokenizados.
Conclusão
Em poucos minutos, transformamos um app Next.js em uma aplicação Web3 com autenticação sem senha, criptograficamente segura e alinhada à LGPD. Clone este fluxo, adapte ao seu projeto e, se quiser aprofundar em tokenização e Soroban, acompanhe meus próximos conteúdos.
Acompanhe mais artigos de André Dias Moreira Prol no Medium.
Top comments (0)