@rodit/rodit-auth-be 9.15.0 → 9.16.2

package/CHANGELOG.md

@@ -2,6 +2,36 @@
 
 All notable changes to `@rodit/rodit-auth-be` are documented here.
 
+## [9.16.2] — 2026-09-19
+
+### Fixed
+
+- **`send_webhook` URL join:** append `endpoint` (e.g. `/hooks/wake`) only when
+  peer `webhook_url` / `rodit_webhookurl` has no path. A URL that already
+  includes a path (e.g. `host:7443/hooks/agent`) is used as-is, so paths are
+  no longer doubled.
+
+## [9.16.1] — 2026-09-18
+
+### Changed
+
+- **Docs:** Clarify that peer `webhook_url` / `rodit_webhookurl` is a base
+  (`host` or `host:port` only). The SDK appends the endpoint path; including
+  `/hooks/wake` or `/hooks/agent` in the metadata doubles the path.
+
+## [9.16.0] — 2026-09-14
+
+### Removed
+
+- **`verify_rodit_isactive`** — DNS TXT revocation check
+  (`<token_id>.revoked.<domain>`). The function short-circuited with an
+  unconditional `return true` while debugging, so its body was unreachable and
+  no RODiT could be rejected as revoked. Removed along with its call sites in
+  `verify_peer_rodit` and `thorough_validate_jwt_token_be`, and the
+  `RODIT_REVOKED` / `SERVER_RODIT_REVOKED` failure codes they emitted.
+  No behavior change; the SDK now has no revocation check.
+  `verify_rodit_isactive_fe` in `@rodit/rodit-auth-fe` is unaffected.
+
 ## [9.15.0] — 2026-08-11
 
 ### Added

package/README.md

@@ -1,10 +1,22 @@
-# RODiT Authentication SDK
+# @rodit/rodit-auth-be
 
-A comprehensive Node.js SDK for implementing RODiT-based mutual authentication, authorization, self-configuration, and session management in Express.js applications.
+Node.js / Express SDK for RODiT-based mutual authentication, authorization, session management, and webhooks.
 
-**Version:** 9.15.0  
-**License:** Proprietary  
-**Author:** Discernible IO
+**npm:** [https://www.npmjs.com/package/@rodit/rodit-auth-be](https://www.npmjs.com/package/@rodit/rodit-auth-be)  
+**Monorepo:** [discernible-io/rodit-sdk](https://github.com/discernible-io/rodit-sdk) (this directory)  
+**Version:** 9.16.2 · **License:** Proprietary · **Author:** Discernible IO
+
+## Production deployments
+
+This package is the server runtime behind RODiT-powered APIs, including:
+
+| Deployment | Role |
+|------------|------|
+| [api.identyclaw.com](https://api.identyclaw.com) | IdentyClaw platform API ([source: api-idc](https://github.com/discernible-io/api-idc)) |
+| [api.lastcradle.io](https://api.lastcradle.io) | Last Cradle family API |
+| Custom / federated APIs | Same SDK; sibling APIs in one token family support [federated login](#federated-login-same-family-different-api-url) |
+
+Browser and wallet clients for these APIs use the companion package [`@rodit/rodit-auth-fe`](https://www.npmjs.com/package/@rodit/rodit-auth-fe).
 
 **Login `POST` /api/login:** Use **`accountid`** (or **`roditid`**), **`timestamp`**, and **`base64url_signature`**. Sign UTF-8 bytes of `identifier + timestamp_iso`, and reject deprecated keys such as **`signature`** and **`account_id`**. See [CHANGELOG.md](./CHANGELOG.md).
 
@@ -1185,7 +1197,7 @@ const jwtDuration = metadata.jwt_duration;  // JWT expiration time
 const maxRequests = metadata.max_requests;  // Rate limit
 const maxRqWindow = metadata.maxrq_window;  // Rate limit window
 const apiEndpoint = metadata.subjectuniqueidentifier_url;  // API URL
-const webhookUrl = metadata.webhook_url;  // Webhook endpoint
+const webhookUrl = metadata.webhook_url;  // Webhook host[:port] (optional path)
 // Parse permissioned routes
 const permissionedRoutes = JSON.parse(metadata.permissioned_routes || '{}')
 // Use SDK config for application settings
@@ -1530,12 +1542,12 @@ Peer RODiT metadata:
 
 ```json
 {
-  "webhook_url": "hooks.example.com",
+  "webhook_url": "hooks.example.com:7443",
   "webhook_cidr": "0.0.0.0/0"
 }
 ```
 
-- `webhook_url` — host (optional path); SDK POSTs `https://{webhook_url}{endpoint}`
+- `webhook_url` — `host` or `host:port` (scheme optional), optionally with a path. If **no path** is present, the SDK appends `endpoint` (e.g. `https://hooks.example.com:7443/hooks/wake`). If a path is already present (e.g. `…:7443/hooks/agent`), that path is used as-is and nothing is appended.
 - `webhook_cidr` — allowlist for the **resolved** destination IP (`0.0.0.0/0` / empty = any public IP still subject to the SSRF blocklist)
 
 Outbound rejection codes (returned as `{ isValid: false, error: { code, message, requestId } }`):
@@ -2378,6 +2390,10 @@ const webhookHandler = roditClient.getWebhookHandler()
 
 Send a webhook notification to the peer URL in `req.user.rodit_webhookurl`.
 
+`rodit_webhookurl` is typically a base (`host` or `host:port`). When it has
+no path, the SDK appends `options.endpoint` (default `/webhook`). When a path
+is already present, that path is used as-is (endpoint is not appended).
+
 Outbound delivery rejects private / loopback / metadata destinations (and
 resolved addresses), enforces peer JWT `rodit_webhookcidr` when set, and pins
 DNS for the request. `SECURITY_OPTIONS.WEBHOOK_TLS_SKIP_VERIFY` still applies
@@ -2473,7 +2489,7 @@ When you call `roditClient.getConfigOwnRodit()`, you get access to these metadat
 | `subjectuniqueidentifier_url` | string | Primary API service endpoint |
 | `userselected_dn` | string | User-selected display name |
 | `webhook_cidr` | string | Allowlist CIDR(s) for outbound webhook resolved IPs (`0.0.0.0/0` = any public IP; private ranges are still blocked by SSRF controls) |
-| `webhook_url` | string | Peer webhook host used as `rodit_webhookurl` in issued JWTs |
+| `webhook_url` | string | Peer webhook host (`host` or `host:port`, optional path). Used as `rodit_webhookurl` in issued JWTs; the SDK appends the endpoint only when no path is present |
 
 ## Best Practices
 

package/index.js

@@ -21,7 +21,8 @@ const {
   login_client_withnep413,
   login_portal,
   login_server,
-  logout_server
+  logout_server,
+  createLoginTimestampChallenge,
 } = require('./lib/middleware/authenticationmw');
 
 const {
@@ -1137,7 +1138,13 @@ class RoditClient {
             errorMessage += '\n→ [CLIENT REJECTED] The RODiT is missing required metadata. The RODiT may be corrupted or incomplete.';
             break;
           case 'LOGIN_BASE64URL_SIGNATURE_INVALID':
-            errorMessage += '\n→ [CLIENT REJECTED] The base64url login signature did not verify. Sign UTF-8 (roditid or accountid + canonical timestamp_iso) with the correct NEAR account private key; encoding must be base64url.';
+            errorMessage += '\n→ [CLIENT REJECTED] The base64url login signature did not verify. Sign UTF-8 (roditid or accountid + canonical timestamp_iso[, + nonce when present]) with the correct NEAR account private key; encoding must be base64url.';
+            break;
+          case 'LOGIN_NONCE_REPLAY':
+            errorMessage += '\n→ [CLIENT REJECTED] The login nonce was already used. Fetch a fresh challenge from GET /api/login/timestamp and sign again.';
+            break;
+          case 'INVALID_LOGIN_NONCE':
+            errorMessage += '\n→ [CLIENT REJECTED] The login nonce is malformed. Use the nonce string from GET /api/login/timestamp (base64url or hex).';
             break;
           case 'RODIT_FAMILY_MISMATCH':
             errorMessage += '\n→ [CLIENT REJECTED] Your RODiT does not belong to the same family as the server. You may need a different RODiT.';
@@ -1145,9 +1152,6 @@ class RoditClient {
           case 'RODIT_NOT_LIVE':
             errorMessage += '\n→ [CLIENT REJECTED] Your RODiT is expired or not yet valid. Check the validity period.';
             break;
-          case 'RODIT_REVOKED':
-            errorMessage += '\n→ [CLIENT REJECTED] Your RODiT has been revoked and is no longer valid.';
-            break;
           case 'SMART_CONTRACT_NOT_TRUSTED':
             errorMessage += '\n→ [CLIENT REJECTED] The smart contract that issued your RODiT is not trusted by this server.';
             break;
@@ -1160,9 +1164,6 @@ class RoditClient {
           case 'SERVER_RODIT_NOT_LIVE':
             errorMessage += '\n→ [SERVER REJECTED] The server\'s RODiT is expired or not yet valid. Contact the server administrator.';
             break;
-          case 'SERVER_RODIT_REVOKED':
-            errorMessage += '\n→ [SERVER REJECTED] The server\'s RODiT has been revoked. Contact the server administrator.';
-            break;
           case 'SERVER_SMART_CONTRACT_NOT_TRUSTED':
             errorMessage += '\n→ [SERVER REJECTED] The server\'s issuing smart contract is not trusted by your client. Update your trust configuration.';
             break;
@@ -1944,6 +1945,7 @@ module.exports = {
   login_portal,
   login_server,
   logout_server,
+  createLoginTimestampChallenge,
   validate_jwt_token_be,
   generate_jwt_token,
   normalizeUrlWithoutPort,

package/lib/auth/authentication.js

@@ -23,12 +23,17 @@ const {
   PayloadNEP413Schema,
   CONSTANTS,
 } = require("../blockchain/blockchainservice");
+const {
+  buildLoginSigningMessageBytes,
+  tryConsumeLoginNonce,
+} = require("./login-nonce");
 
 async function verify_rodit_ownership(
     peerroditid,
     peertimestamp,
     peerroditid_base64url_signature,
-    peer_rodit
+    peer_rodit,
+    peerNonce = null
   ) {
     const requestId = ulid();
     const startTime = Date.now();
@@ -41,6 +46,7 @@ async function verify_rodit_ownership(
         requestId,
         peerRoditId: peerroditid,
         timestamp: peertimestamp,
+        hasNonce: !!peerNonce,
       }
     );
     
@@ -56,16 +62,21 @@ async function verify_rodit_ownership(
       // DO NOT DELETE THE FOLLOWING COMMENT
       /* Maybe for NEP413 compatibility, the following line added "NEAR" before peerroditid */
       
-      // Match legacy implementation exactly
+      // Legacy: identifier + timestamp_iso. With nonce: identifier + timestamp_iso + nonce.
       const timeString = await unixTimeToDateString(peertimestamp);
-      const roditidandtimestamp = new TextEncoder().encode(
-        peerroditid + timeString
+      const roditidandtimestamp = buildLoginSigningMessageBytes(
+        peerroditid,
+        timeString,
+        peerNonce
       );
+      const combinedString = peerNonce
+        ? peerroditid + timeString + peerNonce
+        : peerroditid + timeString;
 
       logger.debugWithContext("Encoded roditid and timestamp", {
         ...baseContext,
         timeString,
-        combinedString: peerroditid + timeString,
+        combinedString,
         bufferLength: roditidandtimestamp.length,
         bufferHex: Buffer.from(roditidandtimestamp).toString('hex'),
       });
@@ -128,7 +139,7 @@ async function verify_rodit_ownership(
       logger.debugWithContext("Verification inputs", {
         ...baseContext,
         messageLength: roditidandtimestamp.length,
-        messageContent: peerroditid + timeString,
+        messageContent: combinedString,
         signatureLength: bytes_ed25519_signature.length,
         publicKeyLength: peer_bytes_ed25519_public_key?.length,
         messageHex: Buffer.from(roditidandtimestamp).toString('hex'),
@@ -795,12 +806,14 @@ async function verify_rodit_ownership(
    * @param {string} peerroditid - Identifier string used in verify_rodit_ownership (client-signed prefix)
    * @param {number} peertimestamp - Unix seconds
    * @param {string} peerroditid_base64url_signature - base64url Ed25519 signature
+   * @param {string|null} [peerNonce=null] - Optional login challenge nonce; when set, bound into signature and single-use
    */
   async function verify_peer_rodit(
     peer_rodit,
     peerroditid,
     peertimestamp,
-    peerroditid_base64url_signature
+    peerroditid_base64url_signature,
+    peerNonce = null
   ) {
     const requestId = ulid();
     const startTime = Date.now();
@@ -813,6 +826,7 @@ async function verify_rodit_ownership(
       requestId,
       peerRoditId: peerroditid,
       timestamp: peertimestamp,
+      hasNonce: !!peerNonce,
       signatureLength: peerroditid_base64url_signature?.length,
       hasOwnRodit: !!config_own_rodit,
       ownRoditId: config_own_rodit?.token_id,
@@ -895,7 +909,8 @@ async function verify_rodit_ownership(
         peerroditid,
         peertimestamp,
         peerroditid_base64url_signature,
-        peer_rodit
+        peer_rodit,
+        peerNonce
       );
       const ownershipDuration = Date.now() - ownershipStart;
 
@@ -910,12 +925,32 @@ async function verify_rodit_ownership(
           requestId,
           roditId: peerroditid,
         });
+        const nonceHint = peerNonce
+          ? " When a nonce is present, the signed payload is identifier + timestamp_iso + nonce from the same login challenge."
+          : "";
         return {
           peer_rodit,
           goodrodit: false,
           failureReason: "LOGIN_BASE64URL_SIGNATURE_INVALID",
           failureMessage:
-            "Login base64url signature invalid: Ed25519 verification failed for the base64url_signature over UTF-8 (roditid or accountid) + canonical timestamp_iso from the login challenge (GET /api/login/timestamp). Wrong key, wrong payload, or wrong encoding (must be base64url, not standard base64)."
+            "Login base64url signature invalid: Ed25519 verification failed for the base64url_signature over UTF-8 (roditid or accountid) + canonical timestamp_iso from the login challenge (GET /api/login/timestamp). Wrong key, wrong payload, or wrong encoding (must be base64url, not standard base64)." +
+            nonceHint
+        };
+      }
+
+      if (peerNonce && !tryConsumeLoginNonce(peerroditid, peerNonce)) {
+        logger.warn("Login nonce replay rejected", {
+          component: "RoditAuth",
+          method: "verify_peer_rodit",
+          requestId,
+          roditId: peerroditid,
+        });
+        return {
+          peer_rodit,
+          goodrodit: false,
+          failureReason: "LOGIN_NONCE_REPLAY",
+          failureMessage:
+            "Login nonce already used: fetch a fresh challenge from GET /api/login/timestamp and sign again. Nonces are single-use when provided."
         };
       }
 
@@ -993,32 +1028,6 @@ async function verify_rodit_ownership(
         };
       }
 
-      const activeStart = Date.now();
-      const isActive = await verify_rodit_isactive(
-        peer_rodit.token_id,
-        config_own_rodit.own_rodit.metadata.subjectuniqueidentifier_url
-      );
-      const activeDuration = Date.now() - activeStart;
-
-      logger.debug("Active verification completed", {
-        requestId,
-        activeDuration,
-        isActive,
-      });
-
-      if (!isActive) {
-        logger.warn("RODiT active verification failed", {
-          requestId,
-          roditId: peerroditid,
-        });
-        return {
-          peer_rodit,
-          goodrodit: false,
-          failureReason: "RODIT_REVOKED",
-          failureMessage: "RODiT has been revoked"
-        };
-      }
-
       const trustedStart = Date.now();
       const isTrusted = await verify_rodit_istrusted_issuingsmartcontract(
         config_own_rodit.own_rodit.metadata.subjectuniqueidentifier_url
@@ -1241,119 +1250,6 @@ async function verify_rodit_ownership(
     }
   }
 
-  async function verify_rodit_isactive(tokenId, ownsubjectuniqueidentifier_url) {
-    const requestId = ulid();
-    const startTime = Date.now();
-  
-    // WHILE DEBUGGING TEMPORARY FIX DO NOT REMOVE THIS LINE EVER WITHOUT PERMISSION
-    return true;
-  
-    logger.debug("Checking RODiT activity status", {
-      component: "RoditAuth",
-      method: "verify_rodit_isactive",
-      requestId,
-      tokenId,
-      subjectUrl: ownsubjectuniqueidentifier_url,
-    });
-  
-    const domainandextensionRegex =
-      /(?:https?:\/\/)?(?:www\.)?([a-zA-Z0-9-]+\.[a-zA-Z0-9-.]+)/i;
-  
-    const match = ownsubjectuniqueidentifier_url.match(domainandextensionRegex);
-  
-    if (match) {
-      const domainandextension = match[1];
-      const revokingDnsEntry = `${tokenId}.revoked.${domainandextension}`;
-  
-      logger.debug("Checking DNS revocation entry", {
-        requestId,
-        domain: domainandextension,
-        revokingDnsEntry,
-      });
-  
-      try {
-        const dnsStart = Date.now();
-        const resolver = new Resolver();
-        await resolver.resolveTxt(revokingDnsEntry);
-        const dnsDuration = Date.now() - dnsStart;
-        const totalDuration = Date.now() - startTime;
-  
-        logger.info("RODiT revocation found", {
-          component: "AuthServices",
-          method: "verify_rodit_isactive",
-          requestId,
-          duration: totalDuration,
-          dnsDuration,
-          tokenId,
-          domain: domainandextension,
-          revokingDnsEntry,
-          isActive: false,
-        });
-  
-        // Add metrics for revoked tokens
-        logger.metric &&
-          logger.metric("rodit_revocation_checks", totalDuration, {
-            result: "revoked",
-            token_id: tokenId,
-          });
-  
-        return false;
-      } catch (error) {
-        // DNS error usually means no revocation entry found, which is good
-        const dnsDuration = Date.now() - dnsStart || 0;
-        const totalDuration = Date.now() - startTime;
-  
-        logger.debug("No revocation found for RODiT", {
-          requestId,
-          dnsDuration,
-          tokenId,
-          error: error.code,
-        });
-  
-        logger.info("RODiT is active", {
-          component: "AuthServices",
-          method: "verify_rodit_isactive",
-          requestId,
-          duration: totalDuration,
-          dnsDuration,
-          tokenId,
-          domain: domainandextension,
-          isActive: true,
-        });
-  
-        // Add metrics for active tokens
-        logger.metric &&
-          logger.metric("rodit_revocation_checks", totalDuration, {
-            result: "active",
-            token_id: tokenId,
-          });
-  
-        return true;
-      }
-    } else {
-      const duration = Date.now() - startTime;
-  
-      logger.warn("Unable to parse domain from URL", {
-        component: "AuthServices",
-        method: "verify_rodit_isactive",
-        requestId,
-        duration,
-        tokenId,
-        subjectUrl: ownsubjectuniqueidentifier_url,
-      });
-  
-      // Add metrics for parsing errors
-      logger.metric &&
-        logger.metric("rodit_revocation_checks", duration, {
-          result: "parse_error",
-          token_id: tokenId,
-        });
-  
-      // Default to allowing the token if domain parsing fails
-      return true;
-    }
-  }
-
   async function verify_rodit_istrusted_issuingsmartcontract(
     ownsubjectuniqueidentifier_url
   ) {
@@ -1963,9 +1859,8 @@ module.exports = {
   resolve_peer_rodit_for_login,
   verify_peer_rodit,
   validateTimestamp,
-  verify_rodit_isactive,
   verify_rodit_isamatch,
   verify_rodit_islive,
   verify_rodit_istrusted_issuingsmartcontract,
-  authenticate_webhook
+  authenticate_webhook,
 };

package/lib/auth/login-nonce.js

@@ -0,0 +1,164 @@
+/**
+ * Login challenge nonce helpers (optional additive field for POST /api/login).
+ * When a nonce is present it is bound into the signed payload and single-use.
+ * Copyright (c) 2026 Discernible IO. All rights reserved.
+ */
+
+const crypto = require("crypto");
+const config = require("../../services/configsdk");
+const { unixTimeToDateString } = require("../../services/utils");
+
+const LOGIN_NONCE_BYTES = 16;
+const LOGIN_NONCE_MIN_LEN = 8;
+const LOGIN_NONCE_MAX_LEN = 128;
+
+/** @type {Map<string, { expiresAtMs: number, firstSeenAtMs: number }>} */
+const loginNonceReplayCache = new Map();
+
+/**
+ * Cryptographic login nonce for challenges (base64url, 128-bit).
+ * @returns {string}
+ */
+function generateLoginNonce() {
+  return crypto.randomBytes(LOGIN_NONCE_BYTES).toString("base64url");
+}
+
+/**
+ * Normalize optional login nonce from a request/challenge body.
+ * Missing/empty → null (legacy timestamp-only login). Invalid → { error }.
+ *
+ * @param {*} rawNonce
+ * @returns {{ nonce: string|null, error?: string, errorCode?: string }}
+ */
+function normalizeOptionalLoginNonce(rawNonce) {
+  if (rawNonce === undefined || rawNonce === null) {
+    return { nonce: null };
+  }
+  if (typeof rawNonce !== "string") {
+    return {
+      nonce: null,
+      errorCode: "INVALID_LOGIN_NONCE",
+      error: "Login nonce must be a string when provided",
+    };
+  }
+  const trimmed = rawNonce.trim();
+  if (trimmed.length === 0) {
+    return { nonce: null };
+  }
+  if (
+    trimmed.length < LOGIN_NONCE_MIN_LEN ||
+    trimmed.length > LOGIN_NONCE_MAX_LEN
+  ) {
+    return {
+      nonce: null,
+      errorCode: "INVALID_LOGIN_NONCE",
+      error: `Login nonce length must be between ${LOGIN_NONCE_MIN_LEN} and ${LOGIN_NONCE_MAX_LEN} characters`,
+    };
+  }
+  // Reject whitespace / control characters inside the token.
+  if (!/^[A-Za-z0-9_-]+$/.test(trimmed)) {
+    return {
+      nonce: null,
+      errorCode: "INVALID_LOGIN_NONCE",
+      error:
+        "Login nonce must be base64url or hex (letters, digits, '-', '_' only)",
+    };
+  }
+  return { nonce: trimmed };
+}
+
+/**
+ * Build UTF-8 bytes for login signature.
+ * Legacy: identifier + timestamp_iso
+ * With nonce: identifier + timestamp_iso + nonce
+ *
+ * @param {string} identifier
+ * @param {string} timeString - ISO timestamp string
+ * @param {string|null|undefined} nonce
+ * @returns {Uint8Array}
+ */
+function buildLoginSigningMessageBytes(identifier, timeString, nonce) {
+  const payload =
+    nonce && String(nonce).length > 0
+      ? String(identifier) + String(timeString) + String(nonce)
+      : String(identifier) + String(timeString);
+  return new TextEncoder().encode(payload);
+}
+
+function getLoginNonceReplayTtlMs() {
+  const maxAgeSeconds = Number(
+    config.get("API_DEFAULT_OPTIONS.TIMESTAMP_MAX_AGE", 300)
+  );
+  const seconds =
+    Number.isFinite(maxAgeSeconds) && maxAgeSeconds > 0 ? maxAgeSeconds : 300;
+  return seconds * 1000;
+}
+
+function cleanupExpiredLoginNonceEntries(nowMs = Date.now()) {
+  for (const [key, entry] of loginNonceReplayCache.entries()) {
+    if (!entry || entry.expiresAtMs <= nowMs) {
+      loginNonceReplayCache.delete(key);
+    }
+  }
+}
+
+function buildLoginNonceReplayKey(nonce) {
+  return String(nonce);
+}
+
+/**
+ * Atomically consume a login nonce. Returns false if already used.
+ * Call only after the signature that binds the nonce has verified.
+ *
+ * @param {string} identifier - roditid or accountid (reserved for future scoped caches / logging)
+ * @param {string} nonce
+ * @returns {boolean} true if consumed (first use), false if replay
+ */
+function tryConsumeLoginNonce(identifier, nonce) {
+  if (!nonce) {
+    return true;
+  }
+  const nowMs = Date.now();
+  cleanupExpiredLoginNonceEntries(nowMs);
+  const key = buildLoginNonceReplayKey(nonce);
+  if (loginNonceReplayCache.has(key)) {
+    return false;
+  }
+  loginNonceReplayCache.set(key, {
+    expiresAtMs: nowMs + getLoginNonceReplayTtlMs(),
+    firstSeenAtMs: nowMs,
+    identifier: identifier ? String(identifier) : undefined,
+  });
+  return true;
+}
+
+/**
+ * Host helper for GET /api/login/timestamp — issues timestamp + CSPRNG nonce.
+ * Clients that understand nonce will bind it into the signature; older clients ignore it.
+ *
+ * @returns {Promise<{ timestamp: number, timestamp_iso: string, nonce: string }>}
+ */
+async function createLoginTimestampChallenge() {
+  const timestamp = Math.floor(Date.now() / 1000);
+  const timestamp_iso = await unixTimeToDateString(timestamp);
+  return {
+    timestamp,
+    timestamp_iso,
+    nonce: generateLoginNonce(),
+  };
+}
+
+/** Test/support: clear replay cache (does not affect production callers). */
+function clearLoginNonceReplayCacheForTests() {
+  loginNonceReplayCache.clear();
+}
+
+module.exports = {
+  generateLoginNonce,
+  normalizeOptionalLoginNonce,
+  buildLoginSigningMessageBytes,
+  tryConsumeLoginNonce,
+  createLoginTimestampChallenge,
+  clearLoginNonceReplayCacheForTests,
+  buildLoginNonceReplayKey,
+};

package/lib/auth/tokenservice.js

@@ -2085,7 +2085,7 @@ async function thorough_validate_jwt_token_be(token, requestId = ulid()) {
     // Starting verification with more detailed logging
     logger.debug("Starting verification checks", {
       requestId,
-      checks: ["match", "live", "active", "trusted"],
+      checks: ["match", "live", "trusted"],
       serviceProviderId: config_own_rodit.own_rodit.metadata.serviceprovider_id,
     });
 
@@ -2093,7 +2093,6 @@ async function thorough_validate_jwt_token_be(token, requestId = ulid()) {
     const { 
       verify_rodit_isamatch,
       verify_rodit_islive,
-      verify_rodit_isactive,
       verify_rodit_istrusted_issuingsmartcontract
     } = require("./authentication");
 
@@ -2188,49 +2187,6 @@ async function thorough_validate_jwt_token_be(token, requestId = ulid()) {
       };
     }
 
-    // Perform active verification
-    const activeStart = performance.now();
-    const isActive = await verify_rodit_isactive(
-      peer_rodit.token_id,
-      config_own_rodit.own_rodit.metadata.subjectuniqueidentifier_url
-    );
-    const activeDuration = performance.now() - activeStart;
-
-    logger.debug("Active verification completed", {
-      requestId,
-      activeDuration,
-      isActive,
-      tokenId: peer_rodit.token_id,
-      url: config_own_rodit.own_rodit.metadata.subjectuniqueidentifier_url,
-    });
-
-    if (!isActive) {
-      logger.warn("RODiT active verification failed", {
-        component: "JwtAuth",
-        method: "thorough_validate_jwt_token_be",
-        requestId,
-        duration: performance.now() - startTime,
-        tokenId: peer_rodit.token_id,
-        url: config_own_rodit.own_rodit.metadata.subjectuniqueidentifier_url,
-      });
-
-      // Add metrics for failed active verification
-      logger.metric &&
-        logger.metric("jwt_thorough_validation", performance.now() - startTime, {
-          result: "active_failed",
-          token_jti: token.jti || "unknown",
-          peer_rodit_id: peer_rodit.token_id,
-        });
-
-      return {
-        isValid: false,
-        notAfter: null,
-        error: "RODiT active verification failed",
-        errorCode: "SERVER_RODIT_REVOKED",
-        errorMessage: "Server's RODiT has been revoked"
-      };
-    }
-
     // Perform trusted verification
     const trustedStart = performance.now();
     const isTrusted = await verify_rodit_istrusted_issuingsmartcontract(

package/lib/middleware/authenticationmw.js

@@ -24,6 +24,11 @@ const {
   verify_peer_rodit,
   verify_rodit_ownership_withnep413
 } = require("../auth/authentication");
+const {
+  normalizeOptionalLoginNonce,
+  buildLoginSigningMessageBytes,
+  createLoginTimestampChallenge,
+} = require("../auth/login-nonce");
 const { 
   nearorg_rpc_tokenfromroditid
 } = require("../blockchain/blockchainservice");
@@ -163,7 +168,16 @@ function buildLoginUrl(apiendpoint, loginPath = "/api/login") {
 async function resolveServerLoginTimestamp(apiendpoint, options = {}) {
   const explicit = parseRequiredServerLoginTimestamp(options.timestamp);
   if (explicit !== null) {
-    return { timestamp: explicit };
+    const nonceResult = normalizeOptionalLoginNonce(options.nonce);
+    if (nonceResult.errorCode) {
+      return {
+        timestamp: null,
+        nonce: null,
+        errorCode: nonceResult.errorCode,
+        error: nonceResult.error,
+      };
+    }
+    return { timestamp: explicit, nonce: nonceResult.nonce };
   }
 
   const timestampPath =
@@ -183,6 +197,7 @@ async function resolveServerLoginTimestamp(apiendpoint, options = {}) {
     if (!response.ok) {
       return {
         timestamp: null,
+        nonce: null,
         errorCode: "LOGIN_TIMESTAMP_FETCH_FAILED",
         error: `Failed to fetch login timestamp challenge: HTTP ${response.status}`,
       };
@@ -193,15 +208,29 @@ async function resolveServerLoginTimestamp(apiendpoint, options = {}) {
     if (parsed === null) {
       return {
         timestamp: null,
+        nonce: null,
         errorCode: "INVALID_LOGIN_TIMESTAMP",
         error: "Login timestamp challenge response is missing a valid timestamp",
       };
     }
 
-    return { timestamp: parsed };
+    const nonceResult = normalizeOptionalLoginNonce(
+      options.nonce !== undefined ? options.nonce : data?.nonce
+    );
+    if (nonceResult.errorCode) {
+      return {
+        timestamp: null,
+        nonce: null,
+        errorCode: nonceResult.errorCode,
+        error: nonceResult.error,
+      };
+    }
+
+    return { timestamp: parsed, nonce: nonceResult.nonce };
   } catch (error) {
     return {
       timestamp: null,
+      nonce: null,
       errorCode: "LOGIN_TIMESTAMP_FETCH_FAILED",
       error: `Failed to fetch login timestamp challenge: ${error.message}`,
     };
@@ -302,6 +331,30 @@ async function login_client(req, res) {
     const hasAccountId = accountid.length > 0;
     const peer_timestamp = parseRequiredLoginTimestamp(body.timestamp);
     const base64url_signature = extractLoginBase64UrlSignature(body);
+    const nonceResult = normalizeOptionalLoginNonce(body.nonce);
+    if (nonceResult.errorCode) {
+      const duration = Date.now() - startTime;
+      logger.metric("login_attempt_duration_ms", duration, {
+        component: "RoditAuth",
+        success: false,
+        result: "failure",
+        reason: "invalid_login_nonce",
+        error: nonceResult.errorCode,
+      });
+      logger.metric("failed_login_attempts_total", 1, {
+        component: "RoditAuth",
+        result: "failure",
+        reason: nonceResult.errorCode,
+      });
+      return respondLoginValidationFailure(res, {
+        silenceLoginFailures,
+        statusCode: 400,
+        requestId,
+        code: nonceResult.errorCode,
+        message: nonceResult.error,
+      });
+    }
+    const peer_nonce = nonceResult.nonce;
 
     logger.infoWithContext("Login request identifiers (sanitized)", {
       ...baseContext,
@@ -309,6 +362,7 @@ async function login_client(req, res) {
       accountid: accountid || undefined,
       login_mode: hasRoditId ? "roditid" : hasAccountId ? "accountid" : "none",
       timestamp: peer_timestamp,
+      has_nonce: !!peer_nonce,
       has_base64url_signature: base64url_signature.length > 0,
     });
 
@@ -449,6 +503,7 @@ async function login_client(req, res) {
       hasRoditId: roditid.length > 0,
       hasAccountId: accountid.length > 0,
       hasTimestamp: peer_timestamp !== undefined && peer_timestamp !== null,
+      hasNonce: !!peer_nonce,
       has_base64url_signature: base64url_signature.length > 0,
     });
 
@@ -503,7 +558,8 @@ async function login_client(req, res) {
       await resolve_peer_rodit_for_login(roditid, accountid),
       peer_roditid,
       peer_timestamp,
-      base64url_signature
+      base64url_signature,
+      peer_nonce
     );
 
     const { peer_rodit, goodrodit: isRoditValid, failureReason, failureMessage } = result;
@@ -1624,6 +1680,16 @@ async function login_portal(config_own_rodit, port, options = {}) {
           requestId
         };
       }
+      const nonceResult = normalizeOptionalLoginNonce(options.nonce);
+      if (nonceResult.errorCode) {
+        return {
+          error: nonceResult.error,
+          errorCode: nonceResult.errorCode,
+          failureReason: nonceResult.errorCode,
+          requestId
+        };
+      }
+      const nonce = nonceResult.nonce;
 
       const hasRoditId = roditid.length > 0;
       const hasAccountId = accountid.length > 0;
@@ -1638,8 +1704,10 @@ async function login_portal(config_own_rodit, port, options = {}) {
 
       const timeString = await unixTimeToDateString(timestamp);
       const signatureIdentifier = hasRoditId ? roditid : accountid;
-      const signatureIdentifierandtimestamp = new TextEncoder().encode(
-        signatureIdentifier + timeString
+      const signatureIdentifierandtimestamp = buildLoginSigningMessageBytes(
+        signatureIdentifier,
+        timeString,
+        nonce
       );
 
       logger.debug("Generating authentication signature", {
@@ -1649,6 +1717,7 @@ async function login_portal(config_own_rodit, port, options = {}) {
         roditId: roditid,
         accountId: accountid,
         timestamp,
+        hasNonce: !!nonce,
       });
 
       // Create signature
@@ -1674,17 +1743,21 @@ async function login_portal(config_own_rodit, port, options = {}) {
       });
 
       try {
+        const requestBody = {
+          ...(hasRoditId ? { roditid } : {}),
+          ...(hasAccountId ? { accountid } : {}),
+          timestamp,
+          roditid_base64url_signature,
+        };
+        if (nonce) {
+          requestBody.nonce = nonce;
+        }
         const response = await fetch(fetchUrl, {
           method: "POST",
           headers: {
             "Content-Type": "application/json",
           },
-          body: JSON.stringify({
-            ...(hasRoditId ? { roditid } : {}),
-            ...(hasAccountId ? { accountid } : {}),
-            timestamp,
-            roditid_base64url_signature,
-          }),
+          body: JSON.stringify(requestBody),
         });
 
         if (!response.ok) {
@@ -1972,8 +2045,12 @@ async function login_portal(config_own_rodit, port, options = {}) {
       });
 
       const roditid = normalizeOptionalLoginString(own_rodit?.token_id);
-      const { timestamp, error: timestampError, errorCode: timestampErrorCode } =
-        await resolveServerLoginTimestamp(apiendpoint, options);
+      const {
+        timestamp,
+        nonce,
+        error: timestampError,
+        errorCode: timestampErrorCode,
+      } = await resolveServerLoginTimestamp(apiendpoint, options);
       const accountid = normalizeOptionalServerAccountId(options.accountId);
 
       if (timestamp === null) {
@@ -2005,13 +2082,16 @@ async function login_portal(config_own_rodit, port, options = {}) {
         roditId: roditid,
         accountId: accountid,
         timestamp,
+        hasNonce: !!nonce,
       });
 
       const timeString = await unixTimeToDateString(timestamp);
 
       const signatureIdentifier = hasRoditId ? roditid : accountid;
-      const signatureIdentifierandtimestamp = new TextEncoder().encode(
-        signatureIdentifier + timeString
+      const signatureIdentifierandtimestamp = buildLoginSigningMessageBytes(
+        signatureIdentifier,
+        timeString,
+        nonce
       );
 
       logger.debug("Generating signature", {
@@ -2020,6 +2100,7 @@ async function login_portal(config_own_rodit, port, options = {}) {
         requestId,
         hasPrivateKey: !!config_own_rodit.own_rodit_bytes_private_key,
         signatureIdentifier,
+        hasNonce: !!nonce,
       });
 
       const own_rodit_bytes_signature = nacl.sign.detached(
@@ -2044,6 +2125,10 @@ async function login_portal(config_own_rodit, port, options = {}) {
         requestBody.accountid = accountid;
       }
 
+      if (nonce) {
+        requestBody.nonce = nonce;
+      }
+
       logger.debug("Sending login request", {
         component: "AuthenticationService",
         method,
@@ -2051,6 +2136,7 @@ async function login_portal(config_own_rodit, port, options = {}) {
         roditid,
         accountId: accountid,
         timestamp,
+        hasNonce: !!nonce,
         signatureLength: roditid_base64url_signature?.length,
         apiEndpoint: loginUrl,
       });
@@ -2379,4 +2465,14 @@ async function logout_server(jwt_token) {
 
 
 // Export the class directly (will be instantiated in rodit.js)
-module.exports = {authenticate_apicall,authenticate_logout,login_server,login_portal,login_client,login_client_withnep413,logout_client,logout_server};
+module.exports = {
+  authenticate_apicall,
+  authenticate_logout,
+  login_server,
+  login_portal,
+  login_client,
+  login_client_withnep413,
+  logout_client,
+  logout_server,
+  createLoginTimestampChallenge,
+};

package/lib/middleware/webhookhandlermw.js

@@ -121,6 +121,27 @@ function validateOutboundWebhookUrl(raw) {
   return parsed;
 }
 
+/**
+ * Build the absolute outbound webhook URL.
+ * If `webhookUrl` is host-only (`host` or `host:port`), append `endpoint`.
+ * If it already includes a path, use that path as-is (do not append).
+ *
+ * @param {string} webhookUrl Peer `rodit_webhookurl` / `webhook_url` (scheme optional)
+ * @param {string} [endpoint='/webhook'] Path to append when none is present
+ * @returns {string} Absolute https URL
+ */
+function formatOutboundWebhookTargetUrl(webhookUrl, endpoint = "/webhook") {
+  const cleanWebhookUrl = String(webhookUrl || "")
+    .replace(/^(https?:\/\/)/i, "")
+    .replace(/\/+$/, "");
+  const hasPath = cleanWebhookUrl.includes("/");
+  if (hasPath) {
+    return `https://${cleanWebhookUrl}`;
+  }
+  const normalizedEndpoint = `/${String(endpoint || "/webhook").replace(/^\/+/, "")}`;
+  return `https://${cleanWebhookUrl}${normalizedEndpoint}`;
+}
+
 function ipv4ToInt(ip) {
   return ip.split(".").reduce((acc, oct) => ((acc << 8) + Number(oct)) >>> 0, 0) >>> 0;
 }
@@ -1208,13 +1229,9 @@ async function resolveOutboundWebhookSessionId(options = {}, req = null) {
         endpoint
       });
    
-      // Normalize base URL and endpoint so we always produce exactly one slash
-      // between host and path (e.g. https://host/hooks/wake).
-      const cleanWebhookUrl = webhookUrl
-        .replace(/^(https?:\/\/)/, "")
-        .replace(/\/+$/, "");
-      const normalizedEndpoint = `/${String(endpoint || "/webhook").replace(/^\/+/, "")}`;
-      const formattedWebhookUrl = `https://${cleanWebhookUrl}${normalizedEndpoint}`;
+      // Append endpoint only when webhook_url has no path
+      // (e.g. host:7443 → …/hooks/wake; host:7443/hooks/agent stays as-is).
+      const formattedWebhookUrl = formatOutboundWebhookTargetUrl(webhookUrl, endpoint);
 
       // Outbound SSRF controls: reject userinfo / private / metadata destinations,
       // enforce peer webhook_cidr, and pin DNS for the request lifetime.
@@ -2101,6 +2118,7 @@ module.exports = {
 
   // Outbound SSRF / CIDR / DNS-pin helpers
   validateOutboundWebhookUrl,
+  formatOutboundWebhookTargetUrl,
   resolveAndPinWebhookDestination,
   createPinnedDispatcher,
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rodit/rodit-auth-be",
-  "version": "9.15.0",
+  "version": "9.16.2",
   "description": "RODiT-based authentication system for Express.js applications",
   "main": "index.js",
   "exports": {
@@ -46,8 +46,13 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/discernible-io/rodit-auth-be.git"
+    "url": "git+https://github.com/discernible-io/rodit-sdk.git",
+    "directory": "rodit-auth-be"
   },
+  "bugs": {
+    "url": "https://github.com/discernible-io/rodit-sdk/issues"
+  },
+  "homepage": "https://github.com/discernible-io/rodit-sdk/tree/main/rodit-auth-be#readme",
   "publishConfig": {
     "access": "public"
   },