REST API Reference

Complete documentation for all Yakmesh REST endpoints.

GET /api/status

Returns node health and network status.

Response

{
  "status": "healthy",
  "networkName": "Alpine-Falcon-7x",
  "trustLevel": "oracle",
  "connectedPeers": 3,
  "currentPhase": 847392,
  "uptime": 3600
}
GET /api/identity

Returns node identity information.

{
  "peerId": "abc123...",
  "publicKey": "ML-DSA-65 public key...",
  "networkName": "Alpine-Falcon-7x",
  "created": "2026-01-13T10:00:00Z"
}
GET /api/peers

Lists all connected peers.

{
  "peers": [
    { "peerId": "xyz789...", "networkName": "Mountain-Eagle-3k", "latency": 45 },
    { "peerId": "def456...", "networkName": "Glacier-Wolf-9p", "latency": 120 }
  ],
  "count": 2
}
GET /api/time

Returns current time source information.

{
  "source": "ptp",
  "device": "Meinberg PTP270PEX",
  "accuracy": "±100ns",
  "timestamp": 1736766000000,
  "phase": 847392
}
GET /api/oracle/phase

Returns current phase epoch information.

{
  "phase": 847392,
  "phaseStart": 1736766000000,
  "phaseEnd": 1736766030000,
  "fingerprint": "8f3a9c2b...",
  "window": 30000
}
POST /api/gossip/broadcast

Broadcasts a message to all connected peers.

Request Body

{
  "type": "custom",
  "payload": { "key": "value" }
}

Response

{
  "messageId": "msg_abc123",
  "recipients": 3,
  "timestamp": 1736766000000
}