Onion
@zocc/onionv2026.09.10.1
01README
Tor onion-service observability model: bootstrap a persistent Tor daemon, probe onion endpoints, capture sha256-attributed evidence snapshots, crawl dump-inventory listings (filebrowser HTML or enumeration JSON) with PII-bearing filename masking. Network layer of the breach-verification bench.
02Models
@zocc/onionv2026.09.10.1mod.ts
fn bootstrap(socksPort: number, timeoutSec: number, force: boolean)
Idempotently ensure a Tor SOCKS daemon is listening (spawns one if absent)
| Argument | Type | Description |
|---|---|---|
| socksPort | number | SOCKS5 port to use |
| timeoutSec | number | Max seconds to wait for Tor bootstrap |
| force | boolean | Restart the daemon even if the port already answers |
fn probe(url: string, socksPort: number, timeoutSec: number, ensureTor: boolean)
Check whether an onion URL is reachable through Tor (stateless)
| Argument | Type | Description |
|---|---|---|
| url | string | Onion URL to probe |
| socksPort | number | Tor SOCKS5 port |
| timeoutSec | number | Per-request timeout |
| ensureTor | boolean | Bootstrap Tor first if the daemon is not running |
fn fetch(url: string, destination: string, socksPort: number, maxBytes: number, timeoutSec: number)
Capture an evidence snapshot: download via Tor to a local path with sha256 + byte attribution
| Argument | Type | Description |
|---|---|---|
| url | string | Onion URL to download |
| destination | string | Absolute local path to save the capture |
| socksPort | number | Tor SOCKS5 port |
| maxBytes | number | Abort if the response exceeds this size (0 = unlimited) |
| timeoutSec | number | Per-request timeout |
Resources
probe_result(1h)— Onion endpoint availability probe result
fetch_result(24h)— Evidence snapshot capture result with sha256 attribution
crawl_result(24h)— Parsed dump-listing inventory with PII masking applied
03Stats
A
92 / 100
Downloads
1
Archive size
11.1 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive0/1missing
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
04Platforms
05Labels