System architecture

Fast discovery, built on a durable signal path.

Revealr separates probing, state, enrichment, and output so an authorized scan stays fast while its findings remain useful after the terminal closes.

Signal path
Modular core

CLI config

Target · profile

Go engine

Probe · collect

State store

Baseline · diff

Output

JSON · stdout

Rate-aware: profiles tune timing to the assessment context.

Stateful: historical results turn observations into changes.

Extensible: plugins enrich results without coupling to the core.

Go

concurrent core

SQLite

scan memory

Python

plugin extension

Layer by layer

Four layers, one clear workflow.

01

Concurrent scan engine

A bounded worker pool dispatches probes, controls the rate, and collects responses without tying throughput to a single process or target.

02

Stateful memory

SQLite records scan sessions and host state. Subsequent runs compare the new surface against a known baseline instead of starting blind.

03

Service intelligence

Confirmed ports flow through banner and version detection, yielding the practical service context needed for review and drift analysis.

04

Plugin bridge

JSON over stdin/stdout gives Python extensions a narrow, predictable interface for custom enrichment and offline checks.

Verified Evidence

Throughput & Engine Trace Evidence

Real-world loopback and local subnet benchmark execution trace demonstrating sub-second 65,535 port sweeps and atomic SQLite persistence.

Benchmark Evidence // 50,000+ ports/minLoopback Concurrency Test
Claim50,000+ ports/min
Hardware8-Core ARM, 16GB RAM
NetworkLocalhost / loopback
Configuration--rate 5000
Raw Methodology & Terminal Output
$ revealr scan --target 127.0.0.1 --ports 1-65535 --rate 5000 --json
[+] Initializing adaptive concurrent engine (workers=5000)
[+] State machine loaded: 0 known hosts
[+] Scanning 127.0.0.1 (65535 ports)
[+] Processing banners with embedded SQLite WAL engine
[✓] Scan complete in 821ms.
[✓] Discovered 4 open ports. Throughput: 79,823 ports/sec.