@openclaw/nostr 2026.7.2-beta.7 → 2026.8.1-beta.3

package/dist/api.js

@@ -1,14 +1,14 @@
-import { s as resolveNostrAccount } from "./setup-surface-BJCFpe02.js";
+import { s as resolveNostrAccount } from "./setup-surface-uA4hN27A.js";
 import { getPluginRuntimeGatewayRequestScope } from "./runtime-api.js";
-import { n as NostrProfileSchema } from "./config-schema-CelPzg1N.js";
-import { a as getNostrRuntime, i as contentToProfile, n as nostrPlugin, o as setNostrRuntime, r as publishNostrProfile, t as getNostrProfileState } from "./channel-O6-jXoT5.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-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-O6-jXoT5.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, t as nostrSetupAdapter } from "./setup-surface-BJCFpe02.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-CelPzg1N.js";
-import { a as DEFAULT_RELAYS } from "./setup-adapter-BjKmSwdW.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 { 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";
@@ -9,14 +9,18 @@ import { missingTargetError } from "openclaw/plugin-sdk/channel-feedback";
 import { DEFAULT_INGRESS_ADOPTION_STALL_MS, bindIngressLifecycleToReplyOptions, createChannelIngressError, createChannelIngressMonitor, createChannelMessageAdapterFromOutbound, runPassiveAccountLifecycle } from "openclaw/plugin-sdk/channel-outbound";
 import { buildPassiveChannelStatusSummary, buildTrafficStatusSummary } from "openclaw/plugin-sdk/extension-shared";
 import { createComputedAccountStatusAdapter } from "openclaw/plugin-sdk/status-helpers";
-import { normalizeStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { isRecord as isNostrIngressRecord, normalizeStringEntries } from "openclaw/plugin-sdk/string-coerce-runtime";
 import { resolveStableChannelMessageIngress } from "openclaw/plugin-sdk/channel-ingress-runtime";
 import { createChannelPairingController } from "openclaw/plugin-sdk/channel-pairing";
 import { attachChannelToResult } from "openclaw/plugin-sdk/channel-send-result";
+import { channelReadyPatch } from "openclaw/plugin-sdk/gateway-runtime";
 import { chunkTextForOutbound, sanitizeAssistantVisibleText, stripMarkdown } from "openclaw/plugin-sdk/text-chunking";
 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";
@@ -288,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));
@@ -382,9 +383,6 @@ var NostrIngressPermanentError = class extends Error {
 		this.name = "NostrIngressPermanentError";
 	}
 };
-function isNostrIngressRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 function requiredString(value, field) {
 	if (typeof value === "string" && value.trim()) return value;
 	throw new NostrIngressPermanentError("invalid-event", `Nostr event is missing ${field}.`);
@@ -550,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
@@ -563,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 () => {
@@ -744,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;
@@ -1359,8 +1315,10 @@ 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();
+}
 function parseNostrAccessGroupAllowFromEntry(entry) {
 	const trimmed = entry.trim();
 	if (!trimmed.startsWith(ACCESS_GROUP_PREFIX)) return null;
@@ -1396,17 +1354,20 @@ const startNostrGatewayAccount = async (ctx) => {
 	const account = ctx.account;
 	ctx.setStatus({
 		accountId: account.accountId,
-		publicKey: account.publicKey
+		publicKey: account.publicKey,
+		lifecycle: "starting"
 	});
 	ctx.log?.info?.(`[${account.accountId}] starting Nostr provider (pubkey: ${account.publicKey})`);
 	if (!account.configured) throw new Error("Nostr private key not configured");
+	const channelRuntime = ctx.channelRuntime;
+	if (!channelRuntime?.inbound?.buildContext) throw new Error("Nostr requires its registered channel runtime context builder");
 	const runtime = getNostrRuntime();
 	const pairing = createChannelPairingController({
 		core: runtime,
 		channel: "nostr",
 		accountId: account.accountId
 	});
-	const resolveInboundAccess = async (senderPubkey, rawBody) => await resolveStableChannelMessageIngress({
+	const resolveInboundAccess = async (senderPubkey, rawBody, contextBinding) => await resolveStableChannelMessageIngress({
 		channelId: "nostr",
 		accountId: account.accountId,
 		identity: nostrIngressIdentity,
@@ -1417,11 +1378,12 @@ const startNostrGatewayAccount = async (ctx) => {
 			kind: "direct",
 			id: senderPubkey
 		},
+		contextBinding,
 		dmPolicy: account.config.dmPolicy ?? "pairing",
 		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, "");
 		if (resolved.senderAccess.decision === "allow") return "allow";
@@ -1461,6 +1423,12 @@ const startNostrGatewayAccount = async (ctx) => {
 					}
 					const { dispatchInboundDirectDm } = await import("./inbound-direct-dm-runtime-DHn9NoYN.js");
 					await dispatchInboundDirectDm({
+						channelRuntime,
+						resolveChannelIngress: async (contextBinding) => {
+							const exactAccess = await resolveInboundAccess(senderPubkey, text, contextBinding);
+							if (!exactAccess.senderAccess.allowed) throw new Error(`Nostr sender authorization changed before dispatch (${senderPubkey})`);
+							return exactAccess;
+						},
 						cfg: ctx.cfg,
 						channel: "nostr",
 						channelLabel: "Nostr",
@@ -1501,9 +1469,17 @@ const startNostrGatewayAccount = async (ctx) => {
 					ctx.log?.error?.(`[${account.accountId}] Nostr error (${context}): ${error.message}`);
 				},
 				onConnect: (relay) => {
+					connectedRelays.add(normalizeRelayLifecycleKey(relay));
+					ctx.setStatus(channelReadyPatch({ accountId: account.accountId }));
 					ctx.log?.debug?.(`[${account.accountId}] Connected to relay: ${relay}`);
 				},
 				onDisconnect: (relay) => {
+					connectedRelays.delete(normalizeRelayLifecycleKey(relay));
+					if (connectedRelays.size === 0) ctx.setStatus({
+						accountId: account.accountId,
+						connected: false,
+						lifecycle: "recovering"
+					});
 					ctx.log?.debug?.(`[${account.accountId}] Disconnected from relay: ${relay}`);
 				},
 				onEose: (relays) => {
@@ -1514,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`);
 			} };
 		},
@@ -1618,6 +1590,14 @@ function normalizeNostrTarget(target) {
 		return target.trim();
 	}
 }
+function inferNostrTargetChatType(target) {
+	try {
+		normalizePubkey(stripNostrTargetPrefix(target));
+		return "direct";
+	} catch {
+		return;
+	}
+}
 const resolveNostrDmPolicy = createScopedDmSecurityResolver({
 	channelKey: "nostr",
 	resolvePolicy: (account) => account.config.dmPolicy,
@@ -1692,7 +1672,6 @@ const nostrPlugin = createChatChannelPlugin({
 		},
 		reload: { configPrefixes: ["channels.nostr"] },
 		configSchema: buildChannelConfigSchema(NostrConfigSchema),
-		setup: nostrSetupAdapter,
 		setupContract: nostrSetupContract,
 		setupWizard: nostrSetupWizard,
 		config: {
@@ -1707,6 +1686,7 @@ const nostrPlugin = createChatChannelPlugin({
 		messaging: {
 			targetPrefixes: ["nostr"],
 			normalizeTarget: normalizeNostrTarget,
+			inferTargetChatType: ({ to }) => inferNostrTargetChatType(to),
 			targetResolver: {
 				looksLikeId: (input, normalized) => {
 					const trimmed = normalized?.trim() || stripNostrTargetPrefix(input);

package/dist/channel-plugin-api.js

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

package/dist/{config-schema-CelPzg1N.js → config-schema-CkYd8ACn.js}

@@ -46,6 +46,7 @@ const NostrConfigSchema = z.object({
 	defaultAccount: z.string().optional(),
 	/** Whether this channel is enabled */
 	enabled: z.boolean().optional(),
+	configWrites: z.boolean().optional(),
 	/** Markdown formatting overrides (tables). */
 	markdown: MarkdownConfigSchema,
 	/** Private key in hex or nsec bech32 format */

package/dist/doctor-contract-api.js

@@ -1,22 +1,20 @@
 import { t as normalizeNostrStateAccountId } from "./state-account-id-CvBZ9s6P.js";
+import { asFiniteNumber } from "openclaw/plugin-sdk/string-coerce-runtime";
 import fs from "node:fs/promises";
 import path from "node:path";
-import { archiveLegacyStateSource } from "openclaw/plugin-sdk/runtime-doctor";
+import { archiveLegacyStateSource } from "openclaw/plugin-sdk/runtime-doctor-migrations";
 //#region extensions/nostr/doctor-contract-api.ts
 const BUS_STATE_NAMESPACE = "bus-state";
 const PROFILE_STATE_NAMESPACE = "profile-state";
 const MAX_NOSTR_STATE_ENTRIES = 256;
-function finiteNumberOrNull(value) {
-	return typeof value === "number" && Number.isFinite(value) ? value : null;
-}
 function parseBusState(value) {
 	if (!value || typeof value !== "object" || Array.isArray(value)) return null;
 	const parsed = value;
 	if (parsed.version !== 1 && parsed.version !== 2) return null;
 	return {
 		version: 2,
-		lastProcessedAt: finiteNumberOrNull(parsed.lastProcessedAt),
-		gatewayStartedAt: finiteNumberOrNull(parsed.gatewayStartedAt),
+		lastProcessedAt: asFiniteNumber(parsed.lastProcessedAt) ?? null,
+		gatewayStartedAt: asFiniteNumber(parsed.gatewayStartedAt) ?? null,
 		recentEventIds: parsed.version === 2 && Array.isArray(parsed.recentEventIds) ? parsed.recentEventIds.filter((entry) => typeof entry === "string") : []
 	};
 }
@@ -31,7 +29,7 @@ function parseProfileState(value) {
 	}
 	return {
 		version: 1,
-		lastPublishedAt: finiteNumberOrNull(parsed.lastPublishedAt),
+		lastPublishedAt: asFiniteNumber(parsed.lastPublishedAt) ?? null,
 		lastPublishedEventId: typeof parsed.lastPublishedEventId === "string" ? parsed.lastPublishedEventId : null,
 		lastPublishResults: rawResults === null || Object.keys(lastPublishResults).length === 0 ? null : lastPublishResults
 	};

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-BjKmSwdW.js → setup-adapter-ClKW2fkz.js}

@@ -1,10 +1,22 @@
 import { uniqueStrings } from "openclaw/plugin-sdk/string-coerce-runtime";
+import { hasConfiguredSecretInput, normalizeSecretInputString } from "openclaw/plugin-sdk/secret-input";
 import { DEFAULT_ACCOUNT_ID } from "openclaw/plugin-sdk/routing";
-import { patchTopLevelChannelConfigSection, splitSetupEntries } from "openclaw/plugin-sdk/setup";
+import { createSetupTranslator, createStandardChannelSetupStatus, patchTopLevelChannelConfigSection, splitSetupEntries } from "openclaw/plugin-sdk/setup";
 import { defineChannelSetupContract } from "openclaw/plugin-sdk/channel-setup";
 //#region extensions/nostr/src/default-relays.ts
 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 ?? "";
+	return process.env["NOSTR_PRIVATE_KEY"]?.trim() ?? "";
+}
+//#endregion
 //#region extensions/nostr/src/setup-adapter.ts
 const channel = "nostr";
 function buildNostrSetupPatch(accountId, patch) {
@@ -41,25 +53,23 @@ function createNostrSetupAdapter(params) {
 			patch: buildNostrSetupPatch(accountId, name?.trim() ? { name: name.trim() } : {})
 		}),
 		validateInput: ({ input }) => {
-			const typedInput = input;
-			if (!typedInput.useEnv) {
-				const privateKey = typedInput.privateKey?.trim();
+			if (!input.useEnv) {
+				const privateKey = input.privateKey?.trim();
 				if (!privateKey) return "Nostr requires --private-key or --use-env.";
 				if (!params.validatePrivateKey(privateKey)) return "Nostr private key must be valid nsec or 64-character hex.";
 			}
-			if (typedInput.relayUrls?.trim()) return parseRelayUrls(typedInput.relayUrls).error ?? null;
+			if (input.relayUrls?.trim()) return parseRelayUrls(input.relayUrls).error ?? null;
 			return null;
 		},
 		applyAccountConfig: ({ cfg, accountId, input }) => {
-			const typedInput = input;
-			const relayResult = typedInput.relayUrls?.trim() ? parseRelayUrls(typedInput.relayUrls) : { relays: [] };
+			const relayResult = input.relayUrls?.trim() ? parseRelayUrls(input.relayUrls) : { relays: [] };
 			return patchTopLevelChannelConfigSection({
 				cfg,
 				channel,
 				enabled: true,
-				clearFields: typedInput.useEnv ? ["privateKey"] : void 0,
+				clearFields: input.useEnv ? ["privateKey"] : void 0,
 				patch: buildNostrSetupPatch(accountId, {
-					...typedInput.useEnv ? {} : { privateKey: typedInput.privateKey?.trim() },
+					...input.useEnv ? {} : { privateKey: input.privateKey?.trim() },
 					...relayResult.relays.length > 0 ? { relays: relayResult.relays } : {}
 				})
 			});
@@ -89,11 +99,32 @@ function createNostrSetupContract(adapter) {
 				cli: {
 					flags: "--use-env",
 					description: "Use NOSTR_PRIVATE_KEY"
-				}
+				},
+				envVars: [NOSTR_PRIVATE_KEY_ENV_VAR]
 			}
 		},
-		legacyAdapter: adapter
+		adapter
+	});
+}
+function createNostrSetupStatus(resolveAccount) {
+	const t = createSetupTranslator();
+	return createStandardChannelSetupStatus({
+		channelLabel: "Nostr",
+		configuredLabel: t("wizard.channels.statusConfigured"),
+		unconfiguredLabel: t("wizard.channels.statusNeedsPrivateKey"),
+		configuredHint: t("wizard.channels.statusConfigured"),
+		unconfiguredHint: t("wizard.channels.statusNeedsPrivateKey"),
+		configuredScore: 1,
+		unconfiguredScore: 0,
+		includeStatusLine: true,
+		resolveConfigured: ({ cfg, accountId }) => resolveAccount({
+			cfg,
+			accountId
+		}).configured,
+		resolveExtraStatusLines: ({ cfg }) => {
+			return [`Relays: ${resolveAccount({ cfg }).relays.length || DEFAULT_RELAYS.length}`];
+		}
 	});
 }
 //#endregion
-export { DEFAULT_RELAYS as a, parseRelayUrls as i, createNostrSetupAdapter as n, createNostrSetupContract as r, 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-BJCFpe02.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,27 +1,21 @@
-import { i as buildChannelConfigSchema, t as NostrConfigSchema } from "./config-schema-CelPzg1N.js";
-import { a as DEFAULT_RELAYS, n as createNostrSetupAdapter, r as createNostrSetupContract } from "./setup-adapter-BjKmSwdW.js";
+import { i as buildChannelConfigSchema, t as NostrConfigSchema } from "./config-schema-CkYd8ACn.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, createSetupTranslator, createStandardChannelSetupStatus } 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 t = createSetupTranslator();
 const channel = "nostr";
 function getNostrConfig(cfg) {
 	return cfg.channels?.nostr;
 }
-function listSetupNostrAccountIds(cfg) {
-	const nostrCfg = getNostrConfig(cfg);
-	if (!(typeof nostrCfg?.privateKey === "string" ? nostrCfg.privateKey.trim() : "")) return [];
-	return [resolveDefaultSetupNostrAccountId(cfg)];
-}
 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 privateKey = typeof nostrCfg?.privateKey === "string" ? nostrCfg.privateKey.trim() : "";
-	const configured = Boolean(privateKey);
+	const accountId = normalizeAccountId(params.accountId ?? resolveDefaultSetupNostrAccountId(params.cfg));
+	const privateKey = resolveNostrPrivateKey(nostrCfg?.privateKey);
+	const configured = hasConfiguredNostrPrivateKey(nostrCfg?.privateKey);
 	return {
 		accountId,
 		name: typeof nostrCfg?.name === "string" ? nostrCfg.name : void 0,
@@ -42,34 +36,10 @@ function resolveSetupNostrAccount(params) {
 		}
 	};
 }
-function looksLikeNostrPrivateKey(privateKey) {
-	return privateKey.startsWith("nsec1") || privateKey.startsWith("NSEC1") || /^[0-9a-fA-F]{64}$/.test(privateKey);
-}
-const nostrSetupAdapter = createNostrSetupAdapter({
-	resolveAccountId: (cfg, accountId) => accountId?.trim() || resolveDefaultSetupNostrAccountId(cfg),
-	validatePrivateKey: looksLikeNostrPrivateKey
-});
-const nostrSetupContract = createNostrSetupContract(nostrSetupAdapter);
 const nostrSetupWizard = createDelegatedSetupWizardProxy({
 	channel,
-	loadWizard: async () => (await import("./setup-surface-BJCFpe02.js").then((n) => n.i)).nostrSetupWizard,
-	status: { ...createStandardChannelSetupStatus({
-		channelLabel: "Nostr",
-		configuredLabel: t("wizard.channels.statusConfigured"),
-		unconfiguredLabel: t("wizard.channels.statusNeedsPrivateKey"),
-		configuredHint: t("wizard.channels.statusConfigured"),
-		unconfiguredHint: t("wizard.channels.statusNeedsPrivateKey"),
-		configuredScore: 1,
-		unconfiguredScore: 0,
-		includeStatusLine: true,
-		resolveConfigured: ({ cfg, accountId }) => resolveSetupNostrAccount({
-			cfg,
-			accountId
-		}).configured,
-		resolveExtraStatusLines: ({ cfg }) => {
-			return [`Relays: ${resolveSetupNostrAccount({ cfg }).relays.length || DEFAULT_RELAYS.length}`];
-		}
-	}) },
+	loadWizard: async () => (await import("./setup-surface-uA4hN27A.js").then((n) => n.i)).nostrSetupWizard,
+	status: createNostrSetupStatus(resolveSetupNostrAccount),
 	resolveShouldPromptAccountIds: () => false,
 	delegatePrepare: true,
 	delegateFinalize: true
@@ -91,11 +61,13 @@ const nostrSetupPlugin = {
 	},
 	reload: { configPrefixes: ["channels.nostr"] },
 	configSchema: buildChannelConfigSchema(NostrConfigSchema),
-	setup: nostrSetupAdapter,
-	setupContract: nostrSetupContract,
+	setupContract: createNostrSetupContract(createNostrSetupAdapter({
+		resolveAccountId: (cfg, accountId) => accountId?.trim() || resolveDefaultSetupNostrAccountId(cfg),
+		validatePrivateKey: (privateKey) => /^(?:nsec1|NSEC1)|^[0-9a-fA-F]{64}$/u.test(privateKey)
+	})),
 	setupWizard: nostrSetupWizard,
 	config: {
-		listAccountIds: listSetupNostrAccountIds,
+		listAccountIds: (cfg) => resolveSetupNostrAccount({ cfg }).configured ? [resolveDefaultSetupNostrAccountId(cfg)] : [],
 		resolveAccount: (cfg, accountId) => resolveSetupNostrAccount({
 			cfg,
 			accountId

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

@@ -1,11 +1,11 @@
-import { a as DEFAULT_RELAYS, i as parseRelayUrls, n as createNostrSetupAdapter, r as createNostrSetupContract, t as buildNostrSetupPatch } from "./setup-adapter-BjKmSwdW.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";
 import { getPublicKey, nip19 } from "nostr-tools";
 import { DEFAULT_ACCOUNT_ID, normalizeAccountId, normalizeOptionalAccountId } from "openclaw/plugin-sdk/account-id";
 import { DEFAULT_ACCOUNT_ID as DEFAULT_ACCOUNT_ID$1 } from "openclaw/plugin-sdk/routing";
-import { createSetupTranslator, createStandardChannelSetupStatus, createTopLevelChannelDmPolicy, createTopLevelChannelParsedAllowFromPrompt, defineTokenCredential, formatDocsLink, mergeAllowFromEntries, parseSetupEntriesWithParser, patchTopLevelChannelConfigSection, setSetupChannelEnabled } from "openclaw/plugin-sdk/setup";
+import { createSetupTranslator, createTopLevelChannelDmPolicy, createTopLevelChannelParsedAllowFromPrompt, defineTokenCredential, formatDocsLink, mergeAllowFromEntries, parseSetupEntriesWithParser, patchTopLevelChannelConfigSection, setSetupChannelEnabled } from "openclaw/plugin-sdk/setup";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __exportAll = (all, no_symbols) => {
@@ -59,7 +59,7 @@ const { listAccountIds: listNostrAccountIds, resolveDefaultAccountId: resolveDef
 	fallbackAccountIdWhenEmpty: false,
 	resolveImplicitAccountId: (cfg) => {
 		const account = cfg.channels?.nostr;
-		return normalizeSecretInputString(account?.privateKey) ? normalizeOptionalAccountId(account?.defaultAccount) ?? DEFAULT_ACCOUNT_ID : void 0;
+		return hasConfiguredNostrPrivateKey(account?.privateKey) ? normalizeOptionalAccountId(account?.defaultAccount) ?? DEFAULT_ACCOUNT_ID : void 0;
 	}
 });
 /**
@@ -69,8 +69,8 @@ function resolveNostrAccount(opts) {
 	const accountId = normalizeAccountId(opts.accountId ?? resolveDefaultNostrAccountId(opts.cfg));
 	const nostrCfg = opts.cfg.channels?.nostr;
 	const baseEnabled = nostrCfg?.enabled !== false;
-	const privateKey = normalizeSecretInputString(nostrCfg?.privateKey) ?? "";
-	const configured = Boolean(privateKey);
+	const privateKey = resolveNostrPrivateKey(nostrCfg?.privateKey);
+	const configured = hasConfiguredNostrPrivateKey(nostrCfg?.privateKey);
 	let publicKey = "";
 	if (privateKey) try {
 		publicKey = getPublicKeyFromPrivate(privateKey);
@@ -162,20 +162,7 @@ const nostrSetupWizard = {
 	channel,
 	resolveAccountIdForConfigure: ({ accountOverride, defaultAccountId }) => accountOverride?.trim() || defaultAccountId,
 	resolveShouldPromptAccountIds: () => false,
-	status: createStandardChannelSetupStatus({
-		channelLabel: "Nostr",
-		configuredLabel: t("wizard.channels.statusConfigured"),
-		unconfiguredLabel: t("wizard.channels.statusNeedsPrivateKey"),
-		configuredHint: t("wizard.channels.statusConfigured"),
-		unconfiguredHint: t("wizard.channels.statusNeedsPrivateKey"),
-		configuredScore: 1,
-		unconfiguredScore: 0,
-		includeStatusLine: true,
-		resolveConfigured: ({ cfg }) => resolveNostrAccount({ cfg }).configured,
-		resolveExtraStatusLines: ({ cfg }) => {
-			return [`Relays: ${resolveNostrAccount({ cfg }).relays.length || DEFAULT_RELAYS.length}`];
-		}
-	}),
+	status: createNostrSetupStatus(resolveNostrAccount),
 	introNote: {
 		title: t("wizard.nostr.setupTitle"),
 		lines: NOSTR_SETUP_HELP_LINES

package/openclaw.plugin.json

@@ -1,5 +1,8 @@
 {
   "id": "nostr",
+  "doctorContract": {
+    "stateMigrations": true
+  },
   "name": "Nostr",
   "description": "OpenClaw Nostr channel plugin for NIP-04 encrypted direct messages.",
   "activation": {
@@ -28,6 +31,9 @@
           "enabled": {
             "type": "boolean"
           },
+          "configWrites": {
+            "type": "boolean"
+          },
           "markdown": {
             "type": "object",
             "properties": {
@@ -73,6 +79,29 @@
                     ],
                     "additionalProperties": false
                   },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "source": {
+                        "type": "string",
+                        "const": "store"
+                      },
+                      "provider": {
+                        "type": "string",
+                        "pattern": "^[a-z][a-z0-9_-]{0,63}$"
+                      },
+                      "id": {
+                        "type": "string",
+                        "pattern": "^[A-Z][A-Z0-9_]{0,127}$"
+                      }
+                    },
+                    "required": [
+                      "source",
+                      "provider",
+                      "id"
+                    ],
+                    "additionalProperties": false
+                  },
                   {
                     "type": "object",
                     "properties": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/nostr",
-  "version": "2026.7.2-beta.7",
+  "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.7.2-beta.7"
+    "openclaw": ">=2026.8.1-beta.3"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -65,7 +65,10 @@
             "cli": {
               "flags": "--use-env",
               "description": "Use NOSTR_PRIVATE_KEY"
-            }
+            },
+            "envVars": [
+              "NOSTR_PRIVATE_KEY"
+            ]
           }
         ]
       }
@@ -76,10 +79,10 @@
       "minHostVersion": ">=2026.4.10"
     },
     "compat": {
-      "pluginApi": ">=2026.7.2-beta.7"
+      "pluginApi": ">=2026.8.1-beta.3"
     },
     "build": {
-      "openclawVersion": "2026.7.2-beta.7"
+      "openclawVersion": "2026.8.1-beta.3"
     },
     "release": {
       "publishToClawHub": true,