ShAir ⬡ Node Console

🜛

SHAIR ⬡ NODE CONSOLE

decentralized air quality · clean air is a human right · made verifiable

NODE shair-node-001 · SPEC

⬡ SPEC-STAGE INSTRUMENT — built from the product README (architecture · API · hardware · data-sovereignty framework). The console below runs the ingestion pipeline as an interactive flow with the spec's own WS message format. Readings shown are deterministic spec samples, labeled as such — no sensor hardware is attached in this build, no fake live claims. AQI is computed by the real US-EPA formula from the demo payload.

PM2.5 (µg/m³)

—

CO₂ (ppm)

—

signature —

US-EPA AQI

—

computed real formula

READINGS SIGNED

—

→ sqlite · ./data/shair.db

LAST WS FRAME — verbatim spec format

awaiting first demo reading…

PM2.5 — LAST 24 DEMO READINGS

Data Sovereignty

Tikkun Olam framework · verbatim

1 · Ownership

Data belongs to the node operator. Communities own, verify, and monetize their environmental data.

2 · Consent

Explicit opt-in for marketplace listing. Nothing is shared without the operator's choice.

3 · Compensation

Revenue share from data purchases — contributors get paid when their data is bought.

4 · Portability

Full export in open formats (CSV, JSON). No lock-in.

5 · Deletion

Right to purge historical data. Sovereignty includes the right to be forgotten.

Pipeline Architecture

README verbatim · sensor → gateway → marketplace

SENSOR NODE

ESP32 / RPi · PMS5003 · SCD30 · SGP30 · BME280 · local OLED/e-Ink display

→

SHAIR GATEWAY

Rust backend · ingest pipeline · cryptographic signing at ingestion · REST + WebSocket API

→

DATA MARKETPLACE

CSM-powered · consent-gated listing · revenue share · analytics & visualization

OriginBlock Timestamping

Every reading is timestamped on the lineage ledger — provenance for the physical world.

Immutable Storage

IPFS / Arweave integration for immutable historical data; sqlite/postgres for local node state.

Real-time Streaming

WebSocket API (ws://localhost:8080/ws) for live monitoring dashboards.

API Surface

README verbatim · REST + WS

METHOD	ENDPOINT	DESCRIPTION
GET	/health	Health check
GET	/readings/latest	Most recent reading
GET	/readings/history?hours=24	Historical data
POST	/readings/ingest	Submit new reading (signed)
GET	/node/info	Node metadata
WS	ws://localhost:8080/ws	Real-time updates · {type:"reading", payload:{timestamp, pm25, pm10, co2, temperature, humidity}}

Hardware Compatibility

README verbatim

SENSOR	PROTOCOL	STATUS	MEASURE
PMS5003	UART	✅ TESTED	PM2.5 / PM10
SCD30	I2C	✅ TESTED	CO₂
SGP30	I2C	✅ TESTED	VOC
BME280	I2C/SPI	✅ TESTED	Temp / Humidity
CCS811	I2C	⚠ IN PROGRESS	VOC / eCO₂

Node Config

shair.toml · README verbatim

[node] id = "shair-node-001" location = { lat = 36.1627, lon = -86.7816 } # Nashville [sensors] pm25 = true pm10 = true co2 = true voc = false [storage] backend = "sqlite" # or "postgres", "ipfs" path = "./data/shair.db" [api] port = 8080 cors_origins = ["http://localhost:3000"]

Roadmap

README verbatim

Q3 2026

Multi-node mesh networking · solar-powered deployment kit · mobile app (React Native)

Q4 2026

CSM marketplace integration · automated EPA compliance reporting · grant-writing automation for community deployments

2027

Satellite backhaul · AI pollution-source detection · global target: 10,000 nodes

🜛 SHAIR — communities own, verify, and monetize their environmental data. MIT License.
Instrument: interactive prototype of the README architecture — pipeline flow, signing, storage backends, and the verbatim WS message format. Demo readings are deterministic and labeled; AQI computed with the real US-EPA formula. No fake live claims: sensors attach when hardware deploys.
⬡ Part of the Tikkun Olam mission — SoulTech Systems / Royalty Investment Company. Built by Pharaoh. · Project Lead: [email protected]