WaveDigger

Explore os sinais sem fio para descobrir suas localizações físicas. O WaveDigger ajuda você a encontrar pontos de acesso Wi-Fi pelo seu BSSID (endereço MAC) e torres de celular (LTE e 5G NR) pelos seus parâmetros de rede. Construído com Next.js, TypeScript e deck.gl para visualização interativa em mapa.

Uma versão hospedada pode ser encontrada em https://wavedigger.networksurvey.app.

Recursos

• Busca por BSSID: Insira um BSSID para encontrar sua localização aproximada
• Validação de Entrada: Formatação e validação automáticas da entrada de BSSID
  • Suporta formatos: AA:BB:CC:DD:EE:FF, AA-BB-CC-DD-EE-FF, AABBCCDDEEFF
• Busca por Torre de Celular: Consulte torres LTE (MCC, MNC, TAC, Cell ID) ou torres 5G NR (MCC, MNC, TAC, NCI). Buscas NR retornam a célula alvo mais as células NR vizinhas no mesmo cluster.
• Mapa Interativo: Visualize os resultados em um mapa alimentado por deck.gl
• Histórico de Buscas: Acompanhe buscas recentes para acesso rápido
• Design Responsivo: Funciona em desktops e dispositivos móveis

Agradecimentos

🙏 Este projeto não seria possível sem o trabalho incrível realizado pela equipe do apple-corelocation-experiments.

O WaveDigger é construído sobre a pesquisa e engenharia reversa deles da API de serviços de localização da Apple. Especificamente, usamos:

• As definições protobuf deles para a API WLOC da Apple
• Documentação dos endpoints da API e formatos de requisição/resposta
• Entendimento da codificação de coordenadas e comportamento da API
• O prefixo de bytes inicial necessário para requisições válidas

O trabalho deles em entender e documentar os serviços de localização não documentados da Apple tornou possível a existência de projetos como o WaveDigger. Por favor, confira o repositório deles para a pesquisa original e ferramentas adicionais para trabalhar com os serviços de localização da Apple.

Primeiros Passos

Pré-requisitos

• Node.js 24+ e npm

Instalação

1. Instale as dependências:

npm install

1. (Opcional) Adicione um token do Mapbox para tiles de mapa aprimorados:
   • Obtenha um token em Mapbox
   • Adicione-o ao .env.local:
   root@kitploit:~

   NEXT_PUBLIC_MAPBOX_TOKEN=your_token_here
   

Executando o Servidor de Desenvolvimento

npm run dev

Abra http://localhost:3000 para visualizar a aplicação.

Detalhes Técnicos

Arquitetura

• Frontend: Next.js 15 com TypeScript
• Visualização de Mapa: deck.gl com react-map-gl
• Estilização: Tailwind CSS
• API: Rotas de API do Next.js

API WLOC Real da Apple

A aplicação usa a API WLOC real da Apple para consultar localizações de BSSID. Esta implementação é baseada na pesquisa e nas definições protobuf do projeto apple-corelocation-experiments.

A implementação da API:

• Usa protobuf para comunicação com os servidores da Apple
• Envia requisições para https://gs-loc.apple.com/clls/wloc
• Lida com conversão de coordenadas (a Apple usa int64 com 8 casas decimais)
• Suporta tanto endpoints padrão quanto da região da China

Testando com BSSIDs Reais

Para testar o aplicativo:

1. Encontre um BSSID real de Wi-Fi (endereço MAC) do seu roteador ou ponto de acesso
2. Insira-o em qualquer formato suportado
3. O aplicativo consultará o banco de dados da Apple e mostrará a localização se encontrada

Nota: Nem todos os BSSIDs estão no banco de dados da Apple. Pontos de acesso recém-implantados ou privados podem não ter dados de localização.

Roadmap de Recursos

• Exportar Resultados: Baixar resultados de busca como JSON/CSV
• Visualização de cluster TAC: Navegar por todas as torres em um TAC sem precisar de um Cell ID ou NCI específico

Licença

O WaveDigger é licenciado sob a GNU Affero General Public License v3.0. Se você executar uma versão modificada deste software como um serviço de rede, a AGPL exige que você disponibilize seu código-fonte modificado aos usuários desse serviço.