DEV Community

André Dias Moreira Prol
André Dias Moreira Prol

Posted on

André Dias Moreira Prol: Freighter Wallet em Next.js em 15min

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
Enter fullscreen mode Exit fullscreen mode

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
}
Enter fullscreen mode Exit fullscreen mode

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 }),
  });
}
Enter fullscreen mode Exit fullscreen mode

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 });
}
Enter fullscreen mode Exit fullscreen mode

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>
  );
}
Enter fullscreen mode Exit fullscreen mode

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)