Chapter 0: Introduction and Use Cases

Why a solo dev built FrameAssembly (.frasm <-> .pcap), how the -> / <- ladder syntax skips Scapy misery, and a 30-second sandbox warm-up.

Labs completed0/7
A Language to Create and Change PCAP (.frasm <-> .pcap)

If you can read a Wireshark packet list or draw -> and <- on a whiteboard, you already know .frasm. Most captures are just two blocks:

1. host — Name the boxes

host fw { ip 10.0.0.1 }

2. compile — Draw the ladder

pc -> fw tcp syn dstport 443

Live Sandbox Presets (.frasm -> .pcap)

Click a Capture Preset to Poke at the Wire Bytes

Each button drops a working .frasm script into the live compiler beside you so you can inspect Ethernet, VLAN, IP, TCP, and SNMPv3 fields right away.

NOC & Monitoringnoc_snmpv3_trap.frasmWireshark: snmp || syslog

Verify Zabbix, PRTG, LibreNMS, or snmptrapd decrypts and pages on a TenGigE0/1/0 linkDown trap before an actual 3 AM outage.

Derives RFC 3414/7860 SHA-256 auth + AES-128 privacy keys on the fly, with zero vendor MIB files required.

Ready to write a 2-packet ping from scratch?
Prefer Reading Over Guided Labs?

Field Guides, Cursed Packets & Cheat Sheets

Origin Story & Full Lab Syllabus (Chapters 1–6)
Why a solo dev built this + what the compiler handles so you don't have to

Why This Exists

FrameAssembly started out of a simple annoyance: creating a 5-packet .pcap or changing two fields inside an existing one took way too much ceremony.

Say you want to verify a Zabbix SNMPv3 trap rule, dry-run a new VLAN 20 firewall policy before Monday morning, or redact private subnets and internal hostnames out of a customer capture before attaching it to a support ticket.

With Python + Scapy you end up debugging imports, raw-socket permissions, and manual TCP sequence counters. With tcprewrite you can swap outer IPs, only to corrupt every header length and checksum the instant a DNS name or TLS SNI string changes size.

FrameAssembly (.frasm <-> .pcap) keeps it plain: name the boxes in host, draw -> and <- lines inside compile, and let the Rust compiler handle Ethernet tags, IP lengths, TCP state, and SNMPv3 crypto — or run reverse on an existing .pcap to edit it as text.

What the Compiler Handles So You Don't Have To
01 · Whiteboard Ladder Syntax
Draw -> and <- arrows instead of debugging Python imports

If you know what an IP, VLAN tag, TCP SYN, or ping reply is, you already speak .frasm. No classes, no byte arrays, and zero underscore guessing.

02 · Zero Root, Zero Drivers
Writes .pcap & .pcapng in user space (browser or CLI)

No sudo, no Npcap kernel drivers on your locked-down work laptop, and zero packets leaving your machine unless you explicitly feed the file to tcpreplay.

03 · Stateful TCP & Checksums
Tracks seq / acknum & swaps ports on <- replies automatically

Stateful firewalls and Suricata laugh at lone spoofed packets. FrameAssembly tracks 4-tuple TCP sessions and calculates every L2–L7 length and checksum.

04 · Two-Way .pcap <-> .frasm
Decompile ugly .pcap files, scrub secrets, and recompile

Run reverse on any binary Wireshark trace, swap customer IPs, MACs, VLANs, or internal hostnames in text, and rebuild a valid .pcap in seconds.

Chapters 1–6 Syllabus
Lab 15 min
Chapter 1: Two Blocks & a Ping (host + compile)
Lab 25 min
Chapter 2: Ladder Arrows (-> / <-) & Lag (wait)
Lab 36 min
Chapter 3: VLAN Tags & Stateful TCP (syn -> syn ack -> ack)
Lab 46 min
Chapter 4: Testing Alerts Offline (snmp3 trap + syslog)
Lab 55 min
Chapter 5: Copy-Paste Detox with Parameterized flow(c, s)
Lab 66 min
Chapter 6: Reverse .pcap -> Scrub Secrets -> Rebuild .pcap
30-Second Warm-Up: Swap a Switch IP & Watch Every Header Update
Change one IP in the sandbox and watch every packet header & checksum update live

Click around the 3 presets or edit the active .frasm script on the right. To check off Chapter 0, change the first host IP (for example from 10.40.1.1 to 10.40.1.25) and hit Check Warm-Up.

  1. 1.Find the first host line near the top of the sandbox.
  2. 2.Swap its IPv4 address to any other valid lab IP (e.g. 10.40.1.25) — plain IP only, no /24 CIDR suffix.
  3. 3.Hit Check Warm-Up and verify every frame updates its Layer 3 header and UDP checksum with zero complaints.
noc_snmpv3_trap.frasmLoading WASM…
Wireshark filter: snmp || syslog
Open in Playground
0 B · 0.000 ms
Compiling capture in WebAssembly…
Learn .frasm — Labs, Guides & 81 Protocols | FrameAssembly