# HZB documentation examples / 文档示例

These files are local educational fixtures, not an HZB SDK, production API, model, audit tool or HIVM implementation.
这些文件只用于理解接入流程，不是 HZB 正式 SDK、线上 API、真实模型、安全审计工具或 HIVM 实现。

1. Install Node.js 20 or newer. Save hzb-demo-server.mjs and a client locally.
2. In terminal A: `node hzb-demo-server.mjs` (listens only on 127.0.0.1:8787).
3. In terminal B: `node hzb-client.mjs`, or `python hzb-client.py` (Python 3.9+).
4. Stop the server with Ctrl+C when finished.

The public example key is `local-demo-key`. It is not a credential for any real service.
Only read/analyze tasks with external_writes=false are accepted. Output is a deterministic checklist fixture, not analysis of your source.
The example makes no outgoing requests, never accesses wallets, and never executes transactions. Use non-sensitive sample data.

Routes: GET /health; GET /v1/models; POST /v1/tasks.
The latter two require Authorization: Bearer local-demo-key. POST also requires Content-Type: application/json and Idempotency-Key.
Exact repeated bodies with the same key replay the same task receipt. A changed body that passes input and permission checks returns 409 when reusing a key; invalid tasks or permissions are rejected first. The in-memory store resets on restart and caps at 100 entries.
The example request limit is 64 KiB. These are demo implementation limits, not HZB production quotas or a public API contract.

task-request.json is the local HTTP example format. hivm-plan.json and ../templates/task-spec.json are separate conceptual architecture formats; do not interchange them.