SDKs & Integrations

Quick installation

@lyhna/bind is a project dependency. Install it inside your Node project with npm install @lyhna/bind. Do not install it globally.

Quick start

Direct SDK — bind() without the loop (advanced)

@lyhna/bind is the underlying primitive: one authorization, one signed receipt. Use it when you are integrating the gate into your own runtime rather than wrapping an MCP server. This path ends at a receipt, not the capsule trio — for the loop-and-trio path, start from the quickstart.

1. Inside your Node project: npm install @lyhna/bind (project dependency, not global).
2. The SDK is ESM-only. If your project was initialized as CommonJS, run npm pkg set type=module first.
3. Set LYHNA_API_KEY, call bind() before execution, obey the outcome.
4. Verify any single receipt offline: npx -y lyhna-verify --receipt receipt.json.

How bind() works

1. 1
   Action declared — Your agent declares what it intends to do, under what intent.
2. 2
   Tier resolved — The enforcement engine looks up the action in your authority rules table. Deterministic — no inference.
3. 3
   Policy evaluated — Tier policy determines outcome: auto-approve, standard review, or authorize-all.
4. 4
   Receipt signed — Ed25519 signed receipt produced. Append-only. Verifiable offline. Contains action hash, tier, outcome, timestamp.
5. 5
   License returned — APPROVED, REFUSED, or ESCALATED. No APPROVED receipt, no execution. Fail-closed.

Six Invariants