@jinn-network/client 0.1.0 → 0.1.1-canary.4a6ed8b2

package/dist/venues/hyperliquid/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/venues/hyperliquid/client.ts"],"names":[],"mappings":"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"}

package/dist/venues/hyperliquid/grid.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Portfolio grid bracketing helper.
+ *
+ * Hyperliquid's `portfolio` endpoint returns `accountValueHistory` on a
+ * rolling ~140-minute grid. Given a target timestamp, this module finds the
+ * two grid points immediately before and after it — the "bracket" — which
+ * the evaluator uses to verify pre-snapshot account value.
+ *
+ * This module is pure (no I/O). Pass in the grid and a target; get back a
+ * bracket or null if bracketing is not possible.
+ */
+import type { HlGridPoint } from './types.js';
+export interface GridBracket {
+    /** The last grid point at or before targetTs. */
+    before: HlGridPoint;
+    /** The first grid point strictly after targetTs. */
+    after: HlGridPoint;
+}
+/**
+ * Given an `accountValueHistory` array and a target timestamp, returns the two
+ * grid points that bracket the target.
+ *
+ * - If `targetTs` is exactly on a grid point, that point is returned as
+ *   `before` and the next point is `after`.
+ * - Returns `null` when:
+ *   - The grid is empty.
+ *   - `targetTs` is before all grid points (no `before` candidate).
+ *   - `targetTs` is at or after the last grid point (no `after` candidate).
+ *
+ * The input array does not need to be sorted — this function sorts by timestamp
+ * before searching.
+ *
+ * @param history  Array of [timestamp_ms, value_str] grid points.
+ * @param targetTs Target timestamp in epoch milliseconds.
+ */
+export declare function bracketGridPoints(history: HlGridPoint[], targetTs: number): GridBracket | null;

package/dist/venues/hyperliquid/grid.js

@@ -0,0 +1,61 @@
+/**
+ * Portfolio grid bracketing helper.
+ *
+ * Hyperliquid's `portfolio` endpoint returns `accountValueHistory` on a
+ * rolling ~140-minute grid. Given a target timestamp, this module finds the
+ * two grid points immediately before and after it — the "bracket" — which
+ * the evaluator uses to verify pre-snapshot account value.
+ *
+ * This module is pure (no I/O). Pass in the grid and a target; get back a
+ * bracket or null if bracketing is not possible.
+ */
+// ---------------------------------------------------------------------------
+// Core helper
+// ---------------------------------------------------------------------------
+/**
+ * Given an `accountValueHistory` array and a target timestamp, returns the two
+ * grid points that bracket the target.
+ *
+ * - If `targetTs` is exactly on a grid point, that point is returned as
+ *   `before` and the next point is `after`.
+ * - Returns `null` when:
+ *   - The grid is empty.
+ *   - `targetTs` is before all grid points (no `before` candidate).
+ *   - `targetTs` is at or after the last grid point (no `after` candidate).
+ *
+ * The input array does not need to be sorted — this function sorts by timestamp
+ * before searching.
+ *
+ * @param history  Array of [timestamp_ms, value_str] grid points.
+ * @param targetTs Target timestamp in epoch milliseconds.
+ */
+export function bracketGridPoints(history, targetTs) {
+    if (history.length === 0)
+        return null;
+    // Sort ascending by timestamp.
+    const sorted = [...history].sort((a, b) => a[0] - b[0]);
+    // Find the last point with timestamp <= targetTs.
+    let beforeIdx = -1;
+    for (let i = 0; i < sorted.length; i++) {
+        if (sorted[i][0] <= targetTs) {
+            beforeIdx = i;
+        }
+        else {
+            break;
+        }
+    }
+    if (beforeIdx === -1) {
+        // Target is before all grid points.
+        return null;
+    }
+    const afterIdx = beforeIdx + 1;
+    if (afterIdx >= sorted.length) {
+        // Target is at or after the last grid point — no after candidate.
+        return null;
+    }
+    return {
+        before: sorted[beforeIdx],
+        after: sorted[afterIdx],
+    };
+}
+//# sourceMappingURL=grid.js.map

package/dist/venues/hyperliquid/grid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid.js","sourceRoot":"","sources":["../../../src/venues/hyperliquid/grid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAeH,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAsB,EACtB,QAAgB;IAEhB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,+BAA+B;IAC/B,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAExD,kDAAkD;IAClD,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,MAAM,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC;YAC9B,SAAS,GAAG,CAAC,CAAC;QAChB,CAAC;aAAM,CAAC;YACN,MAAM;QACR,CAAC;IACH,CAAC;IAED,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,oCAAoC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,SAAS,GAAG,CAAC,CAAC;IAC/B,IAAI,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAC9B,kEAAkE;QAClE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,SAAS,CAAE;QAC1B,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAE;KACzB,CAAC;AACJ,CAAC"}

package/dist/venues/hyperliquid/types.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Hyperliquid public REST API response shapes.
+ *
+ * Only fields we actively use are typed precisely; complex/variable sub-objects
+ * are left as `unknown` to avoid over-modelling a rapidly-changing API.
+ */
+/** A fill record returned by userFills / userFillsByTime. */
+export interface HlFill {
+    coin: string;
+    px: string;
+    sz: string;
+    side: 'A' | 'B';
+    time: number;
+    startPosition: string;
+    dir: string;
+    closedPnl: string;
+    hash: string;
+    oid: number;
+    crossed: boolean;
+    fee: string;
+    tid: number;
+    feeToken: string;
+    twapId: number | null;
+}
+export interface HlMarginSummary {
+    accountValue: string;
+    totalNtlPos: string;
+    totalRawUsd: string;
+    totalMarginUsed: string;
+}
+export interface HlClearinghouseState {
+    marginSummary: HlMarginSummary;
+    crossMarginSummary: HlMarginSummary;
+    crossMaintenanceMarginUsed: string;
+    withdrawable: string;
+    assetPositions: unknown[];
+    time: number;
+}
+export interface HlSpotBalance {
+    coin: string;
+    token: number;
+    total: string;
+    hold: string;
+    entryNtl: string;
+}
+export interface HlSpotClearinghouseState {
+    balances: HlSpotBalance[];
+}
+export type HlUserFills = HlFill[];
+export interface HlUserFillsByTimeResult {
+    fills: HlFill[];
+    /** True when the API silently clamped startTime to its retention horizon. */
+    startTimeClamped: boolean;
+}
+/**
+ * [timestamp_ms, value_str] tuple as returned in accountValueHistory.
+ */
+export type HlGridPoint = [number, string];
+export interface HlPeriodData {
+    accountValueHistory: HlGridPoint[];
+    pnlHistory: HlGridPoint[];
+    vlm: string;
+}
+export type HlPortfolioPeriod = 'day' | 'week' | 'month' | 'allTime' | 'perpDay' | 'perpWeek' | 'perpMonth' | 'perpAllTime';
+/**
+ * portfolio response is an array of [periodName, periodData] tuples.
+ * e.g. [["day", {...}], ["week", {...}], ...]
+ */
+export type HlPortfolioResponse = [string, HlPeriodData][];
+export interface HlPerpMeta {
+    name: string;
+    szDecimals: number;
+    maxLeverage: number;
+    marginTableId: number;
+    isDelisted?: boolean;
+}
+export interface HlMetaResponse {
+    universe: HlPerpMeta[];
+}
+/** Map from asset name to mid-price string. */
+export type HlAllMidsResponse = Record<string, string>;

package/dist/venues/hyperliquid/types.js

@@ -0,0 +1,8 @@
+/**
+ * Hyperliquid public REST API response shapes.
+ *
+ * Only fields we actively use are typed precisely; complex/variable sub-objects
+ * are left as `unknown` to avoid over-modelling a rapidly-changing API.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/venues/hyperliquid/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/venues/hyperliquid/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jinn-network/client",
-  "version": "0.1.0",
+  "version": "0.1.1-canary.4a6ed8b2",
   "description": "Jinn protocol client — headless daemon for the restoration training loop",
   "type": "module",
   "packageManager": "yarn@4.13.0",
@@ -14,13 +14,15 @@
     "node": ">=20"
   },
   "bin": {
-    "jinn": "./dist/bin/jinn.js"
+    "jinn": "./dist/bin/jinn.js",
+    "jinn-mcp": "./dist/bin/jinn-mcp.js"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
     "dist/",
     "deployments/",
+    "skills/",
     "README.md",
     "LICENSE"
   ],
@@ -29,15 +31,24 @@
   },
   "scripts": {
     "jinn": "tsx src/bin/jinn.ts",
-    "build": "tsc && chmod +x dist/bin/jinn.js && node scripts/write-dist-build-meta.mjs",
+    "dev": "yarn build && node dist/bin/jinn.js",
+    "build": "tsc && chmod +x dist/bin/jinn.js dist/bin/jinn-mcp.js && mkdir -p dist/dashboard && cp src/dashboard/index.html dist/dashboard/index.html && node scripts/write-dist-build-meta.mjs",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",
     "prepublishOnly": "yarn build && yarn test",
     "pack:smoke": "yarn pack -o jinn-client.tgz && node scripts/smoke-test-pack.mjs",
     "release:operator-gate": "yarn staking && yarn e2e",
+    "setup:testnet-acceptance-operator": "node scripts/setup-testnet-acceptance-operator-docker.mjs",
+    "setup:testnet-acceptance-operator:docker": "node scripts/setup-testnet-acceptance-operator-docker.mjs",
+    "setup:testnet-acceptance-operator:host": "node scripts/setup-testnet-acceptance-operator.mjs",
+    "release:testnet-acceptance": "node scripts/testnet-acceptance-docker.mjs",
+    "release:testnet-acceptance:docker": "node scripts/testnet-acceptance-docker.mjs",
+    "release:testnet-acceptance:host": "node scripts/testnet-acceptance.mjs",
     "status": "tsx scripts/status.ts",
     "e2e": "tsx scripts/e2e-validate.ts",
+    "e2e-portfolio-v0": "tsx scripts/e2e-portfolio-v0.ts",
+    "e2e:prediction": "cd ../contracts && yarn compile && cd ../client && tsx scripts/e2e-prediction-v0.ts",
     "staking": "tsx scripts/staking-validate.ts",
     "stolas": "tsx scripts/stolas-validate.ts",
     "withdraw": "tsx scripts/withdraw.ts"
@@ -47,6 +58,7 @@
     "@hono/node-server": "^1.19.12",
     "@jinn-network/mech-client-ts": "^0.0.6",
     "@modelcontextprotocol/sdk": "^1.27.1",
+    "@msgpack/msgpack": "^3.0.0",
     "@safe-global/protocol-kit": "^6.1.2",
     "@safe-global/types-kit": "^3.0.0",
     "@scure/bip32": "^1.7.0",
@@ -62,6 +74,9 @@
     "viem": "^2.0.0",
     "zod": "^3.22.0"
   },
+  "optionalDependencies": {
+    "@coinbase/cdp-sdk": "^1.47.0"
+  },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.0",
     "@types/node": "^20.0.0",

package/skills/jinn-operator/SKILL.md

@@ -0,0 +1,213 @@
+---
+name: jinn-operator
+description: Set up and operate a Jinn Network agent. Use when the user wants to install the jinn client, configure MCP tools, run `jinn quickstart`, manage a running daemon, submit intents, or understand the Jinn protocol. Activates on mentions of "jinn", "jinn agent", "jinn network", "jinn quickstart", "desired state", "restoration", or "intent" in the context of operating an agent.
+allowed-tools: Bash, Read, Edit, Write, Glob, Grep
+---
+
+# Jinn Operator Skill
+
+Guides you through installing, configuring, and operating a Jinn Network agent.
+
+## What Is Jinn
+
+Jinn is a training protocol for agentic intents. It defines a loop:
+
+```
+Creation  -->  Execution  -->  Evaluation  -->  Knowledge
+   |                                               |
+   +-----------------------------------------------+
+```
+
+1. **Creation** — a creator publishes a *desired state* (an intent describing what should be true)
+2. **Execution** — a restorer claims the intent and attempts to make it true
+3. **Evaluation** — an evaluator independently verifies whether the restoration succeeded
+4. **Knowledge** — artifacts (learnings, evidence) accumulate to improve future attempts
+
+Agents earn rewards by participating in this loop. The protocol runs on Base (mainnet) and Base Sepolia (testnet).
+
+## Phase 1: Installation
+
+Check if jinn is already installed:
+
+```bash
+jinn --help
+```
+
+If not installed:
+
+```bash
+npm install -g @jinn-network/client
+```
+
+This gives you two binaries:
+- `jinn` — the operator CLI (17 verbs)
+- `jinn-mcp` — the MCP server for agent-to-agent operation
+
+### Prerequisites
+
+- **Node.js 22+** — `node --version` to check
+- **Claude Code CLI** — the daemon spawns Claude as a subprocess for restoration work. Must be installed and authenticated separately.
+
+## Phase 2: MCP Configuration
+
+If the user wants their agent (Claude Code, Cursor, etc.) to operate jinn programmatically, configure the MCP server:
+
+**For Claude Code** — add to project or user MCP settings:
+```json
+{
+  "mcpServers": {
+    "jinn": {
+      "command": "jinn-mcp"
+    }
+  }
+}
+```
+
+**With npx (no global install needed):**
+```json
+{
+  "mcpServers": {
+    "jinn": {
+      "command": "npx",
+      "args": ["-y", "-p", "@jinn-network/client", "jinn-mcp"]
+    }
+  }
+}
+```
+
+Once configured, these MCP tools become available:
+
+| Tool | What it does |
+|------|-------------|
+| `jinn_init` | Create master wallet (idempotent) |
+| `jinn_doctor` | Preflight checks |
+| `jinn_status` | Daemon health + fleet roll-up |
+| `jinn_fleet` | Per-service detail |
+| `jinn_balance` | Wallet balances |
+| `jinn_history` | Recent protocol activity |
+| `jinn_rewards` | Earned vs claimed rewards |
+| `jinn_bootstrap` | Advance fleet state machine |
+| `jinn_submit_intent` | Post a desired state on-chain |
+| `jinn_start_daemon` | Start daemon in background |
+| `jinn_stop_daemon` | Stop running daemon |
+
+## Phase 3: Quickstart (Zero to Running)
+
+The fastest path from nothing to a running agent:
+
+```bash
+jinn quickstart
+```
+
+This single command:
+1. Generates a random keystore password (saved to `~/.jinn-client/keystore-password`)
+2. Creates the master wallet
+3. Funds via Coinbase CDP faucet (automatic on testnet)
+4. Bootstraps the fleet (Safe wallet, service registration, staking, mech deployment)
+5. Starts the daemon
+
+When it finishes: **open `http://localhost:7331`** for the operator dashboard.
+
+### If the user already has JINN_PASSWORD set:
+
+```bash
+JINN_PASSWORD=their-password jinn quickstart
+```
+
+The command respects an existing password and won't generate a new one.
+
+### If quickstart stops at "funding required":
+
+The automatic faucet may have rate-limited (1 claim per 24 hours per address). Options:
+- Wait 24 hours and re-run `jinn quickstart`
+- Fund manually: go to https://portal.cdp.coinbase.com/products/faucet, send testnet ETH to the printed master address, then re-run
+
+## Phase 4: Ongoing Operation
+
+### Monitoring
+
+- **Dashboard:** `http://localhost:7331` (when daemon is running)
+- **CLI:** `jinn status` for a quick health check
+- **Fleet detail:** `jinn fleet` shows each service's step, Safe, mech, staking status
+- **Balances:** `jinn balance` shows master and service wallet balances
+
+### Submitting Intents
+
+To post a desired state for the network to work on:
+
+```bash
+jinn submit-intent --id my-intent --description "The service publishes a daily summary" --yes
+```
+
+Or via MCP: call `jinn_submit_intent` with `id` and `description` parameters.
+
+### Checking Rewards
+
+```bash
+jinn rewards
+```
+
+Shows pending vs claimed rewards per service.
+
+### Changing the Auto-Generated Password
+
+If the user started with `jinn quickstart` and wants to set their own password:
+
+```bash
+JINN_NEW_PASSWORD=their-new-password jinn keys change-password
+```
+
+This re-encrypts the keystore and deletes the auto-generated password file. The wallet and all on-chain state are unchanged.
+
+### Stopping and Starting
+
+```bash
+jinn stop       # stop the daemon
+jinn run        # start in foreground
+```
+
+## Troubleshooting
+
+### `jinn doctor` fails on claude_binary
+
+Claude Code CLI is not installed or not on PATH. Install it separately — see https://claude.ai/code.
+
+### Bootstrap stuck at "awaiting funding"
+
+The master wallet needs testnet ETH. Either:
+- The CDP faucet rate-limited (wait 24h)
+- The faucet SDK isn't installed: `npm install @coinbase/cdp-sdk`
+- Fund manually via a web faucet
+
+### Daemon starts but no activity
+
+Check `jinn status`. If `rpc.ok` is false, the RPC endpoint is down. The default (`https://sepolia.base.org`) is rate-limited. Consider using your own RPC via config:
+
+```bash
+echo '{"rpcUrl": "https://your-rpc.example.com"}' > ~/.jinn-client/config.json
+```
+
+### "No service is ready" after bootstrap
+
+Bootstrap may need multiple runs if it hit a funding gate partway through. Re-run `jinn bootstrap` (it's idempotent — picks up where it left off).
+
+## Key Concepts for Agents
+
+When operating jinn tools, keep this mental model:
+
+- **`jinn quickstart`** is the one-shot setup. After this, the daemon is running.
+- **`jinn status`** is your health check. Poll it to know if things are working.
+- **`jinn submit-intent`** is the main action verb. This is how you create work on the network.
+- **`jinn fleet`** tells you about your staked services and their state.
+- **`jinn bootstrap`** is idempotent. If anything is stuck, re-running it is always safe.
+- **`funding_required`** means "the wallet needs ETH." On testnet, this should auto-resolve via faucet. If not, the user needs to fund manually.
+- The daemon runs three loops: creator (posts intents), restorer (claims and fulfills intents), delivery-watcher (evaluates results). All three run automatically once the daemon starts.
+
+## Network Details
+
+| | Testnet (default) | Mainnet |
+|---|---|---|
+| Chain | Base Sepolia | Base |
+| RPC default | `https://sepolia.base.org` | `https://mainnet.base.org` |
+| Staking mode | standard (stOLAS, no OLAS needed) | standard |
+| Config key | `"network": "testnet"` | `"network": "mainnet"` |