rpp-mesh 0.1.0

RPP Mesh - Consent-aware overlay network extension for RPP

RPP Mesh

Consent-Aware Overlay Network for RPP

RPP Mesh extends the Rotational Packet Protocol with network-level consent enforcement. Instead of checking consent only at the application layer, mesh nodes inspect RPP headers and enforce ACSP states at every hop.

---

Installation

pip install rpp-mesh

For WebSocket support (consent streaming from HNC):

pip install rpp-mesh[websockets]

---

Quick Start

from rpp_mesh import (
    RPPMeshTransport,
    RPPMeshConfig,
    DeploymentConfig,
    DeploymentMode,
    load_config,
)

# Load production config
config = load_config("production")

# Or configure manually
config = DeploymentConfig(
    mode=DeploymentMode.RPP_MESH,
    rpp_mesh=RPPMeshConfig(
        ingress_nodes=["mesh.example.com:7700"],
        consent_update_endpoint="wss://hnc.example.com/consent",
    )
)

# Create transport
transport = RPPMeshTransport(config.rpp_mesh)

# Connect to mesh
await transport.connect()

# Send packet (consent enforced at network level)
response = await transport.send(
    rpp_address=0x0182801,  # shell=0, theta=12, phi=40, harmonic=1
    payload=b"fragment data"
)

await transport.disconnect()

---

Architecture

┌────────┐     ┌─────────┐     ┌─────────┐     ┌─────────┐     ┌────────┐
│ Client │────▶│ Ingress │────▶│ Sector  │────▶│ Consent │────▶│ Portal │
│        │     │  Node   │     │ Router  │     │  Gate   │     │  Host  │
└────────┘     └─────────┘     └─────────┘     └─────────┘     └────────┘
                                    │               │
                              Routes by θ/φ    Enforces ACSP

Node Types

Node	Purpose
Ingress	Entry point, validates headers, routes to sector
Sector Router	Geometric routing by theta/phi ranges
Consent Gate	Enforces ACSP: PASS/DELAY/DROP/FREEZE
Portal Host	Final destination, executes fragments

---

Consent States

State	Action	Description
FULL_CONSENT	PASS	Packet forwarded immediately
DIMINISHED_CONSENT	DELAY	Held, re-checked after backoff
SUSPENDED_CONSENT	DROP	Dropped, logged to SCL
EMERGENCY_OVERRIDE	FREEZE	Alert HNC, quarantine

---

Mesh Header Format

16-byte header prepended to RPP packets:

┌───────┬───────┬───────────────┬─────────────────────────────┐
│ Ver   │ Flags │ Consent State │      Soul ID (16b)          │
│ (4b)  │ (4b)  │    (8b)       │                             │
├───────┴───────┴───────────────┴─────────────────────────────┤
│ Hop Count │  TTL  │ Coherence Hash │      Reserved          │
│   (8b)    │ (8b)  │     (16b)      │        (16b)           │
└───────────┴───────┴────────────────┴─────────────────────────┘

---

Deployment Modes

from rpp_mesh import DeploymentMode, load_config

# Development: Direct connection, no mesh
config = load_config("development")

# Staging: VPN tunnel
config = load_config("staging")

# Production: Full RPP Mesh
config = load_config("production")

---

Requirements

• Python 3.9+
• rpp-protocol >= 0.1.9
• Optional: websockets for HNC consent streaming

---

Documentation

• Full Mesh Specification
• RPP Core Protocol
• PyPI: rpp-protocol

---

License

Apache 2.0

---

Citation

Lennon, A. L. (2025). RPP Mesh: Consent-Aware Overlay Network.
Extension to Rotational Packet Protocol (RPP).
https://github.com/anywave/rpp-spec