ksp packet
ksp packet
Command ReferenceConstruct, parse, mutate, or inspect individual raw KSP binary frames and headers in hexadecimal or JSON.
Protocol Utilities
RFC § 4 — Wire Packet LayoutPurpose
Construct, parse, mutate, or inspect individual raw KSP binary frames and headers in hexadecimal or JSON.
Syntax
Command-line specificationbash / powershell
ksp packet <ACTION> [OPTIONS]
Arguments
| Argument | Description |
|---|---|
| <ACTION> | Subaction: `build`, `parse`, `validate`, or `hexdump`. |
Options & Flags
| Option Flag | Description |
|---|---|
| --hex <HEX_STRING> | Raw hexadecimal wire frame string to parse and decode. |
| --type <FRAME_TYPE> | Frame type when building: `HANDSHAKE`, `STREAM_DATA`, `STREAM_OPEN`, `GO_AWAY`. |
| --stream-id <ID> | Assign stream identifier integer for the synthesized packet. |
Example Usage
Example command
ksp packet parse --hex "01000000030000000A00000048656C6C6F"
Expected Output
════════════════════════════════════════════════════════════ ══ KSP Frame Header Dissector ══ ════════════════════════════════════════════════════════════ [+] Frame Type: STREAM_DATA (0x01) [+] Stream ID: 3 (Client-initiated) [+] Payload Length: 10 bytes [+] Flags: [ACTIVE | NONCE_INCLUDED] [+] Decoded Data: "Hello" (Hex: 48 65 6c 6c 6f) ✔ Frame checksum valid according to RFC § 4.1.
Implementation Notes
Essential tool for protocol developers writing custom dissectors or debugging byte-level serialization anomalies.