30 lines
1.5 KiB
Markdown
30 lines
1.5 KiB
Markdown
# 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 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.
|
|
|