@jinn-network/client 0.1.0-canary.adfd078d

package/dist/cli/commands/fleet.js

@@ -0,0 +1,45 @@
+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 { assembleFleetV1 } from '../../api/fleet-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 fleet',
+            details: { field: 'flags' },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const raw = await gatherIntrospectionRaw({ argv: ctx.argv });
+    const payload = assembleFleetV1(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: 'fleet',
+    summary: 'Per-service fleet detail (wallets, staking, rewards, attention)',
+    helpText: `Usage: jinn fleet [--human]
+
+Emits the §4.2 fleet shape: master wallet, each service’s agent and
+multisig addresses, staking flags, activity counts, and attention hints.
+
+Examples:
+  jinn fleet
+  jinn fleet --human
+`,
+    run,
+};
+export default command;
+//# sourceMappingURL=fleet.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fleet.js","sourceRoot":"","sources":["../../../src/cli/commands/fleet.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,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAE3D,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,YAAY;YACxB,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,eAAe,CAAC,GAAG,CAAC,CAAC;IACrC,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,OAAO;IACb,OAAO,EAAE,iEAAiE;IAC1E,QAAQ,EAAE;;;;;;;;CAQX;IACC,GAAG;CACJ,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/cli/commands/fund-requirements.d.ts

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

package/dist/cli/commands/fund-requirements.js

@@ -0,0 +1,139 @@
+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 humanFundRequirements(payload) {
+    if (payload.satisfied) {
+        return 'Funding requirements satisfied. Nothing needed right now.';
+    }
+    const lines = ['Funding required before bootstrap can advance:'];
+    for (const r of payload.requirements) {
+        lines.push(`- ${r.role} @ ${r.address}: asset role ${r.asset}, need ${r.needWei} wei, have ${r.haveWei} wei`);
+    }
+    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 fund-requirements --help` for supported flags.',
+            exampleCli: 'jinn fund-requirements --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 fund-requirements --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
+            : 'Could not evaluate funding requirements.';
+        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;
+    }
+    const requirements = [];
+    if (result.funding) {
+        requirements.push({
+            role: 'master',
+            address: result.funding.master_address,
+            asset: 'native',
+            haveWei: result.funding.eth_balance,
+            needWei: result.funding.eth_required,
+            reason: result.message,
+            blocks: 'bootstrap',
+            details: { tokenAddress: null, tokenSymbol: 'ETH' },
+        });
+    }
+    const payload = {
+        schemaVersion: 1,
+        generatedAt: new Date().toISOString(),
+        requirements,
+        satisfied: requirements.length === 0,
+    };
+    emitResult(payload, (v) => humanFundRequirements(v), {
+        json,
+        human,
+        writer: ctx.writer,
+        stdoutIsTty: ctx.stdoutIsTty,
+        noColor: Boolean(ctx.env['NO_COLOR']),
+    });
+    ctx.exit(0);
+}
+const command = {
+    name: 'fund-requirements',
+    summary: 'List addresses that need funding before the next bootstrap step',
+    helpText: `Usage: jinn fund-requirements [--human] [--config <path>] [--password-fd <fd>]
+
+Returns a JSON object listing every wallet that needs additional
+funding before the state machine can advance. Each entry names the
+wallet role (never the internal address alone), the asset role
+(native / bond / reward), the amount needed, and a token symbol
+lookup for operators that need to bridge or faucet.
+
+When \`satisfied\` is true, the \`requirements\` array is empty and
+no funding is needed right now.
+
+Examples:
+  jinn fund-requirements
+  jinn fund-requirements --human
+`,
+    run,
+};
+export default command;
+//# sourceMappingURL=fund-requirements.js.map

package/dist/cli/commands/fund-requirements.js.map

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

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

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

package/dist/cli/commands/history.js

@@ -0,0 +1,61 @@
+import { parseArgs } from 'node:util';
+import { emitResult } from '../output.js';
+import { gatherIntrospectionRaw } from '../introspection-context.js';
+import { assembleHistoryV1 } from '../../api/history-build.js';
+import { emitEnvelope } from '../../errors/envelope.js';
+async function run(ctx) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: ctx.argv,
+            options: {
+                limit: { type: 'string', default: '50' },
+                since: { type: 'string' },
+                cursor: { type: 'string' },
+                json: { type: 'boolean', default: false },
+                human: { type: 'boolean', default: false },
+            },
+            allowPositionals: false,
+        });
+    }
+    catch (err) {
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: err instanceof Error ? err.message : String(err),
+            exampleCli: 'jinn history --limit 50',
+            details: { field: 'flags' },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const limit = parseInt(parsed.values.limit, 10);
+    const raw = await gatherIntrospectionRaw({ argv: ctx.argv });
+    const payload = assembleHistoryV1(raw, {
+        limit: Number.isFinite(limit) ? limit : 50,
+        since: parsed.values.since,
+        cursor: parsed.values.cursor,
+    });
+    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: 'history',
+    summary: 'Recent protocol activity (intents, claims, deliveries, evaluations, rewards)',
+    helpText: `Usage: jinn history [--since <ISO-8601>] [--limit <N>] [--human]
+
+Returns recent protocol events from the local activity log. Each
+event has a stable \`kind\` enum (intent_posted, request_claimed,
+delivery_submitted, evaluation_submitted, reward_claimed, other).
+
+Examples:
+  jinn history --limit 20
+  jinn history --human
+`,
+    run,
+};
+export default command;
+//# sourceMappingURL=history.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/cli/commands/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,KAAK,UAAU,GAAG,CAAC,GAAmB;IACpC,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC;YACjB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE;gBACP,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE;gBACxC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;gBACzC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;aAC3C;YACD,gBAAgB,EAAE,KAAK;SACxB,CAAC,CAAC;IACL,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,yBAAyB;YACrC,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,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,KAAe,EAAE,EAAE,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,MAAM,sBAAsB,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,EAAE;QACrC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QAC1C,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAA2B;QAChD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAA4B;KACnD,CAAC,CAAC;IACH,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,8EAA8E;IACvF,QAAQ,EAAE;;;;;;;;;CASX;IACC,GAAG;CACJ,CAAC;AAEF,eAAe,OAAO,CAAC"}

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

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

package/dist/cli/commands/init.js

@@ -0,0 +1,91 @@
+import { parseArgs } from 'node:util';
+import { join } from 'node:path';
+import { emitResult } from '../output.js';
+import { emitEnvelope } from '../../errors/envelope.js';
+import { FleetStateStore } from '../../earning/store.js';
+import { generateMnemonic, encryptMnemonic, decryptMnemonic, deriveMasterAddress, } from '../../earning/wallet.js';
+import { resolveCliPassword } from '../password.js';
+async function run(ctx) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: ctx.argv,
+            options: {
+                json: { type: 'boolean', default: false },
+                human: { type: 'boolean', default: false },
+                'password-fd': { type: 'string' },
+            },
+            allowPositionals: false,
+        });
+    }
+    catch (err) {
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: err instanceof Error ? err.message : String(err),
+            exampleCli: 'JINN_PASSWORD=... jinn init',
+            details: { field: 'flags' },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const password = resolveCliPassword(ctx.argv, ctx.env);
+    if (!password.ok) {
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: password.message,
+            exampleCli: 'JINN_PASSWORD=... jinn init',
+            details: { field: 'keystore password', expected: 'non-empty string via environment or fd' },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const earningDir = ctx.env['JINN_EARNING_DIR'] ?? join(process.env['HOME'] ?? '.', '.jinn-client', 'earning');
+    const store = new FleetStateStore(earningDir);
+    if (!store.hasMnemonicKeystore() && store.hasLegacyKeystore()) {
+        await store.migrateLegacyFiles();
+    }
+    let masterAddress;
+    if (store.hasMnemonicKeystore()) {
+        const mnemonic = await decryptMnemonic(await store.loadMnemonicKeystore(), password.password);
+        masterAddress = deriveMasterAddress(mnemonic);
+    }
+    else {
+        const mnemonic = generateMnemonic();
+        const keystore = await encryptMnemonic(mnemonic, password.password);
+        await store.saveMnemonicKeystore(keystore);
+        masterAddress = deriveMasterAddress(mnemonic);
+    }
+    emitResult({
+        schemaVersion: 1,
+        generatedAt: new Date().toISOString(),
+        master: masterAddress,
+        keystoreDir: earningDir,
+    }, (v) => {
+        const value = v;
+        return `Keystore ready.\nMaster: ${value.master}\nDirectory: ${value.keystoreDir}`;
+    }, {
+        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: 'init',
+    summary: 'Generate the master wallet and write the encrypted keystore',
+    helpText: `Usage: JINN_PASSWORD=... jinn init [--human]
+
+Idempotent. Generates a master wallet mnemonic, encrypts it with
+JINN_PASSWORD, and writes the keystore. On a second run, reads the
+existing keystore and returns the same master address.
+
+Does not contact the RPC or create services. Run \`jinn bootstrap\`
+after \`jinn init\` to advance the state machine.
+
+Examples:
+  JINN_PASSWORD=secret jinn init
+  JINN_PASSWORD=secret jinn init --human
+`,
+    run,
+};
+export default command;
+//# sourceMappingURL=init.js.map

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

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

package/dist/cli/commands/keys-backup.d.ts

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

package/dist/cli/commands/keys-backup.js

@@ -0,0 +1,107 @@
+import { parseArgs } from 'node:util';
+import { writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { emitResult } from '../output.js';
+import { emitEnvelope } from '../../errors/envelope.js';
+import { FleetStateStore } from '../../earning/store.js';
+import { decryptMnemonic } from '../../earning/wallet.js';
+async function runBackup(ctx, rest) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: rest,
+            options: {
+                output: { type: 'string' },
+                json: { type: 'boolean', default: false },
+                human: { type: 'boolean', default: false },
+            },
+            allowPositionals: false,
+        });
+    }
+    catch (err) {
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: err instanceof Error ? err.message : String(err),
+            exampleCli: 'jinn keys backup --output /tmp/mnemonic.txt',
+            details: { field: 'flags' },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const output = parsed.values.output;
+    if (!output) {
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: '--output is required',
+            exampleCli: 'jinn keys backup --output /tmp/mnemonic.txt',
+            details: { field: '--output', expected: 'writable filesystem path' },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const password = ctx.env['JINN_PASSWORD'];
+    if (!password) {
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: 'JINN_PASSWORD is required to decrypt the keystore.',
+            exampleCli: 'JINN_PASSWORD=... jinn keys backup --output /tmp/mnemonic.txt',
+            details: { field: 'JINN_PASSWORD', expected: 'non-empty string' },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const earningDir = ctx.env['JINN_EARNING_DIR'] ?? join(process.env['HOME'] ?? '.', '.jinn-client', 'earning');
+    const store = new FleetStateStore(earningDir);
+    const keystore = await store.loadMnemonicKeystore();
+    const mnemonic = await decryptMnemonic(keystore, password);
+    writeFileSync(output, `${mnemonic}\n`, { encoding: 'utf-8', mode: 0o600 });
+    emitResult({
+        schemaVersion: 1,
+        generatedAt: new Date().toISOString(),
+        verb: 'keys backup',
+        output,
+        words: mnemonic.split(/\s+/).length,
+    }, (v) => {
+        const value = v;
+        return `Mnemonic backup written.\nPath: ${value.output}\nWords: ${value.words}`;
+    }, {
+        json: Boolean(parsed.values.json),
+        human: Boolean(parsed.values.human),
+        writer: ctx.writer,
+        stdoutIsTty: ctx.stdoutIsTty,
+        noColor: Boolean(ctx.env['NO_COLOR']),
+    });
+}
+async function run(ctx) {
+    const [subverb, ...rest] = ctx.argv;
+    if (!subverb) {
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: 'jinn keys requires a subverb: backup',
+            exampleCli: 'jinn keys backup --output /tmp/mnemonic.txt',
+            details: { field: 'subverb', expected: 'backup' },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    if (subverb === 'backup')
+        return runBackup(ctx, rest);
+    emitEnvelope({
+        code: 'invalid_invocation',
+        message: `Unknown keys subverb: ${subverb}`,
+        exampleCli: 'jinn keys backup --output /tmp/mnemonic.txt',
+        details: { field: 'subverb', expected: 'backup' },
+    }, { writer: ctx.writer, exit: ctx.exit });
+}
+const command = {
+    name: 'keys',
+    summary: 'Keystore management: backup',
+    helpText: `Usage: jinn keys backup --output <path> [--human]
+
+Decrypts the local keystore using JINN_PASSWORD and writes the
+mnemonic to <path> with mode 0600. Idempotent: same mnemonic →
+same output. No other side effects.
+
+Examples:
+  JINN_PASSWORD=secret jinn keys backup --output ~/backup/jinn.txt
+`,
+    run,
+};
+export default command;
+//# sourceMappingURL=keys-backup.js.map

package/dist/cli/commands/keys-backup.js.map

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

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

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

package/dist/cli/commands/logs.js

@@ -0,0 +1,69 @@
+import { parseArgs } from 'node:util';
+import { emitEnvelope } from '../../errors/envelope.js';
+import { loadConfig, getConfigPathFromArgs } from '../../config.js';
+import { Store } from '../../store/store.js';
+const REF_MS = Date.UTC(2026, 3, 14, 12, 0, 0);
+async function run(ctx) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: ctx.argv,
+            options: {
+                limit: { type: 'string', default: '100' },
+                json: { type: 'boolean', default: false },
+                human: { type: 'boolean', default: false },
+            },
+            allowPositionals: false,
+        });
+    }
+    catch (err) {
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: err instanceof Error ? err.message : String(err),
+            exampleCli: 'jinn logs --limit 100',
+            details: { field: 'flags' },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const n = parseInt(parsed.values.limit, 10);
+    const limit = Math.min(Math.max(Number.isFinite(n) ? n : 100, 1), 1000);
+    const fromVerbFlags = getConfigPathFromArgs(ctx.argv);
+    const fromProcess = typeof process !== 'undefined' ? getConfigPathFromArgs(process.argv.slice(2)) : undefined;
+    const config = loadConfig(fromVerbFlags ?? fromProcess);
+    const store = new Store(config.dbPath);
+    const rows = store.getRecentOwnActivity(limit);
+    const payload = rows.map((row, i) => ({
+        ts: new Date(REF_MS - i * 1000).toISOString(),
+        level: 'info',
+        component: 'activity',
+        msg: row.role,
+        requestId: row.requestId,
+        txHash: null,
+    }));
+    if (parsed.values.human) {
+        for (const line of payload) {
+            ctx.writer.write(`${line.ts} ${line.component} ${line.msg} request=${line.requestId}\n`);
+        }
+        return;
+    }
+    for (const line of payload) {
+        ctx.writer.write(JSON.stringify(line) + '\n');
+    }
+}
+const command = {
+    name: 'logs',
+    summary: 'Structured event log (one JSON object per line)',
+    helpText: `Usage: jinn logs [--limit <N>] [--human]
+
+v1: reads the most recent N rows from the local activity store and
+emits one JSON object per line matching the spec §8 log line shape
+(\`ts\`, \`level\`, \`component\`, \`msg\`).
+
+Examples:
+  jinn logs --limit 50
+  jinn logs --human
+`,
+    run,
+};
+export default command;
+//# sourceMappingURL=logs.js.map

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

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

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

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

package/dist/cli/commands/rewards.js

@@ -0,0 +1,54 @@
+import { parseArgs } from 'node:util';
+import { emitEnvelope } from '../../errors/envelope.js';
+import { emitResult } from '../output.js';
+import { gatherIntrospectionRaw } from '../introspection-context.js';
+import { assembleRewardsV1 } from '../../api/rewards-build.js';
+async function run(ctx) {
+    let parsed;
+    try {
+        parsed = parseArgs({
+            args: ctx.argv,
+            options: {
+                json: { type: 'boolean', default: false },
+                human: { type: 'boolean', default: false },
+                config: { type: 'string' },
+            },
+            allowPositionals: false,
+        });
+    }
+    catch (err) {
+        emitEnvelope({
+            code: 'invalid_invocation',
+            message: err instanceof Error ? err.message : String(err),
+            exampleCli: 'jinn rewards',
+            details: { field: 'flags' },
+        }, { writer: ctx.writer, exit: ctx.exit });
+        return;
+    }
+    const raw = await gatherIntrospectionRaw({ argv: ctx.argv });
+    const payload = assembleRewardsV1(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: 'rewards',
+    summary: 'Earned vs claimed per service, per asset; next checkpoint time',
+    helpText: `Usage: jinn rewards [--human]
+
+Returns the current pending reward balance per service, per asset
+role. Uses \`reward\` as the asset name; look up the concrete token
+in \`jinn version\`.
+
+Examples:
+  jinn rewards
+  jinn rewards --human
+`,
+    run,
+};
+export default command;
+//# sourceMappingURL=rewards.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rewards.js","sourceRoot":"","sources":["../../../src/cli/commands/rewards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,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,SAAS,CAAC;YACjB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,OAAO,EAAE;gBACP,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;gBACzC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;gBAC1C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aAC3B;YACD,gBAAgB,EAAE,KAAK;SACxB,CAAC,CAAC;IACL,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,gEAAgE;IACzE,QAAQ,EAAE;;;;;;;;;CASX;IACC,GAAG;CACJ,CAAC;AAEF,eAAe,OAAO,CAAC"}

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

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