REST API Reference

Returns node health and network status.

Response

{
  "status": "ok",
  "nodeId": "a7f3b2c1e8d9...",
  "peers": 3,
  "algorithm": "ML-DSA-65",
  "network": {
    "name": "mobius-rabi-junction",
    "id": "pq-g1b6"
  }
}

Returns node identity information.

{
  "nodeId": "a7f3b2c1e8d9...",
  "name": "My YAKMESH Node",
  "region": "local",
  "algorithm": "ML-DSA-65",
  "nistLevel": 3,
  "publicKey": "3082...",
  "createdAt": "2026-01-17T10:00:00.000Z"
}

Lists all connected peers.

[
  {
    "nodeId": "b8e4c3f2a1d7...",
    "name": "Peer Node 1",
    "endpoint": "wss://peer1.example.com:9001",
    "lastSeen": 1737100000000
  },
  {
    "nodeId": "c9f5d4e3b2a8...",
    "name": "Peer Node 2",
    "endpoint": "inbound",
    "lastSeen": 1737100005000
  }
]

Returns network identity (derived from codebase hash, never exposing the hash).

{
  "name": "mobius-rabi-junction",
  "id": "pq-g1b6",
  "fingerprint": "8f3a9c2b...",
  "verificationPhrase": "The tier fermion reflects the create public"
}

Returns oracle status and self-integrity verification.

{
  "status": "healthy",
  "integrity": { "valid": true },
  "networkFingerprint": "8f3a9c2b...",
  "networkName": "mobius-rabi-junction",
  "networkId": "pq-g1b6",
  "validationMethods": ["hashContent", "verify", "seal"],
  "verifiedPeers": []
}

Spreads a rumor to connected peers via gossip protocol.

Request Body

{
  "topic": "custom_event",
  "data": { "key": "value" }
}

Response

{
  "success": true,
  "messageId": "msg_a7f3b2c1"
}

Returns SHERPA discovery service status and beacon information.

{
  "enabled": true,
  "beacon": {
    "nodeId": "a7f3b2c1e8d9...",
    "endpoint": "wss://node.example.com:9001",
    "lastBroadcast": 1737200000000
  },
  "discoveredPeers": 12,
  "beaconAge": "3d 4h 12m"
}

Returns list of discovered peer candidates for connection.

[
  {
    "nodeId": "b8e4c3f2a1d7...",
    "endpoint": "wss://peer1.example.com:9001",
    "karmaTier": "sathi",
    "lastSeen": 1737200000000
  }
]

Returns STUPA replication statistics.

{
  "status": "healthy",
  "peers": 5,
  "pendingSyncs": 0,
  "lastSync": 1737200000000,
  "replicatedItems": 1247
}

Stores data in the local node (rate limited).

Request Body

{
  "key": "my-content-key",
  "value": "content to store",
  "ttl": 86400
}

Response

{
  "success": true,
  "hash": "sha3-256-hash..."
}

Returns current MANI time synchronization status.

{
  "source": "ntp",
  "trustLevel": "yatri",
  "offset": 0.003,
  "timestamp": 1737200000000,
  "synced": true
}

Returns all saved YAK:// protocol bookmarks.

[
  {
    "name": "my-docs",
    "uri": "yak://docs.yakmesh/",
    "createdAt": 1737200000000
  }
]

Serves embedded documentation bundle (SHA3-256 verified).

// Returns HTML documentation
// Bundle hash: 17ccf7d033f25b9de...
// 56 files, ~736 KB total