Skip to content

fix(docs): add outer frame encapsulation preamble to SPEC.md §3 (PILOT-419) #2

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
matthew-pilot merged 2 commits into from
Jun 18, 2026
Merged

fix(docs): add outer frame encapsulation preamble to SPEC.md §3 (PILOT-419) #2

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
687e872
fix(docs): add outer frame encapsulation preamble to SPEC.md §3 (PILO…
matthew-pilot Jun 18, 2026
f394f42
Merge remote-tracking branch 'origin/main' into openclaw/pilot-419-20…
matthew-pilot Jun 18, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions SPEC.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -87,6 +87,21 @@ Socket address includes a port: `1:0001.F291.0004:1000`

## 3. Packet Format

All Pilot Protocol wire-format frames are encapsulated in a tunnel envelope
identified by a 4-byte magic byte prefix. Four frame types are defined:

| Magic | Frame Type |
|-------------------------|--------------------------------------|
| `PILT` (0x50494C54) | Unencrypted tunnel frame (plaintext) |
| `PILS` (0x50494C53) | AES-256-GCM encrypted tunnel frame |
| `PILK` (0x50494C4B) | X25519 key exchange frame |
| `PILA` (0x50494C41) | Ed25519 + X25519 authenticated key exchange |

The frame types are detailed in §4 below. This section (§3) describes the
inner 34-byte header shared by PILT (plaintext) frames. Encrypted (PILS),
key-exchange (PILK), and authenticated (PILA) frames use different header
layouts documented in §4.

### 3.1 Header Layout (34 bytes)

```
Expand Down
Loading