@openclaw/nostr 2026.8.1-beta.2 → 2026.8.1-beta.3

package/dist/api.js

@@ -1,14 +1,14 @@
-import { s as resolveNostrAccount } from "./setup-surface-DAhyNOcb.js";
+import { s as resolveNostrAccount } from "./setup-surface-uA4hN27A.js";
 import { getPluginRuntimeGatewayRequestScope } from "./runtime-api.js";
 import { n as NostrProfileSchema } from "./config-schema-CkYd8ACn.js";
-import { a as getNostrRuntime, i as contentToProfile, n as nostrPlugin, o as setNostrRuntime, r as publishNostrProfile, t as getNostrProfileState } from "./channel-BifOvAwp.js";
+import { a as getNostrRuntime, i as contentToProfile, n as nostrPlugin, o as setNostrRuntime, r as publishNostrProfile, t as getNostrProfileState } from "./channel-ity6au4a.js";
 import { normalizeLowercaseStringOrEmpty, normalizeOptionalLowercaseString, readStringValue } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { z } from "zod";
 import { SimplePool } from "nostr-tools";
+import { createFixedWindowRateLimiter as createFixedWindowRateLimiter$1 } from "openclaw/plugin-sdk/webhook-ingress";
 import { KeyedAsyncQueue } from "openclaw/plugin-sdk/keyed-async-queue";
 import { isBlockedHostnameOrIp, isLoopbackHost } from "openclaw/plugin-sdk/ssrf-runtime";
 import { readJsonBodyWithLimit, requestBodyErrorToText } from "openclaw/plugin-sdk/webhook-request-guards";
-import { createFixedWindowRateLimiter } from "openclaw/plugin-sdk/webhook-ingress";
 import { resolveTimerTimeoutMs } from "openclaw/plugin-sdk/number-runtime";
 //#region extensions/nostr/src/nostr-profile-url-safety.ts
 function validateUrlSafety(urlStr) {
@@ -184,7 +184,7 @@ function mergeProfiles(local, imported) {
 }
 //#endregion
 //#region extensions/nostr/src/nostr-profile-http.ts
-const profileRateLimiter = createFixedWindowRateLimiter({
+const profileRateLimiter = createFixedWindowRateLimiter$1({
 	windowMs: 6e4,
 	maxRequests: 5,
 	maxTrackedKeys: 2048

package/dist/{channel-BifOvAwp.js → channel-ity6au4a.js}

@@ -1,6 +1,6 @@
-import { a as listNostrAccountIds, c as normalizePubkey, l as validatePrivateKey, n as nostrSetupContract, o as resolveDefaultNostrAccountId, r as nostrSetupWizard, s as resolveNostrAccount } from "./setup-surface-DAhyNOcb.js";
+import { a as listNostrAccountIds, c as normalizePubkey, l as validatePrivateKey, n as nostrSetupContract, o as resolveDefaultNostrAccountId, r as nostrSetupWizard, s as resolveNostrAccount } from "./setup-surface-uA4hN27A.js";
 import { a as collectStatusIssuesFromLastError, i as buildChannelConfigSchema, n as NostrProfileSchema, o as createDefaultChannelRuntimeState, r as DEFAULT_ACCOUNT_ID, s as formatPairingApproveHint, t as NostrConfigSchema } from "./config-schema-CkYd8ACn.js";
-import { s as DEFAULT_RELAYS } from "./setup-adapter-DLthHa2q.js";
+import { c as DEFAULT_RELAYS } from "./setup-adapter-ClKW2fkz.js";
 import { t as normalizeNostrStateAccountId } from "./state-account-id-CvBZ9s6P.js";
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
 import { createScopedDmSecurityResolver, createTopLevelChannelConfigAdapter } from "openclaw/plugin-sdk/channel-config-helpers";
@@ -18,6 +18,9 @@ import { chunkTextForOutbound, sanitizeAssistantVisibleText, stripMarkdown } fro
 import { SimplePool, finalizeEvent, getPublicKey, verifyEvent } from "nostr-tools";
 import { decrypt, encrypt } from "nostr-tools/nip04";
 import { createDirectDmPreCryptoGuardPolicy } from "openclaw/plugin-sdk/direct-dm-guard-policy";
+import { createFixedWindowRateLimiter } from "openclaw/plugin-sdk/webhook-ingress";
+import { retryAsync } from "openclaw/plugin-sdk/retry-runtime";
+import { sleepWithAbort } from "openclaw/plugin-sdk/runtime-env";
 import { formatErrorMessage } from "openclaw/plugin-sdk/error-runtime";
 import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";
 import { buildChannelOutboundSessionRoute, stripChannelTargetPrefix } from "openclaw/plugin-sdk/core";
@@ -289,19 +292,16 @@ function createNostrCursorStateWriter(options) {
 	let activeFlush;
 	let recoveryFlush;
 	const writeWithRetry = async (cursor) => {
-		let lastError;
-		for (const delayMs of CURSOR_WRITE_RETRY_MS) {
-			if (delayMs > 0) await new Promise((resolve) => {
-				setTimeout(resolve, delayMs);
+		try {
+			await retryAsync(() => options.write(cursor), {
+				attempts: CURSOR_WRITE_RETRY_MS.length,
+				minDelayMs: 0,
+				delayMs: ({ attempt }) => CURSOR_WRITE_RETRY_MS[attempt] ?? 0,
+				sleep: (delayMs) => sleepWithAbort(delayMs)
 			});
-			try {
-				await options.write(cursor);
-				return;
-			} catch (error) {
-				lastError = error;
-			}
+		} catch (error) {
+			throw new Error("Nostr cursor state write failed.", { cause: error });
 		}
-		throw new Error("Nostr cursor state write failed.", { cause: lastError });
 	};
 	const enqueueWrite = (cursor) => {
 		const write = writeTail.then(() => writeWithRetry(cursor));
@@ -548,12 +548,8 @@ function createNostrIngress(options) {
 		const pending = await getQueue().listPending({ limit: options.maxPendingEvents });
 		const claims = await getQueue().listClaims();
 		if (pending.length + claims.length >= options.maxPendingEvents) throw new NostrIngressAdmissionRejectedError("backpressure", "Nostr event exceeds the durable ingress backlog.");
-		let lastError;
-		for (const delayMs of NOSTR_INGRESS_APPEND_RETRY_MS) {
-			if (delayMs > 0) await new Promise((resolve) => {
-				setTimeout(resolve, delayMs);
-			});
-			try {
+		try {
+			return await retryAsync(async () => {
 				const result = await getQueue().enqueue(prepared.facts.eventId, prepared.payload, {
 					receivedAt: prepared.receivedAt,
 					laneKey: prepared.facts.laneKey
@@ -561,11 +557,15 @@ function createNostrIngress(options) {
 				options.afterDurableAppend(prepared.event);
 				monitor.requestDrain();
 				return result.kind === "accepted" ? "accepted" : "duplicate";
-			} catch (error) {
-				lastError = error;
-			}
+			}, {
+				attempts: NOSTR_INGRESS_APPEND_RETRY_MS.length,
+				minDelayMs: 0,
+				delayMs: ({ attempt }) => NOSTR_INGRESS_APPEND_RETRY_MS[attempt] ?? 0,
+				sleep: (delayMs) => sleepWithAbort(delayMs)
+			});
+		} catch (error) {
+			throw new Error(`Nostr durable admission failed: ${formatErrorMessage(error)}`, { cause: error });
 		}
-		throw new Error(`Nostr durable admission failed: ${formatErrorMessage(lastError)}`, { cause: lastError });
 	};
 	return {
 		ready: async () => {
@@ -742,48 +742,6 @@ async function publishProfile(pool, sk, relays, profile, lastPublishedAt) {
 	return publishProfileEvent(pool, relays, createProfileEvent(sk, profile, lastPublishedAt));
 }
 //#endregion
-//#region extensions/nostr/src/nostr-rate-limiter.ts
-function createFixedWindowRateLimiter(params) {
-	const windowMs = Math.max(1, Math.floor(params.windowMs));
-	const maxRequests = Math.max(1, Math.floor(params.maxRequests));
-	const maxTrackedKeys = Math.max(1, Math.floor(params.maxTrackedKeys));
-	const state = /* @__PURE__ */ new Map();
-	const touch = (key, value) => {
-		state.delete(key);
-		state.set(key, value);
-	};
-	const prune = (nowMs) => {
-		for (const [key, entry] of state) if (nowMs - entry.windowStartMs >= windowMs) state.delete(key);
-		while (state.size > maxTrackedKeys) {
-			const oldest = state.keys().next().value;
-			if (!oldest) break;
-			state.delete(oldest);
-		}
-	};
-	return {
-		isRateLimited: (key, nowMs = Date.now()) => {
-			if (!key) return false;
-			prune(nowMs);
-			const existing = state.get(key);
-			if (!existing || nowMs - existing.windowStartMs >= windowMs) {
-				touch(key, {
-					count: 1,
-					windowStartMs: nowMs
-				});
-				return false;
-			}
-			const nextCount = existing.count + 1;
-			touch(key, {
-				count: nextCount,
-				windowStartMs: existing.windowStartMs
-			});
-			return nextCount > maxRequests;
-		},
-		size: () => state.size,
-		clear: () => state.clear()
-	};
-}
-//#endregion
 //#region extensions/nostr/src/nostr-relay-subscription.ts
 const DEFAULT_EOSE_CONFIRM_DEADLINE_MS = 1e4;
 const LIBRARY_EOSE_TIMEOUT_MARGIN_MS = 1e3;
@@ -1357,7 +1315,6 @@ async function sendEncryptedDm(pool, sk, toPubkey, text, relays, metrics, circui
 //#endregion
 //#region extensions/nostr/src/gateway.ts
 const activeBuses = /* @__PURE__ */ new Map();
-const metricsSnapshots = /* @__PURE__ */ new Map();
 const ACCESS_GROUP_PREFIX = "accessGroup:";
 function normalizeRelayLifecycleKey(relay) {
 	return new URL(relay).toString();
@@ -1426,7 +1383,6 @@ const startNostrGatewayAccount = async (ctx) => {
 		allowFrom: account.config.allowFrom,
 		command: runtime.channel.commands.shouldComputeCommandAuthorized(rawBody, ctx.cfg) ? { modeWhenAccessGroupsOff: "configured" } : void 0
 	});
-	let busHandle = null;
 	const connectedRelays = /* @__PURE__ */ new Set();
 	const authorizeSender = async (input) => {
 		const resolved = await resolveInboundAccess(input.senderId, "");
@@ -1534,17 +1490,13 @@ const startNostrGatewayAccount = async (ctx) => {
 					else if (event.name === "relay.circuit_breaker.open") ctx.log?.warn?.(`[${account.accountId}] Circuit breaker opened for relay: ${event.labels?.relay}`);
 					else if (event.name === "relay.circuit_breaker.close") ctx.log?.info?.(`[${account.accountId}] Circuit breaker closed for relay: ${event.labels?.relay}`);
 					else if (event.name === "relay.error") ctx.log?.debug?.(`[${account.accountId}] Relay error: ${event.labels?.relay}`);
-					if (busHandle) metricsSnapshots.set(account.accountId, busHandle.getMetrics());
 				}
 			});
-			busHandle = bus;
 			activeBuses.set(account.accountId, bus);
 			ctx.log?.info?.(`[${account.accountId}] Nostr provider started with ${account.relays.length} configured relay(s)`);
 			return { stop: async () => {
-				await bus.close();
-				if (busHandle === bus) busHandle = null;
 				if (activeBuses.get(account.accountId) === bus) activeBuses.delete(account.accountId);
-				metricsSnapshots.delete(account.accountId);
+				await bus.close();
 				ctx.log?.info?.(`[${account.accountId}] Nostr provider stopped`);
 			} };
 		},

package/dist/channel-plugin-api.js

@@ -1,2 +1,2 @@
-import { n as nostrPlugin } from "./channel-BifOvAwp.js";
+import { n as nostrPlugin } from "./channel-ity6au4a.js";
 export { nostrPlugin };

package/dist/index.js

@@ -27,6 +27,10 @@ var nostr_default = defineBundledChannelEntry({
 		specifier: "./channel-plugin-api.js",
 		exportName: "nostrPlugin"
 	},
+	secrets: {
+		specifier: "./secret-contract-api.js",
+		exportName: "channelSecrets"
+	},
 	runtime: {
 		specifier: "./api.js",
 		exportName: "setNostrRuntime"

package/dist/secret-contract-api.js

@@ -0,0 +1,37 @@
+import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
+import { collectSecretInputAssignment, createChannelSecretTargetRegistryEntries, getChannelRecord } from "openclaw/plugin-sdk/channel-secret-basic-runtime";
+//#region extensions/nostr/src/secret-contract.ts
+const secretTargetRegistryEntries = createChannelSecretTargetRegistryEntries({
+	channelKey: "nostr",
+	channel: ["privateKey"]
+});
+function collectRuntimeConfigAssignments(params) {
+	const nostr = getChannelRecord(params.config, "nostr");
+	if (!nostr) return;
+	const accountId = normalizeAccountId(typeof nostr.defaultAccount === "string" ? nostr.defaultAccount : void 0);
+	collectSecretInputAssignment({
+		value: nostr.privateKey,
+		path: "channels.nostr.privateKey",
+		expected: "string",
+		defaults: params.defaults,
+		context: params.context,
+		active: nostr.enabled !== false,
+		inactiveReason: "Nostr channel is disabled.",
+		owner: {
+			ownerKind: "account",
+			ownerId: `nostr:${accountId}`,
+			requiredForGateway: false,
+			disposition: "isolate",
+			contract: nostr
+		},
+		apply: (value) => {
+			nostr.privateKey = value;
+		}
+	});
+}
+const channelSecrets = {
+	secretTargetRegistryEntries,
+	collectRuntimeConfigAssignments
+};
+//#endregion
+export { channelSecrets, collectRuntimeConfigAssignments, secretTargetRegistryEntries };

package/dist/{setup-adapter-DLthHa2q.js → setup-adapter-ClKW2fkz.js}

@@ -8,6 +8,9 @@ const DEFAULT_RELAYS = ["wss://relay.damus.io", "wss://nos.lol"];
 //#endregion
 //#region extensions/nostr/src/private-key.ts
 const NOSTR_PRIVATE_KEY_ENV_VAR = "NOSTR_PRIVATE_KEY";
+function hasConfiguredNostrPrivateKey(value) {
+	return hasConfiguredSecretInput(value) || Boolean(process.env["NOSTR_PRIVATE_KEY"]?.trim());
+}
 function resolveNostrPrivateKey(value) {
 	const configured = normalizeSecretInputString(value);
 	if (configured || hasConfiguredSecretInput(value)) return configured ?? "";
@@ -124,4 +127,4 @@ function createNostrSetupStatus(resolveAccount) {
 	});
 }
 //#endregion
-export { parseRelayUrls as a, createNostrSetupStatus as i, createNostrSetupAdapter as n, resolveNostrPrivateKey as o, createNostrSetupContract as r, DEFAULT_RELAYS as s, buildNostrSetupPatch as t };
+export { parseRelayUrls as a, DEFAULT_RELAYS as c, createNostrSetupStatus as i, createNostrSetupAdapter as n, hasConfiguredNostrPrivateKey as o, createNostrSetupContract as r, resolveNostrPrivateKey as s, buildNostrSetupPatch as t };

package/dist/setup-api.js

@@ -1,2 +1,2 @@
-import { r as nostrSetupWizard, t as nostrSetupAdapter } from "./setup-surface-DAhyNOcb.js";
+import { r as nostrSetupWizard, t as nostrSetupAdapter } from "./setup-surface-uA4hN27A.js";
 export { nostrSetupAdapter, nostrSetupWizard };

package/dist/setup-entry.js

@@ -5,6 +5,10 @@ var setup_entry_default = defineBundledChannelSetupEntry({
 	plugin: {
 		specifier: "./setup-plugin-api.js",
 		exportName: "nostrSetupPlugin"
+	},
+	secrets: {
+		specifier: "./secret-contract-api.js",
+		exportName: "channelSecrets"
 	}
 });
 //#endregion

package/dist/setup-plugin-api.js

@@ -1,21 +1,21 @@
 import { i as buildChannelConfigSchema, t as NostrConfigSchema } from "./config-schema-CkYd8ACn.js";
-import { i as createNostrSetupStatus, n as createNostrSetupAdapter, o as resolveNostrPrivateKey, r as createNostrSetupContract, s as DEFAULT_RELAYS } from "./setup-adapter-DLthHa2q.js";
+import { c as DEFAULT_RELAYS, i as createNostrSetupStatus, n as createNostrSetupAdapter, o as hasConfiguredNostrPrivateKey, r as createNostrSetupContract, s as resolveNostrPrivateKey } from "./setup-adapter-ClKW2fkz.js";
 import { describeAccountSnapshot } from "openclaw/plugin-sdk/account-helpers";
-import { DEFAULT_ACCOUNT_ID, createDelegatedSetupWizardProxy } from "openclaw/plugin-sdk/setup-runtime";
+import { normalizeAccountId } from "openclaw/plugin-sdk/account-id";
+import { createDelegatedSetupWizardProxy } from "openclaw/plugin-sdk/setup-runtime";
 //#region extensions/nostr/src/channel.setup.ts
 const channel = "nostr";
 function getNostrConfig(cfg) {
 	return cfg.channels?.nostr;
 }
 function resolveDefaultSetupNostrAccountId(cfg) {
-	const configured = getNostrConfig(cfg)?.defaultAccount;
-	return typeof configured === "string" && configured.trim() ? configured.trim() : DEFAULT_ACCOUNT_ID;
+	return normalizeAccountId(getNostrConfig(cfg)?.defaultAccount);
 }
 function resolveSetupNostrAccount(params) {
 	const nostrCfg = getNostrConfig(params.cfg);
-	const accountId = params.accountId?.trim() || resolveDefaultSetupNostrAccountId(params.cfg);
+	const accountId = normalizeAccountId(params.accountId ?? resolveDefaultSetupNostrAccountId(params.cfg));
 	const privateKey = resolveNostrPrivateKey(nostrCfg?.privateKey);
-	const configured = Boolean(privateKey);
+	const configured = hasConfiguredNostrPrivateKey(nostrCfg?.privateKey);
 	return {
 		accountId,
 		name: typeof nostrCfg?.name === "string" ? nostrCfg.name : void 0,
@@ -38,7 +38,7 @@ function resolveSetupNostrAccount(params) {
 }
 const nostrSetupWizard = createDelegatedSetupWizardProxy({
 	channel,
-	loadWizard: async () => (await import("./setup-surface-DAhyNOcb.js").then((n) => n.i)).nostrSetupWizard,
+	loadWizard: async () => (await import("./setup-surface-uA4hN27A.js").then((n) => n.i)).nostrSetupWizard,
 	status: createNostrSetupStatus(resolveSetupNostrAccount),
 	resolveShouldPromptAccountIds: () => false,
 	delegatePrepare: true,

package/dist/{setup-surface-DAhyNOcb.js → setup-surface-uA4hN27A.js}

@@ -1,4 +1,4 @@
-import { a as parseRelayUrls, i as createNostrSetupStatus, n as createNostrSetupAdapter, o as resolveNostrPrivateKey, r as createNostrSetupContract, s as DEFAULT_RELAYS, t as buildNostrSetupPatch } from "./setup-adapter-DLthHa2q.js";
+import { a as parseRelayUrls, c as DEFAULT_RELAYS, i as createNostrSetupStatus, n as createNostrSetupAdapter, o as hasConfiguredNostrPrivateKey, r as createNostrSetupContract, s as resolveNostrPrivateKey, t as buildNostrSetupPatch } from "./setup-adapter-ClKW2fkz.js";
 import { createAccountListHelpers } from "openclaw/plugin-sdk/account-helpers";
 import { normalizeOptionalString } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { hasConfiguredSecretInput, normalizeSecretInputString } from "openclaw/plugin-sdk/secret-input";
@@ -59,7 +59,7 @@ const { listAccountIds: listNostrAccountIds, resolveDefaultAccountId: resolveDef
 	fallbackAccountIdWhenEmpty: false,
 	resolveImplicitAccountId: (cfg) => {
 		const account = cfg.channels?.nostr;
-		return resolveNostrPrivateKey(account?.privateKey) ? normalizeOptionalAccountId(account?.defaultAccount) ?? DEFAULT_ACCOUNT_ID : void 0;
+		return hasConfiguredNostrPrivateKey(account?.privateKey) ? normalizeOptionalAccountId(account?.defaultAccount) ?? DEFAULT_ACCOUNT_ID : void 0;
 	}
 });
 /**
@@ -70,7 +70,7 @@ function resolveNostrAccount(opts) {
 	const nostrCfg = opts.cfg.channels?.nostr;
 	const baseEnabled = nostrCfg?.enabled !== false;
 	const privateKey = resolveNostrPrivateKey(nostrCfg?.privateKey);
-	const configured = Boolean(privateKey);
+	const configured = hasConfiguredNostrPrivateKey(nostrCfg?.privateKey);
 	let publicKey = "";
 	if (privateKey) try {
 		publicKey = getPublicKeyFromPrivate(privateKey);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/nostr",
-  "version": "2026.8.1-beta.2",
+  "version": "2026.8.1-beta.3",
   "description": "OpenClaw Nostr channel plugin for NIP-04 encrypted direct messages.",
   "repository": {
     "type": "git",
@@ -12,7 +12,7 @@
     "zod": "4.4.3"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.8.1-beta.2"
+    "openclaw": ">=2026.8.1-beta.3"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -79,10 +79,10 @@
       "minHostVersion": ">=2026.4.10"
     },
     "compat": {
-      "pluginApi": ">=2026.8.1-beta.2"
+      "pluginApi": ">=2026.8.1-beta.3"
     },
     "build": {
-      "openclawVersion": "2026.8.1-beta.2"
+      "openclawVersion": "2026.8.1-beta.3"
     },
     "release": {
       "publishToClawHub": true,