Skip to content

commandlayer/verifyagent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VerifyAgent

VerifyAgent.eth is the public verifier for receipts produced by ENS-named agents.

VerifyAgent is the reference verifier: paste or submit a receipt, resolve signer identity and verification metadata from ENS, recompute the canonical hash, verify Ed25519 signatures, and return a clear VERIFIED or INVALID result.

Links

Install the SDK

npm install @commandlayer/agent-sdk

Canonical flow

  • @commandlayer/agent-sdk creates a signed receipt.
  • VerifyAgent verifies the signed receipt.
  • A tampered signed receipt returns INVALID.

Verification flow

  1. Agent executes an action.
  2. @commandlayer/agent-sdk emits a signed receipt.
  3. VerifyAgent resolves signer identity and verification metadata from ENS (cl.sig.pub, cl.sig.kid, cl.sig.canonical, cl.receipt.signer).
  4. VerifyAgent canonicalizes + hashes payload, then verifies Ed25519 signature.
  5. Result is VERIFIED or INVALID with explicit checks.

Scope

VerifyAgent is a verification surface and reference verifier implementation. It does not create receipts.

Run locally

npm install
npm run dev

Open: http://localhost:4173/verify.html

Sample and tamper checks

  • Load Sample verifies a real signed receipt.
  • Load Tampered changes output while keeping original hash/signature to demonstrate tamper detection.
  • examples/sample-receipt.json verifies as VERIFIED.
  • examples/tampered-receipt.json verifies as INVALID.

Canonical values

  • signer: runtime.commandlayer.eth
  • key id: vC4WbcNoq2znSCiQ
  • canonicalization: json.sorted_keys.v1
  • signature algorithm: ed25519

ENS signer records

Known signer records for runtime.commandlayer.eth:

  • cl.receipt.signer = runtime.commandlayer.eth
  • cl.sig.kid = vC4WbcNoq2znSCiQ
  • cl.sig.pub = ed25519:hhyCuPNoMk4JtEvGEV8F6nMZ4uDO1EcyizPufmnJTOY=
  • cl.sig.canonical = json.sorted_keys.v1

VerifyAgent resolves signer keys from ENS TXT records. Fallback is a local demo fallback for runtime.commandlayer.eth only, mirroring the ENS record structure. The verification flow is designed to operate against live ENS records.

VerifyAgent.eth is designed to be discoverable as a verifier for ENS-named agents, enabling independent verification across agent ecosystems.

About

VerifyAgent.eth — public verifier for CommandLayer agent receipts

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors