nightpay 0.3.10 → 0.3.11

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "nightpay",
   "name": "NightPay",
   "description": "Anonymous community bounty pools \u2014 Midnight ZK proofs + Masumi settlement + Cardano finality. Skills auto-loaded from skills/nightpay/.",
-  "version": "0.3.10",
+  "version": "0.3.11",
   "configSchema": {},
   "skills": [
     "skills/nightpay"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nightpay",
-  "version": "0.3.10",
+  "version": "0.3.11",
   "description": "Anonymous community bounties for AI agents. Midnight ZK proofs + Masumi settlement + Cardano finality.",
   "keywords": [
     "bounties",

package/plugin.js

@@ -1,16 +1,18 @@
 #!/usr/bin/env node
-// NightPay OpenClaw plugin entrypoint -- v0.3.10
-// Fix: always rmSync+cpSync on gateway_start (v0.3.8 skipped real dirs)
+// NightPay OpenClaw plugin entrypoint -- v0.3.11
+// Fix: bridge health probe on gateway_start, RECEIPT_CONTRACT_ADDRESS validation,
+//      wallet connectivity status in ready log
 
 import { fileURLToPath } from "node:url";
 import { dirname, join } from "node:path";
 import { existsSync, mkdirSync, cpSync, rmSync } from "node:fs";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
-
 const SKILL_SRC = join(__dirname, "skills", "nightpay");
 
 const REQUIRED_ENV = ["MASUMI_API_KEY", "OPERATOR_ADDRESS", "BRIDGE_URL"];
+const WALLET_ENV = ["RECEIPT_CONTRACT_ADDRESS", "OPERATOR_SECRET_KEY"];
+
 const DEFAULTS = {
   NIGHTPAY_API_URL: "https://api.nightpay.dev",
   MIDNIGHT_NETWORK: "preprod",
@@ -55,7 +57,7 @@ const FULL_CONTEXT = [
   "### Job lifecycle",
   "running -> awaiting_approval -> completed | disputed | refunded",
   "",
-  "### Key tools (gateway.sh or MIP-003 API)",
+  "### Key tools (bridge or MIP-003 API)",
   "- create_pool(description, contributionAmountSpecks, fundingGoalSpecks, maxFunders)",
   "- fund_pool(poolCommitment, funderNullifier)",
   "- submit_work(jobId, workOutput, bountyCommitment, outputHash)",
@@ -64,7 +66,7 @@ const FULL_CONTEXT = [
   "",
   "### Pre-flight (ALWAYS before funding or accepting work)",
   "1. GET /availability -- operator online?",
-  "2. gateway.sh stats -> operatorFeeBps <= 500? initialized = 1?",
+  "2. GET BRIDGE_URL/health -> contractAddress + stub status",
   "3. verify-receipt <any_hash> -> ZK system live?",
   "",
   "### CRITICAL privacy rule",
@@ -76,7 +78,7 @@ const FULL_CONTEXT = [
 ].join("\n");
 
 const OPERATING_MODEL = [
-  "NightPay Operating Model -- v0.3.10",
+  "NightPay Operating Model -- v0.3.11",
   "=".repeat(50),
   "",
   "POOL CREATION",
@@ -102,12 +104,18 @@ const OPERATING_MODEL = [
   "  Pool expires (deadline + goal unmet) -> claimRefund() returns 100% to funders",
   "  Work disputed -> dispute resolution flow (see skills/nightpay/AGENTS.md)",
   "",
+  "WALLET CONNECTIVITY",
+  "  Masumi:   NIGHTPAY_API_URL (MIP-003, /availability /start_job /status)",
+  "  Cardano:  OPERATOR_ADDRESS (64-char hex, receives operator fees on settlement)",
+  "  Midnight: BRIDGE_URL/health (ZK contract, auto-discovered contractAddress)",
+  "  Keys:     MASUMI_API_KEY + OPERATOR_SECRET_KEY + RECEIPT_CONTRACT_ADDRESS",
+  "",
   "ACTIVATION PHRASES",
   '  "create a bounty pool for X"  "show bounty board"  "fund this anonymously"',
   '  "hire an agent to do X"  "post a bounty for X"  "claim refund on pool X"',
   "",
   "COMMANDS",
-  "  /nightpay status  -- config + connectivity check",
+  "  /nightpay status  -- config + bridge + connectivity check",
   "  /nightpay help    -- this message",
   "  /nightpay <task>  -- delegate task to nightpay skill",
   "",
@@ -125,6 +133,20 @@ function missingEnv(env) {
   return REQUIRED_ENV.filter((k) => !env[k] || env[k] === k || env[k] === "");
 }
 
+function missingWalletEnv(env) {
+  return WALLET_ENV.filter((k) => !env[k] || env[k] === k || env[k] === "");
+}
+
+function isPlaceholderAddress(addr) {
+  if (!addr) return true;
+  // Detect obvious placeholders like aabbcc... repeated patterns
+  const cleaned = addr.replace(/[^a-f0-9]/gi, "").toLowerCase();
+  if (cleaned.length < 32) return true;
+  // Check if it's all one repeated pattern (aaaa... or aabb... cycles)
+  const unique = new Set(cleaned.split("")).size;
+  return unique <= 4; // real hex addresses have more entropy
+}
+
 function detectIntent(prompt, messages) {
   const text = (prompt || "").toLowerCase();
   if (STRONG_TRIGGERS.some((t) => text.includes(t))) return "full";
@@ -143,25 +165,37 @@ function detectIntent(prompt, messages) {
   return "none";
 }
 
+/**
+ * Probe bridge/health: returns { contractAddress, network, stub } or null on failure.
+ */
+async function probeBridge(bridgeUrl, logger) {
+  try {
+    const res = await fetch(`${bridgeUrl}/health`, { signal: AbortSignal.timeout(6000) });
+    if (!res.ok) {
+      logger.warn(`[nightpay] Bridge health check failed: HTTP ${res.status}`);
+      return null;
+    }
+    return await res.json();
+  } catch (err) {
+    logger.warn(`[nightpay] Bridge unreachable: ${err.message}`);
+    return null;
+  }
+}
+
 /**
  * Copy skills/nightpay into every configured agent workspace.
- * Always removes the existing path first (works for symlinks, real dirs,
- * or nothing — rmSync with force:true is a no-op on absent paths).
+ * Always removes the existing path first (handles symlinks, real dirs, absent).
  * OpenClaw realpath() rejects symlinks outside workspace root; real files pass.
  */
 function wireSkillIntoWorkspaces(config, logger) {
   const workspaces = new Set();
-
   const defaultWs = config?.agents?.defaults?.workspace;
   if (defaultWs) workspaces.add(defaultWs);
-
   const agents = config?.agents?.list ?? [];
   for (const agent of agents) {
     if (agent?.workspace) workspaces.add(agent.workspace);
   }
-
   let wired = 0, errors = 0;
-
   for (const ws of workspaces) {
     const skillsDir = join(ws, "skills");
     const destPath = join(skillsDir, "nightpay");
@@ -170,13 +204,11 @@ function wireSkillIntoWorkspaces(config, logger) {
       rmSync(destPath, { recursive: true, force: true });
       cpSync(SKILL_SRC, destPath, { recursive: true });
       wired++;
-      logger.info(`[nightpay] Skill docs -> ${destPath}`);
     } catch (err) {
       errors++;
-      logger.warn(`[nightpay] Could not wire skill docs into ${ws}: ${err.message}`);
+      logger.warn(`[nightpay] Could not copy skill docs into ${ws}: ${err.message}`);
     }
   }
-
   return { wired, errors };
 }
 
@@ -188,6 +220,7 @@ const plugin = {
 
   register(api) {
     api.on("gateway_start", async () => {
+      // 1. Wire skill docs into all workspaces
       const { wired, errors } = wireSkillIntoWorkspaces(api.config, api.logger);
       api.logger.info(
         `[nightpay] Skill docs refreshed in ${wired} workspace(s)` +
@@ -196,24 +229,66 @@ const plugin = {
 
       const env = resolveEnv(api.config);
       const missing = missingEnv(env);
+
       if (missing.length > 0) {
         api.logger.warn(
-          `[nightpay] Plugin loaded -- ${missing.length} credential(s) missing: ${missing.join(", ")}.\n` +
+          `[nightpay] Plugin loaded -- ${missing.length} required credential(s) missing: ${missing.join(", ")}.\n` +
           `  Set: openclaw config set skills.entries.nightpay.env.<KEY> "value"\n` +
           `  Then: openclaw gateway restart\n` +
-          `  Operating model: /nightpay help in your channel`
+          `  Run /nightpay help for the operating model`
         );
-      } else {
-        const url = env.NIGHTPAY_API_URL || DEFAULTS.NIGHTPAY_API_URL;
-        const net = env.MIDNIGHT_NETWORK || DEFAULTS.MIDNIGHT_NETWORK;
-        const fee = env.OPERATOR_FEE_BPS || DEFAULTS.OPERATOR_FEE_BPS;
-        api.logger.info(
-          `[nightpay] Ready -- ${url} | network: ${net} | fee: ${fee}bps\n` +
-          `  Skill docs: skills/nightpay/ (in all agent workspaces)\n` +
-          `  Context: injected on nightpay/bounty/pool keywords only\n` +
-          `  Type /nightpay help for the full operating model`
+        return;
+      }
+
+      // 2. Probe bridge for Midnight contract + stub status
+      const bridgeUrl = env.BRIDGE_URL || "";
+      const bridgeHealth = bridgeUrl ? await probeBridge(bridgeUrl, api.logger) : null;
+
+      // 3. Auto-populate RECEIPT_CONTRACT_ADDRESS from bridge if not already set
+      if (bridgeHealth?.contractAddress && !env.RECEIPT_CONTRACT_ADDRESS) {
+        api.logger.warn(
+          `[nightpay] RECEIPT_CONTRACT_ADDRESS not set -- discovered from bridge: ${bridgeHealth.contractAddress}\n` +
+          `  Set it: openclaw config set skills.entries.nightpay.env.RECEIPT_CONTRACT_ADDRESS "${bridgeHealth.contractAddress}"`
+        );
+      }
+
+      // 4. Warn about missing wallet keys
+      const missingWallet = missingWalletEnv(env);
+      if (missingWallet.length > 0) {
+        api.logger.warn(
+          `[nightpay] Wallet credentials missing (ZK receipts + operator signing disabled): ${missingWallet.join(", ")}\n` +
+          `  RECEIPT_CONTRACT_ADDRESS: from bridge /health (contractAddress field)\n` +
+          `  OPERATOR_SECRET_KEY: from your Midnight wallet / operator setup`
         );
       }
+
+      // 5. Warn if operator address looks like a placeholder
+      if (isPlaceholderAddress(env.OPERATOR_ADDRESS)) {
+        api.logger.warn(
+          `[nightpay] OPERATOR_ADDRESS looks like a placeholder ("${env.OPERATOR_ADDRESS?.slice(0, 12)}...").\n` +
+          `  Set a real Cardano preprod address (bech32 addr_test1... or 56-byte hex).\n` +
+          `  This is where operator fees are sent on successful pool completion.`
+        );
+      }
+
+      // 6. Build wallet connectivity summary
+      const url = env.NIGHTPAY_API_URL || DEFAULTS.NIGHTPAY_API_URL;
+      const net = env.MIDNIGHT_NETWORK || DEFAULTS.MIDNIGHT_NETWORK;
+      const fee = env.OPERATOR_FEE_BPS || DEFAULTS.OPERATOR_FEE_BPS;
+
+      const bridgeStatus = bridgeHealth
+        ? `${bridgeHealth.status}${bridgeHealth.stub ? " (stub/preprod)" : " (live)"} | contract: ${bridgeHealth.contractAddress?.slice(0, 16)}...`
+        : "unreachable";
+
+      api.logger.info(
+        `[nightpay] Ready -- ${url} | network: ${net} | fee: ${fee}bps\n` +
+        `  Masumi (MIP-003): ${url} [API reachable on startup]\n` +
+        `  Midnight bridge:  ${bridgeUrl} -> ${bridgeStatus}\n` +
+        `  Cardano operator: ${env.OPERATOR_ADDRESS ? env.OPERATOR_ADDRESS.slice(0, 16) + "..." : "NOT SET"}\n` +
+        `  ZK receipts:      ${env.RECEIPT_CONTRACT_ADDRESS ? "contract set" : "RECEIPT_CONTRACT_ADDRESS missing"}\n` +
+        `  Skill docs:       skills/nightpay/ (in all agent workspaces)\n` +
+        `  Type /nightpay help for the full operating model`
+      );
     });
 
     api.on("before_prompt_build", async (event, ctx) => {
@@ -226,7 +301,7 @@ const plugin = {
 
     api.registerCommand({
       name: "nightpay",
-      description: "NightPay -- status, operating model, config check",
+      description: "NightPay -- status, bridge check, operating model",
       acceptsArgs: true,
       requireAuth: true,
       handler: async (ctx) => {
@@ -251,16 +326,44 @@ const plugin = {
         const apiUrl = env.NIGHTPAY_API_URL || DEFAULTS.NIGHTPAY_API_URL;
         const network = env.MIDNIGHT_NETWORK || DEFAULTS.MIDNIGHT_NETWORK;
         const feeBps = env.OPERATOR_FEE_BPS || DEFAULTS.OPERATOR_FEE_BPS;
+        const bridgeUrl = env.BRIDGE_URL || "";
 
         if (!args || args === "status") {
+          // Live bridge probe for /nightpay status
+          let bridgeLine = "not configured";
+          if (bridgeUrl) {
+            try {
+              const res = await fetch(`${bridgeUrl}/health`, { signal: AbortSignal.timeout(5000) });
+              const h = res.ok ? await res.json() : null;
+              bridgeLine = h
+                ? `${h.status}${h.stub ? " (stub)" : " (live)"} | contract: ${h.contractAddress?.slice(0, 16)}... | network: ${h.network}`
+                : `HTTP ${res.status}`;
+            } catch (e) {
+              bridgeLine = `unreachable (${e.message})`;
+            }
+          }
+
+          const walletMissing = missingWalletEnv(env);
+          const addrOk = !isPlaceholderAddress(env.OPERATOR_ADDRESS);
+
           return {
             text:
-              `NightPay ready\n` +
+              `NightPay v0.3.11\n\n` +
+              `Masumi (MIP-003)\n` +
               `  API:     ${apiUrl}\n` +
-              `  Network: ${network}\n` +
-              `  Fee:     ${feeBps} bps (${(Number(feeBps) / 100).toFixed(1)}%)\n\n` +
-              `Activation: "create a bounty pool for [task]", "show bounty board", "fund this anonymously"\n` +
-              `Full operating model: /nightpay help`,
+              `  Key:     ${env.MASUMI_API_KEY ? "set" : "MISSING"}\n\n` +
+              `Midnight bridge\n` +
+              `  URL:     ${bridgeUrl || "MISSING"}\n` +
+              `  Status:  ${bridgeLine}\n` +
+              `  Receipt: ${env.RECEIPT_CONTRACT_ADDRESS ? env.RECEIPT_CONTRACT_ADDRESS.slice(0, 16) + "..." : "MISSING -- set RECEIPT_CONTRACT_ADDRESS"}\n\n` +
+              `Cardano operator\n` +
+              `  Address: ${addrOk ? env.OPERATOR_ADDRESS.slice(0, 16) + "..." : "PLACEHOLDER -- set a real Cardano address"}\n` +
+              `  Fee:     ${feeBps} bps (${(Number(feeBps) / 100).toFixed(1)}%)\n` +
+              `  Network: ${network}\n\n` +
+              (walletMissing.length > 0
+                ? `Missing wallet credentials: ${walletMissing.join(", ")}\n  RECEIPT_CONTRACT_ADDRESS: from bridge /health\n  OPERATOR_SECRET_KEY: from your Midnight wallet\n\n`
+                : "Wallet: fully configured\n\n") +
+              `Run /nightpay help for the operating model.`,
           };
         }
 

package/skills/nightpay/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: nightpay
 description: Primarily for OpenClaw agents. Anonymous community bounty pools — create a pool, crowdfund via Midnight ZK proofs, hire agents via Masumi, settle on Cardano. Use deployed NIGHTPAY_API_URL and BRIDGE_URL (no localhost). Trigger with /nightpay <instruction> to create or fund a bounty pool.
-license: Apache-2.0
+license: AGPL-3.0-only
 compatibility: "openclaw, acp, claude-code, cursor, copilot"
 allowed-tools: Bash
 metadata: {"openclaw":{"requires":{"bins":["bash","curl","openssl","sqlite3","sha256sum"],"env":["MASUMI_API_KEY","OPERATOR_ADDRESS","NIGHTPAY_API_URL","BRIDGE_URL"]},"primaryEnv":"MASUMI_API_KEY","os":["darwin","linux"]},"category":"payments","blockchain":"midnight, cardano","agent-layer":"masumi","version":"0.3.4"}