@jinn-network/client 0.1.0-canary.adfd078d

package/dist/earning/wallet.js

@@ -0,0 +1,103 @@
+/**
+ * HD wallet derivation for fleet management.
+ *
+ * Mnemonic -> derive master (index 0) and agent (index 1+) wallets.
+ * Master is the funder, agents are service instances.
+ *
+ * Derivation path: m/44'/60'/0'/0/{index}
+ *   Index 0: master wallet (funder)
+ *   Index 1+: agent wallets (one per service)
+ */
+import { Wallet } from '@ethereumjs/wallet';
+import { generateMnemonic as scureGenerateMnemonic, mnemonicToSeedSync, validateMnemonic } from '@scure/bip39';
+import { wordlist } from '@scure/bip39/wordlists/english';
+import { HDKey } from '@scure/bip32';
+import { Buffer } from 'node:buffer';
+import { getAddress, toHex } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+const DERIVATION_PREFIX = "m/44'/60'/0'/0";
+function derivePrivateKeyBytes(mnemonic, index) {
+    const seed = mnemonicToSeedSync(mnemonic);
+    const root = HDKey.fromMasterSeed(seed);
+    const child = root.derive(`${DERIVATION_PREFIX}/${index}`);
+    if (!child.privateKey) {
+        throw new Error(`Could not derive private key at ${DERIVATION_PREFIX}/${index}`);
+    }
+    return child.privateKey;
+}
+export function walletPrivateKeyAtIndex(mnemonic, index) {
+    return toHex(derivePrivateKeyBytes(mnemonic, index));
+}
+export function generateMnemonic() {
+    return scureGenerateMnemonic(wordlist, 128);
+}
+export async function encryptMnemonic(mnemonic, password) {
+    if (!validateMnemonic(mnemonic, wordlist)) {
+        throw new Error('Internal error: generated mnemonic failed validation');
+    }
+    const pk = derivePrivateKeyBytes(mnemonic, 0);
+    const w = new Wallet(pk);
+    const keystore = await w.toV3(password);
+    const keystoreJson = JSON.stringify(keystore);
+    const pkHex = toHex(pk);
+    const account0 = privateKeyToAccount(pkHex);
+    const mnemonicBytes = Buffer.from(mnemonic, 'utf-8');
+    const keyBytes = Buffer.from(pkHex.slice(2), 'hex');
+    const obfuscated = Buffer.alloc(mnemonicBytes.length);
+    for (let i = 0; i < mnemonicBytes.length; i++) {
+        obfuscated[i] = mnemonicBytes[i] ^ keyBytes[i % keyBytes.length];
+    }
+    return JSON.stringify({
+        version: 1,
+        type: 'hd-mnemonic',
+        master_address: getAddress(account0.address),
+        keystore: JSON.parse(keystoreJson),
+        mnemonic_obfuscated: obfuscated.toString('hex'),
+        mnemonic_length: mnemonicBytes.length,
+    });
+}
+export async function decryptMnemonic(encrypted, password) {
+    const data = JSON.parse(encrypted);
+    if (data.type !== 'hd-mnemonic') {
+        throw new Error(`Unknown keystore type: ${data.type}. Expected 'hd-mnemonic'.`);
+    }
+    if (!data.keystore) {
+        throw new Error('Missing keystore in encrypted payload');
+    }
+    const w = await Wallet.fromV3(data.keystore, password);
+    const pkHex = w.getPrivateKeyString();
+    const keyBytes = Buffer.from(pkHex.slice(2), 'hex');
+    const obfuscated = Buffer.from(data.mnemonic_obfuscated ?? '', 'hex');
+    const mnemonicBytes = Buffer.alloc(data.mnemonic_length ?? 0);
+    for (let i = 0; i < mnemonicBytes.length; i++) {
+        mnemonicBytes[i] = obfuscated[i] ^ keyBytes[i % keyBytes.length];
+    }
+    const mnemonic = mnemonicBytes.toString('utf-8');
+    if (!validateMnemonic(mnemonic, wordlist)) {
+        throw new Error('Mnemonic decryption produced an invalid phrase (wrong password?)');
+    }
+    const masterAddress = deriveMasterAddress(mnemonic);
+    if (getAddress(masterAddress) !== getAddress(data.master_address ?? '')) {
+        throw new Error(`Mnemonic decryption verification failed: derived ${masterAddress} but expected ${data.master_address}`);
+    }
+    return mnemonic;
+}
+export function deriveMasterAddress(mnemonic) {
+    return getAddress(privateKeyToAccount(walletPrivateKeyAtIndex(mnemonic, 0)).address);
+}
+export function deriveAgentAddress(mnemonic, index) {
+    if (index < 1) {
+        throw new Error(`Agent index must be >= 1, got ${index}`);
+    }
+    return getAddress(privateKeyToAccount(walletPrivateKeyAtIndex(mnemonic, index)).address);
+}
+export function deriveMasterSigner(mnemonic) {
+    return privateKeyToAccount(walletPrivateKeyAtIndex(mnemonic, 0));
+}
+export function deriveAgentSigner(mnemonic, index) {
+    if (index < 1) {
+        throw new Error(`Agent index must be >= 1, got ${index}`);
+    }
+    return privateKeyToAccount(walletPrivateKeyAtIndex(mnemonic, index));
+}
+//# sourceMappingURL=wallet.js.map

package/dist/earning/wallet.js.map

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

package/dist/errors/envelope.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Error envelope for the Jinn client CLI surface.
+ *
+ * Contract: spec/2026-04-14-client-surface.md §5 (exit codes) and §6 (envelope).
+ * Every non-zero exit from a jinn verb writes one of these objects to stdout
+ * (not stderr — stderr is reserved for logs) and then exits with `exitCode`.
+ */
+export type ErrorCode = 'funding_required' | 'invalid_invocation' | 'bootstrap_incomplete' | 'reconcile_needed' | 'transient_error' | 'fatal';
+export declare const EXIT_CODES: Record<ErrorCode, number>;
+export interface ErrorEnvelope {
+    schemaVersion: 1;
+    generatedAt: string;
+    code: ErrorCode;
+    exitCode: number;
+    message: string;
+    hint?: string;
+    exampleCli?: string;
+    details?: Record<string, unknown>;
+}
+export interface BuildEnvelopeInput {
+    code: ErrorCode;
+    message: string;
+    hint?: string;
+    exampleCli?: string;
+    details?: Record<string, unknown>;
+}
+export declare function buildEnvelope(input: BuildEnvelopeInput): ErrorEnvelope;
+export interface EnvelopeSinks {
+    writer?: {
+        write: (s: string) => boolean;
+    };
+    exit?: (code: number) => void;
+}
+/**
+ * Build the envelope, write it as a single JSON line to stdout, and exit
+ * with its `exitCode`. Injectable sinks exist purely for tests; production
+ * callers pass no second argument.
+ *
+ * This function does not return.
+ */
+export declare function emitEnvelope(input: BuildEnvelopeInput, sinks?: EnvelopeSinks): never;

package/dist/errors/envelope.js

@@ -0,0 +1,48 @@
+/**
+ * Error envelope for the Jinn client CLI surface.
+ *
+ * Contract: spec/2026-04-14-client-surface.md §5 (exit codes) and §6 (envelope).
+ * Every non-zero exit from a jinn verb writes one of these objects to stdout
+ * (not stderr — stderr is reserved for logs) and then exits with `exitCode`.
+ */
+export const EXIT_CODES = {
+    funding_required: 10,
+    invalid_invocation: 11,
+    bootstrap_incomplete: 20,
+    reconcile_needed: 30,
+    transient_error: 40,
+    fatal: 50,
+};
+export function buildEnvelope(input) {
+    const env = {
+        schemaVersion: 1,
+        generatedAt: new Date().toISOString(),
+        code: input.code,
+        exitCode: EXIT_CODES[input.code],
+        message: input.message,
+    };
+    if (input.hint !== undefined)
+        env.hint = input.hint;
+    if (input.exampleCli !== undefined)
+        env.exampleCli = input.exampleCli;
+    if (input.details !== undefined)
+        env.details = input.details;
+    return env;
+}
+/**
+ * Build the envelope, write it as a single JSON line to stdout, and exit
+ * with its `exitCode`. Injectable sinks exist purely for tests; production
+ * callers pass no second argument.
+ *
+ * This function does not return.
+ */
+export function emitEnvelope(input, sinks = {}) {
+    const envelope = buildEnvelope(input);
+    const writer = sinks.writer ?? process.stdout;
+    const exit = sinks.exit ?? ((c) => process.exit(c));
+    writer.write(JSON.stringify(envelope) + '\n');
+    exit(envelope.exitCode);
+    // Unreachable when using real `process.exit`; tests inject a no-op exit.
+    return undefined;
+}
+//# sourceMappingURL=envelope.js.map

package/dist/errors/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../src/errors/envelope.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,MAAM,CAAC,MAAM,UAAU,GAA8B;IACnD,gBAAgB,EAAE,EAAE;IACpB,kBAAkB,EAAE,EAAE;IACtB,oBAAoB,EAAE,EAAE;IACxB,gBAAgB,EAAE,EAAE;IACpB,eAAe,EAAE,EAAE;IACnB,KAAK,EAAE,EAAE;CACV,CAAC;AAqBF,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,GAAG,GAAkB;QACzB,aAAa,EAAE,CAAC;QAChB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;QAChC,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC;IACF,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACpD,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS;QAAE,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACtE,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;IAC7D,OAAO,GAAG,CAAC;AACb,CAAC;AAOD;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAyB,EAAE,QAAuB,EAAE;IAC/E,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACxB,yEAAyE;IACzE,OAAO,SAAkB,CAAC;AAC5B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { type DesiredState, type RequestId, type RestorationRequest, type RestorationResult, type DeliveredResult } from './types/index.js';
+export { TransientError, PermanentError } from './types/index.js';
+export { type ExecutionAdapter } from './adapters/adapter.js';
+export { LocalAdapter } from './adapters/local/adapter.js';
+export { MechAdapter } from './adapters/mech/adapter.js';
+export { type Runner, type RunnerContext } from './runner/runner.js';
+export { SimpleRunner } from './runner/simple.js';
+export { ClaudeRunner } from './runner/claude.js';
+export { Daemon, type DaemonConfig } from './daemon/daemon.js';
+export { DeliveryWatcherLoop } from './daemon/delivery-watcher.js';
+export { Store } from './store/store.js';
+export { loadConfig, getConfigPathFromArgs, JinnConfigSchema, type JinnConfig } from './config.js';
+export { formatBootstrapOperatorMessage, isJinnDebug, } from './operator-errors.js';
+export { FleetBootstrapper, type FleetBootstrapperOptions } from './earning/bootstrap.js';

package/dist/index.js

@@ -0,0 +1,17 @@
+export { TransientError, PermanentError } from './types/index.js';
+export { LocalAdapter } from './adapters/local/adapter.js';
+export { MechAdapter } from './adapters/mech/adapter.js';
+export { SimpleRunner } from './runner/simple.js';
+export { ClaudeRunner } from './runner/claude.js';
+// Daemon
+export { Daemon } from './daemon/daemon.js';
+export { DeliveryWatcherLoop } from './daemon/delivery-watcher.js';
+// Store
+export { Store } from './store/store.js';
+// Config
+export { loadConfig, getConfigPathFromArgs, JinnConfigSchema } from './config.js';
+// Operator-facing errors
+export { formatBootstrapOperatorMessage, isJinnDebug, } from './operator-errors.js';
+// Earning
+export { FleetBootstrapper } from './earning/bootstrap.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIlE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAIzD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,SAAS;AACT,OAAO,EAAE,MAAM,EAAqB,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,QAAQ;AACR,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,SAAS;AACT,OAAO,EAAE,UAAU,EAAE,qBAAqB,EAAE,gBAAgB,EAAmB,MAAM,aAAa,CAAC;AAEnG,yBAAyB;AACzB,OAAO,EACL,8BAA8B,EAC9B,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAE9B,UAAU;AACV,OAAO,EAAE,iBAAiB,EAAiC,MAAM,wBAAwB,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+/**
+ * jinn-client production entry point.
+ *
+ * Bootstraps earning (wallet → Safe → service → staking → mech),
+ * then starts the daemon with MechAdapter + ClaudeRunner on Base.
+ *
+ * Config resolution (highest priority wins):
+ *   1. Environment variables (JINN_*, BASE_RPC_URL, BASE_SEPOLIA_RPC_URL)
+ *   2. Config file (~/.jinn-client/config.json or --config <path>)
+ *   3. Built-in defaults
+ *
+ * JINN_PASSWORD (env-only) is required for keystore encryption.
+ *
+ * Canonical operator command:
+ *   jinn run
+ */
+export interface DaemonStartupInfo {
+    schemaVersion: 1;
+    generatedAt: string;
+    kind: 'daemon_started';
+    pid: number;
+    network: 'testnet' | 'mainnet';
+    phase: 'phase-1b' | 'phase-0';
+    apiPort: number;
+    masterAddress: `0x${string}`;
+    safeAddress: `0x${string}`;
+    mechAddress: `0x${string}`;
+    serviceIndex: number;
+    serviceId: number | null;
+}
+export declare function main(): Promise<DaemonStartupInfo>;

package/dist/main.js

@@ -0,0 +1,281 @@
+#!/usr/bin/env node
+/**
+ * jinn-client production entry point.
+ *
+ * Bootstraps earning (wallet → Safe → service → staking → mech),
+ * then starts the daemon with MechAdapter + ClaudeRunner on Base.
+ *
+ * Config resolution (highest priority wins):
+ *   1. Environment variables (JINN_*, BASE_RPC_URL, BASE_SEPOLIA_RPC_URL)
+ *   2. Config file (~/.jinn-client/config.json or --config <path>)
+ *   3. Built-in defaults
+ *
+ * JINN_PASSWORD (env-only) is required for keystore encryption.
+ *
+ * Canonical operator command:
+ *   jinn run
+ */
+import { config as dotenvConfig } from 'dotenv';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { loadConfig, getConfigPathFromArgs } from './config.js';
+import { emitEnvelope } from './errors/envelope.js';
+import { checkClaudeBinary } from './preflight/claude-binary.js';
+import { emitClaudeBinaryPreflightFailure } from './preflight/claude-invocation-envelope.js';
+import { FleetBootstrapper } from './earning/bootstrap.js';
+import { getChainConfig } from './earning/contracts.js';
+import { FleetStateStore } from './earning/store.js';
+import { decryptMnemonic, deriveMasterSigner, walletPrivateKeyAtIndex } from './earning/wallet.js';
+import { MechAdapter } from './adapters/mech/adapter.js';
+import { ClaudeRunner } from './runner/claude.js';
+import { Daemon } from './daemon/daemon.js';
+import { createJinnPublicClient, createJinnWalletClient } from './earning/viem-clients.js';
+dotenvConfig({ path: join(dirname(fileURLToPath(import.meta.url)), '..', '.env') });
+// ── Password (env-only — never in config files) ────────────────────────────
+const PASSWORD = (() => {
+    const p = process.env['JINN_PASSWORD'];
+    if (!p) {
+        console.error('Fatal: JINN_PASSWORD environment variable is required.');
+        console.error('This password encrypts your agent keystore.');
+        process.exit(1);
+    }
+    return p;
+})();
+// ── Load config ─────────────────────────────────────────────────────────────
+const config = loadConfig(getConfigPathFromArgs());
+const NETWORK_CHAIN = config.network === 'testnet' ? 'base-sepolia' : 'base';
+const CHAIN_CONFIG = getChainConfig(NETWORK_CHAIN, {
+    testnetL2DeploymentPath: config.testnetL2DeploymentPath,
+    testnetL2TokenDeploymentPath: config.testnetL2TokenDeploymentPath,
+    testnetMechDeploymentPath: config.testnetMechDeploymentPath,
+    testnetStolasDeploymentPath: config.testnetStolasDeploymentPath,
+});
+const MARKETPLACE_ADDRESS = CHAIN_CONFIG.mechMarketplace;
+const ROUTER_ADDRESS = (CHAIN_CONFIG.jinnRouter ?? '0xfFa7118A3D820cd4E820010837D65FAfF463181B');
+const STANDARD_SERVICE_PROGRESSION = [
+    'awaiting_stake',
+    'staked',
+    'mech_deployed',
+    'complete',
+];
+const SELF_BOND_SERVICE_PROGRESSION = [
+    'awaiting_stake',
+    'service_created',
+    'service_activated',
+    'agents_registered',
+    'service_deployed',
+    'service_staked',
+    'mech_deployed',
+    'complete',
+];
+/** §6.2 `bootstrap_incomplete` — `{ currentStep, nextStep }` from persisted fleet state. */
+function bootstrapIncompleteSteps(state) {
+    const progression = state.staking_mode === 'self-bond'
+        ? SELF_BOND_SERVICE_PROGRESSION
+        : STANDARD_SERVICE_PROGRESSION;
+    const byIndex = [...state.services].sort((a, b) => a.index - b.index);
+    const focus = byIndex.find(s => s.step === 'complete' && !s.safe_address) ??
+        byIndex.find(s => s.step !== 'complete') ??
+        byIndex[0];
+    if (!focus) {
+        return { currentStep: 'awaiting_service', nextStep: 'awaiting_stake' };
+    }
+    if (focus.step === 'complete' && !focus.safe_address) {
+        return { currentStep: 'complete', nextStep: 'bootstrap' };
+    }
+    const i = progression.indexOf(focus.step);
+    if (i === -1) {
+        return { currentStep: focus.step, nextStep: 'bootstrap' };
+    }
+    if (i < progression.length - 1) {
+        return { currentStep: focus.step, nextStep: progression[i + 1] };
+    }
+    return { currentStep: focus.step, nextStep: 'bootstrap' };
+}
+// ── Bootstrap ───────────────────────────────────────────────────────────────
+async function bootstrap() {
+    console.log('[main] Running fleet bootstrap...');
+    const bootstrapper = new FleetBootstrapper({
+        earningDir: config.earningDir,
+        chain: NETWORK_CHAIN,
+        rpcUrl: config.rpcUrl,
+        stakingMode: config.stakingMode,
+        targetServices: config.targetServices,
+        testnetL2DeploymentPath: config.testnetL2DeploymentPath,
+        testnetL2TokenDeploymentPath: config.testnetL2TokenDeploymentPath,
+        testnetMechDeploymentPath: config.testnetMechDeploymentPath,
+        testnetStolasDeploymentPath: config.testnetStolasDeploymentPath,
+        debug: config.debug,
+        masterEthDailyEstimateWei: config.masterEthDailyEstimateWei,
+        pollIntervalMs: config.pollIntervalMs,
+    });
+    const result = await bootstrapper.bootstrap(PASSWORD);
+    if (result.funding) {
+        emitEnvelope({
+            code: 'funding_required',
+            message: result.message,
+            hint: 'Fund the listed address and re-run this command.',
+            exampleCli: 'jinn fund-requirements --json',
+            details: {
+                role: 'master',
+                address: result.funding.master_address,
+                asset: 'native',
+                needWei: result.funding.eth_required,
+                haveWei: result.funding.eth_balance,
+            },
+        });
+    }
+    if (!result.ok) {
+        emitEnvelope({
+            code: 'fatal',
+            message: result.message,
+            hint: 'Bootstrap failed before the fleet reached a runnable state.',
+            details: { cause: result.message },
+        });
+    }
+    // Use the first complete service for the daemon
+    const state = result.fleet_state;
+    const firstComplete = state.services.find(s => s.step === 'complete');
+    if (!firstComplete || !firstComplete.safe_address) {
+        emitEnvelope({
+            code: 'bootstrap_incomplete',
+            message: 'Bootstrap completed but no service is ready.',
+            hint: 'Re-run to continue the state machine toward a running fleet.',
+            exampleCli: 'jinn bootstrap --json',
+            details: bootstrapIncompleteSteps(state),
+        });
+    }
+    // Derive agent private key from mnemonic
+    const store = new FleetStateStore(config.earningDir);
+    const mnemonic = await decryptMnemonic(await store.loadMnemonicKeystore(), PASSWORD);
+    const agentPrivateKey = walletPrivateKeyAtIndex(mnemonic, firstComplete.index);
+    console.log(`[main] Fleet bootstrap complete.`);
+    console.log(`  Master:  ${state.master_address}`);
+    console.log(`  Services: ${state.services.filter(s => s.step === 'complete').length}/${config.targetServices}`);
+    console.log(`  Active:  service ${firstComplete.service_id} (agent ${firstComplete.agent_address})`);
+    if (firstComplete.mech_address) {
+        console.log(`  Mech:    ${firstComplete.mech_address}`);
+    }
+    return {
+        masterAddress: state.master_address,
+        serviceIndex: firstComplete.index,
+        serviceId: firstComplete.service_id ?? null,
+        agentPrivateKey: agentPrivateKey,
+        safeAddress: firstComplete.safe_address,
+        mechAddress: firstComplete.mech_address ? firstComplete.mech_address : undefined,
+    };
+}
+// ── Main ────────────────────────────────────────────────────────────────────
+export async function main() {
+    console.log(`[main] jinn-client starting on ${NETWORK_CHAIN}`);
+    const { agentPrivateKey, masterAddress, safeAddress, mechAddress, serviceIndex, serviceId } = await bootstrap();
+    if (!mechAddress) {
+        emitEnvelope({
+            code: 'fatal',
+            message: 'Bootstrap completed without a runnable mech deployment.',
+            hint: 'Set a valid mech deployment and re-run `jinn run`.',
+            exampleCli: 'jinn doctor',
+            details: {
+                network: config.network,
+                expected: 'configured mech deployment with a non-zero mech marketplace address',
+            },
+        });
+    }
+    const adapter = new MechAdapter({
+        rpcUrl: config.rpcUrl,
+        mechMarketplaceAddress: MARKETPLACE_ADDRESS,
+        routerAddress: ROUTER_ADDRESS,
+        mechContractAddress: mechAddress,
+        safeAddress,
+        agentEoaPrivateKey: agentPrivateKey,
+        ipfsRegistryUrl: config.ipfsRegistryUrl,
+        ipfsGatewayUrl: config.ipfsGatewayUrl,
+        pollIntervalMs: config.pollIntervalMs,
+        chainId: config.network === 'testnet' ? 84532 : 8453,
+        routerClaimDeliveryVariant: CHAIN_CONFIG.routerClaimDeliveryVersion,
+    });
+    const preflight = await checkClaudeBinary(config.claudePath);
+    if (!preflight.ok) {
+        emitClaudeBinaryPreflightFailure(preflight.detail, config.claudePath);
+    }
+    const runner = new ClaudeRunner({
+        claudePath: config.claudePath,
+        model: config.claudeModel,
+    });
+    const earningStore = new FleetStateStore(config.earningDir);
+    const mnemonicForMaster = await decryptMnemonic(await earningStore.loadMnemonicKeystore(), PASSWORD);
+    const masterAccount = deriveMasterSigner(mnemonicForMaster);
+    const publicClient = createJinnPublicClient(config.rpcUrl, NETWORK_CHAIN);
+    const masterWallet = createJinnWalletClient(config.rpcUrl, NETWORK_CHAIN, masterAccount);
+    const daemon = new Daemon({
+        adapter,
+        runner,
+        desiredStates: config.desiredStates,
+        dbPath: config.dbPath,
+        apiPort: config.apiPort,
+        peers: config.peers.length > 0 ? config.peers : undefined,
+        subgraphUrl: config.subgraphUrl,
+        nodeEndpoint: config.nodeEndpoint,
+        status: {
+            earningDir: config.earningDir,
+            rpcUrl: config.rpcUrl,
+            network: config.network,
+            pollIntervalMs: config.pollIntervalMs,
+            masterEthDailyEstimateWei: config.masterEthDailyEstimateWei,
+            rewardClaimIntervalMs: config.rewardClaimIntervalMs,
+            testnetL2DeploymentPath: config.testnetL2DeploymentPath,
+            testnetL2TokenDeploymentPath: config.testnetL2TokenDeploymentPath,
+            testnetMechDeploymentPath: config.testnetMechDeploymentPath,
+            testnetStolasDeploymentPath: config.testnetStolasDeploymentPath,
+        },
+        rewardClaim: config.rewardClaimIntervalMs > 0
+            ? {
+                intervalMs: config.rewardClaimIntervalMs,
+                publicClient,
+                masterWallet,
+                store: earningStore,
+                chain: NETWORK_CHAIN,
+                distributorAddress: CHAIN_CONFIG.distributorAddress,
+            }
+            : undefined,
+    });
+    // Graceful shutdown
+    const shutdown = async (signal) => {
+        console.log(`\n[main] Received ${signal}, shutting down...`);
+        await daemon.stop();
+        console.log('[main] Shutdown complete.');
+        process.exit(0);
+    };
+    process.on('SIGINT', () => shutdown('SIGINT'));
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+    // Write pidfile so `jinn stop` can find us.
+    const pidPath = join(config.earningDir, 'daemon.pid');
+    const { writeFileSync, unlinkSync } = await import('node:fs');
+    writeFileSync(pidPath, String(process.pid) + '\n', 'utf-8');
+    const removePidfile = () => {
+        try {
+            unlinkSync(pidPath);
+        }
+        catch {
+            /* ignore */
+        }
+    };
+    process.on('exit', removePidfile);
+    await daemon.start();
+    console.log('[main] Daemon running. Press Ctrl+C to stop.');
+    return {
+        schemaVersion: 1,
+        generatedAt: new Date().toISOString(),
+        kind: 'daemon_started',
+        pid: process.pid,
+        network: config.network,
+        phase: config.network === 'testnet' ? 'phase-1b' : 'phase-0',
+        apiPort: config.apiPort,
+        masterAddress,
+        safeAddress,
+        mechAddress,
+        serviceIndex,
+        serviceId,
+    };
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,14 @@
+/**
+ * MCP server for jinn-client — exposes tools to agent subprocesses.
+ *
+ * Spawned by ClaudeRunner as a subprocess via StdioServerTransport.
+ * Receives context via env vars:
+ *   DESIRED_STATE_ID          — ID of the current desired state
+ *   DESIRED_STATE_DESCRIPTION — Human-readable description
+ *   DESIRED_STATE_CONTEXT     — JSON context (optional)
+ *   REQUEST_ID                — On-chain request ID
+ *   RESTORATION_DELIVERY_DATA — JSON delivery data (evaluation requests only)
+ *
+ * Usage: yarn exec tsx src/mcp/server.ts
+ */
+export {};