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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/unicity-spheresphere.svg)](https://yunodb.com/tools/unicity-spheresphere?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/unicity-spheresphere?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/unicity-spheresphere.svg" alt="Featured on YunoDB" height="20"></a>