@wiimdy/openfunderse 0.1.2 → 1.1.1

package/README.md

@@ -1,77 +1,34 @@
 # openfunderse
 
-Install OpenFunderse skill packs into Codex.
+Install OpenFunderse split skill packs (`strategy`, `participant`) for OpenClaw/Codex.
 
-## Role
-- Monorepo distribution package for Codex skills/prompts/manifests.
-- Owns install UX (`npx @wiimdy/openfunderse@latest install openfunderse`) and pack copy logic.
-
-## Usage
+## Quick Start
 
 ```bash
-# list bundled packs
-npx @wiimdy/openfunderse@latest list
-
-# install pack into ~/.codex/skills
-npx @wiimdy/openfunderse@latest install openfunderse
-
-# install strategy-only pack
-npx @wiimdy/openfunderse@latest install openfunderse-strategy
-
-# install participant-only pack
-npx @wiimdy/openfunderse@latest install openfunderse-participant
-
-# install pack + runtime package in one command (recommended)
-npx @wiimdy/openfunderse@latest install openfunderse --with-runtime
-
-# install pack + runtime + strategy env scaffold in one command
-npx @wiimdy/openfunderse@latest install openfunderse \
-  --with-runtime \
-  --env-profile strategy
-
-# install into custom codex home
-npx @wiimdy/openfunderse@latest install openfunderse --codex-home /custom/.codex
-
-# install runtime into a specific project directory
-npx @wiimdy/openfunderse@latest install openfunderse \
-  --with-runtime \
-  --runtime-dir /path/to/project
+# 1) install skill + runtime
+npx @wiimdy/openfunderse@latest install openfunderse-strategy --with-runtime
+# or
+npx @wiimdy/openfunderse@latest install openfunderse-participant --with-runtime
+
+# 2) create/rotate bot wallet and write env
+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
+```
 
-# initialize bot env + fresh Monad wallet (strategy)
-npx @wiimdy/openfunderse@latest bot-init \
-  --skill-name strategy \
-  --env-path .env.strategy \
-  --yes
+## Where Files Are Stored
 
-# initialize participant bot env + wallet
-npx @wiimdy/openfunderse@latest bot-init \
-  --skill-name participant \
-  --env-path .env.participant \
-  --yes
-```
+- In OpenClaw, skills are installed under `~/.openclaw/workspace/skills`.
+- Pack metadata is stored under `~/.openclaw/workspace/packs/<pack-name>`.
+- Wallet backups from `bot-init` are stored under `~/.openclaw/workspace/openfunderse/wallets`.
 
-## Notes
+## Important Notes
 
-- Skills are copied into `$CODEX_HOME/skills` (default `~/.codex/skills`).
-- Pack metadata/prompts are copied into `$CODEX_HOME/packs/<pack-name>`.
-- Use `--force` to overwrite existing installed skills.
-- `--with-runtime` installs `@wiimdy/openfunderse-agents` into the current project (`package.json` required).
-- Env scaffold generation is enabled by default (default path: `.env.openfunderse`).
-- `--env-profile` controls scaffold scope: `strategy` | `participant` | `all` (auto-selected by pack when omitted).
-- Use `--no-init-env` to skip env scaffold generation.
-- `--env-path` sets a custom env scaffold path.
-- Optional: `--runtime-package`, `--runtime-dir`, `--runtime-manager`.
-- Available packs: `openfunderse` (unified), `openfunderse-strategy`, `openfunderse-participant`.
-- Split packs (`openfunderse-strategy`, `openfunderse-participant`) are intentionally minimal and centered on the skill payload.
-- Prefer `--env-path` (Node 20+ reserves `--env-file` as a runtime flag).
-- `bot-init` uses `cast wallet new --json` (Foundry) to generate a new wallet for Monad testnet.
-- `bot-init` infers role from `--skill-name`, `--env-path`, or `--wallet-name` when `--role` is omitted.
-- It also infers from active skill env hints (`OPENCLAW_SKILL_KEY`, `OPENCLAW_ACTIVE_SKILL`, `SKILL_KEY`, `SKILL_NAME`).
-- `bot-init` writes role-specific key fields:
-  - `strategy`: `STRATEGY_PRIVATE_KEY`, `BOT_ADDRESS`
-  - `participant`: `PARTICIPANT_PRIVATE_KEY`, `PARTICIPANT_BOT_ADDRESS`, `BOT_ADDRESS`
-- `bot-init` stores a wallet backup JSON under `$CODEX_HOME/openfunderse/wallets`.
-- Generated scaffolds include a temporary bootstrap key value. It is public/unsafe and must be rotated via `bot-init` before funding.
-- `bot-init` shows a warning and requires confirmation (`Type YES`) unless `--yes` is passed.
-- If private key already exists in the target env file, `bot-init` requires `--force` to rotate.
-- CLI cannot mutate your parent shell env directly; run the printed `set -a; source ...; set +a` command.
+- 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`).

package/bin/openfunderse.mjs

@@ -56,7 +56,6 @@ BOT_ADDRESS=0x0000000000000000000000000000000000000000
 CHAIN_ID=10143
 # Temporary bootstrap key (public and unsafe). Replace via bot-init before real usage.
 PARTICIPANT_PRIVATE_KEY=${TEMP_PRIVATE_KEY}
-CLAIM_ATTESTATION_VERIFIER_ADDRESS=0x0000000000000000000000000000000000000000
 PARTICIPANT_REQUIRE_EXPLICIT_SUBMIT=true
 PARTICIPANT_AUTO_SUBMIT=false
 # PARTICIPANT_TRUSTED_RELAYER_HOSTS=openfunderse-relayer.example.com
@@ -75,12 +74,11 @@ Usage:
 
 Examples:
   openfunderse list
-  openfunderse install openfunderse
-  openfunderse install openfunderse --with-runtime
   openfunderse install openfunderse-strategy --with-runtime
-  openfunderse install openfunderse --codex-home /tmp/codex-home
-  openfunderse bot-init --env-path .env.participant --wallet-name participant-bot --yes
-  openfunderse bot-init --skill-name strategy --env-path .env.strategy --force
+  openfunderse install openfunderse-participant --with-runtime
+  openfunderse install openfunderse-strategy --codex-home /tmp/codex-home
+  openfunderse bot-init --skill-name participant --wallet-name participant-bot --yes
+  openfunderse bot-init --skill-name strategy --force
 `);
 }
 
@@ -342,7 +340,7 @@ async function writeEnvScaffold(options) {
   const profile = normalizeEnvProfile(rawProfile);
   const envTarget = options.envFile
     ? path.resolve(options.envFile)
-    : path.join(runtimeDir, ".env.openfunderse");
+    : path.join(runtimeDir, ".env");
 
   const alreadyExists = existsSync(envTarget);
   if (alreadyExists && !options.force) {
@@ -369,7 +367,7 @@ async function writeEnvScaffold(options) {
 }
 
 function defaultEnvPathForRole(role) {
-  return path.join(process.cwd(), `.env.${role}`);
+  return path.join(process.cwd(), ".env");
 }
 
 function readAssignedEnvValue(content, key) {
@@ -717,6 +715,12 @@ async function installRuntimePackage(options) {
 }
 
 async function installPack(packName, options) {
+  if (packName === "openfunderse") {
+    throw new Error(
+      "pack 'openfunderse' has been removed. use 'openfunderse-strategy' or 'openfunderse-participant'."
+    );
+  }
+
   const packDir = path.join(PACKS_ROOT, packName);
   if (!existsSync(packDir)) {
     throw new Error(`pack not found: ${packName}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wiimdy/openfunderse",
-  "version": "0.1.2",
+  "version": "1.1.1",
   "description": "Install OpenFunderse skill packs into Codex",
   "type": "module",
   "bin": {

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

@@ -3,6 +3,7 @@ name: openfunderse-participant
 description: Participant MoltBot for data mining (claims) and cross-verification (attestations)
 metadata:
   openclaw:
+    installCommand: npx @wiimdy/openfunderse@latest install openfunderse-participant --with-runtime
     requires:
       env:
         - RELAYER_URL
@@ -24,12 +25,36 @@ The Participant MoltBot is responsible for mining data claims from specified sou
 
 ## Quick Start (ClawHub Users)
 
-Install the skill first:
+1) Install the skill:
 
 ```bash
 npx clawhub@latest install openfunderse-participant
 ```
 
+2) Install runtime + generate env scaffold:
+
+```bash
+npx @wiimdy/openfunderse@latest install openfunderse-participant --with-runtime
+```
+
+3) Rotate the temporary bootstrap key and write a fresh participant wallet to env:
+
+```bash
+npx @wiimdy/openfunderse@latest bot-init \
+  --skill-name participant \
+  --yes
+```
+
+4) Load env for the current shell:
+
+```bash
+set -a; source .env; set +a
+```
+
+Note:
+- The scaffold includes a temporary public key placeholder by default.
+- Always run `bot-init` before funding or running production actions.
+
 ## Credential Scope
 
 - `PARTICIPANT_PRIVATE_KEY` (or runtime fallback key) is used only for claim-attestation signing.

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

@@ -5,6 +5,7 @@ always: false
 disable-model-invocation: false
 metadata:
   openclaw:
+    installCommand: npx @wiimdy/openfunderse@latest install openfunderse-strategy --with-runtime
     requires:
       env:
         - RELAYER_URL
@@ -46,41 +47,35 @@ In runtime, use `proposeIntentAndSubmit` to build a canonical proposal first, th
 
 ## Quick Start (ClawHub Users)
 
-Install the skill first:
+1) Install the skill:
 
 ```bash
 npx clawhub@latest install openfunderse-strategy
 ```
 
-This skill is instruction-only. You need the runtime package:
+2) Install runtime + generate env scaffold:
 
 ```bash
-npm init -y && npm i @wiimdy/openfunderse-agents@0.1.1 --ignore-scripts
+npx @wiimdy/openfunderse@latest install openfunderse-strategy --with-runtime
 ```
 
-Create editable env scaffold in one line:
+3) Rotate the temporary bootstrap key and write a fresh strategy wallet to env:
 
 ```bash
-cp node_modules/@wiimdy/openfunderse-agents/.env.strategy.example .env.openfunderse
+npx @wiimdy/openfunderse@latest bot-init \
+  --skill-name strategy \
+  --yes
 ```
 
-Verify source before install (recommended):
+4) Load env for the current shell:
 
 ```bash
-npm view @wiimdy/openfunderse-agents@0.1.1 repository.url homepage dist.integrity
+set -a; source .env; set +a
 ```
 
-Then configure env and run commands from:
-
-- `packages/agents/.env.strategy.example`
-- `packages/agents/README.md`
-
-Runtime sources:
-
-- npm package: `https://www.npmjs.com/package/@wiimdy/openfunderse-agents`
-- repository: `https://github.com/wiimdy/openfunderse/tree/main/packages/agents`
-
-Do not use `@latest` in production; pin an explicit version and keep lockfile reviewed.
+Note:
+- The scaffold includes a temporary public key placeholder by default.
+- Always run `bot-init` before funding or running production actions.
 
 ## Credential Scope
 

package/packs/openfunderse/config/setup-manifest.json

@@ -1,33 +0,0 @@
-{
-  "name": "openfunderse-agent-pack",
-  "version": "0.1.0",
-  "installCommand": "npx @wiimdy/openfunderse@latest install openfunderse --with-runtime",
-  "description": "Scaffold manifest for future MoltBot skills/prompts packaging.",
-  "bundles": [
-    {
-      "id": "clawbot-core",
-      "skill": "skills/clawbot-core/SKILL.md",
-      "prompt": "prompts/core/system.md"
-    },
-    {
-      "id": "strategy",
-      "skill": "skills/openfunderse-strategy/SKILL.md",
-      "prompt": "prompts/strategy/system.md"
-    },
-    {
-      "id": "participant",
-      "skill": "skills/openfunderse-participant/SKILL.md",
-      "prompt": "prompts/participant/system.md"
-    },
-    {
-      "id": "relayer",
-      "skill": "skills/relayer/SKILL.md",
-      "prompt": "prompts/relayer/system.md"
-    }
-  ],
-  "todo": [
-    "Implement openfunderse installer package publishing flow",
-    "Add signed package checksum and version pinning",
-    "Add integration test that installs this pack in a clean environment"
-  ]
-}

package/packs/openfunderse/prompts/core/system.md

@@ -1,25 +0,0 @@
-# ClawBot Core System Prompt
-
-You are ClawBot Core.
-
-## Role routing
-- If `role=strategy`, perform strategy lifecycle actions.
-- If `role=participant`, perform participant claim lifecycle actions.
-
-## Strategy priority
-1. Read relayer state and verify threshold readiness.
-2. Build/validate intent from finalized snapshot only.
-3. Use onchain attest/execute paths only when preconditions pass.
-4. Ack onchain result back to relayer.
-
-## Participant priority
-1. Mine deterministic claim payload.
-2. Verify reproducibility before PASS.
-3. Submit canonical claim payload.
-4. Sign/submit attestation with correct EIP-712 domain.
-
-## Hard rules
-- No secret leakage.
-- No fabricated data.
-- No bypass of SDK canonical hashing/signing paths.
-- Return structured JSON outputs.

package/packs/openfunderse/prompts/participant/system.md

@@ -1,35 +0,0 @@
-# Participant System Prompt
-
-You are the Participant MoltBot for Openfunderse.
-
-## Objective
-- Mine reproducible claims from configured sources.
-- Verify claim technical validity deterministically.
-- Submit mined claims and attest validated claims through relayer APIs.
-
-## Hard rules
-- Never fabricate source data.
-- Never return `PASS` when reproducibility fails.
-- Fail closed on missing evidence, stale data, or hash mismatch.
-- Keep outputs strict JSON with stable keys.
-- Never print private keys or secrets.
-
-## Task contracts
-
-### `mine_claim`
-- Input: `fundId`, `epochId`, `sourceSpec`, `tokenContext`.
-- Output: `status`, `observation`, `confidence`, `reasonCode`.
-- Must include: `claimHash`, `responseHash`, `evidenceURI`, `canonicalPayload`.
-
-### `verify_claim_or_intent_validity`
-- Output verdict: `PASS | FAIL | NEED_MORE_EVIDENCE`.
-- Must include `reasonCode`.
-- Claim verification requires reproducibility check when policy says `reproducible=true`.
-
-### `submit_mined_claim`
-- Submit canonical payload as-is to relayer.
-- Reject if local `claimHash` differs from relayer response hash.
-
-### `attest_claim`
-- Produce EIP-712 signature and submit attestation.
-- Use claim domain verifier address from runtime config.

package/packs/openfunderse/prompts/relayer/system.md

@@ -1,14 +0,0 @@
-# Relayer System Prompt
-
-You are the relayer orchestration assistant for Openfunderse.
-
-## Objective
-- Validate fund/bot authorization boundaries.
-- Route claims, attestations, and intent submissions safely.
-- Surface deterministic errors and retryable states clearly.
-
-## Hard rules
-- Enforce bot scope and fund role checks on every write endpoint.
-- Reject malformed payloads and bigint/string mismatches.
-- Never bypass allowlist, threshold, or signature verification steps.
-- Keep API responses structured and machine-consumable.

package/packs/openfunderse/prompts/strategy/system.md

@@ -1,29 +0,0 @@
-# Strategy System Prompt
-
-You are the Strategy MoltBot for Openfunderse.
-
-## Objective
-- Propose intents only from finalized snapshots.
-- Use NadFun lens quotes to derive executable `minAmountOut`.
-- Prefer `SELL` when open token positions meet exit criteria.
-- Hold when risk checks or quote validation fails.
-
-## Hard rules
-- Never propose when snapshot is not finalized.
-- Never set `minAmountOut=0`.
-- Fail closed if quote call fails or router is not allowlisted.
-- Normalize `openedAt` timestamps (seconds or milliseconds) before age-based checks.
-- Keep output deterministic JSON with fixed schema.
-
-## Decision flow
-1. Validate snapshot finality and claim count.
-2. Validate risk policy (`maxNotional`, `maxSlippageBps`, token allowlist, venue allowlist).
-3. If `marketState.positions` contains token inventory, evaluate `SELL` first:
-- `isBuy=false` quote via lens
-- trigger by take-profit, stop-loss, or max-hold age
-4. If no valid `SELL`, evaluate `BUY` candidates with `isBuy=true`.
-5. Verify lens-returned router is in allowed routers.
-6. Compute `minAmountOut = quoteAmountOut * (10000 - slippageBps) / 10000`.
-7. Return:
-- `PROPOSE` with complete intent when all checks pass.
-- `HOLD` with explicit reason when any check fails.

package/packs/openfunderse/skills/clawbot-core/SKILL.md

@@ -1,157 +0,0 @@
----
-name: clawbot-core
-description: Unified ClawBot skill for strategy and participant actions over relayer and onchain contracts.
-version: 1.0.0
-metadata:
-  openclaw:
-    requires:
-      env:
-        - RELAYER_URL
-        - BOT_ID
-        - BOT_API_KEY
-        - FUND_ID
-        - RPC_URL
-        - CHAIN_ID
-      bins:
-        - node
-        - npm
-    primaryEnv: RELAYER_URL
-    skillKey: clawbot-core
----
-
-# ClawBot Core Skill
-
-Unified runtime entrypoint:
-- `npm run clawbot:run -w @claw/agents -- --role <strategy|participant> --action <action> ...`
-
-## Global Input Contract
-```json
-{
-  "role": "strategy | participant",
-  "action": "string",
-  "params": {
-    "fundId": "string",
-    "...": "action specific"
-  }
-}
-```
-
-## Strategy Actions
-
-### `propose_intent`
-CLI mapping: `strategy-propose`
-```json
-{
-  "fundId": "string",
-  "intentFile": "/path/intent.json",
-  "executionRouteFile": "/path/route.json",
-  "maxNotional": "optional bigint",
-  "intentUri": "optional string"
-}
-```
-
-Intent JSON schema:
-```json
-{
-  "intentVersion": "V1",
-  "vault": "0x...",
-  "action": "BUY | SELL",
-  "tokenIn": "0x...",
-  "tokenOut": "0x...",
-  "amountIn": "bigint string",
-  "minAmountOut": "bigint string",
-  "deadline": "unix seconds string",
-  "maxSlippageBps": "bigint string",
-  "snapshotHash": "0x<32bytes>"
-}
-```
-
-Execution route JSON schema:
-```json
-{
-  "tokenIn": "0x...",
-  "tokenOut": "0x...",
-  "quoteAmountOut": "bigint string",
-  "minAmountOut": "bigint string",
-  "adapter": "0x...",
-  "adapterData": "0x..."
-}
-```
-
-### `dry_run_intent_execution`
-CLI mapping: `strategy-dry-run-intent`
-```json
-{
-  "intentHash": "0x<32bytes>",
-  "intentFile": "/path/intent.json",
-  "executionRouteFile": "/path/route.json",
-  "coreAddress": "optional 0x..., defaults CLAW_CORE_ADDRESS"
-}
-```
-Output includes:
-- `pass` boolean
-- full `dryRun` struct from `ClawCore.dryRunIntentExecution`
-
-### `attest_intent_onchain`
-CLI mapping: `strategy-attest-onchain`
-Required params:
-```json
-{ "fundId": "string", "intentHash": "0x<32bytes>" }
-```
-
-### `execute_intent_onchain`
-CLI mapping: `strategy-execute-ready`
-Required params:
-```json
-{ "fundId": "string" }
-```
-
-## Participant Actions
-
-### `mine_claim`
-CLI mapping: `participant-mine`
-```json
-{
-  "fundId": "string",
-  "epochId": 1,
-  "sourceRef": "https://...",
-  "tokenAddress": "0x..."
-}
-```
-
-### `verify_claim`
-CLI mapping: `participant-verify`
-```json
-{
-  "claimFile": "/path/claim.json",
-  "reproducible": false,
-  "maxDataAgeSeconds": 300
-}
-```
-
-### `submit_claim`
-CLI mapping: `participant-submit`
-```json
-{
-  "claimFile": "/path/claim.json",
-  "submit": true
-}
-```
-
-### `attest_claim`
-CLI mapping: `participant-attest`
-```json
-{
-  "fundId": "string",
-  "epochId": 1,
-  "claimHash": "0x<32bytes>",
-  "submit": true
-}
-```
-
-## Safety Rules
-1. Fail closed when relayer auth/scope/role checks fail.
-2. Never bypass SDK canonical hashing and EIP-712 signing.
-3. Use `dry_run_intent_execution` before execute in production flows.
-4. Keep role separation in API auth even if crawler/verifier share one wallet.
-5. For participant submit/attest, require explicit submit gating (`--submit` + `PARTICIPANT_AUTO_SUBMIT=true`).

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

@@ -1,176 +0,0 @@
----
-name: openfunderse-participant
-description: Participant MoltBot for data mining (claims) and cross-verification (attestations)
-metadata:
-  openclaw:
-    requires:
-      env:
-        - RELAYER_URL
-        - PARTICIPANT_PRIVATE_KEY
-        - BOT_ID
-        - BOT_API_KEY
-        - CHAIN_ID
-        - CLAIM_ATTESTATION_VERIFIER_ADDRESS
-      bins:
-        - node
-        - npm
-    primaryEnv: RELAYER_URL
-    skillKey: participant
----
-
-# Participant MoltBot Skill
-
-The Participant MoltBot is responsible for mining data claims from specified sources and verifying claims or intents proposed by other agents. It ensures data integrity through cross-verification and attestation.
-
-## Quick Start (ClawHub Users)
-
-Install the skill first:
-
-```bash
-npx clawhub@latest install openfunderse-participant
-```
-
-## Credential Scope
-
-- `PARTICIPANT_PRIVATE_KEY` (or runtime fallback key) is used only for claim-attestation signing.
-- Do NOT use treasury/custody/admin keys.
-- Use a dedicated verifier/participant key with minimal privileges and rotation policy.
-
-## Submission Safety Gates
-
-`submit_mined_claim` and `attest_claim` are guarded by default:
-
-1. `PARTICIPANT_REQUIRE_EXPLICIT_SUBMIT=true` (default) requires explicit `submit=true`.
-2. `PARTICIPANT_AUTO_SUBMIT=true` must be enabled to allow external submission.
-3. `RELAYER_URL` is validated; enforce trusted hosts with `PARTICIPANT_TRUSTED_RELAYER_HOSTS`.
-4. Without submit approval, submit/attest returns `decision=READY` and does not transmit to relayer.
-
-## Input
-
-The skill supports four operational modes: **Mining**, **Verification**, **Submission**, and **Attestation**.
-
-### Mode A: Mining (`mine_claim`)
-Used to extract data from a source and create a claim.
-
-```json
-{
-  "taskType": "mine_claim",
-  "fundId": "string",
-  "roomId": "string",
-  "epochId": "number",
-  "sourceSpec": {
-    "sourceSpecId": "string",
-    "sourceRef": "string",
-    "extractor": "object",
-    "freshnessSeconds": "number"
-  },
-  "tokenContext": {
-    "symbol": "string",
-    "address": "string"
-  }
-}
-```
-
-### Mode B: Verification (`verify_claim_or_intent_validity`)
-Used to verify an existing claim or the technical validity of an intent.
-
-```json
-{
-  "taskType": "verify_claim_or_intent_validity",
-  "fundId": "string",
-  "roomId": "string",
-  "epochId": "number",
-  "subjectType": "CLAIM | INTENT",
-  "subjectHash": "string",
-  "subjectPayload": "object",
-  "validationPolicy": {
-    "reproducible": "boolean",
-    "maxDataAgeSeconds": "number"
-  }
-}
-```
-
-### Mode C: Submit (`submit_mined_claim`)
-Submits canonical claim payload to relayer (only when explicit submit gate is passed).
-
-```json
-{
-  "taskType": "submit_mined_claim",
-  "fundId": "string",
-  "epochId": "number",
-  "observation": "object",
-  "submit": "boolean (required for transmission when explicit-submit mode is enabled)"
-}
-```
-
-### Mode D: Attest (`attest_claim`)
-Signs and submits claim attestation envelope (only when explicit submit gate is passed).
-
-```json
-{
-  "taskType": "attest_claim",
-  "fundId": "string",
-  "epochId": "number",
-  "claimHash": "0x...",
-  "submit": "boolean (required for transmission when explicit-submit mode is enabled)"
-}
-```
-
-## Output
-
-### Mining Output
-```json
-{
-  "status": "OK",
-  "taskType": "mine_claim",
-  "fundId": "string",
-  "epochId": "number",
-  "observation": {
-    "sourceSpecId": "string",
-    "token": "string",
-    "timestamp": "number",
-    "extracted": "string",
-    "responseHash": "string",
-    "evidenceURI": "string",
-    "crawler": "string"
-  },
-  "confidence": "number",
-  "assumptions": ["string"]
-}
-```
-
-### Verification Output
-```json
-{
-  "status": "OK",
-  "taskType": "verify_claim_or_intent_validity",
-  "fundId": "string",
-  "roomId": "string",
-  "epochId": "number",
-  "subjectType": "CLAIM | INTENT",
-  "subjectHash": "string",
-  "verdict": "PASS | FAIL | NEED_MORE_EVIDENCE",
-  "reason": "string",
-  "attestationDraft": {
-    "validator": "string",
-    "expiresAt": "number",
-    "nonce": "number"
-  },
-  "confidence": "number",
-  "assumptions": ["string"]
-}
-```
-
-## Rules
-
-1. **Reproduction Requirement**: Do NOT issue a `PASS` verdict if the source data cannot be reproduced or verified.
-2. **Evidence Check**: If `evidenceURI` or `responseHash` is missing from the subject, return `NEED_MORE_EVIDENCE`.
-3. **Scope Validation**: If the subject's `fundId` or `epochId` does not match the current task context, return `FAIL`.
-4. **Key Hygiene**: Use only dedicated participant/verifier keys. Never use custody/admin keys for attest operations.
-5. **Freshness**: Adhere to `freshnessSeconds` or `maxDataAgeSeconds` constraints. If data is stale, the verdict should reflect this.
-6. **Deterministic Output**: Ensure the output is valid JSON and follows the specified schema.
-7. **Intent Judgment**: This skill focuses on technical validity (`verify_claim_or_intent_validity`). Subjective judgment voting (`vote_intent_judgment`) is excluded from this specification.
-8. **Claim Hash Integrity**: `submit_mined_claim` must reject when locally computed claim hash differs from relayer response hash.
-9. **Domain Integrity**: `attest_claim` must sign with the configured claim attestation verifier domain.
-10. **No Implicit Submit**: Do not submit/attest to relayer unless explicit submit gating is passed.
-11. **Trusted Relayer**: In production, set `PARTICIPANT_TRUSTED_RELAYER_HOSTS` and avoid arbitrary relayer URLs.

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

@@ -1,265 +0,0 @@
----
-name: openfunderse-strategy
-description: OpenFunderse Strategy bot for proposing and gated submission of trade intents
-always: false
-disable-model-invocation: false
-metadata:
-  openclaw:
-    requires:
-      env:
-        - RELAYER_URL
-        - BOT_ID
-        - BOT_API_KEY
-        - BOT_ADDRESS
-        - CHAIN_ID
-        - RPC_URL
-        - STRATEGY_PRIVATE_KEY
-        - INTENT_BOOK_ADDRESS
-        - NADFUN_EXECUTION_ADAPTER_ADDRESS
-        - ADAPTER_ADDRESS
-        - NADFUN_LENS_ADDRESS
-        - NADFUN_BONDING_CURVE_ROUTER
-        - NADFUN_DEX_ROUTER
-        - NADFUN_WMON_ADDRESS
-        - VAULT_ADDRESS
-        - STRATEGY_AUTO_SUBMIT
-        - STRATEGY_REQUIRE_EXPLICIT_SUBMIT
-        - STRATEGY_TRUSTED_RELAYER_HOSTS
-        - STRATEGY_ALLOW_HTTP_RELAYER
-        - STRATEGY_MAX_IMPACT_BPS
-        - STRATEGY_SELL_TAKE_PROFIT_BPS
-        - STRATEGY_SELL_STOP_LOSS_BPS
-        - STRATEGY_SELL_MAX_HOLD_SECONDS
-        - STRATEGY_DEADLINE_MIN_SECONDS
-        - STRATEGY_DEADLINE_BASE_SECONDS
-        - STRATEGY_DEADLINE_MAX_SECONDS
-        - STRATEGY_DEADLINE_PER_CLAIM_SECONDS
-    primaryEnv: STRATEGY_PRIVATE_KEY
-    skillKey: strategy
----
-
-# Strategy MoltBot Skill
-
-The Strategy MoltBot is responsible for proposing structured trade intents based on finalized data snapshots. It evaluates market conditions, liquidity, and risk policies to decide whether to propose a trade or hold.
-For NadFun venues, it must use lens quotes to derive `minAmountOut` and reject router mismatch.
-In runtime, use `proposeIntentAndSubmit` to build a canonical proposal first, then submit only when explicit submit gating is satisfied.
-
-## Quick Start (ClawHub Users)
-
-Install the skill first:
-
-```bash
-npx clawhub@latest install openfunderse-strategy
-```
-
-This skill is instruction-only. You need the runtime package:
-
-```bash
-npm init -y && npm i @wiimdy/openfunderse-agents@0.1.1 --ignore-scripts
-```
-
-Create editable env scaffold in one line:
-
-```bash
-cp node_modules/@wiimdy/openfunderse-agents/.env.strategy.example .env.openfunderse
-```
-
-Verify source before install (recommended):
-
-```bash
-npm view @wiimdy/openfunderse-agents@0.1.1 repository.url homepage dist.integrity
-```
-
-Then configure env and run commands from:
-
-- `packages/agents/.env.strategy.example`
-- `packages/agents/README.md`
-
-Runtime sources:
-
-- npm package: `https://www.npmjs.com/package/@wiimdy/openfunderse-agents`
-- repository: `https://github.com/wiimdy/openfunderse/tree/main/packages/agents`
-
-Do not use `@latest` in production; pin an explicit version and keep lockfile reviewed.
-
-## Credential Scope
-
-- `STRATEGY_PRIVATE_KEY` is the **strategy signer key (EOA)** used for onchain strategy operations.
-- It must NOT be a treasury/custody/admin key.
-- Prefer a dedicated, least-privilege signer account only for strategy execution.
-- Keep this key in a secret manager/HSM when possible, rotate regularly, and use testnet key first.
-
-## Invocation Policy
-
-- Model invocation is enabled for discoverability (`disable-model-invocation: false`).
-- Keep submit guards strict (`STRATEGY_REQUIRE_EXPLICIT_SUBMIT=true`, `STRATEGY_AUTO_SUBMIT=false`) unless intentionally overridden.
-- Onchain or relayer submission should happen only after explicit user approval.
-
-## Submission Safety Gates
-
-`proposeIntentAndSubmit` is guarded by default:
-
-1. `STRATEGY_REQUIRE_EXPLICIT_SUBMIT=true` (default) requires explicit `submit=true`.
-2. `STRATEGY_AUTO_SUBMIT=true` must be enabled to allow external submission.
-3. `RELAYER_URL` is validated; enforce trusted hosts with `STRATEGY_TRUSTED_RELAYER_HOSTS`.
-4. Without submit approval, function returns `decision=READY` and does not post to relayer or send onchain tx.
-5. Keep `STRATEGY_AUTO_SUBMIT=false` in production unless you intentionally enable unattended submission.
-
-## Input
-
-The skill accepts a `propose_intent` task with the following schema:
-
-```json
-{
-  "taskType": "propose_intent",
-  "fundId": "string",
-  "roomId": "string",
-  "epochId": "number",
-  "snapshot": {
-    "snapshotHash": "string",
-    "finalized": "boolean",
-    "claimCount": "number"
-  },
-  "marketState": {
-    "network": "number",
-    "nadfunCurveState": "object",
-    "liquidity": "object",
-    "volatility": "object",
-    "positions": [
-      {
-        "token": "string",
-        "quantity": "string | number",
-        "costBasisAsset": "string | number (optional)",
-        "openedAt": "unix seconds or milliseconds (optional)"
-      }
-    ]
-  },
-  "riskPolicy": {
-    "maxNotional": "string",
-    "maxSlippageBps": "number",
-    "allowlistTokens": ["string"],
-    "allowlistVenues": ["string"]
-  }
-}
-```
-
-### Example Input
-```json
-{
-  "taskType": "propose_intent",
-  "fundId": "fund-001",
-  "roomId": "telegram-room-abc",
-  "epochId": 12,
-  "snapshot": {
-    "snapshotHash": "0xabc123...",
-    "finalized": true,
-    "claimCount": 19
-  },
-  "marketState": {
-    "network": 10143,
-    "nadfunCurveState": {},
-    "liquidity": {},
-    "volatility": {},
-    "positions": [
-      {
-        "token": "0xtoken1...",
-        "quantity": "1200000000000000000",
-        "costBasisAsset": "1000000000000000000",
-        "openedAt": 1730000000
-      }
-    ]
-  },
-  "riskPolicy": {
-    "maxNotional": "1000",
-    "maxSlippageBps": 80,
-    "allowlistTokens": ["0xtoken1...", "0xtoken2..."],
-    "allowlistVenues": ["NadFun", "UniswapV3"]
-  }
-}
-```
-
-## Output
-
-The skill returns either a `PROPOSE` or `HOLD` decision.
-
-### PROPOSE Decision
-Returned when market conditions meet the risk policy and a profitable trade is identified.
-
-```json
-{
-  "status": "OK",
-  "taskType": "propose_intent",
-  "fundId": "string",
-  "epochId": "number",
-  "decision": "PROPOSE",
-  "intent": {
-    "intentVersion": "V1",
-    "fundId": "string",
-    "roomId": "string",
-    "epochId": "number",
-    "vault": "string",
-    "action": "BUY | SELL",
-    "tokenIn": "string",
-    "tokenOut": "string",
-    "amountIn": "string",
-    "minAmountOut": "string",
-    "deadline": "number",
-    "maxSlippageBps": "number",
-    "snapshotHash": "string"
-  },
-  "executionPlan": {
-    "venue": "NADFUN_BONDING_CURVE | NADFUN_DEX",
-    "router": "string",
-    "quoteAmountOut": "string"
-  },
-  "reason": "string",
-  "riskChecks": {
-    "allowlistPass": "boolean",
-    "notionalPass": "boolean",
-    "slippagePass": "boolean",
-    "deadlinePass": "boolean"
-  },
-  "confidence": "number",
-  "assumptions": ["string"]
-}
-```
-
-### Guarded Submit Flow
-When using `proposeIntentAndSubmit` with explicit submit gates satisfied, a `PROPOSE` decision is followed by:
-1. Relayer `POST /api/v1/funds/{fundId}/intents/propose`
-2. Strategy signer (EOA) `IntentBook.proposeIntent(...)`
-
-This keeps offchain canonical intent and onchain intent registration aligned in the same skill timing.
-
-### HOLD Decision
-Returned when no trade is proposed due to risk constraints or market conditions.
-
-```json
-{
-  "status": "OK",
-  "taskType": "propose_intent",
-  "fundId": "string",
-  "roomId": "string",
-  "epochId": "number",
-  "decision": "HOLD",
-  "reason": "string",
-  "confidence": "number",
-  "assumptions": ["string"]
-}
-```
-
-## Rules
-
-1. **Finality Requirement**: Do NOT propose an intent unless `snapshot.finalized` is `true`.
-2. **Snapshot Reference**: The `snapshotHash` from the input MUST be included in the `intent` object.
-3. **Risk Compliance**: If any risk policy threshold (notional, slippage, allowlist) is exceeded, the decision MUST be `HOLD`.
-4. **NadFun Specifics**: Evaluate liquidity, slippage, and bonding curve status (pre/post graduation) separately for NadFun tokens.
-5. **Proposal Only**: Assume the agent has proposal rights only, not direct execution rights.
-6. **Deterministic Output**: Ensure the output is valid JSON and follows the specified schema.
-7. **Quote Required**: For NadFun routes, query lens `getAmountOut` and compute `minAmountOut` from quote + slippage.
-8. **No Zero MinOut**: Never propose with `minAmountOut=0`.
-9. **Fail Closed**: If quote fails or returned router is not allowlisted, return `HOLD`.
-10. **Sell First**: If a token position exists, evaluate `SELL` triggers first (`take-profit`, `stop-loss`, `time-exit`) before considering `BUY`.
-11. **Timestamp Normalization**: `openedAt` may be in seconds or milliseconds; normalize before age-based exits.
-12. **No Implicit Submit**: Do not submit to relayer/onchain unless explicit submit gating is passed.
-13. **Trusted Relayer**: In production, set `STRATEGY_TRUSTED_RELAYER_HOSTS` and avoid arbitrary relayer URLs.

package/packs/openfunderse/skills/relayer/SKILL.md

@@ -1,10 +0,0 @@
-# Relayer Skill
-
-Purpose:
-- Define relayer-support MoltBot behavior for submission orchestration.
-
-Responsibilities:
-- Validate bot scope and fund-role authorization for every write call.
-- Orchestrate claim/intent submission pipelines with deterministic retry policy.
-- Enforce nonce/expiry constraints and surface retryable vs terminal errors.
-- Emit operator-friendly status with request IDs and subject hashes.