nx_ipp_codec.nx

nx_ipp_codec.nx -- sovereign IPP/1.1 wire codec (RFC 8010 encoding) -- R0 keystone of the "better printer standard that works with ANY printer" arc. WHY this is the foundation: IPP (Internet Printing Protocol) / IPP Everywhere is the vendor-neutral standard every modern printer speaks -- it is what AirPrint and CUPS "driverless" printing use under the hood. A Brother, HP, Canon or Epson all answer the SAME Get-Printer-Attributes operation. So a correct IPP codec is the one primitive that lets us manage every printer without a per-vendor driver. This file is the pure byte layer: build a request, parse a response. Transport (TCP/HTTP) is R1; semantics/model (printer-state -> human meaning, waste accounting) is R2+. WHY it kills silent failure (the operator's core complaint): An IPP response carries "printer-state" (idle/processing/stopped) and "printer-state-reasons" -- a 1setOf keyword list that enumerates EVERY reason the device is stuck (media-empty, media-jam, marker-supply-low, cover-open, ...). Brother's own UI swallows these; this parser surfaces them. The parser NEVER returns a silent success on bad bytes: every length is bounds-checked and a malformed message yields the sealed NX_IPP_MALFORMED verdict (no_silent_failure by construction). NEVER-BRICK (global rule #26): this is a pure codec. It performs NO syscalls, touches no hardware, and cannot write firmware/NVRAM. Safe BY CONSTRUCTION -- the safest possible bottom rung. Sovereign: pure integer/byte arithmetic, no imports, no 3rd-party. nx_cc -> nxasm, no gcc. CITED EVIDENCE (fetched by the sovereign researcher over its own TLS-1.3, saved under knowledge/fetched/): ipp_rfc8010.raw RFC 8010 "IPP/1.1: Encoding and Transport" (Jan 2017) - msg = version(2) op/status(2) request-id(4) *attr-group end-tag(0x03) data (sec 3.1.1) - delimiter-tags: operation=0x01 job=0x02 end=0x03 printer=0x04 unsupported=0x05 (Table 2) - value-tags: integer=0x21 boolean=0x22 enum=0x23 keyword=0x44 uri=0x45 charset=0x47 naturalLanguage=0x48 mimeMediaType=0x49 nameWithoutLanguage=0x42 (Tables 4-6) - delimiters are 0x00-0x0f, value-tags are 0x10-0xff (sec 3.5.1 -- the walker's key rule) - attr = value-tag(1) name-length(2) name value-length(2) value; lengths are SIGNED-SHORT, big-endian; integer/enum = exactly 4 octets; boolean = 1 octet; 1setOf extra values use name-length 0 "additional-value" (sec 3.1.2, 3.8, 3.9 Table 7) ipp_rfc8011.raw RFC 8011 "IPP/1.1: Model and Semantics" (Jan 2017) - operation-ids (Table): Print-Job=0x0002 Validate-Job=0x0004 Get-Jobs=0x000a Get-Printer-Attributes=0x000b - printer-state (sec 5.4.11): idle=3 processing=4 stopped=5 - printer-state-reasons keywords (sec 5.4.12): media-empty media-jam media-needed marker-supply-low marker-supply-empty toner-low toner-empty cover-open door-open