@wiimdy/openfunderse 1.1.3 → 1.1.5

package/.env.participant.example

@@ -0,0 +1,17 @@
+# OpenFunderse participant env scaffold
+# Copy values from your PARTICIPANT_PK, ADDRESS
+
+RELAYER_URL=https://openfunderse-relayer-liard.vercel.app/
+BOT_ID=bot-participant-1
+BOT_API_KEY=replace_me
+
+CHAIN_ID=10143
+CLAIM_ATTESTATION_VERIFIER_ADDRESS=0x76AB8571cED9F4A81b733969216F53C1e13BC835
+# Temporary bootstrap key (public and unsafe). Replace via bot-init before real usage.
+PARTICIPANT_PRIVATE_KEY=__TEMP_PRIVATE_KEY__
+PARTICIPANT_ADDRESS=0x00
+
+PARTICIPANT_REQUIRE_EXPLICIT_SUBMIT=true
+PARTICIPANT_AUTO_SUBMIT=false
+# PARTICIPANT_TRUSTED_RELAYER_HOSTS=openfunderse-relayer.example.com
+# PARTICIPANT_ALLOW_HTTP_RELAYER=true

package/.env.strategy.example

@@ -0,0 +1,31 @@
+# OpenFunderse strategy env scaffold
+# Copy values from your STRATEGY_PK, ADDRESS
+
+RELAYER_URL=https://openfunderse-relayer-liard.vercel.app/
+BOT_ID=bot-strategy-1
+BOT_API_KEY=replace_me
+CHAIN_ID=10143
+RPC_URL=https://testnet-rpc.monad.xyz
+
+# NadFun / protocol addresses
+INTENT_BOOK_ADDRESS=0x76AB8571cED9F4A81b733969216F53C1e13BC835
+NADFUN_EXECUTION_ADAPTER_ADDRESS=0x7949DBd0779Cd829D1B2491A33C8EcCc88669Aa4
+ADAPTER_ADDRESS=0x7949DBd0779Cd829D1B2491A33C8EcCc88669Aa4
+VAULT_ADDRESS=0x34FB76f115f4C4E461eB90eA9f92faEF8c4A5E0A
+NADFUN_LENS_ADDRESS=0xB056d79CA5257589692699a46623F901a3BB76f1
+NADFUN_BONDING_CURVE_ROUTER=0x865054F0F6A288adaAc30261731361EA7E908003
+NADFUN_DEX_ROUTER=0x5D4a4f430cA3B1b2dB86B9cFE48a5316800F5fb2
+NADFUN_WMON_ADDRESS=0xFb8bE43D65FBC1290D6178C6DbA6E58c6D18fA60
+
+# Strategy signer (EOA)
+# Temporary bootstrap key (public and unsafe). Replace via bot-init before real usage.
+STRATEGY_PRIVATE_KEY=__TEMP_PRIVATE_KEY__
+STRATEGY_ADDRESS=0x00
+
+# STRATEGY_CREATE_MIN_SIGNER_BALANCE_WEI=10000000000000000
+
+# Safety defaults
+STRATEGY_REQUIRE_EXPLICIT_SUBMIT=true
+STRATEGY_AUTO_SUBMIT=false
+# STRATEGY_TRUSTED_RELAYER_HOSTS=openfunderse-relayer.example.com
+# STRATEGY_ALLOW_HTTP_RELAYER=true

package/README.md

@@ -15,10 +15,16 @@ npx @wiimdy/openfunderse@latest bot-init --skill-name strategy --yes
 # or
 npx @wiimdy/openfunderse@latest bot-init --skill-name participant --yes
 
-# 3) load env in current shell
-set -a; source .env; set +a
+# 3) (optional) load env in current shell
+# @wiimdy/openfunderse-agents auto-loads .env.strategy / .env.participant by command role.
+set -a; source .env.strategy; set +a
+# or
+set -a; source .env.participant; set +a
 ```
 
+By default, `install` and `bot-init` also sync env keys into OpenClaw config (`~/.openclaw/openclaw.json > env.vars`).
+Disable this with `--no-sync-openclaw-env`.
+
 ## Where Files Are Stored
 
 - In OpenClaw, skills are installed under `~/.openclaw/workspace/skills`.
@@ -30,5 +36,7 @@ set -a; source .env; set +a
 - Use only:
   - `openfunderse-strategy`
   - `openfunderse-participant`
-- Default env scaffold path is `.env`.
-- If you run both bots in the same directory, use `--env-path` to split files (for example `.env.strategy`, `.env.participant`).
+- Default env scaffold path is role-based:
+  - strategy: `.env.strategy`
+  - participant: `.env.participant`
+- Use `--env-path` only when you want a custom filename/location.

package/bin/openfunderse.mjs

@@ -12,6 +12,8 @@ import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
 const THIS_FILE = fileURLToPath(import.meta.url);
 const PACKAGE_ROOT = path.resolve(path.dirname(THIS_FILE), "..");
 const PACKS_ROOT = path.join(PACKAGE_ROOT, "packs");
+const STRATEGY_ENV_TEMPLATE_PATH = path.join(PACKAGE_ROOT, ".env.strategy.example");
+const PARTICIPANT_ENV_TEMPLATE_PATH = path.join(PACKAGE_ROOT, ".env.participant.example");
 const DEFAULT_RUNTIME_PACKAGE = "@wiimdy/openfunderse-agents";
 const SUPPORTED_ENV_PROFILES = new Set(["strategy", "participant", "all"]);
 const SUPPORTED_BOT_INIT_ROLES = new Set(["strategy", "participant"]);
@@ -69,8 +71,10 @@ function printUsage() {
 Usage:
   openfunderse list
   openfunderse bot-init [--role <strategy|participant>] [--skill-name <name>] [--env-path <path>] [--wallet-dir <dir>] [--wallet-name <name>] [--force] [--yes]
+                       [--no-sync-openclaw-env]
   openfunderse install <pack-name> [--dest <skills-dir>] [--codex-home <dir>] [--force] [--with-runtime]
                      [--no-init-env] [--env-path <path>] [--env-profile <strategy|participant|all>]
+                     [--no-sync-openclaw-env]
                      [--runtime-package <name>] [--runtime-dir <dir>] [--runtime-manager <npm|pnpm|yarn|bun>]
 
 Examples:
@@ -103,6 +107,7 @@ function parseArgs(argv) {
     skillName: "",
     walletDir: "",
     walletName: "",
+    syncOpenclawEnv: true,
     yes: false
   };
   const positionals = [];
@@ -135,6 +140,14 @@ function parseArgs(argv) {
       options.withRuntime = true;
       continue;
     }
+    if (token === "--sync-openclaw-env") {
+      options.syncOpenclawEnv = true;
+      continue;
+    }
+    if (token === "--no-sync-openclaw-env") {
+      options.syncOpenclawEnv = false;
+      continue;
+    }
     if (token === "--init-env") {
       options.initEnv = true;
       options.initEnvExplicit = true;
@@ -315,12 +328,42 @@ function runtimeEnvExamplePath(runtimeDir, runtimePackage) {
   return path.join(runtimeDir, "node_modules", ...runtimePackage.split("/"), ".env.example");
 }
 
+function openclawConfigPath(codexHome) {
+  const resolvedCodexHome = path.resolve(codexHome);
+  return path.join(path.dirname(resolvedCodexHome), "openclaw.json");
+}
+
+function defaultEnvFileNameForProfile(profile) {
+  if (profile === "strategy") {
+    return ".env.strategy";
+  }
+  if (profile === "participant") {
+    return ".env.participant";
+  }
+  return ".env";
+}
+
+function applyTemplateTokens(template) {
+  return template.replaceAll("__TEMP_PRIVATE_KEY__", TEMP_PRIVATE_KEY);
+}
+
+async function readProfileTemplate(profile) {
+  const templatePath =
+    profile === "strategy" ? STRATEGY_ENV_TEMPLATE_PATH : PARTICIPANT_ENV_TEMPLATE_PATH;
+  const fallback = profile === "strategy" ? STRATEGY_ENV_TEMPLATE : PARTICIPANT_ENV_TEMPLATE;
+  if (!existsSync(templatePath)) {
+    return fallback;
+  }
+  const template = await readFile(templatePath, "utf8");
+  return applyTemplateTokens(template);
+}
+
 async function buildEnvScaffold(profile, runtimeDir, runtimePackage) {
   if (profile === "strategy") {
-    return STRATEGY_ENV_TEMPLATE;
+    return readProfileTemplate("strategy");
   }
   if (profile === "participant") {
-    return PARTICIPANT_ENV_TEMPLATE;
+    return readProfileTemplate("participant");
   }
 
   const runtimeTemplate = runtimeEnvExamplePath(runtimeDir, runtimePackage);
@@ -328,7 +371,9 @@ async function buildEnvScaffold(profile, runtimeDir, runtimePackage) {
     return readFile(runtimeTemplate, "utf8");
   }
 
-  return `${STRATEGY_ENV_TEMPLATE}\n\n${PARTICIPANT_ENV_TEMPLATE}`;
+  const strategy = await readProfileTemplate("strategy");
+  const participant = await readProfileTemplate("participant");
+  return `${strategy}\n\n${participant}`;
 }
 
 async function writeEnvScaffold(options) {
@@ -341,7 +386,7 @@ async function writeEnvScaffold(options) {
   const profile = normalizeEnvProfile(rawProfile);
   const envTarget = options.envFile
     ? path.resolve(options.envFile)
-    : path.join(runtimeDir, ".env");
+    : path.join(runtimeDir, defaultEnvFileNameForProfile(profile));
 
   const alreadyExists = existsSync(envTarget);
   if (alreadyExists && !options.force) {
@@ -368,7 +413,7 @@ async function writeEnvScaffold(options) {
 }
 
 function defaultEnvPathForRole(role) {
-  return path.join(process.cwd(), ".env");
+  return path.join(process.cwd(), `.env.${role}`);
 }
 
 function readAssignedEnvValue(content, key) {
@@ -382,6 +427,86 @@ function readAssignedEnvValue(content, key) {
   return "";
 }
 
+function parseEnvAssignments(content) {
+  const result = {};
+  const lines = String(content || "").replace(/^\uFEFF/, "").split(/\r?\n/);
+  for (const rawLine of lines) {
+    const line = rawLine.trim();
+    if (!line || line.startsWith("#")) continue;
+    const match = line.match(/^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/);
+    if (!match) continue;
+    const key = match[1];
+    let value = (match[2] || "").trim();
+    if (
+      ((value.startsWith("\"") && value.endsWith("\"")) ||
+        (value.startsWith("'") && value.endsWith("'"))) &&
+      value.length >= 2
+    ) {
+      value = value.slice(1, -1);
+    }
+    result[key] = value;
+  }
+  return result;
+}
+
+async function syncOpenclawEnvVarsFromFile(envFile, codexHome) {
+  const configPath = openclawConfigPath(codexHome);
+  if (!existsSync(configPath)) {
+    return {
+      synced: false,
+      reason: "openclaw-config-not-found",
+      configPath,
+      envFile,
+      writtenKeys: []
+    };
+  }
+
+  const envContent = await readFile(envFile, "utf8");
+  const assignments = parseEnvAssignments(envContent);
+  const keys = Object.keys(assignments);
+  if (keys.length === 0) {
+    return {
+      synced: false,
+      reason: "empty-env-file",
+      configPath,
+      envFile,
+      writtenKeys: []
+    };
+  }
+
+  const rawConfig = await readFile(configPath, "utf8");
+  const parsedConfig = JSON.parse(rawConfig);
+  if (!parsedConfig || typeof parsedConfig !== "object" || Array.isArray(parsedConfig)) {
+    throw new Error(`invalid openclaw config json object: ${configPath}`);
+  }
+
+  const nextConfig = { ...parsedConfig };
+  const envSection =
+    nextConfig.env && typeof nextConfig.env === "object" && !Array.isArray(nextConfig.env)
+      ? { ...nextConfig.env }
+      : {};
+  const varsSection =
+    envSection.vars && typeof envSection.vars === "object" && !Array.isArray(envSection.vars)
+      ? { ...envSection.vars }
+      : {};
+
+  for (const [key, value] of Object.entries(assignments)) {
+    varsSection[key] = value;
+  }
+
+  envSection.vars = varsSection;
+  nextConfig.env = envSection;
+  await writeFile(configPath, `${JSON.stringify(nextConfig, null, 2)}\n`);
+
+  return {
+    synced: true,
+    reason: "ok",
+    configPath,
+    envFile,
+    writtenKeys: keys
+  };
+}
+
 function isPlaceholderEnvValue(value) {
   const normalized = (value || "").trim();
   if (!normalized) return true;
@@ -567,11 +692,27 @@ async function runBotInit(options) {
   await mkdir(path.dirname(envFile), { recursive: true });
   await writeFile(envFile, nextEnvContent);
   await chmod(envFile, 0o600);
+  let syncMeta = null;
+  if (options.syncOpenclawEnv) {
+    const codexHome = options.codexHome ? path.resolve(options.codexHome) : defaultCodexHome();
+    syncMeta = await syncOpenclawEnvVarsFromFile(envFile, codexHome);
+  }
   const sourceCommand = `set -a; source ${shellQuote(envFile)}; set +a`;
 
   console.log(`Initialized ${role} bot wallet for Monad testnet (${DEFAULT_MONAD_CHAIN_ID}).`);
   console.log(`Address: ${wallet.address}`);
   console.log(`Env file updated: ${envFile}`);
+  if (syncMeta) {
+    if (syncMeta.synced) {
+      console.log(
+        `Synced env vars to OpenClaw config: ${syncMeta.configPath} (${syncMeta.writtenKeys.length} keys)`
+      );
+    } else {
+      console.log(
+        `Skipped OpenClaw env sync (${syncMeta.reason}): ${syncMeta.configPath}`
+      );
+    }
+  }
   console.log(`Wallet backup (keep secret): ${walletFiles.walletPath}`);
   console.log(`Private key backup (keep secret): ${walletFiles.privateKeyPath}`);
   console.log(`Load env now: ${sourceCommand}`);
@@ -747,6 +888,10 @@ async function installPack(packName, options) {
     };
     envScaffoldMeta = await writeEnvScaffold(envOptions);
   }
+  let openclawSyncMeta = null;
+  if (envScaffoldMeta && options.syncOpenclawEnv) {
+    openclawSyncMeta = await syncOpenclawEnvVarsFromFile(envScaffoldMeta.envFile, codexHome);
+  }
 
   console.log(`Installed pack: ${packName}`);
   console.log(`Skills root: ${skillsRoot}`);
@@ -767,6 +912,17 @@ async function installPack(packName, options) {
       );
     }
   }
+  if (openclawSyncMeta) {
+    if (openclawSyncMeta.synced) {
+      console.log(
+        `Synced env vars to OpenClaw config: ${openclawSyncMeta.configPath} (${openclawSyncMeta.writtenKeys.length} keys)`
+      );
+    } else {
+      console.log(
+        `Skipped OpenClaw env sync (${openclawSyncMeta.reason}): ${openclawSyncMeta.configPath}`
+      );
+    }
+  }
   console.log("Restart Codex to pick up new skills.");
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wiimdy/openfunderse",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "Install OpenFunderse skill packs into Codex",
   "type": "module",
   "bin": {
@@ -9,6 +9,8 @@
   "files": [
     "bin",
     "packs",
+    ".env.strategy.example",
+    ".env.participant.example",
     "README.md"
   ],
   "dependencies": {

package/packs/openfunderse-participant/openfunderse-participant/SKILL.md

@@ -48,9 +48,13 @@ npx @wiimdy/openfunderse@latest bot-init \
 4) Load env for the current shell:
 
 ```bash
-set -a; source .env; set +a
+set -a; source .env.participant; set +a
 ```
 
+OpenClaw note:
+- `install` / `bot-init` sync env keys into `~/.openclaw/openclaw.json` (`env.vars`) by default.
+- Use `--no-sync-openclaw-env` if you want file-only behavior.
+
 Note:
 - The scaffold includes a temporary public key placeholder by default.
 - Always run `bot-init` before funding or running production actions.

package/packs/openfunderse-strategy/openfunderse-strategy/SKILL.md

@@ -70,9 +70,13 @@ npx @wiimdy/openfunderse@latest bot-init \
 4) Load env for the current shell:
 
 ```bash
-set -a; source .env; set +a
+set -a; source .env.strategy; set +a
 ```
 
+OpenClaw note:
+- `install` / `bot-init` sync env keys into `~/.openclaw/openclaw.json` (`env.vars`) by default.
+- Use `--no-sync-openclaw-env` if you want file-only behavior.
+
 Note:
 - The scaffold includes a temporary public key placeholder by default.
 - Always run `bot-init` before funding or running production actions.