v0.0.1

README.md

@@ -0,0 +1,29 @@
+# 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 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`](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.
+