@wiimdy/openfunderse 0.1.3 → 1.1.2

package/README.md

@@ -1,76 +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 \
-  --yes
+## Where Files Are Stored
 
-# initialize participant bot env + wallet
-npx @wiimdy/openfunderse@latest bot-init \
-  --skill-name 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`).
-- `--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.
-- `bot-init` writes to `.env` by default. Use `--env-path` to split strategy/participant env files.
-- 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,10 +74,9 @@ 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 install openfunderse-participant --with-runtime
+  openfunderse install openfunderse-strategy --codex-home /tmp/openclaw-workspace
   openfunderse bot-init --skill-name participant --wallet-name participant-bot --yes
   openfunderse bot-init --skill-name strategy --force
 `);
@@ -202,7 +200,7 @@ function parseArgs(argv) {
 }
 
 function defaultCodexHome() {
-  return process.env.CODEX_HOME || path.join(os.homedir(), ".codex");
+  return path.join(os.homedir(), ".openclaw", "workspace");
 }
 
 function ensureUnderRoot(root, target) {
@@ -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.3",
+  "version": "1.1.2",
   "description": "Install OpenFunderse skill packs into Codex",
   "type": "module",
   "bin": {

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

@@ -1,6 +1,6 @@
 {
   "name": "openfunderse-participant-pack",
-  "version": "0.1.0",
+  "version": "1.1.1",
   "installCommand": "npx @wiimdy/openfunderse@latest install openfunderse-participant --with-runtime",
   "description": "Standalone OpenFunderse participant skill pack.",
   "bundles": [

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

@@ -1,6 +1,6 @@
 {
   "name": "openfunderse-strategy-pack",
-  "version": "0.1.0",
+  "version": "1.1.1",
   "installCommand": "npx @wiimdy/openfunderse@latest install openfunderse-strategy --with-runtime",
   "description": "Standalone OpenFunderse strategy skill pack.",
   "bundles": [

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

@@ -56,7 +56,7 @@ npx clawhub@latest install openfunderse-strategy
 2) Install runtime + generate env scaffold:
 
 ```bash
-npx @wiimdy/openfunderse@latest install openfunderse-strategy --with-runtime
+npm init -y && npx @wiimdy/openfunderse@latest install openfunderse-strategy --with-runtime
 ```
 
 3) Rotate the temporary bootstrap key and write a fresh strategy wallet to env:

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

@@ -1,23 +0,0 @@
-{
-  "name": "openfunderse-agent-pack",
-  "version": "0.1.0",
-  "installCommand": "npx @wiimdy/openfunderse@latest install openfunderse --with-runtime",
-  "description": "Unified OpenFunderse pack with strategy + participant skills.",
-  "bundles": [
-    {
-      "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"
-    }
-  ],
-  "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/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/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/openfunderse-participant/SKILL.md

@@ -1,201 +0,0 @@
----
-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
-        - 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)
-
-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.
-- 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,260 +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:
-    installCommand: npx @wiimdy/openfunderse@latest install openfunderse-strategy --with-runtime
-    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)
-
-1) Install the skill:
-
-```bash
-npx clawhub@latest install openfunderse-strategy
-```
-
-2) Install runtime + generate env scaffold:
-
-```bash
-npx @wiimdy/openfunderse@latest install openfunderse-strategy --with-runtime
-```
-
-3) Rotate the temporary bootstrap key and write a fresh strategy wallet to env:
-
-```bash
-npx @wiimdy/openfunderse@latest bot-init \
-  --skill-name strategy \
-  --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
-
-- `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.