Skip to content

Agent Mesh

feat(warm-pool): add HMAC lease-token mint/verify module

Tomas Tormo827249959cd0
diff --git a/development/examples/code-reviewer-pool/manager/lease-token.mjs b/development/examples/code-reviewer-pool/manager/lease-token.mjs
new file mode 100644
index 00000000..c9b92e12
--- /dev/null
+++ b/development/examples/code-reviewer-pool/manager/lease-token.mjs
@@ -0,0 +1,24 @@
+import { createHmac, timingSafeEqual } from "node:crypto";
+
+// Signed bearer lease token: `${peerId}.${exp}.${sig}`, sig = HMAC-SHA256(secret, `${peerId}.${exp}`).
+// exp is epoch-ms; the token is valid while now < exp. Shared verbatim by manager and reviewer.
+
+export function mintToken(secret, peerId, exp) {
+ const payload = `${peerId}.${exp}`;
+ const sig = createHmac("sha256", secret).update(payload).digest("hex");
+ return `${payload}.${sig}`;
+}
+
+export function verifyToken(secret, token, now) {
+ if (typeof token !== "string") return { valid: false };
+ const parts = token.split("."); // peer ids are base58 (no dots), sig is hex → exactly 3 parts
+ if (parts.length !== 3) return { valid: false };
+ const [peerId, expStr, sig] = parts;
+ const expected = createHmac("sha256", secret).update(`${peerId}.${expStr}`).digest("hex");
+ const a = Buffer.from(sig);
+ const b = Buffer.from(expected);
+ if (a.length !== b.length || !timingSafeEqual(a, b)) return { valid: false };
+ const exp = Number(expStr);
+ if (!Number.isFinite(exp) || now >= exp) return { valid: false };
+ return { valid: true, peerId, exp };
+}
diff --git a/development/examples/code-reviewer-pool/reviewer/lease-token.mjs b/development/examples/code-reviewer-pool/reviewer/lease-token.mjs
new file mode 100644
index 00000000..c9b92e12
--- /dev/null
+++ b/development/examples/code-reviewer-pool/reviewer/lease-token.mjs
@@ -0,0 +1,24 @@
+import { createHmac, timingSafeEqual } from "node:crypto";
+
+// Signed bearer lease token: `${peerId}.${exp}.${sig}`, sig = HMAC-SHA256(secret, `${peerId}.${exp}`).
+// exp is epoch-ms; the token is valid while now < exp. Shared verbatim by manager and reviewer.
+
+export function mintToken(secret, peerId, exp) {
+ const payload = `${peerId}.${exp}`;
+ const sig = createHmac("sha256", secret).update(payload).digest("hex");
+ return `${payload}.${sig}`;
+}
+
+export function verifyToken(secret, token, now) {
+ if (typeof token !== "string") return { valid: false };
+ const parts = token.split("."); // peer ids are base58 (no dots), sig is hex → exactly 3 parts
+ if (parts.length !== 3) return { valid: false };
+ const [peerId, expStr, sig] = parts;
+ const expected = createHmac("sha256", secret).update(`${peerId}.${expStr}`).digest("hex");
+ const a = Buffer.from(sig);
+ const b = Buffer.from(expected);
+ if (a.length !== b.length || !timingSafeEqual(a, b)) return { valid: false };
+ const exp = Number(expStr);
+ if (!Number.isFinite(exp) || now >= exp) return { valid: false };
+ return { valid: true, peerId, exp };
+}
diff --git a/development/examples/code-reviewer-pool/reviewer/lease-token.test.mjs b/development/examples/code-reviewer-pool/reviewer/lease-token.test.mjs
new file mode 100644
index 00000000..c1eb36c3
--- /dev/null
+++ b/development/examples/code-reviewer-pool/reviewer/lease-token.test.mjs
@@ -0,0 +1,35 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { mintToken, verifyToken } from "./lease-token.mjs";
+
+const SECRET = "test-secret";
+const PEER = "12D3KooWabc";
+
+test("mint then verify round-trips before expiry", () => {
+ const token = mintToken(SECRET, PEER, 10_000);
+ const r = verifyToken(SECRET, token, 5_000);
+ assert.equal(r.valid, true);
+ assert.equal(r.peerId, PEER);
+ assert.equal(r.exp, 10_000);
+});
+
+test("rejects a tampered signature", () => {
+ const token = mintToken(SECRET, PEER, 10_000);
+ const bad = token.slice(0, -1) + (token.endsWith("a") ? "b" : "a");
+ assert.equal(verifyToken(SECRET, bad, 5_000).valid, false);
+});
+
+test("rejects the wrong secret", () => {
+ const token = mintToken(SECRET, PEER, 10_000);
+ assert.equal(verifyToken("other-secret", token, 5_000).valid, false);
+});
+
+test("rejects an expired token", () => {
+ const token = mintToken(SECRET, PEER, 10_000);
+ assert.equal(verifyToken(SECRET, token, 10_000).valid, false);
+});
+
+test("rejects malformed or missing tokens", () => {
+ assert.equal(verifyToken(SECRET, "garbage", 5_000).valid, false);
+ assert.equal(verifyToken(SECRET, undefined, 5_000).valid, false);
+});