@jinn-network/client 0.1.0-canary.adfd078d

package/dist/cli/action.js

@@ -0,0 +1,56 @@
+/**
+ * Shared helpers for action verbs (verbs that emit transactions).
+ *
+ * Contract: spec/2026-04-14-client-surface.md §7.3 (dry-run / yes).
+ */
+import { buildEnvelope, EXIT_CODES } from '../errors/envelope.js';
+import { emitResult } from './output.js';
+/**
+ * Ensure an action is confirmed before proceeding.
+ *
+ * - Dry run → always permitted, returns true without any check.
+ * - `--yes` → permitted regardless of TTY state.
+ * - Non-TTY without `--yes` → emits invalid_invocation (exit 11) and returns false.
+ * - TTY without `--yes` → v1 never prompts; emits invalid_invocation and returns false.
+ */
+export function ensureConfirmed(ctx, flags) {
+    if (flags.dryRun)
+        return true;
+    if (flags.yes)
+        return true;
+    const envelope = buildEnvelope({
+        code: 'invalid_invocation',
+        message: 'This action requires explicit confirmation.',
+        hint: 'Re-run with --yes to confirm, or --dry-run to see what would happen without executing.',
+        exampleCli: 'jinn <verb> --dry-run',
+        details: { field: 'confirmation', expected: '--yes or --dry-run' },
+    });
+    ctx.writer.write(JSON.stringify(envelope) + '\n');
+    ctx.exit(EXIT_CODES.invalid_invocation);
+    return false;
+}
+/** Emit a dry-run JSON response (success path; no process exit). */
+export function emitDryRun(ctx, payload) {
+    const body = {
+        schemaVersion: 1,
+        generatedAt: new Date().toISOString(),
+        dryRun: true,
+        ...payload,
+    };
+    emitResult(body, (v) => {
+        const value = v;
+        return [
+            `Dry run: ${value.verb}`,
+            value.description,
+            `Planned steps: ${value.plan.length}`,
+            JSON.stringify(value.plan, null, 2),
+        ].join('\n');
+    }, {
+        json: ctx.argv.includes('--json'),
+        human: ctx.argv.includes('--human'),
+        writer: ctx.writer,
+        stdoutIsTty: ctx.stdoutIsTty,
+        noColor: Boolean(ctx.env['NO_COLOR']),
+    });
+}
+//# sourceMappingURL=action.js.map

package/dist/cli/action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../../src/cli/action.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAOzC;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,GAAmB,EAAE,KAAmB;IACtE,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,KAAK,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,QAAQ,GAAG,aAAa,CAAC;QAC7B,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,6CAA6C;QACtD,IAAI,EAAE,wFAAwF;QAC9F,UAAU,EAAE,uBAAuB;QACnC,OAAO,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,oBAAoB,EAAE;KACnE,CAAC,CAAC;IACH,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;IAClD,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC;AACf,CAAC;AAQD,oEAAoE;AACpE,MAAM,UAAU,UAAU,CAAC,GAAmB,EAAE,OAAsB;IACpE,MAAM,IAAI,GAAG;QACT,aAAa,EAAE,CAAC;QAChB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,MAAM,EAAE,IAAI;QACZ,GAAG,OAAO;KACX,CAAC;IACJ,UAAU,CACR,IAAI,EACJ,CAAC,CAAC,EAAE,EAAE;QACJ,MAAM,KAAK,GAAG,CAAqC,CAAC;QACpD,OAAO;YACL,YAAY,KAAK,CAAC,IAAI,EAAE;YACxB,KAAK,CAAC,WAAW;YACjB,kBAAkB,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE;YACrC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;SACpC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,EACD;QACE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACjC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QACnC,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;KACtC,CACF,CAAC;AACJ,CAAC"}

package/dist/cli/command.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Shared types and helpers for jinn CLI command modules.
+ *
+ * Every command module exports a default `CommandModule` object. The
+ * dispatcher in cli/index.ts looks up the verb name, parses flags with
+ * `parseArgs`, and calls `run`.
+ */
+import { parseArgs, type ParseArgsConfig } from 'node:util';
+export interface CommandContext {
+    /** Everything after the verb, e.g. for `jinn bootstrap --json`, this is ['--json']. */
+    argv: string[];
+    /** Effective stdout TTY state; tests inject false. */
+    stdoutIsTty: boolean;
+    /** Injected writer for tests; production uses process.stdout. */
+    writer: {
+        write: (s: string) => boolean;
+    };
+    /** Injected exit for tests; production uses process.exit. */
+    exit: (code: number) => void;
+    /** Process environment, for JINN_PASSWORD, JINN_CLAUDE_PATH, etc. */
+    env: NodeJS.ProcessEnv;
+}
+export interface CommandModule {
+    name: string;
+    summary: string;
+    helpText: string;
+    run(ctx: CommandContext): Promise<void>;
+}
+/**
+ * Strongly-typed wrapper around Node's parseArgs. Callers pass the command
+ * name and options schema; this returns the parsed values or throws on
+ * invalid flags. Callers are responsible for catching and emitting an
+ * envelope with code 'invalid_invocation'.
+ */
+export declare function parseCommandArgs<T extends ParseArgsConfig['options']>(argv: string[], options: T): ReturnType<typeof parseArgs<{
+    options: T;
+    allowPositionals: true;
+}>>;
+/**
+ * Common flags every verb accepts. Callers spread this into their options.
+ */
+export declare const COMMON_FLAGS: {
+    json: {
+        type: "boolean";
+        default: boolean;
+    };
+    human: {
+        type: "boolean";
+        default: boolean;
+    };
+    help: {
+        type: "boolean";
+        default: boolean;
+    };
+    config: {
+        type: "string";
+    };
+    /** Parsed value is the fd number as string; read via resolveCliPassword / readPasswordFromFd. */
+    'password-fd': {
+        type: "string";
+    };
+};

package/dist/cli/command.js

@@ -0,0 +1,29 @@
+/**
+ * Shared types and helpers for jinn CLI command modules.
+ *
+ * Every command module exports a default `CommandModule` object. The
+ * dispatcher in cli/index.ts looks up the verb name, parses flags with
+ * `parseArgs`, and calls `run`.
+ */
+import { parseArgs } from 'node:util';
+/**
+ * Strongly-typed wrapper around Node's parseArgs. Callers pass the command
+ * name and options schema; this returns the parsed values or throws on
+ * invalid flags. Callers are responsible for catching and emitting an
+ * envelope with code 'invalid_invocation'.
+ */
+export function parseCommandArgs(argv, options) {
+    return parseArgs({ args: argv, options, allowPositionals: true });
+}
+/**
+ * Common flags every verb accepts. Callers spread this into their options.
+ */
+export const COMMON_FLAGS = {
+    json: { type: 'boolean', default: false },
+    human: { type: 'boolean', default: false },
+    help: { type: 'boolean', default: false },
+    config: { type: 'string' },
+    /** Parsed value is the fd number as string; read via resolveCliPassword / readPasswordFromFd. */
+    'password-fd': { type: 'string' },
+};
+//# sourceMappingURL=command.js.map

package/dist/cli/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../src/cli/command.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAwB,MAAM,WAAW,CAAC;AAsB5D;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAc,EACd,OAAU;IAEV,OAAO,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,OAAO,EAAE,KAAK,EAAE;IAClD,KAAK,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,OAAO,EAAE,KAAK,EAAE;IACnD,IAAI,EAAE,EAAE,IAAI,EAAE,SAAkB,EAAE,OAAO,EAAE,KAAK,EAAE;IAClD,MAAM,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;IACnC,iGAAiG;IACjG,aAAa,EAAE,EAAE,IAAI,EAAE,QAAiB,EAAE;CAC3C,CAAC"}

package/dist/cli/commands/balance.d.ts

@@ -0,0 +1,3 @@
+import type { CommandModule } from '../command.js';
+declare const command: CommandModule;
+export default command;

package/dist/cli/commands/balance.js

@@ -0,0 +1,46 @@
+import { COMMON_FLAGS, parseCommandArgs } from '../command.js';
+import { emitResult } from '../output.js';
+import { emitEnvelope } from '../../errors/envelope.js';
+import { gatherIntrospectionRaw } from '../introspection-context.js';
+import { assembleBalanceV1 } from '../../api/balance-build.js';
+async function run(ctx) {
+    let parsed;
+    try {
+        parsed = parseCommandArgs(ctx.argv, { ...COMMON_FLAGS });
+    }
+    catch (err) {
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: err instanceof Error ? err.message : String(err),
+            exampleCli: 'jinn balance',
+            details: { field: 'flags' },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const raw = await gatherIntrospectionRaw({ argv: ctx.argv });
+    const payload = assembleBalanceV1(raw);
+    emitResult(payload, (v) => JSON.stringify(v, null, 2), {
+        json: Boolean(parsed.values.json),
+        human: Boolean(parsed.values.human),
+        writer: ctx.writer,
+        stdoutIsTty: ctx.stdoutIsTty,
+        noColor: Boolean(ctx.env['NO_COLOR']),
+    });
+}
+const command = {
+    name: 'balance',
+    summary: 'Flat per-wallet balance map across master and service wallets',
+    helpText: `Usage: jinn balance [--human]
+
+Cheaper than \`jinn fleet\` when the only thing you need is current
+balances. Each wallet is identified by its stable role name
+(master, service.<i>.agent, service.<i>.multisig).
+
+Examples:
+  jinn balance
+  jinn balance --human
+`,
+    run,
+};
+export default command;
+//# sourceMappingURL=balance.js.map

package/dist/cli/commands/balance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balance.js","sourceRoot":"","sources":["../../../src/cli/commands/balance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,KAAK,UAAU,GAAG,CAAC,GAAmB;IACpC,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,YAAY,EAAE,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,YAAY,CACV;YACE,IAAI,EAAE,oBAAoB;YAC1B,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;YACzD,UAAU,EAAE,cAAc;YAC1B,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;SAC5B,EACD,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CACvC,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,sBAAsB,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACvC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;QACrD,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACjC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QACnC,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;KACtC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,OAAO,GAAkB;IAC7B,IAAI,EAAE,SAAS;IACf,OAAO,EAAE,+DAA+D;IACxE,QAAQ,EAAE;;;;;;;;;CASX;IACC,GAAG;CACJ,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/cli/commands/bootstrap.d.ts

@@ -0,0 +1,3 @@
+import type { CommandModule } from '../command.js';
+declare const command: CommandModule;
+export default command;

package/dist/cli/commands/bootstrap.js

@@ -0,0 +1,165 @@
+import { COMMON_FLAGS, parseCommandArgs } from '../command.js';
+import { emitResult } from '../output.js';
+import { emitEnvelope } from '../../errors/envelope.js';
+import { loadConfig } from '../../config.js';
+import { FleetBootstrapper } from '../../earning/bootstrap.js';
+import { resolveCliPassword } from '../password.js';
+/** §6.2 — `stack` only when `JINN_DEBUG=1` (exact string). */
+function envelopeDebug(env) {
+    return env['JINN_DEBUG'] === '1';
+}
+function humanBootstrapSuccess(payload) {
+    const lines = [`Bootstrap complete.`, `Master: ${payload.master}`];
+    if (payload.services.length === 0) {
+        lines.push('Services: (none)');
+    }
+    else {
+        lines.push('Services:');
+        for (const s of payload.services) {
+            const id = s.serviceId != null ? ` (id ${s.serviceId})` : '';
+            lines.push(`  #${s.index} ${s.step}${id}`);
+        }
+    }
+    return lines.join('\n');
+}
+async function run(ctx) {
+    let json = false;
+    let human = false;
+    let configPath;
+    try {
+        const parsed = parseCommandArgs(ctx.argv, { ...COMMON_FLAGS });
+        json = Boolean(parsed.values.json);
+        human = Boolean(parsed.values.human);
+        configPath =
+            typeof parsed.values.config === 'string' && parsed.values.config.length > 0
+                ? parsed.values.config
+                : undefined;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: 'Invalid command-line arguments.',
+            hint: 'Run `jinn bootstrap --help` for supported flags.',
+            exampleCli: 'jinn bootstrap --json',
+            details: { field: 'argv', expected: message },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const password = resolveCliPassword(ctx.argv, ctx.env);
+    if (!password.ok) {
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: password.message,
+            hint: 'Set JINN_PASSWORD or pass --password-fd N, then re-run.',
+            exampleCli: 'jinn bootstrap --json',
+            details: { field: 'keystore password', expected: 'non-empty string via environment or fd' },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const config = loadConfig(configPath);
+    const bootstrapper = new FleetBootstrapper({
+        earningDir: config.earningDir,
+        chain: config.network === 'testnet' ? 'base-sepolia' : 'base',
+        rpcUrl: config.rpcUrl,
+        stakingMode: config.stakingMode,
+        targetServices: config.targetServices,
+        testnetL2DeploymentPath: config.testnetL2DeploymentPath,
+        testnetL2TokenDeploymentPath: config.testnetL2TokenDeploymentPath,
+        testnetMechDeploymentPath: config.testnetMechDeploymentPath,
+        testnetStolasDeploymentPath: config.testnetStolasDeploymentPath,
+        debug: config.debug,
+        pollIntervalMs: config.pollIntervalMs,
+    });
+    let result;
+    try {
+        result = await bootstrapper.bootstrap(password.password);
+    }
+    catch (err) {
+        const cause = err instanceof Error ? err.message : String(err);
+        const message = err instanceof Error && err.message.trim().length > 0
+            ? err.message
+            : 'Bootstrap failed with an unexpected error.';
+        const details = { cause };
+        if (envelopeDebug(ctx.env) && err instanceof Error && err.stack) {
+            details.stack = err.stack;
+        }
+        emitEnvelope({
+            code: 'fatal',
+            message,
+            details,
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    if (result.funding) {
+        emitEnvelope({
+            code: 'funding_required',
+            message: result.message,
+            hint: 'Fund the listed address and re-run jinn bootstrap.',
+            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,
+            },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    if (!result.ok) {
+        emitEnvelope({
+            code: 'fatal',
+            message: result.message,
+            hint: 'Bootstrap failed before the fleet reached a runnable state.',
+            details: { cause: result.message },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const state = result.fleet_state;
+    const payload = {
+        schemaVersion: 1,
+        generatedAt: new Date().toISOString(),
+        master: state.master_address ?? '',
+        services: state.services.map((s) => ({
+            index: s.index,
+            step: s.step,
+            serviceId: s.service_id ?? null,
+        })),
+    };
+    emitResult(payload, (v) => humanBootstrapSuccess(v), {
+        json,
+        human,
+        writer: ctx.writer,
+        stdoutIsTty: ctx.stdoutIsTty,
+        noColor: Boolean(ctx.env['NO_COLOR']),
+    });
+    ctx.exit(0);
+}
+const command = {
+    name: 'bootstrap',
+    summary: 'Advance the fleet state machine toward a running daemon',
+    helpText: `Usage: jinn bootstrap [--human] [--config <path>] [--password-fd <fd>]
+
+Idempotent. Walks the fleet state machine from wherever it is toward
+a complete, running state. Re-run as many times as needed; the
+machine picks up where it left off. On funding gates, exits 10 with
+a funding_required envelope.
+
+Requires the password environment variable required by the client
+(never as a flag).
+
+Examples:
+  jinn bootstrap
+  jinn bootstrap --human
+
+Failure example (funding gate):
+  $ jinn bootstrap
+  {"schemaVersion":1,"code":"funding_required","exitCode":10,...}
+  $ echo $?
+  10
+`,
+    run,
+};
+export default command;
+//# sourceMappingURL=bootstrap.js.map

package/dist/cli/commands/bootstrap.js.map

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

package/dist/cli/commands/claim-rewards.d.ts

@@ -0,0 +1,3 @@
+import { type CommandModule } from '../command.js';
+declare const command: CommandModule;
+export default command;

package/dist/cli/commands/claim-rewards.js

@@ -0,0 +1,121 @@
+import { parseArgs } from 'node:util';
+import { COMMON_FLAGS } from '../command.js';
+import { emitResult } from '../output.js';
+import { emitEnvelope } from '../../errors/envelope.js';
+import { ensureConfirmed, emitDryRun } from '../action.js';
+import { createCliSignerContext } from '../execution-context.js';
+import { runRewardClaimOnce } from '../../daemon/reward-claim-loop.js';
+import { isRecoverableTransactionError } from '../../tx-retry.js';
+import { TransientError } from '../../types/errors.js';
+async function run(ctx) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: ctx.argv,
+            options: {
+                ...COMMON_FLAGS,
+                'dry-run': { type: 'boolean', default: false },
+                yes: { type: 'boolean', default: false },
+            },
+            allowPositionals: false,
+        });
+    }
+    catch (err) {
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: err instanceof Error ? err.message : String(err),
+            exampleCli: 'jinn claim-rewards --dry-run',
+            details: { field: 'flags' },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const dryRun = parsed.values['dry-run'];
+    const yes = parsed.values.yes;
+    if (dryRun) {
+        emitDryRun(ctx, {
+            verb: 'claim-rewards',
+            description: 'Would call the reward distributor for every staked service',
+            plan: [{ action: 'distributor.claim', perServiceTx: true }],
+        });
+        return;
+    }
+    if (!ensureConfirmed(ctx, { yes, dryRun: false }))
+        return;
+    const built = await createCliSignerContext({ argv: ctx.argv, env: ctx.env });
+    if (!built.ok) {
+        emitEnvelope(built.envelope, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const { networkChain, chainConfig, fleetStore, masterWallet, publicClient } = built.ctx;
+    try {
+        const tick = await runRewardClaimOnce({
+            publicClient,
+            masterWallet,
+            store: fleetStore,
+            chain: networkChain,
+            distributorAddress: chainConfig.distributorAddress,
+            strict: true,
+        });
+        emitResult({
+            schemaVersion: 1,
+            generatedAt: new Date().toISOString(),
+            verb: 'claim-rewards',
+            attempted: tick.attempted,
+            submitted: tick.submitted,
+            skippedNoPending: tick.skippedNoPending,
+            skippedNoDistributor: tick.skippedNoDistributor,
+            skippedWrongMode: tick.skippedWrongMode,
+            claimAttempted: tick.claimAttempted,
+            failedRecoverable: tick.failedRecoverable,
+            failedPermanent: tick.failedPermanent,
+        }, (v) => {
+            const value = v;
+            return [
+                'Reward claim tick complete.',
+                `Attempted services: ${value.attempted}`,
+                `Submitted claims: ${value.submitted}`,
+                `Recoverable failures: ${value.failedRecoverable}`,
+                `Permanent failures: ${value.failedPermanent}`,
+            ].join('\n');
+        }, {
+            json: Boolean(parsed.values.json),
+            human: Boolean(parsed.values.human),
+            writer: ctx.writer,
+            stdoutIsTty: ctx.stdoutIsTty,
+            noColor: Boolean(ctx.env['NO_COLOR']),
+        });
+    }
+    catch (e) {
+        if (e instanceof TransientError || isRecoverableTransactionError(e)) {
+            emitEnvelope({
+                code: 'transient_error',
+                message: e instanceof Error ? e.message : String(e),
+                hint: 'Retry when the RPC endpoint is healthy.',
+                exampleCli: 'jinn claim-rewards --yes',
+                details: { cause: e instanceof Error ? e.message : String(e) },
+            }, { writer: ctx.writer, exit: ctx.exit });
+            return;
+        }
+        emitEnvelope({
+            code: 'fatal',
+            message: e instanceof Error ? e.message : String(e),
+            details: { cause: e instanceof Error ? e.message : String(e) },
+        }, { writer: ctx.writer, exit: ctx.exit });
+    }
+}
+const command = {
+    name: 'claim-rewards',
+    summary: 'Pull pending protocol rewards to the fleet multisigs',
+    helpText: `Usage: jinn claim-rewards [--dry-run] [--yes] [--human]
+
+Idempotent: zero-delta is success, not error. Second consecutive call
+may show submitted:0 and exits 0.
+
+Examples:
+  jinn claim-rewards --dry-run
+  jinn claim-rewards --yes
+`,
+    run,
+};
+export default command;
+//# sourceMappingURL=claim-rewards.js.map

package/dist/cli/commands/claim-rewards.js.map

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

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,3 @@
+import type { CommandModule } from '../command.js';
+declare const command: CommandModule;
+export default command;