my_router_path

What this is

A HeroLib-based HTTP server providing a JSON-RPC 2.0 interface for routing through a supernode mesh network. Built with Rust 1.92+ and Edition 2024, it handles edge registration, heartbeat, lookup, supernode link reporting, route finding, graph visualization, and benchmarking across a distributed network topology.

What this repository contains

• src/main.rs — Server entry point with HTTP, JSON-RPC /rpc, and MCP /mcp endpoints
• src/lib.rs — Library root exposing config, RPC, types, crypto, state, storage, routing, precompute, API, MCP, handlers, and logging modules
• src/handlers.rs — HTTP fragment handlers for UI visualization
• src/precompute.rs — Background precomputation task for routing optimization
• src/types.rs — Core type definitions
• src/config.rs — Server configuration
• src/state.rs — Application state management
• src/logging.rs — Structured logging utilities
• tests/ — Integration, routing, and storage tests
• Cargo.toml — Workspace manifest with root package and my_client crate
• Makefile — Build targets for development and release
• schemas/models.oschema — OSchema type definitions

Build & Run

# Development mode (debug)
make rundev

# Release mode
make run

Test the server:

curl http://localhost:2918/health | jq

Available Make Targets

• make build — Build release binary
• make rundev — Run in development mode (with debug logs)
• make run — Run release binary
• make test — Run all tests
• make clean — Clean build artifacts
• make check — Run cargo check
• make fmt — Format code with rustfmt
• make clippy — Run clippy linter

Dependencies

• axum — HTTP framework
• tokio — Async runtime
• serde/serde_json — Serialization
• ed25519-dalek — Cryptographic node identity
• askama — HTML templating
• tower-http — CORS and middleware
• parking_lot / rayon — Concurrency

Role in the stack

This component provides the routing backbone for the Mycelium mesh network, enabling supernodes to report links, edges to register and heartbeat, and consumers to find optimal routes through the network. It exposes both a JSON-RPC API and an HTML UI for visualization and administration.

Relation to ThreeFold

This technology is used within the ThreeFold ecosystem and was first deployed on the ThreeFold Grid. The component itself is designed as reusable infrastructure technology and should be understood by its technical function first, independent of any specific deployment.

Ownership

This repository is owned and maintained by TF-Tech NV, a Belgian company responsible for the development and maintenance of this technology.

License

This project is licensed under the Apache License 2.0 — see the LICENSE file for details.