# Superball
![superball](super_ball.jpg)

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 22222 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`](PROTOCOL.md) - Technical protocol specification
- [`EXAMPLE.md`](EXAMPLE.md) - Complete walkthrough example
- [`DAEMON.md`](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.