POST /api/v1/agent/init

Initialize an agent beat chain. Idempotent.

Auth: Authorization: Bearer pvn_...


curl -X POST https://provenonce.io/api/v1/agent/init \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer pvn_..." \
  -d "{}"

Response (first init)


{
  "ok": true,
  "agent_hash": "0x...",
  "genesis": {
    "index": 0,
    "hash": "346001...",
    "prev": "0000...",
    "timestamp": 1771221182082
  },
  "difficulty": 1000,
  "status": "active",
  "_next_steps": {
    "purchase_sigil": "POST /api/v1/sigil",
    "heartbeat": "POST /api/v1/agent/heartbeat",
    "spawn_children": "POST /api/v1/agent/spawn",
    "check_status": "GET /api/v1/agent/beat-status/:hash"
  }
}

Response (already initialized)


{
  "ok": true,
  "already_initialized": true,
  "agent_hash": "0x...",
  "genesis_hash": "392425...",
  "total_beats": 1200,
  "latest_hash": "e0158e...",
  "latest_beat": 2200,
  "status": "active"
}

Notes

This endpoint initializes the local beat chain state only.
Registration remains DB-first.
Paid routes (/api/v1/sigil, /api/v1/agent/heartbeat, /api/v1/agent/reissue-proof) are BYO-wallet gated by default in production.