sphere

Unicity AgentSphere é uma plataforma Web3 de carteira e agentes construída para a rede Unicity. Ela combina funcionalidades de carteira de criptomoedas com mensagens, chat em grupo e recursos de marketplace em um aplicativo unificado. Os recursos principais da carteira incluem transferências de tokens rápidas e de baixo custo, gerenciamento de tokens e rastreamento de saldo, notificações de pagamentos recebidos e um sistema de etiquetas de nome para identificação de usuários. A carteira suporta códigos QR, troca de carteiras, gerenciamento de frases-semente e dados de mercado em tempo real. A plataforma implementa o protocolo Sphere Connect, que permite que dApps externos se conectem à carteira e solicitem operações. Dois modos de conexão são suportados: modo iframe, onde o dApp é incorporado dentro da Sphere e se comunica via PostMessageTransport, e modo popup, onde o dApp abre a Sphere como uma janela popup para aprovação do usuário. O acesso é baseado em permissões, com dApps solicitando escopos específicos que os usuários podem aprovar ou rejeitar. O protocolo também suporta manipulação de intenções, permitindo que dApps acionem fluxos de envio, assinatura e mensagens diretas (DM) dentro da interface da carteira. A Sphere suporta um protocolo de link profundo personalizado (unicity-connect://) para vinculação entre aplicativos dentro de DMs. Quando um dApp envia um URL de link profundo em uma mensagem DM, a Sphere o renderiza como um botão interativo com opções para abrir o link dentro da Sphere como um agente iframe ou em uma aba de navegador externa. O protocolo é resolvido para URLs HTTP/HTTPS padrão, com tratamento especial para endereços localhost. O sistema de agentes permite que interfaces especializadas sejam carregadas como abas dentro do aplicativo. Os agentes atualmente ativos incluem Mensagens (DM) para conversas privadas via Nostr, Chat em Grupo para canais públicos via NIP-29 e Agentes Sphere para carregar qualquer dApp externo via iframe com um URL personalizado. Tipos adicionais de agentes podem ser adicionados por meio de configuração. A funcionalidade de chat em grupo é construída sobre o NIP-29, uma especificação de protocolo Nostr para mensagens em grupo baseadas em relay. Os recursos incluem grupos públicos e privados com códigos de convite, mensagens em tempo real via WebSocket, descoberta de grupos, operações de entrar/sair e rastreamento de mensagens não lidas. Um relay dedicado está disponível em wss://sphere-relay.unicity.network. O aplicativo é construído com React 19 e TypeScript, usando Vite 7 como ferramenta de build. Ele utiliza TanStack Query v5 para gerenciamento de estado do servidor, Tailwind CSS 4 para estilização, Framer Motion para animações e React Router DOM v7 para roteamento. Todas as operações da carteira são tratadas pelo pacote @unicitylabs/sphere-sdk, que cobre funcionalidades de L3, Nostr e IPFS. Os testes são feitos com Vitest e jsdom. O projeto pode ser executado em modo de desenvolvimento com npm run dev, construído para produção com npm run build e implantado via Docker Compose na porta 3010. Variáveis de ambiente controlam a configuração, como etiqueta de nome do agente de boas-vindas, atraso de boas-vindas, certificados SSL e caminho base de implantação. O projeto é licenciado como um projeto privado pela Unicity Labs.