@jinn-network/client 0.1.0-canary.adfd078d

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Jinn Network contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,162 @@
+# @jinn-network/client
+
+Jinn protocol client. Runs a headless daemon that participates in the Jinn training loop: create, restore, and evaluate desired states, and earn rewards for measured work.
+
+## Install
+
+```bash
+npm install -g @jinn-network/client@latest
+```
+
+Or with Yarn:
+
+```bash
+yarn global add @jinn-network/client@latest
+```
+
+## Quick start
+
+```bash
+# Generate wallet and keystore
+jinn init
+
+# Check environment readiness
+jinn doctor
+
+# Start the daemon
+JINN_PASSWORD=your-keystore-password jinn run
+```
+
+On first run, the bootstrap generates a master wallet and prints a funding address. Send testnet ETH to it, then re-run. The bootstrap is idempotent — it picks up where it left off.
+
+`JINN_PASSWORD` encrypts the local keystore and is env-only; never put it in a config file.
+
+## Try without installing
+
+```bash
+npx @jinn-network/client@latest doctor
+```
+
+## Docker (Recommended for Operators)
+
+The Jinn daemon runs pure Node, but spawns the Anthropic `claude` CLI as a subprocess for restorations. To keep your costs low, operators should use Claude's OAuth authentication (which leverages prompt caching and app tiers) instead of brute-forcing API keys.
+
+Because the macOS keychain securely encrypts OAuth tokens, you **cannot** simply mount `~/.claude` from a Mac host into Docker. Instead, the most robust way to manage credentials and daemon state is using our included `docker-compose.yml`.
+
+### Zero-Friction Setup
+
+1. **Configure Environment:** Create a `.env` file with your master password:
+   ```bash
+   echo "JINN_PASSWORD=your-secure-password" > .env
+   ```
+
+2. **Authenticate Claude (One-Time):** The image entrypoint is the `jinn` binary, so run the Anthropic CLI directly by overriding the entrypoint. This performs the OAuth flow and saves the token to the persistent `jinn-claude-state` volume (same volumes as the daemon service):
+   ```bash
+   docker compose run --rm -it --entrypoint claude jinn-daemon auth login
+   ```
+   Use `-it` so the CLI can open a browser (or show a URL to visit) and receive input. The process stays in the foreground until you finish sign-in.
+   *Follow the URL to authenticate in your browser.*
+
+3. **Start the Fleet:** Now that the Docker volume holds the token, start the headless daemon:
+   ```bash
+   docker compose up -d
+   ```
+
+### Quick Test
+
+```bash
+docker run --rm ghcr.io/jinn-network/client:latest version --json
+```
+
+## Operator commands
+
+### Lifecycle
+
+| Command | Purpose | Idempotent |
+|---|---|---|
+| `jinn init` | Generate wallet + keystore | Yes |
+| `jinn doctor` | Preflight checks without mutation | Yes |
+| `jinn bootstrap` | Advance toward a running fleet | Yes |
+| `jinn fund-requirements` | List what needs funding | Yes |
+| `jinn run` | Start the daemon (foreground) | N/A |
+| `jinn stop` | Signal a running daemon to stop | Yes |
+| `jinn version` | Version, phase, deployment digest | Yes |
+
+### Monitoring
+
+| Command | Purpose |
+|---|---|
+| `jinn status` | Daemon liveness + fleet health roll-up |
+| `jinn fleet` | Per-service detail: wallets, staking, activity |
+| `jinn balance` | Flat per-wallet balance map |
+| `jinn history` | Recent protocol activity |
+| `jinn rewards` | Earned vs claimed per service |
+| `jinn logs` | Structured event stream |
+
+### Actions
+
+All action verbs support `--dry-run` and `--yes`.
+
+| Command | Purpose |
+|---|---|
+| `jinn submit-intent` | Publish a desired state |
+| `jinn claim-rewards` | Pull pending protocol rewards |
+| `jinn fleet scale --to N` | Grow or shrink fleet |
+| `jinn fleet retire <index>` | Retire one service |
+| `jinn withdraw --to <addr>` | Sweep wallets to external address |
+| `jinn keys backup --output <path>` | Export mnemonic |
+
+## Output contract
+
+- **JSON by default** for operational verbs unless you pass `--human` (headless- and agent-friendly regardless of TTY).
+- Add `--human` for readable terminal output.
+- `stderr` is reserved for progress, warnings, and runtime logs.
+- Non-zero exits emit a structured error envelope on stdout with `schemaVersion`, `code`, `exitCode`, `message`, `hint`, and `exampleCli`.
+- Without a global install, use `npx @jinn-network/client@latest <verb> ...` instead of `jinn ...` (the package name is scoped; `npx jinn` resolves a different package).
+
+See [`spec/2026-04-14-client-surface.md`](../spec/2026-04-14-client-surface.md) for the full surface spec.
+
+## Configuration
+
+Config file first, env var override. Default location: `~/.jinn-client/config.json`.
+
+```bash
+JINN_PASSWORD=secret jinn run --config ./my-config.json
+```
+
+| Config key | Env override | Default |
+|---|---|---|
+| network | JINN_NETWORK | testnet (flips to mainnet at launch) |
+| rpcUrl | BASE_RPC_URL / JINN_RPC_URL | network-appropriate public RPC |
+| claudeModel | JINN_CLAUDE_MODEL | claude-haiku-4-5-20251001 |
+| claudePath | JINN_CLAUDE_PATH | claude |
+| pollIntervalMs | JINN_POLL_INTERVAL_MS | 5000 |
+| apiPort | JINN_API_PORT | 7331 |
+| dbPath | JINN_DB_PATH | ~/.jinn-client/jinn.db |
+| earningDir | JINN_EARNING_DIR | ~/.jinn-client/earning |
+| peers | JINN_PEERS | [] |
+| desiredStates | JINN_DESIRED_STATES | [health-check] |
+
+`JINN_PASSWORD` is env-only (keystore encryption, never in config files). Alternatively, use `--password-fd <N>` to read from a file descriptor.
+
+## Switching to mainnet
+
+When Phase 2 launches, the default flips. Until then:
+
+```bash
+JINN_NETWORK=mainnet JINN_PASSWORD=secret jinn run
+```
+
+## How it works
+
+The daemon runs three concurrent loops:
+
+1. **CreatorLoop** — posts desired states as restoration jobs
+2. **RestorerLoop** — claims requests, spawns Claude to attempt restoration, submits results
+3. **DeliveryWatcherLoop** — claims deliveries, creates evaluation jobs
+
+Each loop call increments on-chain activity counters. Staking contracts read these at checkpoints to determine reward eligibility.
+
+## Development
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup, running from source, and testing.

package/deployments/deployment-phase1a-l2-baseSepolia-fast.json

@@ -0,0 +1,32 @@
+{
+  "network": "baseSepolia",
+  "chainId": 84532,
+  "deployer": "0x15e78734481bD31F6e183dad05225505a45ACd07",
+  "deployedAt": "2026-04-08T16:00:00.000Z",
+  "config": {
+    "jinnTokenSource": "external",
+    "serviceRegistrySource": "external",
+    "serviceRegistryTokenUtilitySource": "external",
+    "proxyHash": "0xb89c1b3bdf2cf8827818646bce9a8f6e372885f8c55e5c07acbd307cb133b000",
+    "proxyHashSource": "external",
+    "timingProfile": "fast-test",
+    "livenessRatio": "1000000000000000",
+    "maxNumServices": 100,
+    "rewardsPerSecond": "100000000000000",
+    "minStakingDeposit": "10000000000000000000",
+    "minNumStakingPeriods": 2,
+    "maxNumInactivityPeriods": 1,
+    "livenessPeriod": 300,
+    "timeForEmissions": 21600,
+    "numAgentInstances": 1
+  },
+  "contracts": {
+    "jinnToken": "0xAB9a01cd4A379e36006ec6df2960CF39EF79df63",
+    "serviceRegistry": "0x31D3202d8744B16A120117A053459DDFAE93c855",
+    "serviceRegistryTokenUtility": "0xeB49bE5DF00F74bd240DE4535DDe6Bc89CEfb994",
+    "activityChecker": "0xdaa1529de84B429945A33744539Af6D7140BF9B6",
+    "stakingFactory": "0x4FaF53A13Df420D70FE337F5b77B35B6E7309C48",
+    "stakingImplementation": "0xE98F9a4d368A0ea190cBdC938d1eAe8cEf086e12",
+    "stakingToken": "0x2c286651590b4DdC6d58d1270069B43183a851D1"
+  }
+}

package/deployments/deployment-phase1a-token-baseSepolia-fast.json

@@ -0,0 +1,27 @@
+{
+  "network": "baseSepolia",
+  "chainId": 84532,
+  "deployer": "0x15e78734481bD31F6e183dad05225505a45ACd07",
+  "deployedAt": "2026-04-08T15:59:07.620Z",
+  "config": {
+    "timingProfile": "fast-test",
+    "l1DeploymentPath": "deployment-phase1a-sepolia-fast.json",
+    "l1Token": "0xc3ae831f146Eabbb8095E1EDf90a187AA4E5F408",
+    "name": "Jinn",
+    "symbol": "JINN",
+    "factoryAddress": "0x4200000000000000000000000000000000000012",
+    "l2StandardBridgeAddress": "0x4200000000000000000000000000000000000010"
+  },
+  "contracts": {
+    "l1Token": "0xc3ae831f146Eabbb8095E1EDf90a187AA4E5F408",
+    "l2Token": "0xAB9a01cd4A379e36006ec6df2960CF39EF79df63",
+    "mintableFactory": "0x4200000000000000000000000000000000000012",
+    "l2StandardBridge": "0x4200000000000000000000000000000000000010"
+  },
+  "verification": {
+    "remoteToken": "0xc3ae831f146Eabbb8095E1EDf90a187AA4E5F408",
+    "bridge": "0x4200000000000000000000000000000000000010",
+    "txHash": "0x27d79a54715df4509524e0f2308809d6336e0b734002266552ce256828b1469a",
+    "reusedExisting": false
+  }
+}

package/deployments/deployment-phase1b-mech-baseSepolia-fast.json

@@ -0,0 +1,26 @@
+{
+  "network": "baseSepolia",
+  "chainId": 84532,
+  "deployer": "0x15e78734481bD31F6e183dad05225505a45ACd07",
+  "deployedAt": "2026-04-09T13:21:20.747Z",
+  "config": {
+    "timingProfile": "fast-test",
+    "fee": 0,
+    "minResponseTimeout": 60,
+    "maxResponseTimeout": 300,
+    "livenessRatio": "1000000000000000",
+    "nativePaymentType": "0xba699a34be8fe0e7725e93dcbce1701b0211a8ca61330aaeb8a05bf2ec7abed1"
+  },
+  "contracts": {
+    "karmaImpl": "0x5FFD663593Cea8dedF19fD314b13E392F5b64FC1",
+    "karma": "0x61434dAFf652FF0654684482Ab11736E96a7ba3A",
+    "mechMarketplaceImpl": "0x16F35EF27d4A0a8b49B77BfB65e668dB43311133",
+    "mechMarketplace": "0xD3233FdAaB51E9775f6bFCE8242B02C181D7c0e7",
+    "balanceTracker": "0xDbeEF1947F7BB3657f984aA6b230a0ca6578229D",
+    "mechFactory": "0x206183F35B2450Ca15A906BB923E74d945F78d67",
+    "jinnRouter": "0x6059Dd37eB0FD3a55BCe7A3C1fA86AB84F2d9675",
+    "serviceRegistry": "0x31D3202d8744B16A120117A053459DDFAE93c855",
+    "activityChecker": "0xF4Ca4943Eb0b0927d754A6A95206364f017D45f6",
+    "stakingToken": "0xf358b5c1ac4ddc4e807b5baf008826bf193eab3b"
+  }
+}

package/deployments/deployment-stolas-l2-baseSepolia-fast.json

@@ -0,0 +1,35 @@
+{
+  "network": "baseSepolia",
+  "chainId": 84532,
+  "deployer": "0x15e78734481bD31F6e183dad05225505a45ACd07",
+  "deployedAt": "2026-04-10T16:46:00.888Z",
+  "config": {
+    "l2Jinn": "0xAB9a01cd4A379e36006ec6df2960CF39EF79df63",
+    "stakingContract": "0xf358b5c1ac4ddc4e807b5baf008826bf193eab3b",
+    "l1DepositProcessor": "0x494FBcd686C895fD6265e852086B53Abf15cb076",
+    "l1DistributorProxy": "0x12F14eF5b4881a932BE3F334599cB9473aBE987A",
+    "l1TreasuryProxy": "0xa87c117cB54d9C6C8a8e0aA0b336a1125E485Cb7",
+    "stakingType": 1,
+    "collectorRewardFactor": 10000,
+    "protocolRewardFactor": 0,
+    "curatingAgentRewardFactor": 0,
+    "agentId": 103,
+    "livenessRatio": "1000000000000000"
+  },
+  "contracts": {
+    "recoveryModule": "0x5E3327C73834502f14e93e6b7D74742De1f9F3FD",
+    "safeMultisigWithRecoveryModule": "0x20F7b9b55a88e3b2561fe83B076DE52916C7eaf0",
+    "collectorImpl": "0x6A7a3aBdbfF301A6212ebA1523E579399833C718",
+    "collector": "0x21c52Be4F656435F97d0335B37e21B417c8b6DFa",
+    "distributorImpl": "0xf734551289f11431486D60621F4BDB0081887B34",
+    "distributor": "0x20951FBDb4F9cB1f051ef416BCB11A9Cfe3CEf81",
+    "multisigGuardImpl": "0xD6229A8b3D1b5824e824E6589469F85987379183",
+    "multisigGuard": "0x77aE56B2B745b3e81002090749Ef59B72B688D5F",
+    "moduleActivityChecker": "0x4B7F3539cAb410C7b56ad6158DB4197F02942a0F",
+    "activityModule": "0x73e2713B535540A3378ddA3DC62F1e75b35469c3",
+    "beacon": "0xB73Be5348C09FD95e4Fc64cc5fCb2b4B4F932b10",
+    "stakingManagerImpl": "0xFb0B086D3f7C03f1F671C6ccD5D16CC779B25Af9",
+    "stakingManager": "0x5edCd012C581b946E06a74e1906a5f29D588403e",
+    "baseStakingProcessorL2": "0x23a063f600e9938405D0367a137f1bE2F0B4D0D2"
+  }
+}

package/dist/adapters/adapter.d.ts

@@ -0,0 +1,11 @@
+import type { DesiredState, RequestId, RestorationRequest, RestorationResult, DeliveredResult } from '../types/index.js';
+export interface ExecutionAdapter {
+    readonly name: string;
+    initialize(): Promise<void>;
+    postDesiredState(state: DesiredState): Promise<RequestId>;
+    watchForRequests(): AsyncIterable<RestorationRequest>;
+    claimRequest(requestId: RequestId): Promise<void>;
+    submitResult(requestId: RequestId, result: RestorationResult): Promise<void>;
+    watchForDeliveries(): AsyncIterable<DeliveredResult>;
+    stop(): Promise<void>;
+}

package/dist/adapters/adapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/adapters/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/adapters/adapter.ts"],"names":[],"mappings":""}

package/dist/adapters/local/adapter.d.ts

@@ -0,0 +1,20 @@
+import type { ExecutionAdapter } from '../adapter.js';
+import type { DesiredState, RequestId, RestorationRequest, RestorationResult, DeliveredResult } from '../../types/index.js';
+export declare class LocalAdapter implements ExecutionAdapter {
+    readonly name = "local";
+    private requests;
+    private pendingRequests;
+    private deferredEvalRequests;
+    private pendingDeliveries;
+    private requestWaiters;
+    private deliveryWaiters;
+    private deliveredRequestIds;
+    private stopped;
+    initialize(): Promise<void>;
+    postDesiredState(state: DesiredState): Promise<RequestId>;
+    watchForRequests(): AsyncIterable<RestorationRequest>;
+    claimRequest(_requestId: RequestId): Promise<void>;
+    submitResult(requestId: RequestId, result: RestorationResult): Promise<void>;
+    watchForDeliveries(): AsyncIterable<DeliveredResult>;
+    stop(): Promise<void>;
+}

package/dist/adapters/local/adapter.js

@@ -0,0 +1,146 @@
+import { randomUUID } from 'node:crypto';
+export class LocalAdapter {
+    name = 'local';
+    requests = new Map();
+    pendingRequests = [];
+    deferredEvalRequests = [];
+    pendingDeliveries = [];
+    requestWaiters = [];
+    deliveryWaiters = [];
+    deliveredRequestIds = new Set();
+    stopped = false;
+    async initialize() {
+        // No-op for local
+    }
+    async postDesiredState(state) {
+        const requestId = randomUUID();
+        // Create restoration request
+        const restorationState = {
+            ...state,
+            type: state.type ?? 'restoration',
+        };
+        const request = {
+            requestId,
+            desiredState: restorationState,
+        };
+        this.requests.set(requestId, request);
+        if (this.requestWaiters.length > 0) {
+            this.requestWaiters.shift()(request);
+        }
+        else {
+            this.pendingRequests.push(request);
+        }
+        // Create linked evaluation request
+        const evalRequestId = randomUUID();
+        const evaluationState = {
+            ...state,
+            type: 'evaluation',
+            restorationRequestId: requestId,
+        };
+        const evalRequest = {
+            requestId: evalRequestId,
+            desiredState: evaluationState,
+        };
+        this.requests.set(evalRequestId, evalRequest);
+        // Evaluation requests are deferred — only yielded after restoration is delivered
+        this.deferredEvalRequests.push(evalRequest);
+        return requestId;
+    }
+    async *watchForRequests() {
+        while (!this.stopped) {
+            // Check if any deferred evaluation requests are now ready
+            const stillDeferred = [];
+            for (const evalReq of this.deferredEvalRequests) {
+                const restorationId = evalReq.desiredState.restorationRequestId;
+                if (restorationId && this.deliveredRequestIds.has(restorationId)) {
+                    // Restoration delivered — yield evaluation request
+                    if (this.requestWaiters.length > 0) {
+                        this.requestWaiters.shift()(evalReq);
+                    }
+                    else {
+                        this.pendingRequests.push(evalReq);
+                    }
+                }
+                else {
+                    stillDeferred.push(evalReq);
+                }
+            }
+            this.deferredEvalRequests = stillDeferred;
+            if (this.pendingRequests.length > 0) {
+                yield this.pendingRequests.shift();
+            }
+            else {
+                const req = await new Promise((resolve) => {
+                    this.requestWaiters.push(resolve);
+                });
+                if (!this.stopped)
+                    yield req;
+            }
+        }
+    }
+    async claimRequest(_requestId) {
+        // Always succeeds in local mode
+    }
+    async submitResult(requestId, result) {
+        const request = this.requests.get(requestId);
+        if (!request)
+            throw new Error(`Unknown request: ${requestId}`);
+        this.deliveredRequestIds.add(requestId);
+        const delivery = {
+            requestId,
+            desiredState: request.desiredState,
+            result,
+            deliveryMechAddress: 'local',
+        };
+        if (this.deliveryWaiters.length > 0) {
+            this.deliveryWaiters.shift()(delivery);
+        }
+        else {
+            this.pendingDeliveries.push(delivery);
+        }
+        // Check if any deferred evaluation requests are now ready
+        const stillDeferred = [];
+        for (const evalReq of this.deferredEvalRequests) {
+            const restorationId = evalReq.desiredState.restorationRequestId;
+            if (restorationId && this.deliveredRequestIds.has(restorationId)) {
+                if (this.requestWaiters.length > 0) {
+                    this.requestWaiters.shift()(evalReq);
+                }
+                else {
+                    this.pendingRequests.push(evalReq);
+                }
+            }
+            else {
+                stillDeferred.push(evalReq);
+            }
+        }
+        this.deferredEvalRequests = stillDeferred;
+    }
+    async *watchForDeliveries() {
+        while (!this.stopped) {
+            if (this.pendingDeliveries.length > 0) {
+                yield this.pendingDeliveries.shift();
+            }
+            else {
+                const del = await new Promise((resolve) => {
+                    this.deliveryWaiters.push(resolve);
+                });
+                if (!this.stopped)
+                    yield del;
+            }
+        }
+    }
+    async stop() {
+        this.stopped = true;
+        // Resolve any pending waiters so loops can exit
+        for (const waiter of this.requestWaiters) {
+            waiter({ requestId: '', desiredState: { id: '', description: '' } });
+        }
+        for (const waiter of this.deliveryWaiters) {
+            waiter({ requestId: '', desiredState: { id: '', description: '' }, result: { data: '' }, deliveryMechAddress: '' });
+        }
+        this.requestWaiters = [];
+        this.deliveryWaiters = [];
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapters/local/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/adapters/local/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAUzC,MAAM,OAAO,YAAY;IACd,IAAI,GAAG,OAAO,CAAC;IAEhB,QAAQ,GAAG,IAAI,GAAG,EAAiC,CAAC;IACpD,eAAe,GAAyB,EAAE,CAAC;IAC3C,oBAAoB,GAAyB,EAAE,CAAC;IAChD,iBAAiB,GAAsB,EAAE,CAAC;IAC1C,cAAc,GAA6C,EAAE,CAAC;IAC9D,eAAe,GAA0C,EAAE,CAAC;IAC5D,mBAAmB,GAAG,IAAI,GAAG,EAAa,CAAC;IAC3C,OAAO,GAAG,KAAK,CAAC;IAExB,KAAK,CAAC,UAAU;QACd,kBAAkB;IACpB,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,KAAmB;QACxC,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;QAE/B,6BAA6B;QAC7B,MAAM,gBAAgB,GAAiB;YACrC,GAAG,KAAK;YACR,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,aAAa;SAClC,CAAC;QACF,MAAM,OAAO,GAAuB;YAClC,SAAS;YACT,YAAY,EAAE,gBAAgB;SAC/B,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAEtC,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAG,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrC,CAAC;QAED,mCAAmC;QACnC,MAAM,aAAa,GAAG,UAAU,EAAE,CAAC;QACnC,MAAM,eAAe,GAAiB;YACpC,GAAG,KAAK;YACR,IAAI,EAAE,YAAY;YAClB,oBAAoB,EAAE,SAAS;SAChC,CAAC;QACF,MAAM,WAAW,GAAuB;YACtC,SAAS,EAAE,aAAa;YACxB,YAAY,EAAE,eAAe;SAC9B,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;QAC9C,iFAAiF;QACjF,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAE5C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,CAAC,gBAAgB;QACrB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACrB,0DAA0D;YAC1D,MAAM,aAAa,GAAyB,EAAE,CAAC;YAC/C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBAChD,MAAM,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,oBAAoB,CAAC;gBAChE,IAAI,aAAa,IAAI,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;oBACjE,mDAAmD;oBACnD,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACnC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAG,CAAC,OAAO,CAAC,CAAC;oBACxC,CAAC;yBAAM,CAAC;wBACN,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;oBACrC,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;YACD,IAAI,CAAC,oBAAoB,GAAG,aAAa,CAAC;YAE1C,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpC,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,EAAG,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,GAAG,MAAM,IAAI,OAAO,CAAqB,CAAC,OAAO,EAAE,EAAE;oBAC5D,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACpC,CAAC,CAAC,CAAC;gBACH,IAAI,CAAC,IAAI,CAAC,OAAO;oBAAE,MAAM,GAAG,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,UAAqB;QACtC,gCAAgC;IAClC,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,SAAoB,EAAE,MAAyB;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,SAAS,EAAE,CAAC,CAAC;QAE/D,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAExC,MAAM,QAAQ,GAAoB;YAChC,SAAS;YACT,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,MAAM;YACN,mBAAmB,EAAE,OAAO;SAC7B,CAAC;QAEF,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAG,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,CAAC;QAED,0DAA0D;QAC1D,MAAM,aAAa,GAAyB,EAAE,CAAC;QAC/C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAChD,MAAM,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,oBAAoB,CAAC;YAChE,IAAI,aAAa,IAAI,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;gBACjE,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACnC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAG,CAAC,OAAO,CAAC,CAAC;gBACxC,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,oBAAoB,GAAG,aAAa,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,CAAC,kBAAkB;QACvB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACrB,IAAI,IAAI,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtC,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAG,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,GAAG,MAAM,IAAI,OAAO,CAAkB,CAAC,OAAO,EAAE,EAAE;oBACzD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACrC,CAAC,CAAC,CAAC;gBACH,IAAI,CAAC,IAAI,CAAC,OAAO;oBAAE,MAAM,GAAG,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,gDAAgD;QAChD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACzC,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC1C,MAAM,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,mBAAmB,EAAE,EAAE,EAAE,CAAC,CAAC;QACtH,CAAC;QACD,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,eAAe,GAAG,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/adapters/mech/adapter.d.ts

@@ -0,0 +1,29 @@
+import type { ExecutionAdapter } from '../adapter.js';
+import type { DesiredState, RequestId, RestorationRequest, RestorationResult, DeliveredResult } from '../../types/index.js';
+import { type MechAdapterConfig } from './types.js';
+import type { Store } from '../../store/store.js';
+export declare class MechAdapter implements ExecutionAdapter {
+    readonly name = "mech";
+    private publicClient;
+    private walletClient;
+    private config;
+    private stopped;
+    private requestBlockCursor;
+    private deliveryBlockCursor;
+    private pendingEvaluations;
+    private pendingEvaluationClaims;
+    private claimedButNotEvaluated;
+    private originalStates;
+    private store?;
+    private claimPolicy;
+    constructor(config: MechAdapterConfig, store?: Store);
+    initialize(): Promise<void>;
+    private recoverPendingState;
+    postDesiredState(state: DesiredState): Promise<RequestId>;
+    watchForRequests(): AsyncIterable<RestorationRequest>;
+    claimRequest(requestId: RequestId): Promise<void>;
+    submitResult(requestId: RequestId, result: RestorationResult): Promise<void>;
+    watchForDeliveries(): AsyncIterable<DeliveredResult>;
+    private tryCreateEvaluationJob;
+    stop(): Promise<void>;
+}