ciajaf/super_ball
1
0
Fork 0
forked from npub1wsauh7vr2kwz5kpyk0hwzja35640a9gls5t/super_ball
Code Pull Requests Activity

Created kind 12222

Browse Source
This commit is contained in:
Your Name
2025-09-18 17:18:47 -04:00
parent 6cf5d6c50e
commit e9c8fccc9f
9 changed files with 2574 additions and 2645 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
README.md
View File

@@ -1,29 +1,33 @@
# 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.
Superball provides Tor-like location privacy for Nostr users. A **Superball** is a wrapped nostr event, similar to a TOR onion packet, that bounces between nostr relays and **Throwers**.
A **Thrower** is a nostr-capable daemon that monitors nostr nodes, looks for superballs posted for them, grabs them, cryptographically unwraps them, rewraps them potentially with padding, then throws the superball to relay(s) that it is instructed to, when it is instructed to.
## 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
2. **Wrap as Superball** - Bundle event + routing instructions, encrypt to Thrower daemon
3. **Anonymous bouncing** - Superball bounces through multiple Throwers with delays and padding
4. **Final posting** - Original event appears on target relay with user's identity but from Thrower'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
- **Flexible Routing**: Support for multi-hop paths through multiple Throwers
- **Signature Preservation**: Original event signatures maintained for authenticity
- **Audit Security**: Detect and avoid malicious Superballs through cryptographic verification
- **Audit Security**: Detect and avoid malicious Throwers through cryptographic verification
## Documentation
- [`PROTOCOL.md`](PROTOCOL.md) - Technical protocol specification
- [`THROWER.md`](THROWER.md) - Rules and behavior for Thrower operators
- [`EXAMPLE.md`](EXAMPLE.md) - Complete walkthrough example
- [`DAEMON.md`](DAEMON.md) - Rules and behavior for Superball daemon operators
- [`SUPs.md`](SUPs.md) - Superball Upgrade Proposals
Perfect for journalists, activists, or anyone who needs to protect their physical location while maintaining accountability for their public statements.