sphere
A Web3 wallet and agent platform for the Unicity network - crypto wallet, DMs, group chat, and marketplace.
What is sphere?
A Web3 wallet and agent platform for the Unicity network - crypto wallet, DMs, group chat, and marketplace.
Overview of sphere
What it is
A Web3 wallet and agent platform for the Unicity network. It provides crypto wallet functionality, direct messaging (DMs), group chat, and a marketplace. The project is built with React 19, TypeScript, Vite 7, and uses the @unicitylabs/sphere-sdk for wallet operations.
Key features
- Unicity state transitions: fast, low-cost token transfers, token management and balance tracking, incoming payment notifications, and a nametag system (@username).
- Connect Protocol (dApp ↔ Wallet): supports iframe mode, popup mode, permission-based access, and intent handling for send/sign/DM flows.
- Deep Links (unicity-connect://): custom URL protocol for inter-app linking within DMs, rendered as interactive buttons with options to open in Sphere or browser.
- Agent System: specialized interfaces loaded as tabs, including Messages (DM via Nostr), Group Chat (via NIP-29), and Sphere Agents (iframe for external dApps).
- Group Chat (NIP-29): relay-based group messaging with public/private groups, invite codes, real-time WebSocket messaging, group discovery, join/leave, and unread tracking.
- Wallet modules: optional features discovered by folder; bridge for external assets is one example.
Use cases
- Managing a Unicity wallet with token transfers, balance tracking, and payment notifications.
- Communicating via private DMs or public group chats using Nostr and NIP-29.
- Interacting with external dApps through the Connect Protocol or deep links.
- Loading any external dApp as an iframe agent within the Sphere platform.
Getting started
Requirements: Node.js 20+. Setup: bash npm install cp .env.example .env # Configure environment variables npm run dev # Start dev server at http://localhost:5173 Commands: bash npm run dev # Development server npm run build # TypeScript compile + Vite production build npm run preview # Preview production build npm run lint # ESLint npm run test # Vitest watch mode npm run test:run # Vitest single run
License and pricing
The README states the project is a private project by Unicity Labs. The metadata lists pricing type as open_source. No specific pricing information is provided.
Based on the project's public README and repository metadata.