Unicity AgentSphere
A Web3 wallet and agent platform for the Unicity network, featuring crypto wallet, DMs, group chat, and marketplace.
Evidence shows permission requests and user confirmation (e.g., connection approval modal), but least privilege is not detailed; data flow transparency is limited; sensitive data handling (e.g., seed phrases) not fully specified; dependency security not audited; external effects (e.g., deployment) are described but rollback is missing; source attribution only via README mentioning Unicity Labs, unverified.
Self-consistency is good with CI and tests; dependency availability not verified; failure messages are present in tests but not fully documented in product.
Audience and scenarios are clear (Web3 wallet and agent platform), capability boundaries partially described (e.g., agent types), trigger precision (e.g., deep links) described but not precise; environment fit has Docker and deployment configs.
Information architecture is clear, install notes exist, naming stability not verified, examples and FAQ lacking, known limitations not explicit, license is private project, versioning and changelog missing, maintenance responsibility not clear.
Output usability not fully specified, marginal value described but not quantified, cost-benefit not analyzed.
Claim traceability is limited, cross-source corroboration insufficient, fact-inference separation not clear.
- Unverified publisher identity, proceed with caution.
- Sensitive data handling (e.g., seed phrases) not fully specified, needs review.
- Dependency security not audited, potential risks.
- Rollback mechanism missing, deployment failures may impact availability.
What does this agent do, and when should you use it?
Unicity AgentSphere is a Web3 wallet and agent platform built for the Unicity network, combining a cryptocurrency wallet, direct messages (DMs), group chat, and a marketplace. It offers fast, low-cost state transitions, token management, balance tracking, incoming payment notifications, and a @username nametag system. The platform implements the Connect protocol (ConnectHost) that allows external dApps to connect via iframe or popup, with permission-based access to wallet operations. It also supports unicity-connect:// deep links for opening dApps within chat. The agent system supports loading external dApps as iframe agents, and group chat is based on NIP-29. The tech stack includes React 19, TypeScript, Vite 7, TanStack Query, Tailwind CSS 4, and more. It requires Node.js 20+ and can be run via npm or Docker.
AgentSphere provides a complete Web3 wallet experience, including Unicity token transfers, balance queries, transaction history, payment notifications, and nametag management. It enables dApp connections through the Connect protocol, supporting iframe and popup modes with user-approved permissions. The deep link protocol converts unicity-connect:// URLs to https://, allowing users to open dApps in an iframe or browser. The agent system loads custom iframe agents via /agents/custom?url=, and group chat uses NIP-29 with WebSocket real-time messaging. The platform uses @unicitylabs/sphere-sdk for all wallet operations, including L3, Nostr, and IPFS.
- End users can perform fast and low-cost cryptocurrency transfers on the Unicity network and track their balances and transaction history.
- dApp developers can integrate their applications by implementing the Connect protocol, using iframe or popup modes to request wallet operations like sending tokens, signing, or DMs.
- Users receive unicity-connect:// links in DMs from dApps and can open them in Sphere or in a browser with one click.
- Community members can join public group chats via NIP-29, participate in real-time discussions, and create or join private groups with invite codes.
- Developers can extend the platform by loading external dApps as iframe agents through the /agents/custom?url= endpoint.
What are this agent's strengths and limitations?
- Specifically designed for the Unicity network, offering fast and low-cost state transitions and token management.
- Implements the Connect protocol, supporting iframe and popup modes for easy dApp integration.
- Supports multiple agent types, including iframe agents, providing high extensibility.
- Integrates NIP-29 group chat with real-time messaging and invite codes.
- Only supports the Unicity network, not other blockchains.
- Relies on a specific relay (wss://sphere-relay.unicity.network) for group chat, which may introduce centralization.
- License is private, so code may not be freely used or modified.
- Requires Node.js 20+ which is relatively new.
How do you install or deploy this agent?
Requirements: Node.js 20+.
- Clone the repository: git clone https://github.com/unicity-sphere/sphere
- Navigate into the directory: cd sphere
- Install dependencies: npm install
- Copy the environment file: cp .env.example .env
- Configure .env variables (e.g., VITE_WELCOME_AGENT_NAMETAG).
- Start the development server: npm run dev
Alternatively, use Docker: docker compose up (runs on port 3010).
How do you use this agent?
Development commands:
- npm run dev: start dev server at http://localhost:5173
- npm run build: TypeScript compile + Vite production build
- npm run preview: preview production build
- npm run lint: run ESLint
- npm run test: run Vitest testsEnvironment variables:
- VITE_WELCOME_AGENT_NAMETAG=kbbot (welcome DM agent nametag)
- VITE_WELCOME_DELAY_MS=4000 (welcome DM delay)To connect dApps via Connect protocol: initiate connection in iframe or popup, user approves permissions.
To use deep links: send unicity-connect:// URLs in DMs to open in Sphere or browser.