Construído com Next.js, MapLibre GL, FastAPI e Python. Mais de 40 camadas de dados alternáveis, incluindo detecção de mudanças no solo SAR, OSINT do Telegram (visualizações de canais públicos geoparsadas no mapa), um kit de ferramentas de reconhecimento do lado do servidor (DNS, WHOIS, sanções, BGP, varredura de IP e mais), sobreposições de risco da cadeia de suprimentos e feeds de ameaças cibernéticas de malware/C2 + CISA KEV. Múltiplos modos visuais (DEFAULT / SATELLITE / FLIR / NVG / CRT). Clique com o botão direito em qualquer ponto da Terra para obter um dossiê do país, consulta de chefe de estado, expansão do gráfico de entidades e a foto mais recente do satélite Sentinel-2. ShadowBroker não tem contas, telemetria de produto ou análises; o painel se comunica com seu backend auto-hospedado. Consultas sensíveis de reconhecimento e Shodan nunca chegam a APIs de terceiros a partir do navegador — elas são intermediadas pelo backend com proteções SSRF e autenticação de operador local. O canal de comando de agente OpenClaw expõe os mesmos backends de reconhecimento mais pesquisa completa de telemetria — sem necessidade de integração de API separada.

Projetado para analistas, pesquisadores, operadores de rádio e qualquer pessoa que queira ver como o mundo parece quando todos os sinais públicos estão no mesmo mapa.

Uma quantidade surpreendente de telemetria global já é pública — transmissões ADS-B de aeronaves, sinais AIS marítimos, dados orbitais de satélites, sensores de terremotos, redes de rádio mesh, feeds de scanners policiais, estações de monitoramento ambiental, telemetria de infraestrutura da Internet e muito mais. Esses dados estão espalhados por dezenas de ferramentas e APIs. ShadowBroker combina tudo em uma única interface.

O projeto não introduz novas capacidades de vigilância — ele agrega e visualiza conjuntos de dados públicos já existentes. É totalmente open-source para que qualquer pessoa possa auditar exatamente quais dados são acessados e como. ShadowBroker não inclui telemetria de produto, análises ou contas. As chaves fornecidas pelo operador permanecem em sua implantação local, mas os recursos de OSINT ao vivo necessariamente fazem requisições de saída para os provedores de dados públicos que você ativar ou consultar.

ShadowBroker inclui um conector Shodan opcional para acesso à API fornecido pelo operador (SHODAN_API_KEY) e um painel de Kit de Ferramentas de Reconhecimento para consultas OSINT sem chave. Ambos são executados apenas no lado do servidor: o navegador chama suas rotas /api/osint/* e /api/tools/shodan/* auto-hospedadas; as requisições de saída são feitas pelo backend após validação SSRF. O reconhecimento requer acesso de operador local (mesmo modelo de confiança que alternâncias de camada e rotas de administrador). Os resultados do Shodan são renderizados como uma sobreposição de mapa separada e permanecem sujeitos aos termos de serviço do Shodan.

• Rastreie o Air Force One, os jatos particulares de bilionários e ditadores, e todos os petroleiros militares, ISR e caças que transmitem ADS-B. O Air Force One e todos os aviões presidenciais/vice-presidenciais que o acompanham são destacados e monitorados desde o momento em que deixam o solo.
• Conecte um agente de IA como co-analista através do canal de comando agêntico assinado por HMAC do ShadowBroker — suporta OpenClaw e qualquer outro agente que fale o protocolo (Claude, GPT, LangChain, personalizado). O agente obtém acesso completo de leitura/gravação a todas as 40+ camadas de dados, pesquisa compacta entre camadas (search_telemetry, search_news), o kit de ferramentas de reconhecimento completo (osint_lookup para IP/DNS/WHOIS/sanções/CVE/etc.), expansão de gráfico de entidades, colocação de pinos, controle de mapa, mudança de solo SAR, redes mesh e entrega de alertas. Ele vê tudo o que o operador vê e pode realizar ações no mapa em tempo real.
• Comunique-se na testnet InfoNet — A primeira malha de inteligência descentralizada integrada a uma ferramenta OSINT. Mensagens ofuscadas com personas de gate, troca peer-to-peer Dead Drop e um terminal CLI embutido. Sem contas, sem cadastro. A privacidade ainda não é garantida — esta é uma testnet experimental — mas o protocolo está ativo e sendo fortalecido.
• Clique com o botão direito em qualquer lugar da Terra para obter um dossiê do país (chefe de estado, população, idiomas), resumo da Wikipedia e a foto mais recente do satélite Sentinel-2 em resolução de 10m
• Clique em um nó KiwiSDR e sintonize o rádio de ondas curtas ao vivo diretamente no painel. Clique em um feed de scanner policial e ouça com um clique.
• Assista a mais de 11.000 câmeras CCTV em 6 países — Londres, Nova York, Califórnia, Espanha, Singapura e mais — transmitindo ao vivo no mapa
• Veja zonas de bloqueio de GPS em tempo real — derivadas da análise de degradação NAC-P dos dados do transponder de aeronaves
• Monitore satélites acima codificados por cores por tipo de missão — reconhecimento militar, SIGINT, SAR, alerta precoce, estações espaciais — com as redes de estações terrestres SatNOGS e TinyGS
• Rastreie o tráfego naval incluindo mais de 25.000 embarcações AIS, atividade pesqueira via Global Fishing Watch e superiates de bilionários
• Acompanhe terremotos, erupções vulcânicas, incêndios florestais ativos (NASA FIRMS), alertas meteorológicos severos e leituras de qualidade do ar em todo o mundo
• Mapeie bases militares, mais de 35.000 usinas elétricas, mais de 2.000 centros de dados e regiões de interrupção da Internet — referenciados automaticamente
• Conecte-se a nós de rádio mesh Meshtastic e redes de rádio amador APRS — visíveis no mapa e integrados ao Mesh Chat
• Detecte mudanças no solo através da cobertura de nuvens com SAR (Radar de Abertura Sintética) — deformação do solo em escala milimétrica, extensão de inundações, distúrbios na vegetação e avaliações de danos da NASA OPERA e Copernicus EGMS. Defina suas próprias áreas de monitoramento e receba alertas de anomalias. Gratuito com uma conta NASA Earthdata.
• Altere os modos visuais — DEFAULT, SATELLITE, FLIR (térmico), NVG (visão noturna), CRT (terminal retrô) — através do botão STYLE
• Rastreie trens pelos EUA (Amtrak) e Europa (DigiTraffic) em tempo real
• Estime onde estão os porta-aviões dos EUA usando raspagem automatizada de notícias do GDELT — nenhuma outra ferramenta aberta faz isso
• Pesquise dispositivos conectados à Internet em todo o mundo via Shodan — câmeras, sistemas SCADA, bancos de dados — plotados como uma sobreposição ao vivo no mapa
• Execute um kit de ferramentas de reconhecimento completo na barra lateral esquerda — geolocalização de IP, DNS, RDAP/WHOIS, transparência de certificados, BGP/ASN, pesquisa de sanções OFAC, consulta CVE, verificações de ameaças Tor/OTX e varreduras de sub-rede (InternetDB intermediado no servidor)
• Expanda um gráfico de entidades ao selecionar uma aeronave, embarcação, empresa ou IP — links cruzados do Wikidata + OFAC + loja ao vivo renderizados no painel de Gráfico de Entidades
• Monitore o risco da cadeia de suprimentos — Fabs de semicondutores e baterias de Nível 1/2 classificados em relação a terremotos, incêndios florestais e eventos de conflito próximos (painel SCM)
• Ative/desative pontos de acesso C2 de malware — feeds abuse.ch Feodo Tracker + URLhaus mapeados por país (camada opcional)
• Monitore canais OSINT do Telegram — feeds públicos de guerra/conflito t.me/s (OSINTdefender, NEXTA, etc.) raspados a cada hora, classificados por risco, geoparsados para âncoras metropolitanas, e plotados como pins de mapa clicáveis com mídia inline
• Sobreponha cabos submarinos globais — rotas de cabos estáticas derivadas da TeleGeography (camada opcional)

Para implantações de alta disponibilidade ou clusters de laboratório doméstico, o ShadowBroker oferece suporte à implantação via Helm. Este chart é baseado no template bjw-s-labs e fornece uma configuração robusta e modular tanto para o backend quanto para o frontend.

1. Adicione o Repositório:```bash helm repo add bjw-s-labs https://bjw-s-labs.github.io/helm-charts/ helm repo update

**2. Instalar o Chart:**```bash
# Default — pulls images from GHCR
helm install shadowbroker ./helm/chart --create-namespace --namespace shadowbroker

# GitLab registry variant
helm install shadowbroker ./helm/chart --create-namespace --namespace shadowbroker \
  -f helm/chart/values.yaml \
  -f helm/chart/values-gitlab.yaml

3. Funcionalidades Principais:

• Arquitetura Modular: Escale individualmente o backend de inteligência e o frontend HUD.
• Contexto de Segurança: Executa com UIDs restritas (1001) para endurecimento de contêineres.
• Pronto para Ingress: Compatível com Traefik, Cert-Manager e Gateway API para acesso externo seguro ao seu nó de inteligência.

Agradecimentos especiais ao @chr0n1x por contribuir com a arquitetura Kubernetes inicial.

O ShadowBroker v0.9.7 inclui InfoNet (malha de inteligência descentralizada + economia de governança Shell Soberano), um canal de comando de IA agêntico (suporta OpenClaw e qualquer agente de assinatura HMAC), reprodução instantânea Time Machine e detecção de mudanças no solo por SAR. Esta é uma testnet experimental — não é um mensageiro privado nem um sistema de governança de produção.

Não transmita nada sensível em nenhum canal. Trate todos os canais como abertos e públicos por enquanto. A criptografia ponta a ponta e o endurecimento nativo/Tauri mais profundo são os próximos marcos. Se você bifurcar este projeto, mantenha estes rótulos intactos e não faça alegações de privacidade mais fortes do que a implementação suporta.

Para uma imagem completa do que a malha realmente defende e do que não defende, leia o modelo de ameaças e a reconciliação de alegações. Cada frase acima está mapeada para o caminho de código que a aplica (ou não).

🧅 InfoNet — Malha de Inteligência Descentralizada + Shell Soberano (expandido na v0.9.7)

A primeira camada de comunicação e governança de inteligência descentralizada construída diretamente em uma plataforma OSINT. Sem contas, sem cadastro, sem identidade necessária. A v0.9.7 promove o InfoNet de uma camada de chat para uma economia de governança completa com um caminho claro para uma plataforma de inteligência descentralizada que preserva a privacidade.

Camada de Comunicação (desde v0.9.6):

• InfoNet Testnet Experimental — Um relé de mensagens global e ofuscado usando Tor e Reticulum. Qualquer pessoa executando o ShadowBroker pode transmitir e receber no InfoNet. As mensagens passam por uma camada de relé Wormhole com personas de gate, assinatura de payload canônica Ed25519 e ofuscação de transporte.
• Painel de Chat Mesh — Interface de três abas: INFONET (gate chat com transporte ofuscado), MESH (integração de rádio Meshtastic), DEAD DROP (troca de mensagens peer-to-peer com caixas postais baseadas em token — canal mais forte atual).
• Sistema de Persona Gate — Identidades pseudônimas com chaves de assinatura Ed25519, pacotes de pré-chave, verificação de contato por palavras SAS e relato de abuso.
• Terminal Mesh — CLI integrada: send, dm, comandos de mercado, inspeção de estado do gate. Painel arrastável, minimiza para a barra superior. Digite help para ver todos os comandos.
• Pilha Criptográfica — Assinatura Ed25519, Diffie-Hellman X25519, criptografia AESGCM com derivação de chave HKDF, sistema de comprometimento hashchain. Andaime de DM double-ratchet em andamento.

Shell Soberano — economia de governança (NOVO na v0.9.7):

• Petições + DSL de Governança — Alterações de parâmetros on-chain por meio de petições assinadas. Executor de payload type-safe para UPDATE_PARAM, BATCH_UPDATE_PARAMS, ENABLE_FEATURE e DISABLE_FEATURE. Parâmetros ajustáveis mudam por voto — sem necessidade de implantações de código.
• Governança de Hash de Atualização — Atualizações de protocolo que exigem nova lógica (não apenas alterações de parâmetros) votam em um hash SHA-256 da versão verificada. Supermaioria de 80%, quórum de 40%, ativação por 67% dos Nós Pesados. Ciclo de vida: assinaturas → votação → janela de desafio → aguardando prontidão → ativado.
• Resolução e Mercados de Disputa — Aposte em resultados de resolução de mercado (sim / não / dados_indisponíveis), abra disputas com evidências vinculadas e aposte na confirmação ou reversão da disputa. O estado de submissão por linha permanece isolado para que ações concorrentes não compartilhem um slot em andamento.
• Submissão de Evidências — Pacotes de evidências vinculados com canonicalização SHA-256 no lado do cliente que corresponde exatamente ao repr() do Python, para que os hashes transitem limpos pela cadeia.
• Suspensão / Desligamento / Recursos de Gate — Formulários de arquivamento para suspender ou desligar um gate, com um fluxo de recurso reutilizável visando automaticamente a petição pendente.
• Bootstrapping de Um-Voto-Por-Nó Elegível — Os primeiros 100 mercados são resolvidos via um-voto-por-nó-elegível em vez de resolução ponderada por aposta. Elegibilidade: idade da identidade ≥ 3 dias, não no conjunto de exclusão de preditor, PoW Argon2id válido (apenas Nó Pesado). Transiciona para resolução com aposta em 1000 nós.
• Estado de Dois Níveis + Finalidade de Época — Eventos do Nível 1 propagam estilo CRDT para baixa latência; eventos do Nível 2 exigem finalidade de época antes de poderem ser executados. Rotação de identidade, penalidades progressivas, marcos de rampa e invariantes constitucionais aplicados via MappingProxyType.
• Polling Adaptativo — Visualizações do Shell Soberano fazem polling a cada 8 segundos durante fases ativas de votação / desafio / ativação, a cada 30–60 segundos quando ocioso. A votação parece ao vivo sem uma camada websocket.
• Diagnósticos Literais — Cada botão de escrita exibe a razão de rejeição literal do backend. Sem notificações opacas de "negado".

Pista de primitivas de privacidade (NOVO na v0.9.7):

• Chaves de Função — Andaime de Credencial Anônima — A infraestrutura está em vigor para nullifiers, desafio-resposta, recibos de commit em duas fases, códigos de negação enumerados e liquidação em lote. O desafio-resposta de hoje é um placeholder baseado em HMAC para testes de integração, não uma prova de cidadania anônima ou de conhecimento zero de produção. A verdadeira emissão não vinculável ainda aguarda uma decisão sobre primitivas (assinaturas cegas RSA vs BBS+ vs U-Prove vs Idemix).
• Contratos de Protocolo Bloqueados — Interfaces estáveis em services/infonet/privacy/contracts.py para assinaturas em anel, endereços stealth, compromissos Pedersen, provas de intervalo e correspondência DEX. O crate Rust privacy-core é o alvo de integração — nenhum chamador do módulo de privacidade precisa saber qual esquema está ativo.
• Caminho Sprint 11+ — Quando o esquema criptográfico for escolhido, as primitivas serão conectadas aos Protocolos bloqueados sem alterações na API.

Testnet Experimental — Sem Garantia de Privacidade: As mensagens do InfoNet são ofuscadas, mas NÃO criptografadas ponta a ponta. A rede Mesh (Meshtastic/APRS) NÃO é privada — as transmissões de rádio são inerentemente públicas. Os contratos de primitivas de privacidade estão esboçados, mas ainda não conectados. Não envie nada sensível em nenhum canal. Trate todos os canais como abertos e públicos por enquanto.

🔍 Toolkit de Reconhecimento e Shodan (derivado do Osiris, segurança em primeiro lugar)

Adaptado da pilha de reconhecimento OSIRIS (MIT) com o modelo de proxy do ShadowBroker. Atribuição: backend/third_party/osiris/NOTICE.md.

Toolkit de Reconhecimento (barra lateral esquerda — apenas operador local):

• IP / DNS / WHOIS — Geolocalização ip-api.com, Google DNS-over-HTTPS, dados de registrante RDAP com pontuação opcional de cabeçalhos de segurança HTTP
• Certificados e BGP — Descoberta de subdomínios crt.sh, consultas ASN/prefixo bgpview.io
• Inteligência de ameaças — Pulsos OTX do AlienVault, verificações de nó de saída Tor, reputação opcional por IP/domínio
• Sanções — Índice OpenSanctions us_ofac_sdn (CC-BY); verificação cruzada em entidades WHOIS e strings ISP/org de IP
• CVE / MAC / GitHub / vazamentos — API MITRE CVE, consulta de fabricante MAC, reconhecimento de perfil GitHub, verificações de violações públicas
• Varredura IP — /api/osint/sweep/scan geolocaliza um alvo /24–/32 e faz proxy da descoberta de host Shodan InternetDB no servidor (navegador nunca entra em contato com o InternetDB diretamente)
• Proteção SSRF — Hostnames privados, loopback, link-local e de metadados são bloqueados antes de qualquer busca fornecida pelo usuário

Grafo de entidades — Selecione qualquer entidade do mapa para abrir o painel Grafo de Entidades (GET /api/entity/expand). Resolve aeronaves, embarcações, empresas, pessoas, IPs e países em um grafo nó/ligação (Wikidata SPARQL + OFAC + armazenamento em memória de voos/navios).

OpenClaw / acesso de agente — Os mesmos backends de reconhecimento estão disponíveis no canal de comando HMAC (sem gate de operador local do navegador): osint_lookup (IP/DNS/WHOIS/certificados/BGP/sanções/CVE/MAC/GitHub/vazamentos/ameaças passivo), entity_expand (grafo de relacionamentos) e osint_sweep (varredura de sub-rede ativa — apenas nível de acesso total). Chame osint_tools para listar os tipos de consulta suportados. Pacote de habilidade: openclaw-skills/shadowbroker/ (SKILL.md + sb_query.py).

Sobreposição Shodan (inalterado):

• Pesquisa de Dispositivos de Internet — Consulte o Shodan com sua própria chave de API; resultados plotados como uma sobreposição ao vivo
• Marcadores Configuráveis — Personalização de forma, cor e tamanho para resultados Shodan

🛩️ Rastreamento de Aviação

• Voos Comerciais — Posições em tempo real via OpenSky Network (~5.000+ aeronaves)
• Aeronaves Particulares — GA leve, turbohélices, jatos executivos rastreados separadamente
• Jatos Particulares — Aeronaves de indivíduos de alto patrimônio líquido com identificação do proprietário
• Voos Militares — Tanqueiros, ISR, caças, transportes via endpoint militar adsb.lol
• Acúmulo de Trilha de Voo — Marcas de navegação persistentes para todas as aeronaves rastreadas
• Detecção de Padrão de Espera — Sinaliza automaticamente aeronaves circulando (>300° de curva total)
• Classificação de Aeronaves — Ícones SVG precisos para a forma: aviões comerciais, turbohélices, jatos executivos, helicópteros
• Detecção de Aeronave no Solo — Aeronaves abaixo de 100ft AGL renderizadas com ícones cinza

🚢 Rastreamento Marítimo

• Fluxo AIS de Embarcações — 25.000+ embarcações via WebSocket aisstream.io (tempo real)
• Classificação de Navios — Carga, petroleiro, passageiros, iate, tipos de embarcações militares com ícones codificados por cores
• Rastreador de Grupo de Ataque de Porta-aviões — Todos os 11 porta-aviões ativos da Marinha dos EUA com posições estimadas por OSINT. Nenhuma outra ferramenta aberta faz isso.
  • Raspagem automatizada de notícias GDELT analisa relatórios de movimento de porta-aviões para estimar posições
  • Mais de 50 mapeamentos de regiões geográficas para coordenadas (ex.: "Mediterrâneo Oriental" → lat/lng)
  • Posições em cache em disco, atualização automática às 00:00 e 12:00 UTC
• Navios de Cruzeiro e Passageiros — Camada dedicada para transatlânticos e balsas
• Atividade Pesqueira — Eventos de embarcações do Global Fishing Watch (NOVO)
• Exibição Agrupada — Navios se agrupam em zoom baixo com rótulos de contagem, desagrupam ao aumentar o zoom

🚆 Rastreamento Ferroviário (NOVO na v0.9.6)

• Trens Amtrak — Posições em tempo real de trens Amtrak nos EUA com velocidade, direção, rota e status
• Ferrovias Europeias — Integração DigiTraffic para posições de trens europeus

🛰️ Espaço e Satélites

• Rastreamento Orbital — Posições de satélites em tempo real via dados TLE do CelesTrak + propagação SGP4 (2.000+ satélites ativos, sem necessidade de chave de API)
• Classificação por Tipo de Missão — Codificado por cores por missão: reconhecimento militar (vermelho), SAR (ciano), SIGINT (branco), navegação (azul), alerta precoce (magenta), imagens comerciais (verde), estação espacial (dourado)
• Estações Terrenas SatNOGS — Rede de estações terrenas amadoras de satélites com dados de observação ao vivo (NOVO)
• Satélites LoRa TinyGS — Rastreamento da constelação de satélites LoRa (NOVO)

🌍 Geopolítica e Conflitos

• Incidentes Globais — Agregação de eventos de conflito alimentada por GDELT (últimas 8 horas, ~1.000 eventos)
• Linha de Frente da Ucrânia — GeoJSON ao vivo da linha de guerra do DeepState Map
• Alertas Aéreos da Ucrânia — Alertas regionais de ataque aéreo em tempo real (NOVO)
• Feed de Notícias SIGINT/RISINT — Agregação RSS em tempo real de várias fontes focadas em inteligência com feeds personalizáveis pelo usuário (até 20 fontes, pesos de prioridade configuráveis 1-5)
• Dossiê Regional — Clique com o botão direito em qualquer lugar da Terra para um briefing de inteligência instantâneo:
  • Perfil do país (população, capital, idiomas, moedas, área)
  • Chefe de estado atual e tipo de governo (consulta Wikidata SPARQL ao vivo)
  • Resumo da Wikipédia local com miniatura
  • Foto de satélite Sentinel-2 mais recente com data de captura e cobertura de nuvens (resolução de 10m)

🛰️ Imagens de Satélite

• NASA GIBS (MODIS Terra) — Sobreposição diária de imagens de satélite em cores reais com controle deslizante de tempo de 30 dias, animação play/pause e controle de opacidade (~250m/pixel)
• Alta Resolução (Esri) — Imagens de resolução submétrica via Esri World Imagery — amplie para ver detalhes de edifícios e terreno (zoom 18+)
• Cartão de Inteligência Sentinel-2 — Clique com o botão direito em qualquer lugar do mapa para um cartão de inteligência flutuante mostrando a foto de satélite Sentinel-2 mais recente com data de captura, % de cobertura de nuvens e imagem clicável em resolução total (resolução de 10m, atualizada a cada ~5 dias)
• API de Processo Sentinel Hub — Imagens de satélite Copernicus CDSE com fluxo de token OAuth2 (NOVO)
• Luzes Noturnas VIIRS — Sobreposição de detecção de mudanças na iluminação noturna (NOVO)
• 5 Modos Visuais — Alterne a estética de todo o mapa através do botão STYLE:
  • DEFAULT — Mapa base CARTO escuro
  • SATELLITE — Esri World Imagery de resolução submétrica
  • FLIR — Estética de imagem térmica (escala de cinza invertida)
  • NVG — Fósforo verde de visão noturna
  • CRT — Sobreposição de linhas de varredura de terminal retrô

🛰️ Detecção de Mudança no Solo por SAR (NOVO)

• Camada de Radar de Abertura Sintética — Detecta mudanças no solo através da cobertura de nuvens, à noite, em qualquer lugar da Terra. Dois modos, ambos gratuitos:
  • Modo A (Catálogo) — Metadados de cena Sentinel-1 gratuitos do Alaska Satellite Facility. Sem necessidade de conta. Mostra quando os passes de radar ocorreram sobre suas Áreas de Interesse e quando o próximo passará.
  • Modo B (Anomalias Completas) — Alertas de mudança no solo em tempo real do NASA OPERA (DISP, DSWx, DIST-ALERT) e Copernicus EGMS. Requer uma conta gratuita NASA Earthdata — o assistente no aplicativo guia você pela configuração em menos de um minuto.
• Tipos de Anomalia — Deformação do solo (subsidência em escala mm, deslizamentos de terra), mudança na água superficial (extensão de inundação), perturbação da vegetação (desmatamento, cicatrizes de queimadura, crateras de explosão), avaliações de danos (UNOSAT/Copernicus EMS verificados) e detecção de mudança de coerência
• Visualização no Mapa — Pinos de anomalia codificados por cores por tipo (laranja para deformação, ciano para água, verde para vegetação, vermelho para dano, roxo para coerência). Limites das Áreas de Interesse desenhados como polígonos tracejados com cores baseadas na categoria. Clique em qualquer pino para um popup de detalhes com magnitude, confiança, solver, contagem de cenas e link de proveniência.
• Editor de Áreas de Interesse — Defina áreas de interesse diretamente do mapa. Clique no botão "EDITAR AOIs" quando a camada SAR estiver ativa, em seguida use a ferramenta de mira para clicar e soltar um centro de AOI no mapa. Defina nome, raio (1–500 km) e categoria. As AOIs aparecem no mapa imediatamente.
• Integração OpenClaw — O agente de IA pode inspecionar detalhes de anomalias SAR (sar_pin_click) e mover o mapa do operador para qualquer centro de AOI (sar_focus_aoi) — permitindo fluxos de trabalho analíticos colaborativos.
• Painel de Configurações — Aba SAR dedicada nas Configurações mostra o status do Modo A/B, estado de integração OpenClaw e permite revogar credenciais Earthdata com um clique.

📻 Rádio Definido por Software e SIGINT

• Receptores KiwiSDR — Mais de 500 receptores SDR públicos plotados mundialmente com marcadores âmbar agrupados
• Sintonizador de Rádio ao Vivo — Clique em qualquer nó KiwiSDR para abrir um sintonizador SDR embutido diretamente no painel SIGINT
• Exibição de Metadados — Nome do nó, localização, tipo de antena, bandas de frequência, usuários ativos
• Rádio Mesh Meshtastic — Integração de rádio mesh baseada em MQTT com mapa de nós, integrado ao Mesh Chat (NOVO)
• Integração APRS — Posicionamento de rádio amador via feed TCP APRS-IS (NOVO)
• Detecção de Interferência GPS — Análise em tempo real dos valores NAC-P (Categoria de Precisão de Navegação) de aeronaves
  • Agregação baseada em grade identifica zonas de interferência
  • Quadrados de sobreposição vermelhos com rótulos de gravidade "GPS JAM XX%"
• Painel de Interceptação de Rádio — Interface estilo scanner com feeds de rádio policial/bombeiros OpenMHZ. Clique em qualquer sistema para ouvir ao vivo. O modo Scan percorre os feeds ativos automaticamente. Escuta por clique em comunicações reais de emergência.

📷 Vigilância

• Malha CCTV — Mais de 22.000 câmeras de trânsito ao vivo de 21 injetores em 10 países (EUA, Reino Unido, Canadá, Austrália, Áustria, Espanha, Singapura, Países Baixos quando o feed NDW está ativo, mais OSM):
  • 🇬🇧 London JamCams (Transport for London)
  • 🇺🇸 NYC DOT, Austin TX (TxDOT)
  • 🇺🇸 Califórnia (12 distritos Caltrans), Washington State (WSDOT), Georgia DOT, Illinois DOT, Michigan DOT
  • 🇪🇸 Espanha DGT Nacional (20 cidades), Madrid City (357 câmeras via KML)
  • 🇦🇹 Áustria ASFINAG webcams rodoviárias
  • 🇸🇬 Singapura LTA
  • 🌍 Windy Webcams
• Renderização de Feed — Detecção e renderização automática de feeds de vídeo, MJPEG, HLS, incorporados, tiles de satélite e imagem
• Exibição Agrupada no Mapa — Pontos verdes agrupados com rótulos de contagem, desagrupam ao aumentar o zoom

🔥 Monitoramento Ambiental e de Perigos

• NASA FIRMS Hotspots de Incêndio (24h) — Mais de 5.000 anomalias térmicas globais do satélite NOAA-20 VIIRS, atualizadas a cada ciclo. Ícones em forma de chama codificados por cores pela Potência Radiativa do Fogo (FRP): amarelo (baixo), laranja, vermelho, vermelho escuro (intenso). Agrupados em zoom baixo com marcadores de grupo em forma de fogo.
• Vulcões — Vulcões do Holoceno do Smithsonian Global Volcanism Program plotados mundialmente (NOVO)
• Alertas Meteorológicos — Polígonos de clima severo com indicadores de urgência/gravidade (NOVO)
• Qualidade do Ar (PM2.5) — Estações OpenAQ mundialmente com leituras em tempo real de material particulado (NOVO)
• Terremotos (24h) — Feed em tempo real de terremotos USGS com marcadores dimensionados por magnitude
• Distintivo de Clima Espacial — Indicador de tempestade geomagnética NOAA ao vivo na barra de status inferior. Índice Kp codificado por cores: verde (silencioso), amarelo (ativo), vermelho (tempestade G1–G5). Dados do feed de índice K planetário de 1 minuto do SWPC.

🏗️ Monitoramento de Infraestrutura* Monitoramento de Interrupções de Internet — Alertas regionais de conectividade da Internet do Georgia Tech IODA. Marcadores cinzas nas regiões afetadas com percentual de gravidade. Usa apenas fontes de dados confiáveis (tabelas de roteamento BGP, sondagem de ping ativa) — sem telescópio ou dados interpolados.

• Mapeamento de Data Centers — Mais de 2.000 data centers globais plotados a partir de um conjunto de dados curado. Marcadores roxos agrupados com ícones de rack de servidor. Clique para operador, localização e referência cruzada automática de interrupções de internet por país.
• Bases Militares — Banco de dados global de instalações militares e instalações de mísseis (NOVO)
• Usinas Elétricas — Mais de 35.000 usinas globais do banco de dados WRI (NOVO)
• Cabos Submarinos — Rotas globais de cabos submarinos a partir de GeoJSON estático derivado da TeleGeography (frontend/public/data/submarine-cables.json). Sobreposição de linha opcional.
• Camada de C2 de Malware — Servidores C2 de botnets (Feodo Tracker) e URLs recentes de malware (URLhaus) do abuse.ch, atualizados no nível lento quando a camada está ativada.
• Risco de Fornecedor SCM — Fabs de nível 1/2 e usinas de baterias (TSMC, Samsung, CATL, etc.) com referência cruzada contra terremotos, incêndios FIRMS e proximidade de conflitos GDELT. Alertas no painel SCM; camada de mapa opcional.
• Feed de Ameaças Cibernéticas — Entradas recentes de Vulnerabilidades Exploradas Conhecidas (KEV) da CISA expostas via /api/cyber-threats e o alternador de camada.
• Índice de Risco de País — Pontuações de risco geopolítico estáticas com enriquecimento de terremotos do USGS via /api/country-risk.
• OSINT do Telegram — Visualizações de canais públicos (t.me/s/*) de feeds configuráveis de guerra/OSINT. Mesclagem incremental horária (sem re-raspagem redundante), pontuação de risco por palavra-chave, aliases de lugares em cirílico/árabe, geocodificação metro-âncora (separada dos centroides de notícias), foto/vídeo inline via proxy /api/telegram/media. Chave da camada: telegram_osint.

🌐 Camadas e Ferramentas Adicionais

• Ciclo Dia/Noite — Sobreposição do terminador solar mostrando luz/escuridão global
• Ticker de Mercados Globais — Índices de mercado financeiro ao vivo (minimizável)
• Ferramenta de Medição — Medição de distância e rumo ponto a ponto no mapa
• Barra LOCATE — Pesquise por coordenadas (31.8, 34.8) ou nome de lugar (Teerã, Estreito de Ormuz) para voar diretamente para qualquer local — geocodificado via OpenStreetMap Nominatim

Gaza

🤖 Canal de Comando de IA Agêntica — OpenClaw + Agentes Compatíveis (expandido na v0.9.7)

O ShadowBroker expõe um canal de comando de IA agêntica bidirecional — uma ponte assinada e com acesso por níveis que dá a qualquer agente de IA compatível acesso total de leitura/escrita à plataforma de inteligência. O OpenClaw é o agente de referência, mas o canal é um protocolo aberto: qualquer agente baseado em LLM que assine solicitações com HMAC-SHA256 (Claude Code, GPT, LangChain, clientes Python/TypeScript personalizados ou sua própria integração) pode conectar-se como um analista que vê os mesmos dados que o operador e pode tomar ações no mapa. O ShadowBroker não inclui um LLM, um runtime de agente ou pesos de modelo — ele fornece a superfície; você traz o agente.

A v0.9.7 transforma o ShadowBroker de um painel que um humano observa para uma superfície de inteligência na qual qualquer agente pode atuar.

Transporte do canal (NOVO na v0.9.7):

• Canal de Comando Único — POST /api/ai/channel/command aceita {cmd, args} e despacha para qualquer ferramenta registrada.
• Execução Concorrente em Lote — POST /api/ai/channel/batch aceita até 20 comandos em uma solicitação. O backend os executa concorrentemente e retorna um mapa de resultados. Reduz a latência do agente em uma ordem de grandeza em comparação com chamadas sequenciais.
• Acesso por Nível — OPENCLAW_ACCESS_TIER controla quais comandos o agente pode chamar: restricted expõe o conjunto somente leitura, full adiciona gravações e injeção. O endpoint de descoberta retorna available_commands para que o agente possa inspecionar suas próprias capacidades.
• Assinatura HMAC-SHA256 — Cada comando é assinado com HMAC-SHA256(secret, METHOD|path|timestamp|nonce|sha256(body)) com proteção contra repetição de timestamp + nonce e integridade da solicitação. Suporta modo local (sem configuração) e modo remoto (agente em uma máquina diferente / VPS).

Capacidades:

• Acesso Total à Telemetria — O agente consulta todas as 40+ camadas de dados: voos, navios, satélites, SIGINT, eventos de conflito, terremotos, incêndios, águas residuais, OSINT do Telegram, malware/C2, ameaças cibernéticas CISA KEV, sobreposições SCM, atividade pesqueira (GFW), mercados de previsão e mais. Endpoints de nível rápido e lento retornam dados enriquecidos com coordenadas geográficas, carimbos de data/hora e atribuição de fonte.
• Pesquisa Compacta (preferida em vez de despejos completos) — get_summary → get_layer_slice com since_layer_versions por camada (o push SSE layer_changed informa ao agente exatamente quais camadas foram atualizadas). search_telemetry é o índice de palavras-chave entre camadas no estilo Google. search_news cobre notícias, GDELT, CrowdThreat, LiveUAMap, linhas de frente e postagens do Telegram. entities_near, brief_area, find_flights/find_ships/find_entity e correlate_entity respondem a perguntas direcionadas sem puxar megabytes.
• Kit de Reconhecimento no Canal — osint_lookup executa os mesmos backends protegidos por SSRF que o painel Recon (ip, dns, whois, certs, bgp, sanctions, cve, mac, github, leaks, threats, sweep_init). entity_expand constrói gráficos de relacionamento Wikidata + OFAC. osint_sweep executa descoberta de sub-rede Shodan InternetDB (nível full). Aliases de camada: telegram, malware/botnet, cyber/cisa/kev, scm/suppliers, gfw/fishing.
• Pinos de Inteligência de IA — Coloque marcadores de investigação codificados por cores diretamente no mapa do operador. 14 categorias de pinos (ameaça, anomalia, militar, marítimo, aviação, SIGINT, infraestrutura, etc.) com pontuações de confiança, expiração de TTL, URLs de origem e colocação em lote de até 100 pinos de uma vez.
• Controle do Mapa — Mova a vista do mapa do operador para qualquer coordenada, acione consultas de imagens de satélite e abra dossiês de região. O agente pode direcionar a atenção do operador para locais específicos em tempo real.
• SAR Ground-Change — Consulte feeds de anomalias SAR, inspecione detalhes de pinos, gerencie AOIs e mova o mapa para vigiar áreas. O agente pode monitorar deformação do solo, extensão de inundação ou danos e promover anomalias para pinos.
• Injeção de Camada Nativa — Envie dados personalizados diretamente para as camadas nativas do ShadowBroker (câmeras CCTV, navios, nós SIGINT, bases militares, etc.) para que fontes descobertas pelo agente sejam renderizadas junto com feeds reais.
• Participação na Mesh Wormhole — O agente pode entrar na InfoNet descentralizada, postar mensagens assinadas, entrar em canais de gateway criptografados, enviar/receber DMs criptografados e interagir com rádio Meshtastic e Dead Drops — operando como um peer completo da malha.
• Participação no Sovereign Shell (v0.9.7) — Arquivar petições, assinar e votar em mudanças de governança, apostar em resoluções e disputas, sinalizar prontidão de Heavy-Node para atualizações — tudo programaticamente, tudo controlado por nível e HMAC. Os agentes tornam-se participantes de primeira classe na economia de inteligência descentralizada.
• Geocodificação & Varreduras de Proximidade — Resolver nomes de lugares para coordenadas e depois escanear todas as camadas dentro de um raio para um resumo completo de proximidade.
• Notícias e GDELT Próximo ao Local — Puxar eventos de conflito GDELT e artigos de notícias agregados perto de qualquer coordenada para consciência situacional regional.
• Entrega de Alertas — Enviar briefings de inteligência, avisos e notificações de ameaça para webhooks do Discord e canais do Telegram.
• Relatórios de Inteligência — Gerar relatórios estruturados com estatísticas resumidas, principais voos militares, correlações, atividade sísmica, contagens SIGINT e inventários de pinos.
• Auditável — Cada chamada de canal é registrada; o operador pode inspecionar o que o agente fez.

Conecte um agente: Abra o painel AI Intel na barra lateral esquerda, clique em Connect Agent e copie o segredo HMAC. A partir daí, aponte qualquer agente compatível para o canal — para o OpenClaw, importe ShadowBrokerClient de openclaw-skills/shadowbroker/sb_query.py (veja SKILL.md para exemplos); para qualquer outro agente, use o mesmo contrato HMAC documentado acima (timestamp + nonce + body digest, acesso por nível). Descoberta: GET /api/ai/tools e GET /api/ai/capabilities. O canal é o protocolo, não o agente.

Docker Compose + agentes remotos: A interface do painel se comunica com o backend pela ponte privada do Docker (confiado automaticamente). Um agente OpenClaw rodando no host (fora do contêiner) acessa http://localhost:8000 a partir do IP do gateway Docker — HMAC é necessário lá. Em AI Intel → Connect Agent, clique em Bootstrap depois Reveal, copie SHADOWBROKER_HMAC_SECRET para o env do seu agente e reinicie o backend uma vez para que data/openclaw.env no volume backend_data seja carregado. Teste com:

curl -s -H "Authorization: Bearer $SHADOWBROKER_HMAC_SECRET" \
  http://localhost:8000/api/ai/tools | jq .

— Certifique-se de que o agente pode GET /api/ai/tools antes de esperar que funcione.```bash export SHADOWBROKER_URL=http://127.0.0.1:8000 export SHADOWBROKER_HMAC_SECRET= python openclaw-skills/shadowbroker/verify_hmac.py

Use a porta do backend (`:8000`), não a porta do dashboard Next.js (`:3000`). Signers feitos à mão devem fazer hash dos bytes exatos do POST: `json.dumps(payload, separators=(",", ":"), sort_keys=True)`.

### ⏱️ Time Machine — Reprodução de Snapshots (NOVO na v0.9.7)

Um transporte no estilo de mídia para todo o feed de telemetria. Trate o mapa ao vivo como uma gravação que pode ser avançada, pausada e reproduzida.

* **Alternância Ao Vivo ↔ Snapshot** — Mudar para o modo snapshot pausa o loop de polling global instantaneamente; voltar para Ao Vivo invalida ETags e força a atualização tanto das camadas rápidas quanto lentas, para que o dashboard se atualize sem oscilação de quadros obsoletos.
* **Índice Horário** — Cada snapshot capturado é indexado por seu bucket de hora com `count`, `latest_id`, `latest_ts` e a lista completa `snapshot_ids`. Pule para qualquer timestamp capturado diretamente do seletor de linha do tempo.
* **Interpolação de Quadros** — Entidades em movimento (aeronaves, navios, satélites, voos militares) interpolam suavemente entre os quadros gravados durante a reprodução, de modo que o movimento permaneça contínuo mesmo quando os snapshots são esparsos.
* **Velocidade de Reprodução Variável** — Avance, reproduza, acelere e retroceda pela telemetria salva em velocidade ajustável.
* **Ciente do Perfil** — Cada snapshot registra o perfil de privacidade que estava ativo quando foi capturado, de modo que a reprodução seja fiel ao que um operador naquele perfil teria visto.
* **Lado do Operador, Não do Servidor** — Os snapshots são armazenados localmente no backend; nenhum terceiro vê a linha do tempo da reprodução.

### 📦 Painel de Chaves de API — Primeiro o Caminho, Somente Leitura (NOVO na v0.9.7)

Configurações → Chaves de API agora é um registro somente leitura. Os valores das chaves nunca chegam ao processo do navegador — nem mesmo um prefixo ofuscado. O painel exibe:

* O caminho absoluto para o arquivo `.env` do backend conforme resolvido por `Path(__file__).resolve()` — funciona em todos os sistemas operacionais, unidades, locais de instalação (Linux `/home/...`, macOS `/Users/...`, Windows em qualquer unidade, contêineres Docker, VMs na nuvem).
* Indicadores `[existe]` / `[será criado no primeiro salvamento]` / `[NÃO GRAVÁVEL — edite manualmente]` no próprio caminho.
* O caminho para o template `.env.example` para que os usuários possam copiá-lo e preencher suas chaves.
* Um badge binário `CONFIGURED` / `NOT CONFIGURED` por chave, mais uma linha env copiável (ex.: `OPENSKY_CLIENT_ID=YOUR_VALUE`) que o usuário pode inserir no arquivo manualmente.

As credenciais da API OpenSky agora são um requisito de ambiente **critical-warn**: a verificação de ambiente na inicialização sinaliza credenciais OAuth2 do OpenSky ausentes com um aviso forte, e o modal de changelog linka diretamente para a página de registro gratuito. Sem elas, a camada de voos recai para cobertura apenas ADS-B com lacunas significativas na África, Ásia e América Latina.

</details>

---

<details>
<summary>🏗️ Arquitetura</summary>

ShadowBroker v0.9.7 é composto por três planos empilhados verticalmente — a **Operator UI**, o **Backend Service Plane** e a **Decentralized Layer (InfoNet)** — mais duas pontes transversais (a **Time Machine** e o **Agentic AI Channel**, que é o protocolo pelo qual o OpenClaw e qualquer outro agente compatível se conecta) e um crate Rust do **Privacy Core** que sustenta tanto a mesh legada quanto o futuro trabalho de moeda blindada / DEX.```
╔═════════════════════════════════════════════════════════════════════════════╗
║                       OPERATOR UI  (Next.js + MapLibre)                     ║
║                                                                             ║
║  ┌────────────────┐  ┌──────────┐  ┌────────────────┐  ┌────────────────┐   ║
║  │ MapLibre GL    │  │ NewsFeed │  │ Sovereign Shell│  │   Mesh Chat    │   ║
║  │  WebGL render  │  │  SIGINT  │  │  Petitions /   │  │  + Mesh Term.  │   ║
║  │  + clusters    │  │  GDELT   │  │  Upgrades /    │  │  (Infonet /    │   ║
║  │                │  │  Threat  │  │  Disputes /    │  │   Mesh /       │   ║
║  │                │  │          │  │  Gates /       │  │   Dead Drop)   │   ║
║  │                │  │          │  │  Bootstrap /   │  │                │   ║
║  │                │  │          │  │  Function Keys │  │                │   ║
║  └──────┬─────────┘  └────┬─────┘  └────────┬───────┘  └────────┬───────┘   ║
║         │                 │                 │                   │           ║
║  ┌──────┴─────────────────┴─────────────────┴───────────────────┴───────┐   ║
║  │  Time Machine ◀── snapshot playback ── snapshotMode toggle ──▶ Live │   ║
║  │  hourly index │ frame interpolation │ profile-aware │ per-tier ETag  │   ║
║  └──────────────────────────────────┬───────────────────────────────────┘   ║
║                                     │ REST  +  /api/[...path] proxy         ║
╠═════════════════════════════════════╪═══════════════════════════════════════╣
║                       BACKEND SERVICE PLANE  (FastAPI)                      ║
║                                     │                                       ║
║  ┌──────────────────────────────────┴────────────────────────────────────┐  ║
║  │              Data Fetcher  (APScheduler — fast / slow tiers)          │  ║
║  │                                                                       │  ║
║  │  ┌───────────┬───────────┬───────────┬───────────┬───────────┐        │  ║
║  │  │  OpenSky* │ adsb.lol  │ CelesTrak │   USGS    │   AIS WS  │        │  ║
║  │  │  Flights  │ Military  │   Sats    │  Quakes   │   Ships   │        │  ║
║  │  ├───────────┼───────────┼───────────┼───────────┼───────────┤        │  ║
║  │  │  Carrier  │   GDELT   │ CCTV (12) │ DeepState │   NASA    │        │  ║
║  │  │  Tracker  │ Conflict  │  Cameras  │ Frontline │   FIRMS   │        │  ║
║  │  ├───────────┼───────────┼───────────┼───────────┼───────────┤        │  ║
║  │  │   GPS     │  KiwiSDR  │  Shodan   │  Amtrak   │  SatNOGS  │        │  ║
║  │  │  Jamming  │   Radios  │  Devices  │ DigiTraf  │  TinyGS   │        │  ║
║  │  ├───────────┼───────────┼───────────┼───────────┼───────────┤        │  ║
║  │  │ Volcanoes │  Weather  │  Fishing  │ Mil Bases │   IODA    │        │  ║
║  │  │  Air Qual │  Alerts   │  Activity │ PwrPlants │  Outages  │        │  ║
║  │  ├───────────┼───────────┼───────────┼───────────┼───────────┤        │  ║
║  │  │ Sentinel  │   MODIS   │   VIIRS   │   Data    │ Meshtastic│        │  ║
║  │  │  Hub/STAC │   Terra   │ Nightlts  │  Centers  │   APRS    │        │  ║
║  │  ├───────────┴───────────┴───────────┴───────────┴───────────┤        │  ║
║  │  │  SAR (NEW v0.9.7)                                         │        │  ║
║  │  │   Mode A: ASF Search catalog (free, no account)           │        │  ║
║  │  │   Mode B: NASA OPERA / Copernicus EGMS / GFM / EMS /      │        │  ║
║  │  │           UNOSAT  ground-change anomalies (opt-in)        │        │  ║
║  │  └───────────────────────────────────────────────────────────┘        │  ║
║  │   * OpenSky: REQUIRED for global flight coverage                      │  ║
║  └───────────────────────────────────────────────────────────────────────┘  ║
║                                     │                                       ║
║  ┌──────────────────────────────────┴────────────────────────────────────┐  ║
║  │                   Snapshot Store  (Time Machine source)               │  ║
║  │   Hourly index  │  per-snapshot layer manifest  │  profile metadata   │  ║
║  └───────────────────────────────────────────────────────────────────────┘  ║
║                                                                             ║
║  ┌───────────────────────────────────────────────────────────────────────┐  ║
║  │   Agentic AI Channel  (HMAC-SHA256, tier-gated  —  OpenClaw + others) │  ║
║  │                                                                       │  ║
║  │   POST /api/ai/channel/command   →  one tool call                     │  ║
║  │   POST /api/ai/channel/batch     →  up to 20 concurrent tool calls    │  ║
║  │                                                                       │  ║
║  │   Tier:   restricted (read-only)   │   full (read + write + inject)   │  ║
║  │   Auth:   X-SB-Timestamp + X-SB-Nonce + X-SB-Signature                │  ║
║  │   Sig  =  HMAC-SHA256(secret, METHOD|path|ts|nonce|sha256(body))      │  ║
║  └───────────────────────────────────────────────────────────────────────┘  ║
╠═════════════════════════════════════════════════════════════════════════════╣
║                  DECENTRALIZED LAYER  (InfoNet Testnet — signed events)     ║
║                                                                             ║
║  ┌────────────────────────────┐    ┌──────────────────────────────────┐     ║
║  │    Mesh Hashchain          │    │   Sovereign Shell Governance     │     ║
║  │                            │    │                                  │     ║
║  │  Ed25519 signed events     │    │  Petitions  (DSL: UPDATE_PARAM,  │     ║
║  │  Public-key binding        │    │              ENABLE_FEATURE …)   │     ║
║  │  Replay / sequence guard   │    │  Upgrade-Hash voting (80% / 40%  │     ║
║  │  Two-tier finality         │    │             quorum / 67% Heavy)  │     ║
║  │   ├ Tier 1 (CRDT, fast)    │    │  Resolution & Dispute markets    │     ║
║  │   └ Tier 2 (epoch finality)│    │  Gate suspend / shutdown / appeal│     ║
║  │  Identity rotation         │    │  Bootstrap eligible-node-1-vote  │     ║
║  │  Constitutional invariants │    │   (Argon2id PoW, Heavy-Node only)│     ║
║  │  (MappingProxyType)        │    │  Function Keys (5 of 6 pieces)   │     ║
║  └─────────────┬──────────────┘    └─────────────┬────────────────────┘     ║
║                │                                 │                          ║
║                └──────────────┬──────────────────┘                          ║
║                               │                                             ║
║  ┌────────────────────────────┴──────────────────────────────────────┐      ║
║  │            Wormhole / InfoNet Relay  (transport layer)            │      ║
║  │   Gate personas │ canonical signing │ Dead Drop epoch mailboxes   │      ║
║  └───────────────────────────────────────────────────────────────────┘      ║
╠═════════════════════════════════════════════════════════════════════════════╣
║              PRIVACY CORE  (Rust crate — locked Protocol contracts)         ║
║                                                                             ║
║   privacy-core/  ─►  Argon2id │ Ed25519/X25519 │ AESGCM │ HKDF              ║
║                      Ring sigs* │ Stealth addrs* │ Pedersen* │ Bulletproofs*║
║                      Blind-sig issuance* (RSA / BBS+ / U-Prove / Idemix)    ║
║                                                                             ║
║   * = locked Protocol contract; cryptographic primitive lands Sprint 11+    ║
╚═════════════════════════════════════════════════════════════════════════════╝

   Distribution
   ────────────
     GitHub (primary):  ghcr.io/bigbodycobain/shadowbroker-{backend,frontend}
     GitLab (mirror):   registry.gitlab.com/bigbodycobain/shadowbroker/{backend,frontend}
     Multi-arch:        linux/amd64  +  linux/arm64  (Raspberry Pi 5 supported)
     Desktop:           Tauri shell  →  packaged backend-runtime  +  Next.js frontend

Privacidade e auditoria de saída (#348–#366): Cada instalação auto-hospedada usa seu próprio IP de backend e identificador User-Agent por instalação. Consulte docs/OUTBOUND_DATA.md para saber o que contata terceiros, controles de adesão/env e compensações aceitas (CCTV Referer, CDN de basemap, LiveUAMap, etc.).

🐳 Configuração Docker (Recomendado para Auto-Hospedagem)

O repositório inclui um docker-compose.yml que baixa imagens pré-construídas do GitHub Container Registry.```bash git clone https://github.com/BigBodyCobain/Shadowbroker.git cd Shadowbroker

Add your API keys in a repo-root .env file (optional — see Environment Variables below)

docker compose pull docker compose up -d

Abra `http://localhost:3000` para ver o painel.

> **Implantando publicamente ou em uma LAN?** Nenhuma configuração necessária para a maioria das configurações.
> O frontend faz proxy de todas as chamadas de API através do servidor Next.js para `BACKEND_URL`,
> que por padrão é `http://backend:8000` (rede interna do Docker).
> A porta `8000` do host é publicada apenas para acesso local de API/depuração (`127.0.0.1:8000`
> em `docker-compose.yml`). Se entrar em conflito com outro serviço, defina
> `BACKEND_PORT=8001` no `.env`; deixe `BACKEND_URL` como `http://backend:8000`
> porque essa é a porta interna do Docker.
>
> **Executando o backend fora do Docker** (`cd backend && python main.py`):
> o servidor de desenvolvimento vincula **apenas loopback** (`127.0.0.1:8000`) para que outras máquinas na
> sua LAN não possam acessar rotas de admin/confiança local com um `ADMIN_KEY` vazio. Defina
> `SHADOWBROKER_DEV_BIND_ALL=true` no `.env` apenas quando você deliberadamente precisar
> de `0.0.0.0` e use uma `ADMIN_KEY` forte para qualquer chamador não local.
> O limite de memória do backend é controlado por `BACKEND_MEMORY_LIMIT` e o padrão é
> `4G`. Se o Docker relatar eventos OOM, o backend será reiniciado e as
> camadas lentas podem parecer vazias até que sejam repovoadas.
>
> Se o seu backend estiver em um **host ou porta diferente**, defina `BACKEND_URL` em tempo de execução — nenhuma reconstrução necessária:
>
> ```bash
> # Linux / macOS
> BACKEND_URL=http://myserver.com:9096 docker compose up -d
>
> # Podman (via compose.sh wrapper)
> BACKEND_URL=http://192.168.1.50:9096 ./compose.sh up -d
>
> # Windows (PowerShell)
> $env:BACKEND_URL="http://myserver.com:9096"; docker compose up -d
>
> # Or add to a .env file next to docker-compose.yml:
> # BACKEND_URL=http://myserver.com:9096
> ```

**Usuários do Podman:** Não passe a URL do GitHub para `podman compose pull`; clone o repositório primeiro, `cd Shadowbroker`, depois execute o compose a partir dessa pasta. `podman compose` também requer um provedor de Compose. Se o Podman relatar `looking up compose provider failed`, instale um:```bash
# Linux / macOS / WSL
python3 -m pip install --user podman-compose
podman-compose pull
podman-compose up -d

Please provide the Markdown content to translate.```powershell

Windows PowerShell

py -m pip install --user podman-compose podman-compose pull podman-compose up -d

Se você estiver em um shell compatível com bash, o wrapper incluído pode detectar automaticamente o Docker ou o Podman:```bash
./compose.sh --engine podman pull
./compose.sh --engine podman up -d

Não é necessário clonar o repositório. Use as imagens pré-construídas do GitHub Container Registry. As imagens do registro GitLab podem ser usadas como espelho se você as publicar lá.

Crie um docker-compose.yml com o seguinte conteúdo e implante-o diretamente — cole no editor de stacks do Portainer, uncloud deploy ou qualquer host Docker:```yaml

Image registry — uncomment ONE line per service:

GitHub (primary): ghcr.io/bigbodycobain/shadowbroker-backend:latest

GitLab (mirror): registry.gitlab.com/bigbodycobain/shadowbroker/backend:latest

services: backend: image: ghcr.io/bigbodycobain/shadowbroker-backend:latest # image: registry.gitlab.com/bigbodycobain/shadowbroker/backend:latest container_name: shadowbroker-backend ports: - "${BACKEND_PORT:-8000}:8000" environment: - AIS_API_KEY=your_aisstream_key # Required — get one free at aisstream.io - OPENSKY_CLIENT_ID= # Optional — higher flight data rate limits - OPENSKY_CLIENT_SECRET= # Optional — paired with Client ID above - LTA_ACCOUNT_KEY= # Optional — Singapore CCTV cameras - SHODAN_API_KEY= # Optional — Shodan device search overlay - SH_CLIENT_ID= # Optional — Sentinel Hub satellite imagery - SH_CLIENT_SECRET= # Optional — paired with Sentinel Hub ID - CORS_ORIGINS= # Optional — comma-separated allowed origins volumes: - backend_data:/app/data restart: unless-stopped

frontend: image: ghcr.io/bigbodycobain/shadowbroker-frontend:latest # image: registry.gitlab.com/bigbodycobain/shadowbroker/frontend:latest container_name: shadowbroker-frontend ports: - "3000:3000" environment: - BACKEND_URL=http://backend:8000 # Docker internal networking — no rebuild needed depends_on: - backend restart: unless-stopped

volumes: backend_data:

> **Como funciona:** O contêiner frontend faz proxy de todas as requisições `/api/*` através do servidor Next.js para `BACKEND_URL` usando a rede interna do Docker. O navegador se comunica apenas com a porta 3000. A porta host do backend é para acesso local de API/depuração e pode ser alterada com `BACKEND_PORT=8001` sem alterar `BACKEND_URL`.
>
> `BACKEND_URL` é uma variável de ambiente de tempo de execução comum (não é uma `NEXT_PUBLIC_*` de tempo de compilação), então você pode alterá-la no Portainer, Uncloud ou qualquer editor de compose sem reconstruir a imagem. Defina-a para o endereço onde seu backend está acessível de dentro da rede Docker (ex.: `http://backend:8000`, `http://192.168.1.50:8000`).

</details>

---

<details>
<summary>📦 Início Rápido (Sem Necessidade de Código)</summary>

Se você só quer executar o dashboard sem lidar com comandos de terminal:

1. Vá até a guia **[Releases](https://raw.githubusercontent.com/bigbodycobain/releases)** no lado direito da página deste repositório.
2. Baixe o arquivo `.zip` mais recente da release.
3. Extraia a pasta para o seu computador.
4. **Windows:** Clique duas vezes em `start.bat`.
   **Mac/Linux:** Abra o terminal, digite `chmod +x start.sh`, `dos2unix start.sh` e execute `./start.sh`.
5. Ele instalará tudo automaticamente e iniciará o dashboard!

Notas sobre o laçador local:

- `start.bat` / `start.sh` executam o aplicativo sem Docker — eles instalam dependências e iniciam ambos os servidores diretamente.
- Se os endpoints de identidade do Wormhole ou de contato DM falharem após uma atualização, verifique a pasta `docs/mesh/` para solução de problemas.
- Para implantação de testemunha raiz DM, transparência e monitoramento de operador, comece com `docs/mesh/wormhole-dm-root-operations-runbook.md`.
- Para exemplos de ativos de ponte de operações raiz DM, veja também `scripts/mesh/poll-dm-root-health-alerts.mjs`, `scripts/mesh/export-dm-root-health-prometheus.mjs`, `scripts/mesh/publish-external-root-witness-package.mjs`, `scripts/mesh/smoke-external-root-witness-flow.mjs`, `scripts/mesh/smoke-root-transparency-publication-flow.mjs`, `scripts/mesh/smoke-dm-root-deployment-flow.mjs`, `scripts/mesh/sync-dm-root-external-assurance.mjs` e `docs/mesh/examples/`.

</details>

---

<details>
<summary>💻 Configuração do Desenvolvedor</summary>

Se você quiser modificar o código ou executar a partir da fonte:

#### Pré-requisitos

* **Node.js** 18+ e **npm** — [nodejs.org](https://nodejs.org/)
* **Python** 3.10, 3.11 ou 3.12 com `pip` — [python.org](https://www.python.org/downloads/) (**marque "Add to PATH"** durante a instalação)
  * ⚠️ Python 3.13+ pode ter problemas de compatibilidade com algumas dependências. **Recomenda-se 3.11 ou 3.12.**
* Chaves de API para: `aisstream.io` (obrigatório) e opcionalmente `opensky-network.org` (OAuth2), `lta.gov.sg`

### Instalação

</details>```bash
# Clone the repository
git clone https://github.com/BigBodyCobain/Shadowbroker.git
cd Shadowbroker

# Backend setup
cd backend
python -m venv venv
venv\Scripts\activate        # Windows
# source venv/bin/activate   # macOS/Linux
pip install .

# Optional helper scripts (creates venv + installs dev deps)
# Windows PowerShell
# .\backend\scripts\setup-venv.ps1
# macOS/Linux
# ./backend/scripts/setup-venv.sh

# Optional env check (prints warnings for missing keys)
# Windows PowerShell
# .\backend\scripts\check-env.ps1
# macOS/Linux
# ./backend/scripts/check-env.sh

# Create .env with your API keys
echo "AIS_API_KEY=your_aisstream_key" >> .env
echo "OPENSKY_CLIENT_ID=your_opensky_client_id" >> .env
echo "OPENSKY_CLIENT_SECRET=your_opensky_secret" >> .env

# Frontend setup
cd ../frontend
npm ci

Executando```bash

From the frontend directory — starts both frontend & backend concurrently

npm run dev

* **Next.js** frontend em `http://localhost:3000`
* **FastAPI** backend em `http://localhost:8000`

### Pre-commit (Opcional)

Se você usa pre-commit, instale os hooks uma vez a partir da raiz do repositório:```bash
pre-commit install

Receptor AIS Local (Opcional)

Você pode alimentar seus próprios dados de navios AIS no ShadowBroker usando um dongle RTL-SDR e o AIS-catcher, um decodificador AIS de código aberto. Isso fornece cobertura em tempo real de embarcações na sua área local — sem necessidade de chave de API.

1. Conecte um dongle RTL-SDR
2. Instale o AIS-catcher (releases) ou use a imagem Docker: ```bash docker run -d --device /dev/bus/usb
   ghcr.io/jvde-github/ais-catcher -H http://host.docker.internal:4000/api/ais/feed interval 10
   root@kitploit:~

3. Ou execute nativamente: ```bash AIS-catcher -H http://localhost:4000/api/ais/feed interval 10
   root@kitploit:~

AIS-catcher decodifica sinais de rádio VHF em 161.975 MHz e 162.025 MHz e envia via POST os dados decodificados das embarcações para o ShadowBroker a cada 10 segundos. Navios detectados pela sua antena SDR aparecem junto com o fluxo global de AIS.

Docker (ARM/Raspberry Pi): Veja docker-shipfeeder para uma imagem Docker pronta para produção otimizada para ARM.

Nota: O alcance do AIS depende da sua antena — normalmente 20-40 milhas náuticas com uma configuração básica, 60+ nm com uma antena VHF marítima em elevação.

Todas as 41 camadas podem ser ativadas/desativadas independentemente pelo painel esquerdo:

Ferramentas de reconhecimento e entidade (não são camadas do mapa — painel esquerdo / seleção):

† osint_sweep (varredura ativa do InternetDB) requer OPENCLAW_ACCESS_TIER=full.

A plataforma é otimizada para lidar com conjuntos de dados massivos em tempo real:

• Compressão Gzip — Payloads da API comprimidos ~92% (11,6 MB → 915 KB)
• Cache ETag — Respostas 304 Not Modified ignoram análise JSON redundante
• Culling de Viewport — Apenas recursos dentro dos limites visíveis do mapa (+20% de buffer) são renderizados
• Atualizações Imperativas do Mapa — Camadas de alto volume (voos, satélites, incêndios) ignoram a reconciliação do React por meio de chamadas diretas setData()
• Renderização Agrupada — Navios, CCTV, terremotos e data centers usam agrupamento MapLibre para reduzir a contagem de recursos
• Atualizações de Viewport com Debounce — Debounce de 300ms impede a reconstrução excessiva de GeoJSON durante pan/zoom; debounce de 2s em camadas densas (satélites, incêndios)
• Interpolação de Posição — Animação suave de tick de 10s entre atualizações de dados
• React.memo — Componentes pesados encapsulados para evitar re-renderizações desnecessárias
• Precisão de Coordenadas — Lat/lng arredondado para 5 decimais (~1m) para reduzir o tamanho do JSON

Novos contribuidores podem usar docs/contributor-map.md para um guia de orientação mais curto.``` Shadowbroker/ ├── openclaw-skills/shadowbroker/ # OpenClaw skill — SKILL.md, sb_query.py client, alerts/monitor helpers ├── backend/ │ ├── main.py # FastAPI app, middleware, API routes (~4,000 lines) │ ├── cctv.db # SQLite CCTV camera database (auto-generated) │ ├── config/ │ │ └── news_feeds.json # User-customizable RSS feed list │ ├── services/ │ │ ├── data_fetcher.py # Core scheduler — orchestrates all data sources │ │ ├── ais_stream.py # AIS WebSocket client (25K+ vessels) │ │ ├── carrier_tracker.py # OSINT carrier position estimator (GDELT news scraping) │ │ ├── cctv_pipeline.py # 14-source CCTV camera ingestion pipeline │ │ ├── ssrf_guard.py # SSRF validation for operator recon fetches │ │ ├── sanctions/ofac.py # OpenSanctions OFAC SDN index │ │ ├── osint/lookups.py # Server-side recon lookups (Osiris port) │ │ ├── osint/openclaw_recon.py # OpenClaw dispatch for recon + entity_expand │ │ ├── osint_intel/resolve.py # Entity graph resolver (Wikidata + OFAC) │ │ ├── scm/suppliers.py # Supply-chain risk overlay │ │ ├── intel_feeds/ # Country risk index helpers │ │ ├── fetchers/malware.py # abuse.ch Feodo + URLhaus │ │ ├── fetchers/cyber_status.py # CISA KEV feed │ │ ├── fetchers/telegram_osint.py # Public Telegram channel scrape + geoparse │ │ ├── third_party/osiris/ # MIT attribution for Osiris-derived code │ │ ├── geopolitics.py # GDELT + Ukraine frontline + air alerts │ │ ├── region_dossier.py # Right-click country/city intelligence │ │ ├── radio_intercept.py # Police scanner feeds + OpenMHZ │ │ ├── kiwisdr_fetcher.py # KiwiSDR receiver scraper │ │ ├── sentinel_search.py # Sentinel-2 STAC imagery search │ │ ├── shodan_connector.py # Shodan device search connector │ │ ├── sigint_bridge.py # APRS-IS TCP bridge │ │ ├── network_utils.py # HTTP client with curl fallback │ │ ├── api_settings.py # API key management │ │ ├── news_feed_config.py # RSS feed config manager │ │ ├── fetchers/ │ │ │ ├── flights.py # OpenSky, adsb.lol, GPS jamming, holding patterns │ │ │ ├── geo.py # AIS vessels, carriers, GDELT, fishing activity │ │ │ ├── satellites.py # CelesTrak TLE + SGP4 propagation │ │ │ ├── earth_observation.py # Quakes, fires, volcanoes, air quality, weather │ │ │ ├── infrastructure.py # Data centers, power plants, military bases │ │ │ ├── trains.py # Amtrak + DigiTraffic European rail │ │ │ ├── sigint.py # SatNOGS, TinyGS, APRS, Meshtastic │ │ │ ├── meshtastic_map.py # Meshtastic MQTT + map node aggregation │ │ │ ├── military.py # Military aircraft classification │ │ │ ├── news.py # RSS intelligence feed aggregation │ │ │ ├── financial.py # Global markets data │ │ │ └── ukraine_alerts.py # Ukraine air raid alerts │ │ └── mesh/ # InfoNet / Wormhole protocol stack │ │ ├── mesh_protocol.py # Core mesh protocol + routing │ │ ├── mesh_crypto.py # Ed25519, X25519, AESGCM primitives │ │ ├── mesh_hashchain.py # Hash chain commitment system (~1,400 lines) │ │ ├── mesh_router.py # Multi-transport router (APRS, Meshtastic, WS) │ │ ├── mesh_wormhole_persona.py # Gate persona identity management │ │ ├── mesh_wormhole_dead_drop.py # Dead Drop token-based DM mailbox │ │ ├── mesh_wormhole_ratchet.py # Double-ratchet DM scaffolding │ │ ├── mesh_wormhole_gate_keys.py # Gate key management + rotation │ │ ├── mesh_wormhole_seal.py # Message sealing + unsealing │ │ ├── mesh_merkle.py # Merkle tree proofs for data commitment │ │ ├── mesh_reputation.py # Node reputation scoring │ │ ├── mesh_oracle.py # Oracle consensus protocol │ │ └── mesh_secure_storage.py # Secure credential storage │ ├── routers/ │ │ ├── osint.py # /api/osint/* recon routes (local operator) │ │ ├── entity_graph.py # /api/entity/expand │ │ ├── scm.py # /api/scm-suppliers │ │ └── intel_feeds.py # /api/malware, /api/cyber-threats, /api/telegram-feed, /api/country-risk ├── frontend/ │ ├── public/data/ │ │ └── submarine-cables.json # Static undersea cable GeoJSON │ ├── src/ │ │ ├── app/ │ │ │ └── page.tsx # Main dashboard — state, polling, layout │ │ └── components/ │ │ ├── MaplibreViewer.tsx # Core map — all GeoJSON layers │ │ ├── MeshChat.tsx # InfoNet / Mesh / Dead Drop chat panel │ │ ├── MeshTerminal.tsx # Draggable CLI terminal │ │ ├── NewsFeed.tsx # SIGINT feed + entity detail panels │ │ ├── WorldviewLeftPanel.tsx # Data layer toggles (40+ layers) │ │ ├── ShodanPanel.tsx # Shodan device search overlay │ │ ├── ReconPanel.tsx # Server-side OSINT recon toolkit │ │ ├── ScmPanel.tsx # Supply-chain risk command panel │ │ ├── EntityGraphPanel.tsx # Entity graph on map selection │ │ ├── MaplibreViewer/popups/TelegramOsintPopup.tsx # Threat-intercept styled Telegram pin popups │ │ ├── WorldviewRightPanel.tsx # Search + filter sidebar │ │ ├── AdvancedFilterModal.tsx # Airport/country/owner filtering │ │ ├── MapLegend.tsx # Dynamic legend with all icons │ │ ├── MarketsPanel.tsx # Global financial markets ticker │ │ ├── RadioInterceptPanel.tsx # Scanner-style radio panel │ │ ├── FindLocateBar.tsx # Search/locate bar │ │ ├── ChangelogModal.tsx # Version changelog popup (auto-shows on upgrade) │ │ ├── SettingsPanel.tsx # API Keys + News Feed + Shodan config │ │ ├── ScaleBar.tsx # Map scale indicator │ │ └── ErrorBoundary.tsx # Crash recovery wrapper │ └── package.json

</details>

---

<details>
<summary>🔑 Variáveis de Ambiente</summary>

### Backend (`backend/.env`)```env
# Required for airplane telemetry (NEW in v0.9.7 — startup env check flags these as critical)
# Free registration: https://opensky-network.org/index.php?option=com_users&view=registration
OPENSKY_CLIENT_ID=your_opensky_client_id      # OAuth2 — global flight state vectors
OPENSKY_CLIENT_SECRET=your_opensky_secret     # OAuth2 — paired with Client ID above

# Optional (enhances data quality)
AIS_API_KEY=your_aisstream_key                # Maritime vessel tracking (aisstream.io) — ships layer empty without it
LTA_ACCOUNT_KEY=your_lta_key                  # Singapore CCTV cameras
SHODAN_API_KEY=your_shodan_key                # Shodan device search overlay
SH_CLIENT_ID=your_sentinel_hub_id             # Copernicus CDSE Sentinel Hub imagery
SH_CLIENT_SECRET=your_sentinel_hub_secret     # Paired with Sentinel Hub Client ID
MESH_SAR_EARTHDATA_USER=                      # NASA Earthdata user (SAR Mode B — OPERA products)
MESH_SAR_EARTHDATA_TOKEN=                     # NASA Earthdata token (paired with user above)
MESH_SAR_COPERNICUS_USER=                     # Copernicus Data Space user (SAR Mode B — EGMS / EMS)
MESH_SAR_COPERNICUS_TOKEN=                    # Copernicus token (paired with user above)
OPENCLAW_ACCESS_TIER=restricted               # OpenClaw agent tier: "restricted" (read-only) or "full"
# OPENCLAW_HMAC_SECRET=                         # Optional; UI Bootstrap persists to data/openclaw.env in Docker
GFW_API_TOKEN=your_gfw_token                  # Global Fishing Watch — fishing_activity layer (Settings → Maritime)
TELEGRAM_OSINT_ENABLED=true                   # Telegram OSINT layer (default on)
TELEGRAM_OSINT_CHANNELS=osintdefender,...     # Comma-separated public channel slugs (see .env.example)

# Private-lane privacy-core pinning (required when Arti or RNS is enabled)
PRIVACY_CORE_MIN_VERSION=0.1.0
PRIVACY_CORE_ALLOWED_SHA256=your_privacy_core_sha256
# Optional override if you load a non-default shared library path
PRIVACY_CORE_LIB=

Quando MESH_ARTI_ENABLED=true ou MESH_RNS_ENABLED=true, a inicialização do backend agora falha de forma segura a menos que o artefato privacy-core carregado reporte uma versão analisável igual ou superior a PRIVACY_CORE_MIN_VERSION e corresponda a um dos hashes em PRIVACY_CORE_ALLOWED_SHA256.

Gere o hash a partir do artefato que pretende enviar:```powershell Get-FileHash .\privacy-core\target\release\privacy_core.dll -Algorithm SHA256

- [Versão WASM (Rust)]: `wasm-pack build --target web` (a saída estará em `./pkg/`)
- [Exemplo de integração]: Adicionar exemplo: `rustfinity.com`
- [Versão Emscripten (C/C++)]: `emcc file.c -s WASM=1 -o output.html`
- [Suporte Node.js]: Verificar `node --experimental-wasm-modules`
- [Exemplo de runtime WASM]: Use [wasmtime](https://wasmtime.dev/) ou [wasmer](https://wasmer.io/)```bash
sha256sum ./privacy-core/target/release/libprivacy_core.so

Em seguida, confirme que o GET /api/wormhole/status ou GET /api/settings/wormhole-status autenticado mostra os mesmos privacy_core.version, privacy_core.library_path e privacy_core.library_sha256.

Frontend

Como funciona: O frontend faz proxy de todas as requisições /api/* através do servidor Next.js para BACKEND_URL usando a rede interna do Docker. Os navegadores se comunicam apenas com a porta 3000; a porta do host do backend é apenas para diagnósticos locais. Para desenvolvimento local sem Docker, BACKEND_URL padrão é http://localhost:8000.

ShadowBroker é construído em público. Estas pessoas enviaram código real: