JAMNP-S (tracking issue)

[emielsebastiaan]

Objectives

Implementation of preliminary specification of JAMNP-S (JAM Simple Networking Protocol) based on QUIC.

Sources:

https://hackmd.io/@polkadot/jamsnp (d.d. 2024-08-24)
https://github.com/zdave-parity/jam-np/blob/main/simple.md (d.d. 2025-12-11)

Implementation

M1 Features (MVP)

• MVP (JAMSNP - MVP #87)

M2 Features (Full)

• Handshake (TLS)
• Signatures (Ed25519)
• Alternative Name
• APLN
• Connectivity
• Epoch Transitions
• Unique Persistent Streams (UP)
• Common Ephemeral Streams (CE)
• General Messages
• Common Types
• Grid Structure

Messages & Integration

• UP 0: Block announcement
  • Implementation
  • Integration
• CE 128: Block request
  • Implementation
  • Integration
• CE 129: State request
  • Implementation
  • Integration
• CE 131/132: Safrole ticket distribution
  • Implementation
  • Integration
• CE 133: Work-package submission
  • Implementation
  • Integration
• CE 146: Work-package bundle submission (NEW)
  • Implementation
  • Integration
• CE 134: Work-package sharing
  • Implementation
  • Integration
• CE 135: Work-report distribution
  • Implementation
  • Integration
• CE 136: Work-report request (and Shard Assignment)
  • Implementation
  • Integration
• CE 137: Shard distribution
  • Implementation
  • Integration
• CE 138: Audit shard request
  • Implementation
  • Integration
• CE 147: Bundle request (NEW)
  • Implementation
  • Integration
• CE 139/140: Segment shard request
  • Implementation
  • Integration
• CE 148: Segment request (NEW)
  • Implementation
  • Integration
• CE 141: Assurance distribution
  • Implementation
  • Integration
• CE 142: Preimage announcement
  • Implementation
  • Integration
• CE 143: Preimage request
  • Implementation
  • Integration
• CE 144: Audit announcement
  • Implementation
  • Integration
• CE 145: Judgment publication
  • Implementation
  • Integration

Known Issues/Challenges

• Self Signed Certificates (JAMNP-S - Self Signed Certificates #90)
• Client Certificate Check (JAMNP-S - Client Certificate Check #81)
• Automatic Reconnect (JAMNP-S - Automatic Reconnect #120)

Quality Assurance

• Passes Updated JDT Unit Tests
• Passes Updated W3F Test Vectors
• Runs Local Testnet
• Passes Full Team Code Review
• Documented Non-Blocking Suggestions for Follow-up
• Updated all Graypaper References with correct version