NDA Format - UnitBuilds-CC/V.E.L.O.C.I.T.Y.-MCP GitHub Wiki

NDA Format

NDA (Neural Document Archive) is a cryptographically signed binary container format.

What's Inside

Semantic Triples — Subject-predicate-object knowledge representations
Visual Display Commands — Layout and formatting instructions
String Pool — Deduplicated pool of all string data
Executable Payloads (optional) — Compiled binaries or scripts

Binary Format

[4 bytes: magic "NMCP"]
[32 bytes: Merkle root (SHA-256)]
[1 byte: method type]
[TLV: request data]
[String pool]
[Signature section (optional)]
  [4B: sig length] [64B: Ed25519 sig] [32B: public key]

The Pipeline

Source File → convert_to_nda_document → .nda File → read_nda → Inspect
                                              ↓
                                         execute_nda → Run in sandbox

Supported Input Types

Type	Extensions	What Gets Encapsulated
C# Source	`.cs`	Compiled assembly + semantic triples
PDF	`.pdf`	Text triples + page layout
CSV	`.csv`	Column/row triples + metadata
Excel	`.xlsx`	Sheet structure + cell data
Word	`.docx`	Paragraph triples + styles
Images	`.png`, `.jpg`, `.webp`	Display commands + pixel data
Archives	`.zip`	File manifest + payloads
Source code	20+ languages	Syntax-colored layout

Security

Ed25519 signatures — Cryptographic authenticity verification
Merkle tree — SHA-256 integrity verification of all content
Backward compatible — Unsigned documents still parse

Performance

NDA binary parsing is 1.6x faster than JSON with Merkle verification, and 3.1x faster for shared memory throughput.