ksp journey
DocsCLIksp journey

ksp journey

Command Reference

Step-by-step interactive terminal walkthrough tracing a packet's journey from application buffer to network wire.

Protocol Utilities

Purpose

Step-by-step interactive terminal walkthrough tracing a packet's journey from application buffer to network wire.

Syntax

Command-line specification
bash / powershell
ksp journey [OPTIONS]

Options & Flags

Option FlagDescription
--verboseShow byte-by-byte XOR key derivation and authentication tag calculations.

Example Usage

Example command
ksp journey --verbose

Expected Output

════════════════════════════════════════════════════════════
══              KSP End-to-End Packet Journey             ══
════════════════════════════════════════════════════════════
  [Step 1] App writes "Hello Kush" to Stream ID #3
  [Step 2] KSP framing engine wraps payload with 16-byte header (Type: STREAM_DATA)
  [Step 3] Nonce constructed: Salt (0xA1B2) || Sequence (Counter: 1)
  [Step 4] AEAD AES-256-GCM encrypts payload + calculates 16-byte Auth Tag
  [Step 5] Final wire packet (48 bytes) transmitted over UDP socket to 127.0.0.1:9876!
Implementation Notes

A fantastic educational tool directly mirroring the web-based `kspprotocol.dev/packet-journey` experience.