Go to file
Your Name f86e0ce7dd v0.0.1 2025-09-17 10:03:26 -04:00
.gitignore v0.0.1 2025-09-17 10:03:26 -04:00
DAEMON.md v0.0.1 2025-09-17 10:03:26 -04:00
EXAMPLE.md v0.0.1 2025-09-17 10:03:26 -04:00
Norman_Stingley.txt v0.0.1 2025-09-17 10:03:26 -04:00
PROTOCOL.md v0.0.1 2025-09-17 10:03:26 -04:00
README.md v0.0.1 2025-09-17 10:03:26 -04:00
super_ball.code-workspace v0.0.1 2025-09-17 10:03:26 -04:00
super_ball.jpg v0.0.1 2025-09-17 10:03:26 -04:00

README.md

Superball

superball

Superball provides Tor-like location privacy for Nostr users. It's a daemon that bounces encrypted events between relays, allowing users to post content under their real identity while completely hiding their network location.

How It Works

  1. User creates content - Normal signed Nostr event with their real pubkey
  2. Encrypt with routing - Bundle event + routing instructions, encrypt to Superball daemon
  3. Anonymous forwarding - Event bounces through multiple daemons with delays and padding
  4. Final posting - Original event appears on target relay with user's identity but from daemon's location

Key Features

  • Location Privacy: Hide your network location while preserving your identity
  • Traffic Analysis Resistance: Random delays and size padding prevent correlation
  • Simple Protocol: Uses NIP-44 encryption with new kind 30000 for routing
  • Flexible Routing: Support for multi-hop paths through multiple daemons
  • Signature Preservation: Original event signatures maintained for authenticity
  • Audit Security: Detect and avoid malicious Superballs through cryptographic verification

Documentation

  • PROTOCOL.md - Technical protocol specification
  • EXAMPLE.md - Complete walkthrough example
  • DAEMON.md - Rules and behavior for Superball daemon operators

Perfect for journalists, activists, or anyone who needs to protect their physical location while maintaining accountability for their public statements.