io.github.World-999-Labs/proof-layer

السجل الرسمي الذكاء الاصطناعي والوكلاء

Signed, hash-chained provenance receipts for AI agent actions.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @proof-layer/mcp
Claude Code
claude mcp add proof-layer -e 'PROOF_LAYER_API_KEY=<your proof_layer_api_key>' -e 'PROOF_LAYER_API_URL=<PROOF_LAYER_API_URL>' -e 'PROOF_LAYER_TELEMETRY=<PROOF_LAYER_TELEMETRY>' -- npx -y @proof-layer/mcp@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "proof-layer": {
            "command": "npx",
            "args": [
                "-y",
                "@proof-layer/mcp@1.0.1"
            ],
            "env": {
                "PROOF_LAYER_API_KEY": "<your proof_layer_api_key>",
                "PROOF_LAYER_API_URL": "<PROOF_LAYER_API_URL>",
                "PROOF_LAYER_TELEMETRY": "<PROOF_LAYER_TELEMETRY>"
            }
        }
    }
}

متغيرات البيئة

  • PROOF_LAYER_API_KEY إلزامي سري Your Proof Layer API key from https://prooflayer.world999labs.com/dashboard/keys
  • PROOF_LAYER_API_URL Override the default API endpoint (default: https://prooflayer.world999labs.com)
  • PROOF_LAYER_TELEMETRY Set to 'off' to disable anonymous usage telemetry (default: on)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Proof Layer
  2. What this repo contains
  3. Quick start
  4. Why pre-execution governance?
  5. Verifying receipts offline
  6. Resources
  7. License
  8. Contributing

Proof Layer

Cryptographic governance receipts for AI agents. Issued before the agent acts. Ed25519-signed. Hash-chained. Verifiable offline.

Built by WORLD999_LABS. Published on npm under @proof-layer/*. The legacy @veridocs/* package names continue to resolve and forward to the new ones.


What this repo contains

This is the public half of Proof Layer — the parts you install and run on your own machine:

PackageWhat it doesnpm
@proof-layer/mcpMCP server for Claude Desktop, Cursor, Cline, and any MCP-aware host
@proof-layer/verifyStandalone offline verifier — zero dependencies, audits any receipt bundle with just our public key

The kernel (governance engine, Gauntlet adversary/judge pipeline, billing, dashboard) is closed-source and runs at prooflayer.world999labs.com. Open-source clients + closed-source server is the same pattern Stripe, Resend, and Vercel use — you get full transparency on what runs locally and what data leaves your machine, while the proprietary server logic stays protected.


Quick start

npx -y @proof-layer/mcp@latest

Drop into Claude Desktop's claude_desktop_config.json:

{
  "mcpServers": {
    "proof-layer": {
      "command": "npx",
      "args": ["-y", "@proof-layer/mcp@latest"],
      "env": {
        "PROOF_LAYER_API_KEY": "pl_live_...",
        "PROOF_LAYER_API_URL": "https://prooflayer.world999labs.com"
      }
    }
  }
}

Restart Claude. Eight pl_* tools appear in the picker. Get an API key at prooflayer.world999labs.com.

Migrating from @veridocs/mcp? No code changes required. The legacy package name continues to resolve, the legacy vd_* tool names continue to work alongside pl_*, and existing VERIDOCS_API_KEY / VERIDOCS_API_URL environment variables are still accepted. You can switch the package name and env-var names on your own schedule.


Why pre-execution governance?

Most "AI safety" tools run after the model has acted — toxicity filters, output classifiers, post-hoc audit logs. By the time the alarm fires, the agent has already sent the email, merged the PR, or executed the trade.

Proof Layer flips this:

  1. Agent proposes an action (e.g. "send wire transfer for $50,000")
  2. Proof Layer evaluates → returns signed verdict: EXECUTE / BLOCK / REVIEW / SHADOW
  3. Receipt is written to a hash-chained, Ed25519-signed audit trail
  4. Anyone with our public key can verify the entire chain offline — no trust in our infra required

A broken hash chain = tampering, immediately visible. A missing receipt = the agent acted without permission.


Verifying receipts offline

Receipts are designed to outlive us. Here's how to verify a bundle without ever calling our API:

import { verifyBundle } from "@proof-layer/verify";
import fs from "fs";

const bundle = fs.readFileSync("./receipts.ndjson", "utf8");
const publicKey = fs.readFileSync("./prooflayer-public-key.pem", "utf8");

const result = verifyBundle(bundle, publicKey);
console.log(result);
// { pass: 147, fail: 0, total: 147, chainBroken: false }

Public key is published at prooflayer.world999labs.com/v1/public-key and rotates on a published schedule.


Resources


License

MIT — see LICENSE.

The kernel and dashboard are proprietary and not included in this repo. The MCP server, verifier, and all client SDKs published under @proof-layer/* (and the legacy @veridocs/* names) are MIT-licensed.


Contributing

Pull requests, issues, and feedback welcome. See CONTRIBUTING.md.

الأسئلة الشائعة

ما هو io.github.World-999-Labs/proof-layer؟

Signed, hash-chained provenance receipts for AI agent actions.

كيف أثبّت io.github.World-999-Labs/proof-layer؟

يعمل على جهازك. في Claude Code: claude mcp add proof-layer -e 'PROOF_LAYER_API_KEY=<your proof_layer_api_key>' -e 'PROOF_LAYER_API_URL=<PROOF_LAYER_API_URL>' -e 'PROOF_LAYER_TELEMETRY=<PROOF_LAYER_TELEMETRY>' -- npx -y @proof-layer/mcp@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.World-999-Labs/proof-layer إلى مفتاح API؟

نعم. يتطلب PROOF_LAYER_API_KEY، وتضبطها في إعداداته.

هل io.github.World-999-Labs/proof-layer مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.World-999-Labs/proof-layer؟

ينشره World-999-Labs. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.