@wiimdy/openfunderse 1.1.2 → 1.1.4

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,8 +15,11 @@ 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
 ```
 
 ## Where Files Are Stored
@@ -30,5 +33,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

@@ -7,10 +7,13 @@ import os from "node:os";
 import path from "node:path";
 import { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
+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"]);
@@ -314,12 +317,37 @@ function runtimeEnvExamplePath(runtimeDir, runtimePackage) {
   return path.join(runtimeDir, "node_modules", ...runtimePackage.split("/"), ".env.example");
 }
 
+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);
@@ -327,7 +355,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) {
@@ -340,7 +370,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) {
@@ -367,7 +397,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) {
@@ -418,43 +448,6 @@ function shellQuote(input) {
   return `'${input.replace(/'/g, `'\\''`)}'`;
 }
 
-async function runCommandCapture(cmd, args, cwd = process.cwd()) {
-  return await new Promise((resolve, reject) => {
-    const child = spawn(cmd, args, {
-      cwd,
-      stdio: ["ignore", "pipe", "pipe"]
-    });
-
-    const stdout = [];
-    const stderr = [];
-
-    child.stdout.on("data", (chunk) => {
-      stdout.push(chunk);
-    });
-    child.stderr.on("data", (chunk) => {
-      stderr.push(chunk);
-    });
-    child.on("error", (error) => {
-      reject(error);
-    });
-    child.on("exit", (code) => {
-      if (code === 0) {
-        resolve({
-          stdout: Buffer.concat(stdout).toString("utf8"),
-          stderr: Buffer.concat(stderr).toString("utf8")
-        });
-        return;
-      }
-      const stderrText = Buffer.concat(stderr).toString("utf8").trim();
-      reject(
-        new Error(
-          `command failed: ${cmd} ${args.join(" ")} (exit ${code})${stderrText ? ` - ${stderrText}` : ""}`
-        )
-      );
-    });
-  });
-}
-
 async function confirmBotInit({ role, envFile, privateKeyKey, isRotation, assumeYes }) {
   const mode = isRotation ? "wallet rotation" : "new wallet bootstrap";
   console.log("WARNING: bot-init will generate a new wallet and update your env private key.");
@@ -486,39 +479,11 @@ async function confirmBotInit({ role, envFile, privateKeyKey, isRotation, assume
   }
 }
 
-async function generateMonadWalletWithCast() {
-  let output;
-  try {
-    output = await runCommandCapture("cast", ["wallet", "new", "--json"]);
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    if (message.includes("ENOENT")) {
-      throw new Error(
-        "cast is not installed. Install Foundry first (https://book.getfoundry.sh/getting-started/installation)."
-      );
-    }
-    throw error;
-  }
-
-  let parsed;
-  try {
-    parsed = JSON.parse(output.stdout);
-  } catch {
-    throw new Error(`failed to parse cast output as JSON: ${output.stdout}`);
-  }
-
-  const first = Array.isArray(parsed) ? parsed[0] : parsed;
-  const address = String(first?.address ?? "");
-  const privateKey = String(first?.private_key ?? first?.privateKey ?? "");
-  if (!/^0x[0-9a-fA-F]{40}$/.test(address)) {
-    throw new Error(`invalid wallet address from cast: ${address}`);
-  }
-  if (!/^0x[0-9a-fA-F]{64}$/.test(privateKey)) {
-    throw new Error("invalid private key from cast output");
-  }
-
+function generateMonadWalletWithViem() {
+  const privateKey = generatePrivateKey();
+  const account = privateKeyToAccount(privateKey);
   return {
-    address,
+    address: account.address,
     privateKey
   };
 }
@@ -551,10 +516,13 @@ async function persistWallet(role, wallet, options) {
   if (rawName.includes("/") || rawName.includes("\\")) {
     throw new Error("--wallet-name must be a file name, not a path");
   }
-  const fileName = rawName.endsWith(".json") ? rawName : `${rawName}.json`;
-  const walletPath = path.join(walletDir, fileName);
-  if (existsSync(walletPath) && !options.force) {
-    throw new Error(`wallet file already exists: ${walletPath} (use --force to overwrite)`);
+  const baseName = rawName.endsWith(".json") ? rawName.slice(0, -".json".length) : rawName;
+  const walletPath = path.join(walletDir, `${baseName}.json`);
+  const privateKeyPath = path.join(walletDir, `${baseName}.private-key`);
+  if ((existsSync(walletPath) || existsSync(privateKeyPath)) && !options.force) {
+    throw new Error(
+      `wallet file already exists: ${walletPath} or ${privateKeyPath} (use --force to overwrite)`
+    );
   }
 
   const payload = {
@@ -565,11 +533,22 @@ async function persistWallet(role, wallet, options) {
     privateKey: wallet.privateKey
   };
   await mkdir(walletDir, { recursive: true, mode: 0o700 });
+  if (options.force) {
+    await rm(walletPath, { force: true });
+    await rm(privateKeyPath, { force: true });
+  }
   await writeFile(walletPath, `${JSON.stringify(payload, null, 2)}\n`, {
     mode: 0o600
   });
+  await writeFile(privateKeyPath, `${wallet.privateKey}\n`, {
+    mode: 0o600
+  });
   await chmod(walletPath, 0o600);
-  return walletPath;
+  await chmod(privateKeyPath, 0o600);
+  return {
+    walletPath,
+    privateKeyPath
+  };
 }
 
 function assertPrivateKeyRotationAllowed(envContent, role, force) {
@@ -609,8 +588,8 @@ async function runBotInit(options) {
     assumeYes: options.yes
   });
 
-  const wallet = await generateMonadWalletWithCast();
-  const walletPath = await persistWallet(role, wallet, options);
+  const wallet = generateMonadWalletWithViem();
+  const walletFiles = await persistWallet(role, wallet, options);
   const updates = roleEnvUpdates(role, wallet);
   const nextEnvContent = upsertEnvValues(envContent, updates);
 
@@ -622,7 +601,8 @@ async function runBotInit(options) {
   console.log(`Initialized ${role} bot wallet for Monad testnet (${DEFAULT_MONAD_CHAIN_ID}).`);
   console.log(`Address: ${wallet.address}`);
   console.log(`Env file updated: ${envFile}`);
-  console.log(`Wallet backup (keep secret): ${walletPath}`);
+  console.log(`Wallet backup (keep secret): ${walletFiles.walletPath}`);
+  console.log(`Private key backup (keep secret): ${walletFiles.privateKeyPath}`);
   console.log(`Load env now: ${sourceCommand}`);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wiimdy/openfunderse",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "Install OpenFunderse skill packs into Codex",
   "type": "module",
   "bin": {
@@ -9,8 +9,13 @@
   "files": [
     "bin",
     "packs",
+    ".env.strategy.example",
+    ".env.participant.example",
     "README.md"
   ],
+  "dependencies": {
+    "viem": "^2.38.2"
+  },
   "engines": {
     "node": ">=20"
   },

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

@@ -48,7 +48,7 @@ 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
 ```
 
 Note:

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

@@ -70,7 +70,7 @@ 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
 ```
 
 Note: