Skip to content

About

NLTP v1.6.0 — Loss-healing X25519+PSK ChaCha20-Poly1305 UDP & ESP-NOW v1/v2 transport with GF(2^8) Cauchy FEC, LZ4 compression & 4.76 KB TX-only MCU profile in zero-float C99.

Topics

Resources

Contributing

Security policy

Stars

4 stars

Watchers

0 watching

Forks

Repository files navigation

NLTP v1.6.0 — Arduino, PlatformIO & ESP-IDF C99 SDK

Tier-1 Compliance CI OpenSSF Best Practices OpenSSF Scorecard IETF Datatracker ESP Component Registry License: MIT

Loss-Healing X25519 Forward-Secret UDP & ESP-NOW v1/v2 Transport (4.76 KB TX-Only MCU Profile)

Key Capabilities

  • Systematic GF(2^8) Cauchy Erasure Coding: Heals 10–35% random RF packet loss in-flight with zero retransmit stall (100% SHA-256 verified on physical ESP32 + ESP8266 hardware).
  • X25519 Forward Secrecy + ChaCha20-Poly1305 AEAD: 512-packet anti-replay window (160/160 forged/replayed frames dropped pre-FEC).
  • Built-in Zero-Dependency LZ4 Block Compression: Shrinks repetitive JSON/CSV telemetry 6.1×–6.9× before encryption and FEC slicing (FLAG_LZ4 = 0x40).
  • Confirmed 0 ms HOL Out-of-Line Reflex Channel: Sub-millisecond emergency actuator commands bypass bulk file transfer queues.
  • 4,760-Byte #define NLTP_TX_ONLY Sensor Mode: Fits comfortably inside ESP8266, ATmega, and STM32 SRAM budgets with 0 malloc calls and 0 floats.

Standards, Security & Verification (Tier 1)

Every commit is continuously verified against formal IETF/NIST cryptographic vectors, memory sanitizers, adversarial fuzzing, static safety rules, and supply-chain provenance:

Artifact / Assurance Gate Specification & Verification Scope
Formal IETF Internet-Draft datatracker.ietf.org/doc/draft-bains-nltp/ (TXT · XML · HTML) — active IETF Individual Internet-Draft specifying wire headers, handshake, Cauchy FEC, and LZ4
NIST & IETF Cryptographic KATs tests/test_kat_vectors.c — 1,668 checks covering RFC 7748 (X25519 + low-order point rejection), RFC 8439 (ChaCha20-Poly1305 AEAD), RFC 4231 (HMAC-SHA256), NIST FIPS 180-4 (SHA-256), RFC 6479 (512-bit anti-replay), and 30%-loss encrypted loopback under ASan/UBSan
Continuous libFuzzer Harness fuzz/fuzz_nltp_rx.c — 500,000 mutated frames per CI run (clang -fsanitize=fuzzer,address,undefined) across plaintext/encrypted parsers & in-place LZ4 decompression
MISRA C:2012 Compliance docs/MISRA_C_2012_COMPLIANCE.md — strict ISO C99 (-Wpedantic -Werror), zero heap (-DNLTP_NO_MALLOC), zero floats, acyclic call graph, cppcheck + MISRA C:2012 CI audit
Security & Disclosure Policy SECURITY.md & CONTRIBUTING.md — coordinated disclosure SLA, authenticate-before-decrypt architecture, and contributor gates
Supply-Chain SBOM & Provenance sbom.spdx.json (SPDX 2.3) · sbom.cdx.json (CycloneDX 1.5) + GitHub SLSA Build Provenance attestations & OpenSSF Scorecard

Installation (Arduino, PlatformIO, ESP-IDF, CMake)

1. Espressif ESP-IDF Component Manager (v5.0+)

Published on the official ESP Component Registry (indian-aman/nltp):

idf.py add-dependency "indian-aman/nltp^1.6.0"

Or reference this repository directly in idf_component.yml:

dependencies:
  nltp:
    git: https://github.com/indian-aman/NLTP-Arduino.git
    version: "1.6.0"

2. PlatformIO (platformio.ini)

lib_deps =
    https://github.com/indian-aman/NLTP-Arduino.git#v1.6.0

3. Standalone CMake (Linux / macOS / Windows / Embedded)

cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build
ctest --test-dir build --output-on-failure

About

NLTP v1.6.0 — Loss-healing X25519+PSK ChaCha20-Poly1305 UDP & ESP-NOW v1/v2 transport with GF(2^8) Cauchy FEC, LZ4 compression & 4.76 KB TX-only MCU profile in zero-float C99.

Topics

Resources

Contributing

Security policy

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages