Merge pull request #55 from commandlayer/codex/add-integration-comments-for-ethglobal-prize-code

Add judge-friendly comments for ENS, verification, and receipt generation in server.mjs

Author: GsCommand

server.mjs

@@ -1013,6 +1013,8 @@ function makeFlowReceiptId() {
 }
 
 function makeReceipt({ execution, result, status = "success", error = null, traceId, receiptId }) {
+  // CommandLayer receipt generation
+  // Wraps an agent verb execution into a signed, verifiable receipt.
   let receipt = {
     status,
     entry: execution.entry,
@@ -1797,6 +1799,8 @@ app.post("/verify", async (req, res) => {
     let ensExpect = null;
 
     if (wantEns) {
+      // ENS signer resolution (VerifyAgent.eth integration)
+      // Resolves cl.sig.pub / cl.sig.kid from the signer ENS name so receipts can be verified without hardcoded keys.
       const signerForEns = String(proof?.signer_id || runtimeConfig.signerId || "").trim();
       const ensOut = await fetchEnsSignerBundle({ signerName: signerForEns, refresh });
 
@@ -1866,7 +1870,8 @@ app.post("/verify", async (req, res) => {
       });
     }
 
-    // 2) verify signature/hash via runtime-core
+    // CommandLayer receipt verification
+    // Rebuilds the canonical receipt hash and verifies the Ed25519 signature.
     let v;
     try {
       v = verifyReceiptEd25519Sha256(runtimeCoreReceipt, {
@@ -1899,6 +1904,8 @@ app.post("/verify", async (req, res) => {
 
     const sigErr = signatureValid ? null : v?.reason || "verify failed";
 
+    // Schema validation for verifiable agent receipts
+    // Confirms receipt structure matches the declared CommandLayer schema.
     // 3) schema validation (optional + edge-safe)
     let schemaOk = null;
     let schemaErrors = null;