@commandlayer/agent-sdk

Wrap your agent. Emit a signed receipt. Verify through CommandLayer.

@commandlayer/agent-sdk is a minimal Node-first TypeScript SDK for generating signed receipts from ENS-named agents and verifying them with the public CommandLayer verifier.

Install

npm install @commandlayer/agent-sdk

Wrap your agent

wrap() returns { output, receipt }; receipt is signed.

import { CommandLayer } from "@commandlayer/agent-sdk";

const cl = new CommandLayer({
  agent: process.env.CL_AGENT ?? "runtime.commandlayer.eth",
  privateKey: process.env.CL_PRIVATE_KEY_PEM,
  keyId: process.env.CL_KEY_ID ?? "vC4WbcNoq2znSCiQ"
});

const result = await cl.wrap("summarize", async () => {
  return { summary: "hello world" };
});

console.log(result.output);
console.log(result.receipt);

const verified = await cl.verify(result.receipt);
console.log(verified.status);

wrap() returns both:

• output: the value returned by your agent function
• receipt: the signed CommandLayer receipt for that action

The receipt includes the ENS signer identity and proof metadata required for independent verification.

This signs the agent action with its ENS identity and verifies it through the public CommandLayer verifier.

runtime.commandlayer.eth is the demo signer. Developers must replace it with their own ENS name and key (CL_AGENT, CL_KEY_ID, and CL_PRIVATE_KEY_PEM).

Verifier references:

• UI verifier: https://www.commandlayer.org/verify.html
• API verifier: https://www.commandlayer.org/api/verify

Private key must be a valid Ed25519 PKCS#8 PEM. Invalid formats will fail during import.

Full proof demo

npm run example:demo

This runs an agent action, emits a signed receipt, verifies it, tampers with the output, and verifies again to show INVALID.

Builder integration examples

All examples are dependency-free TypeScript and use:

• CL_PRIVATE_KEY_PEM
• CL_KEY_ID
• CL_AGENT (defaults to runtime.commandlayer.eth)

Examples by builder type:

• Agent frameworks
  • examples/basic-agent.ts
  • examples/langchain-agent.ts
• Tool/function calling
  • examples/openai-tool-wrapper.ts
• Workflow automation
  • examples/workflow-job-runner.ts
• Multi-agent systems
  • examples/agent-to-agent-verify.ts
• Existing agent integration
  • examples/existing-agent-integration.ts

Run them after build:

npm run example:basic
npm run example:wrapped
npm run example:tool
npm run example:langchain
npm run example:workflow
npm run example:a2a
npm run example:existing

See also: docs/examples.md.

Already have an agent?

CommandLayer wraps the boundary around the action so your agent keeps its existing logic. The SDK emits a signed receipt tied to the agent’s ENS identity that can be verified publicly.

const result = await cl.wrap("agent.execute", async () => existingAgent.run(input));

const verified = await cl.verify(result.receipt);

Development

npm test

License

MIT