Developers

Build on MossyMesh

Rust monorepo, deterministic WASM jobs, identity-routed transport, and an OpenAPI interop surface. Product brand is MossyMesh; the chess proof-of-concept is MessyMash.

Repository OpenAPI API v1

Contribute

How to get started

Prefer small, SLA-preserving changes. Crypto or memory allocation changes need written proof that the ≤10 MB ledger and <1% unverifiable SLAs still hold.

Clone & explore

Start from github.com/movahedi-ca/MossyMesh. Read README.md, docs/sla-and-dod.md, and docs/interface-contracts.md.

git clone https://github.com/movahedi-ca/MossyMesh.git
cd MossyMesh
# Workspace crates: mesh-transport, sandbox, consensus, engine, interop, …

Pick a phase-aligned crate

Phase 1 transport modules, Phase 2 sandbox/VDF, Phase 3 ledger/CRDT, Phase 4 engine/HTLC, Phase 5 OpenAPI gateway — sequential DoDs are documented in docs/sla-and-dod.md.

Respect interface contracts

Cross-crate messages stay behind documented surfaces (JobEnvelope, VdfProof, ExecutionResult, …). Prefer mocks until the producer crate is ready; breaking changes need architect sign-off.

Test & open a PR

Run crate unit tests and any integration smoke paths. Link SLA impact if you touch memory limits, VDF, VRF assignment, or proof sizes. Use issues for design discussion when in doubt.

Stack

Technical layers

Layer	Core technologies	Guardrails
Frontend	React, TypeScript, Vite, vite-plugin-pwa	Offline PWA via captive portal; large asset transfers
Application	Rust, shakmaty, shakmaty-syzygy, yrs	Deterministic chess + CRDT merge
Sandbox	WAMR (wasm32-wasip1), WASI	10 MB MEM_LIMIT; fixed-block pools; static INT8
Transport	reticulum-rs, lxmf-rs, Kademlia DHT	Identity routing; LoRa / BLE light paths
Ledger	trie-db, ipld-core, serde_ipld_dagcbor	Compact DAG-CBOR; ≤10 MB active set
Proofs	nova-snark	Constant-size folding over Pallas/Vesta
AI	SITF, Edge PagedAttention, Vulkan	Deterministic high-compute tiers
Interop	OpenAPI gateway, HTLC, TWAMM	2% max spread; online only when reconnected

Machine-readable docs

OpenAPI & JSON API

Marketing facts and gateway contracts are available without scraping HTML.

OpenAPI specification

Full public gateway surface for mesh interop (health, jobs, TWAMM, liquidity, gateway control).

/openapi.yaml

Versioned JSON under /api/v1/

Static CDN-friendly documents for project metadata, health, phases, and stack.

/api/v1/
/api/v1/project.json

Human overview of endpoints lives on the API page. CORS is intended as Access-Control-Allow-Origin: * on /api/*.

Quality protocol

What the mesh enforces

VRF assignment

3 primary + 2 standby workers; battery-curve and thermal-aware routing (deprioritize CPUs >75°C).

Free-rider prevention

Cryptographic hash chains of WASM execution traces prove computation, not mere forwarding.

Hardware quarantine

Statistical anomaly detection; three fails → 1-hour diagnostic benchmark for silent decay.

Sybil resistance

Memory-hard MinRoot VDF (x → x^1/5 mod p) gates ephemeral Job DIDs — parallel ASICs do not skip sequential work.