tool.meshservice/docs/status.md

MeshService Status

Overview

Generic decentralized service layer for mesh networks.

Crate: meshservice
Version: 0.1.0
Status: ✅ Core complete, ready for integration

Completed

• Core message types (ServiceMessage, MessageType)
• Identity management (ServiceIdentity with Ed25519)
• Wire protocol (64-byte header + CBOR payload)
• Message store with eviction policies
• Service router with pluggable handlers
• Verification framework (3 levels)
• FAPP service (psychotherapy appointments)
• Housing service (room/apartment sharing)
• 32 passing unit tests
• 3 working examples

Architecture

ServiceMessage → ServiceRouter → ServiceHandler → ServiceStore
                      ↓
              TrustedVerifiers

File Structure

src/
├── lib.rs          # Crate root, service IDs, capabilities
├── identity.rs     # Ed25519 key management
├── message.rs      # ServiceMessage, MessageType
├── router.rs       # ServiceRouter, ServiceHandler trait
├── store.rs        # In-memory store with eviction
├── verification.rs # Trust levels, TrustedVerifiers
├── wire.rs         # Binary encoding/decoding
├── error.rs        # Error types
└── services/
    ├── mod.rs
    ├── fapp.rs     # FAPP implementation
    └── housing.rs  # Housing implementation
examples/
├── fapp_service.rs
├── housing_service.rs
└── multi_service.rs

Integration Points

With quicprochat-p2p

The MeshService layer sits above the transport layer. Integration:

1. Receive raw bytes from mesh transport
2. wire::decode() to get ServiceMessage
3. router.handle() returns ServiceAction
4. On StoreAndForward, re-broadcast via transport

Custom Services

1. Define payload structs (serde + CBOR)
2. Implement ServiceHandler trait
3. Register with router: router.register(Box::new(MyService))

Next Steps

• Integration with quicprochat-p2p transport
• Service discovery protocol
• Encrypted reservation flow (E2E)
• Persistent storage backend
• Rate limiting per sender

Metrics

Metric	Value
Lines of Code	~2000
Tests	32
Examples	3
Dependencies	10