super_ball/README.md

1.5 KiB

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.