@jinn-network/client 0.1.7 → 0.1.8-canary.09a3b2f6

package/dist/config.d.ts

@@ -15,45 +15,6 @@
  */
 import { z } from 'zod';
 import type { Task } from './types/task.js';
-export interface DefaultSolverNetConfig extends Record<string, unknown> {
-    enabled?: boolean;
-    solverType: string;
-    /**
-     * Operator-selected roles for this SolverNet. A non-empty subset of
-     * `['solving', 'evaluating']`. Multiple roles can run concurrently — the
-     * daemon enforces `disallowSolverSelfEvaluation` on-chain so the operator
-     * never evaluates its own Solutions, and the on-chain
-     * TaskActivityCheckerV3 keeps `solutionDeliveryWeight` and
-     * `verdictDeliveryWeight` as independent additive counters.
-     *
-     * Launcher-side flagging is no longer expressed as an operator role —
-     * launcher ownership is determined by the launched-record subsystem
-     * (spec/2026-05-05-solvernet-creation-and-launch.md §11). Operator config
-     * carries only the participation roles.
-     *
-     * Legacy `role: 'solving' | 'evaluating'` configs are auto-migrated to
-     * `roles: [<role>]` by the loader (zod preprocessor on solverNets[*]).
-     */
-    roles?: Array<'solving' | 'evaluating'>;
-    harness?: string;
-    model?: string;
-    plugins?: Array<string | {
-        name?: string;
-        source: string;
-        version?: string;
-    }>;
-    taskGenerator?: {
-        enabled?: boolean;
-    };
-}
-/**
- * Default `solverNets` is empty per Decision 5 of
- * spec/2026-05-05-solvernet-creation-and-launch.md — pre-release, no
- * migration burden. Fresh installs no longer seed the `prediction` entry;
- * the operator joins SolverNets through the registry (Task 21's
- * `joinedSolverNets` block).
- */
-export declare const DEFAULT_SOLVER_NETS: Record<string, DefaultSolverNetConfig>;
 export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
     /**
      * Network to connect to.
@@ -64,19 +25,36 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
      */
     network: z.ZodDefault<z.ZodEnum<["mainnet", "testnet"]>>;
     /**
-     * Base RPC endpoint.
-     * Defaults to https://mainnet.base.org for 'mainnet' and
-     * https://sepolia.base.org for 'testnet'. Set explicitly to override.
+     * Base RPC endpoint(s). Accepts either a single URL string or an array of
+     * URLs. When an array (or a comma-separated env var) is supplied, the
+     * daemon builds a viem `fallback()` chain in slot order (primary first).
+     * See `client/src/rpc/transport.ts` for the wrapper. Defaults to the
+     * publicnode+sepolia.base.org two-provider chain on testnet and the public
+     * `mainnet.base.org` on mainnet. Set explicitly to override.
+     *
+     * Env: JINN_RPC_URL / BASE_SEPOLIA_RPC_URL / BASE_RPC_URL (comma-separated).
      */
-    rpcUrl: z.ZodOptional<z.ZodString>;
-    archiveRpcUrl: z.ZodOptional<z.ZodString>;
+    rpcUrl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    archiveRpcUrl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
     /**
-     * Optional L2 proof/archive RPC endpoint for canonical cross-chain canaries.
+     * Optional L2 proof/archive RPC endpoint(s) for canonical cross-chain canaries.
      * The daemon can use its normal rpcUrl for writes while proof construction
      * uses this endpoint for historical eth_getProof at OP dispute-game blocks.
-     * Env: JINN_L2_PROOF_RPC_URL.
+     * Accepts string or array form (see rpcUrl). Env: JINN_L2_PROOF_RPC_URL.
      */
-    l2ProofRpcUrl: z.ZodOptional<z.ZodString>;
+    l2ProofRpcUrl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
+    /**
+     * Single volume-aware durable-state root. When set (env JINN_STATE_DIR or
+     * this file field), `earningDir`, `dbPath`, `engine.implStateDirRoot`, and
+     * the swe-rebench-v2 pool dir derive from it as `<stateDir>/<subdir>` —
+     * UNLESS each is individually overridden, in which case the per-key value
+     * wins (derive-don't-collapse). With `stateDir` unset, every default is
+     * byte-identical to the legacy `~/.jinn-client/<subdir>` paths. Hosted
+     * deploys collapse four ENV lines to one `JINN_STATE_DIR=/data`.
+     * `engine.workingDirRoot` is deliberately NOT derived — it stays ephemeral
+     * (reaped per-task).
+     */
+    stateDir: z.ZodOptional<z.ZodString>;
     /** Earning state directory */
     earningDir: z.ZodDefault<z.ZodString>;
     /** SQLite database path */
@@ -132,6 +110,8 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
     hermesModel: z.ZodOptional<z.ZodString>;
     /** Hermes provider (e.g. 'anthropic'). */
     hermesProvider: z.ZodOptional<z.ZodString>;
+    /** Local OpenAI-compatible Hermes base URL, e.g. http://127.0.0.1:11434/v1 for Ollama. */
+    hermesBaseUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
     /**
      * Timeout in ms for `hermes doctor` health-check runs.
      * Default 30 000 ms. Env: JINN_HERMES_DOCTOR_TIMEOUT_MS.
@@ -193,6 +173,17 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
      * backlog while proving one fresh task path.
      */
     taskDiscoveryAllowedTaskIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Explicit absolute lower bound (L2 block number) for the mech adapter's
+     * on-chain TaskCreated backlog scan. Unset → the scan defaults to a bounded
+     * rolling window (`head − DEFAULT_ONCHAIN_SCAN_WINDOW_BLOCKS`, ~28h on Base),
+     * so a restart no longer replays full chain history every boot (#801); the
+     * indexer (DiscoveryAPI.findClaimableTasks) is the primary discovery path and
+     * the on-chain scan is a bounded backstop. Set this to widen the backstop to a
+     * specific block (the value pins both the scan start and the gh #300 admission
+     * floor). Env: JINN_TASK_DISCOVERY_FROM_BLOCK.
+     */
+    taskDiscoveryOnchainFromBlock: z.ZodOptional<z.ZodNumber>;
     /** This node's public HTTP endpoint (for 8004 registration) */
     nodeEndpoint: z.ZodOptional<z.ZodString>;
     /** Tasks to create and solve. Empty by default; enabled SolverNet generators fill the loop. */
@@ -970,18 +961,19 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
      */
     jinnMviL2DeploymentPath: z.ZodOptional<z.ZodString>;
     /**
-     * RPC endpoint for the L1 governance chain (Ethereum / Sepolia) where the
-     * JinnDistributor lives. Testnet defaults to a public Sepolia RPC; mainnet
-     * requires an operator override when L1 submit mode is configured.
-     * Env: JINN_ETHEREUM_RPC_URL.
+     * RPC endpoint(s) for the L1 governance chain (Ethereum / Sepolia) where
+     * the JinnDistributor lives. Accepts string or array form (see rpcUrl) and
+     * supports comma-separated env values. Testnet defaults to a public Sepolia
+     * RPC; mainnet requires an operator override when L1 submit mode is
+     * configured. Env: JINN_ETHEREUM_RPC_URL.
      */
-    ethereumRpcUrl: z.ZodOptional<z.ZodString>;
+    ethereumRpcUrl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
     /**
-     * Optional archive RPC endpoint for the L1 governance chain. Used for
-     * historical block lookups when constructing canonical-mode proofs.
-     * Env: JINN_ETHEREUM_ARCHIVE_RPC_URL.
+     * Optional archive RPC endpoint(s) for the L1 governance chain. Used for
+     * historical block lookups when constructing canonical-mode proofs. Accepts
+     * string or array form. Env: JINN_ETHEREUM_ARCHIVE_RPC_URL.
      */
-    ethereumArchiveRpcUrl: z.ZodOptional<z.ZodString>;
+    ethereumArchiveRpcUrl: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>;
     /**
      * L1 network used by the cross-chain claim loop. 'sepolia' tracks Base
      * Sepolia testnet; 'ethereum' tracks Base mainnet. Defaults to 'sepolia'
@@ -1137,97 +1129,7 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
         mode?: "train" | "frozen" | undefined;
     }>>;
     /**
-     * SolverNet activation, Harness selection, and operator-configured runtime plugins.
-     *
-     * Each entry's `roles` is a non-empty subset of `['solving', 'evaluating']`.
-     * Multiple roles can run concurrently for the same SolverNet; the
-     * protocol-level `disallowSolverSelfEvaluation` flag prevents the operator
-     * from evaluating its own Solutions and the on-chain
-     * TaskActivityCheckerV3 tracks Solution and Verdict counters independently
-     * (additive into `eligibleActivityWeight`).
-     *
-     * Launcher ownership lives in the launched-record subsystem
-     * (spec/2026-05-05-solvernet-creation-and-launch.md §11), not in operator
-     * config — there is no `'launching'` operator role. Legacy entries that
-     * include `'launching'` in `roles` have it stripped by the preprocessor so
-     * older config files keep loading.
-     *
-     * Backwards-compat: a legacy `role: 'solving' | 'evaluating'` field is
-     * auto-promoted to `roles: [<role>]` by the zod preprocessor below so
-     * existing `~/.jinn-client/config.json` files keep loading without an
-     * operator migration step.
-     */
-    solverNets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
-        enabled: z.ZodDefault<z.ZodBoolean>;
-        solverType: z.ZodString;
-        roles: z.ZodEffects<z.ZodDefault<z.ZodArray<z.ZodEnum<["solving", "evaluating"]>, "many">>, ("solving" | "evaluating")[], ("solving" | "evaluating")[] | undefined>;
-        harness: z.ZodDefault<z.ZodEffects<z.ZodString, string, string>>;
-        model: z.ZodOptional<z.ZodString>;
-        plugins: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
-            name: z.ZodOptional<z.ZodString>;
-            source: z.ZodString;
-            version: z.ZodOptional<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            source: string;
-            name?: string | undefined;
-            version?: string | undefined;
-        }, {
-            source: string;
-            name?: string | undefined;
-            version?: string | undefined;
-        }>]>, "many">>;
-        taskGenerator: z.ZodDefault<z.ZodObject<{
-            enabled: z.ZodDefault<z.ZodBoolean>;
-        }, "strip", z.ZodTypeAny, {
-            enabled: boolean;
-        }, {
-            enabled?: boolean | undefined;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        solverType: string;
-        enabled: boolean;
-        roles: ("solving" | "evaluating")[];
-        harness: string;
-        plugins: (string | {
-            source: string;
-            name?: string | undefined;
-            version?: string | undefined;
-        })[];
-        taskGenerator: {
-            enabled: boolean;
-        };
-        model?: string | undefined;
-    }, {
-        solverType: string;
-        enabled?: boolean | undefined;
-        roles?: ("solving" | "evaluating")[] | undefined;
-        harness?: string | undefined;
-        model?: string | undefined;
-        plugins?: (string | {
-            source: string;
-            name?: string | undefined;
-            version?: string | undefined;
-        })[] | undefined;
-        taskGenerator?: {
-            enabled?: boolean | undefined;
-        } | undefined;
-    }>, {
-        solverType: string;
-        enabled: boolean;
-        roles: ("solving" | "evaluating")[];
-        harness: string;
-        plugins: (string | {
-            source: string;
-            name?: string | undefined;
-            version?: string | undefined;
-        })[];
-        taskGenerator: {
-            enabled: boolean;
-        };
-        model?: string | undefined;
-    }, unknown>>>;
-    /**
-     * Manifest-keyed joined SolverNets (Task 21).
+     * Manifest-keyed joined SolverNets.
      *
      * Spec: spec/2026-05-05-solvernet-creation-and-launch.md §12.
      *
@@ -1236,10 +1138,10 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
      * (CIDv0 / CIDv1) — the only stable identifier that maps back to a
      * launched-instance authority across launchers.
      *
-     * Kept structurally separate from legacy `solverNets` for now. The daemon
-     * narrows this block into runtime SolverNet registry entries on restart, and
-     * Task 22 collapses both branches into a single manifest-keyed shape once
-     * the legacy block is fully drained.
+     * The daemon narrows this block into runtime SolverNet registry entries on
+     * restart. Legacy short-name-keyed `solverNets` blocks on operator config
+     * files are auto-migrated into synthetic `legacy:<short-name>`-keyed
+     * entries at load time (see `migrateLegacySolverNets`).
      */
     joinedSolverNets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
         manifestCid: z.ZodString;
@@ -1260,28 +1162,28 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
         plugins: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         disabledDefaultPlugins: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
     }, "strip", z.ZodTypeAny, {
+        manifestCid: string;
         roles: ("solver" | "evaluator")[];
         plugins: string[];
-        manifestCid: string;
         disabledDefaultPlugins: string[];
         name?: string | undefined;
         harness?: string | undefined;
-        model?: string | undefined;
         contract?: {
             id: string;
             version: string;
         } | undefined;
+        model?: string | undefined;
     }, {
-        roles: ("solver" | "evaluator")[];
         manifestCid: string;
+        roles: ("solver" | "evaluator")[];
         name?: string | undefined;
         harness?: string | undefined;
-        model?: string | undefined;
-        plugins?: string[] | undefined;
         contract?: {
             id: string;
             version: string;
         } | undefined;
+        model?: string | undefined;
+        plugins?: string[] | undefined;
         disabledDefaultPlugins?: string[] | undefined;
     }>>>;
     /**
@@ -1438,10 +1340,36 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
      * Env: JINN_REPUTATION_ENABLED
      */
     reputationEnabled: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Per-credential daily spend caps (USD). Keys are credential identifiers
+     * (e.g. `'anthropic:api-key'`); values are positive numbers representing
+     * the maximum USD spend per day for that credential.
+     *
+     * `JINN_SPEND_CAP_USD` (env-only, consumed directly by the spend-budget
+     * subsystem in Task 9) is tracked for provenance in TRACKED_ENV_VARS below
+     * but is NOT a config-file field and has no entry in this schema.
+     */
+    spendCaps: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    /**
+     * Operator-local SolverPlugin trust state.
+     *
+     * `blockedCids` is the list of plug-in CIDs the operator has chosen to
+     * refuse to load — populated by `jinn solver-plugins block <cid>` and read
+     * at daemon startup. The block list complements the on-chain
+     * `giveFeedback(score=0)` write (which is the public-trust signal); the
+     * local list is the operator's own refusal to execute, applied even when
+     * the network write fails. File-managed only — no env override.
+     *
+     * See spec/2026-05-26-117-design.md "Failure modes" and "Local-only effects".
+     */
+    solverPlugins: z.ZodDefault<z.ZodObject<{
+        blockedCids: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        blockedCids: string[];
+    }, {
+        blockedCids?: string[] | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
-    harness: {
-        mode: "train" | "frozen";
-    };
     network: "testnet" | "mainnet";
     earningDir: string;
     dbPath: string;
@@ -1536,21 +1464,9 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
     stakingMode: "standard" | "self-bond";
     targetServices: number;
     debug: boolean;
-    solverNets: Record<string, {
-        solverType: string;
-        enabled: boolean;
-        roles: ("solving" | "evaluating")[];
-        harness: string;
-        plugins: (string | {
-            source: string;
-            name?: string | undefined;
-            version?: string | undefined;
-        })[];
-        taskGenerator: {
-            enabled: boolean;
-        };
-        model?: string | undefined;
-    }>;
+    harness: {
+        mode: "train" | "frozen";
+    };
     captures: {
         llmProxy: {
             enabled: boolean;
@@ -1559,13 +1475,18 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
     };
     runLegacyMigrations: boolean;
     reputationEnabled: boolean;
-    rpcUrl?: string | undefined;
-    archiveRpcUrl?: string | undefined;
-    l2ProofRpcUrl?: string | undefined;
+    solverPlugins: {
+        blockedCids: string[];
+    };
+    rpcUrl?: string | string[] | undefined;
+    archiveRpcUrl?: string | string[] | undefined;
+    l2ProofRpcUrl?: string | string[] | undefined;
+    stateDir?: string | undefined;
     apiBindHost?: string | undefined;
     hermesPath?: string | undefined;
     hermesModel?: string | undefined;
     hermesProvider?: string | undefined;
+    hermesBaseUrl?: string | undefined;
     codexPath?: string | undefined;
     runtimeMode?: "bare" | "docker-compose" | "container" | undefined;
     discovery?: {
@@ -1574,6 +1495,7 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
         fallbackToOnchain?: boolean | undefined;
     } | undefined;
     taskDiscoveryAllowedTaskIds?: string[] | undefined;
+    taskDiscoveryOnchainFromBlock?: number | undefined;
     nodeEndpoint?: string | undefined;
     testnetL2DeploymentPath?: string | undefined;
     testnetL2TokenDeploymentPath?: string | undefined;
@@ -1581,8 +1503,8 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
     testnetStolasDeploymentPath?: string | undefined;
     jinnMviL1DeploymentPath?: string | undefined;
     jinnMviL2DeploymentPath?: string | undefined;
-    ethereumRpcUrl?: string | undefined;
-    ethereumArchiveRpcUrl?: string | undefined;
+    ethereumRpcUrl?: string | string[] | undefined;
+    ethereumArchiveRpcUrl?: string | string[] | undefined;
     jinnDistributorAddress?: string | undefined;
     jinnClaimEmitterAddress?: string | undefined;
     jinnMessengerAddress?: string | undefined;
@@ -1600,17 +1522,17 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
         }[] | undefined;
     } | undefined;
     joinedSolverNets?: Record<string, {
+        manifestCid: string;
         roles: ("solver" | "evaluator")[];
         plugins: string[];
-        manifestCid: string;
         disabledDefaultPlugins: string[];
         name?: string | undefined;
         harness?: string | undefined;
-        model?: string | undefined;
         contract?: {
             id: string;
             version: string;
         } | undefined;
+        model?: string | undefined;
     }> | undefined;
     trustedImplSigners?: {
         publicKey: string;
@@ -1631,14 +1553,13 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
     } | undefined;
     identityRegistryAddress?: string | undefined;
     validationRegistryAddress?: string | undefined;
+    spendCaps?: Record<string, number> | undefined;
 }, {
-    harness?: {
-        mode?: "train" | "frozen" | undefined;
-    } | undefined;
     network?: "testnet" | "mainnet" | undefined;
-    rpcUrl?: string | undefined;
-    archiveRpcUrl?: string | undefined;
-    l2ProofRpcUrl?: string | undefined;
+    rpcUrl?: string | string[] | undefined;
+    archiveRpcUrl?: string | string[] | undefined;
+    l2ProofRpcUrl?: string | string[] | undefined;
+    stateDir?: string | undefined;
     earningDir?: string | undefined;
     dbPath?: string | undefined;
     pollIntervalMs?: number | undefined;
@@ -1653,6 +1574,7 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
     hermesPath?: string | undefined;
     hermesModel?: string | undefined;
     hermesProvider?: string | undefined;
+    hermesBaseUrl?: string | undefined;
     hermesDoctorTimeoutMs?: number | undefined;
     codexPath?: string | undefined;
     codexDoctorTimeoutMs?: number | undefined;
@@ -1664,6 +1586,7 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
         fallbackToOnchain?: boolean | undefined;
     } | undefined;
     taskDiscoveryAllowedTaskIds?: string[] | undefined;
+    taskDiscoveryOnchainFromBlock?: number | undefined;
     nodeEndpoint?: string | undefined;
     tasks?: {
         id?: string | undefined;
@@ -1783,8 +1706,8 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
     testnetStolasDeploymentPath?: string | undefined;
     jinnMviL1DeploymentPath?: string | undefined;
     jinnMviL2DeploymentPath?: string | undefined;
-    ethereumRpcUrl?: string | undefined;
-    ethereumArchiveRpcUrl?: string | undefined;
+    ethereumRpcUrl?: string | string[] | undefined;
+    ethereumArchiveRpcUrl?: string | string[] | undefined;
     jinnL1Network?: "sepolia" | "ethereum" | undefined;
     jinnDistributorAddress?: string | undefined;
     jinnClaimEmitterAddress?: string | undefined;
@@ -1809,18 +1732,20 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
             version?: string | undefined;
         }[] | undefined;
     } | undefined;
-    solverNets?: Record<string, unknown> | undefined;
+    harness?: {
+        mode?: "train" | "frozen" | undefined;
+    } | undefined;
     joinedSolverNets?: Record<string, {
-        roles: ("solver" | "evaluator")[];
         manifestCid: string;
+        roles: ("solver" | "evaluator")[];
         name?: string | undefined;
         harness?: string | undefined;
-        model?: string | undefined;
-        plugins?: string[] | undefined;
         contract?: {
             id: string;
             version: string;
         } | undefined;
+        model?: string | undefined;
+        plugins?: string[] | undefined;
         disabledDefaultPlugins?: string[] | undefined;
     }> | undefined;
     trustedImplSigners?: {
@@ -1850,10 +1775,11 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
     identityRegistryAddress?: string | undefined;
     validationRegistryAddress?: string | undefined;
     reputationEnabled?: boolean | undefined;
+    spendCaps?: Record<string, number> | undefined;
+    solverPlugins?: {
+        blockedCids?: string[] | undefined;
+    } | undefined;
 }>, {
-    harness: {
-        mode: "train" | "frozen";
-    };
     network: "testnet" | "mainnet";
     earningDir: string;
     dbPath: string;
@@ -1948,21 +1874,9 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
     stakingMode: "standard" | "self-bond";
     targetServices: number;
     debug: boolean;
-    solverNets: Record<string, {
-        solverType: string;
-        enabled: boolean;
-        roles: ("solving" | "evaluating")[];
-        harness: string;
-        plugins: (string | {
-            source: string;
-            name?: string | undefined;
-            version?: string | undefined;
-        })[];
-        taskGenerator: {
-            enabled: boolean;
-        };
-        model?: string | undefined;
-    }>;
+    harness: {
+        mode: "train" | "frozen";
+    };
     captures: {
         llmProxy: {
             enabled: boolean;
@@ -1971,13 +1885,18 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
     };
     runLegacyMigrations: boolean;
     reputationEnabled: boolean;
-    rpcUrl?: string | undefined;
-    archiveRpcUrl?: string | undefined;
-    l2ProofRpcUrl?: string | undefined;
+    solverPlugins: {
+        blockedCids: string[];
+    };
+    rpcUrl?: string | string[] | undefined;
+    archiveRpcUrl?: string | string[] | undefined;
+    l2ProofRpcUrl?: string | string[] | undefined;
+    stateDir?: string | undefined;
     apiBindHost?: string | undefined;
     hermesPath?: string | undefined;
     hermesModel?: string | undefined;
     hermesProvider?: string | undefined;
+    hermesBaseUrl?: string | undefined;
     codexPath?: string | undefined;
     runtimeMode?: "bare" | "docker-compose" | "container" | undefined;
     discovery?: {
@@ -1986,6 +1905,7 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
         fallbackToOnchain?: boolean | undefined;
     } | undefined;
     taskDiscoveryAllowedTaskIds?: string[] | undefined;
+    taskDiscoveryOnchainFromBlock?: number | undefined;
     nodeEndpoint?: string | undefined;
     testnetL2DeploymentPath?: string | undefined;
     testnetL2TokenDeploymentPath?: string | undefined;
@@ -1993,8 +1913,8 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
     testnetStolasDeploymentPath?: string | undefined;
     jinnMviL1DeploymentPath?: string | undefined;
     jinnMviL2DeploymentPath?: string | undefined;
-    ethereumRpcUrl?: string | undefined;
-    ethereumArchiveRpcUrl?: string | undefined;
+    ethereumRpcUrl?: string | string[] | undefined;
+    ethereumArchiveRpcUrl?: string | string[] | undefined;
     jinnDistributorAddress?: string | undefined;
     jinnClaimEmitterAddress?: string | undefined;
     jinnMessengerAddress?: string | undefined;
@@ -2012,17 +1932,17 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
         }[] | undefined;
     } | undefined;
     joinedSolverNets?: Record<string, {
+        manifestCid: string;
         roles: ("solver" | "evaluator")[];
         plugins: string[];
-        manifestCid: string;
         disabledDefaultPlugins: string[];
         name?: string | undefined;
         harness?: string | undefined;
-        model?: string | undefined;
         contract?: {
             id: string;
             version: string;
         } | undefined;
+        model?: string | undefined;
     }> | undefined;
     trustedImplSigners?: {
         publicKey: string;
@@ -2043,14 +1963,13 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
     } | undefined;
     identityRegistryAddress?: string | undefined;
     validationRegistryAddress?: string | undefined;
+    spendCaps?: Record<string, number> | undefined;
 }, {
-    harness?: {
-        mode?: "train" | "frozen" | undefined;
-    } | undefined;
     network?: "testnet" | "mainnet" | undefined;
-    rpcUrl?: string | undefined;
-    archiveRpcUrl?: string | undefined;
-    l2ProofRpcUrl?: string | undefined;
+    rpcUrl?: string | string[] | undefined;
+    archiveRpcUrl?: string | string[] | undefined;
+    l2ProofRpcUrl?: string | string[] | undefined;
+    stateDir?: string | undefined;
     earningDir?: string | undefined;
     dbPath?: string | undefined;
     pollIntervalMs?: number | undefined;
@@ -2065,6 +1984,7 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
     hermesPath?: string | undefined;
     hermesModel?: string | undefined;
     hermesProvider?: string | undefined;
+    hermesBaseUrl?: string | undefined;
     hermesDoctorTimeoutMs?: number | undefined;
     codexPath?: string | undefined;
     codexDoctorTimeoutMs?: number | undefined;
@@ -2076,6 +1996,7 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
         fallbackToOnchain?: boolean | undefined;
     } | undefined;
     taskDiscoveryAllowedTaskIds?: string[] | undefined;
+    taskDiscoveryOnchainFromBlock?: number | undefined;
     nodeEndpoint?: string | undefined;
     tasks?: {
         id?: string | undefined;
@@ -2195,8 +2116,8 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
     testnetStolasDeploymentPath?: string | undefined;
     jinnMviL1DeploymentPath?: string | undefined;
     jinnMviL2DeploymentPath?: string | undefined;
-    ethereumRpcUrl?: string | undefined;
-    ethereumArchiveRpcUrl?: string | undefined;
+    ethereumRpcUrl?: string | string[] | undefined;
+    ethereumArchiveRpcUrl?: string | string[] | undefined;
     jinnL1Network?: "sepolia" | "ethereum" | undefined;
     jinnDistributorAddress?: string | undefined;
     jinnClaimEmitterAddress?: string | undefined;
@@ -2221,18 +2142,20 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
             version?: string | undefined;
         }[] | undefined;
     } | undefined;
-    solverNets?: Record<string, unknown> | undefined;
+    harness?: {
+        mode?: "train" | "frozen" | undefined;
+    } | undefined;
     joinedSolverNets?: Record<string, {
-        roles: ("solver" | "evaluator")[];
         manifestCid: string;
+        roles: ("solver" | "evaluator")[];
         name?: string | undefined;
         harness?: string | undefined;
-        model?: string | undefined;
-        plugins?: string[] | undefined;
         contract?: {
             id: string;
             version: string;
         } | undefined;
+        model?: string | undefined;
+        plugins?: string[] | undefined;
         disabledDefaultPlugins?: string[] | undefined;
     }> | undefined;
     trustedImplSigners?: {
@@ -2262,10 +2185,33 @@ export declare const JinnConfigSchema: z.ZodEffects<z.ZodObject<{
     identityRegistryAddress?: string | undefined;
     validationRegistryAddress?: string | undefined;
     reputationEnabled?: boolean | undefined;
+    spendCaps?: Record<string, number> | undefined;
+    solverPlugins?: {
+        blockedCids?: string[] | undefined;
+    } | undefined;
 }>;
-/** JinnConfig with rpcUrl guaranteed to be resolved (never undefined) and tasks with id always assigned. */
-export type JinnConfig = Omit<z.infer<typeof JinnConfigSchema>, 'rpcUrl' | 'tasks' | 'engine'> & {
+/**
+ * JinnConfig with rpcUrl guaranteed to be resolved (never undefined) and tasks
+ * with id always assigned.
+ *
+ * `rpcUrl` is the head of the fallback chain (the slot-0 URL) and is kept as
+ * a `string` for display continuity — the ~30 places that log/display
+ * `config.rpcUrl` (provenance, error formatting, `[main] daemon starting on …`)
+ * keep working unchanged. The full chain lives in `rpcUrls: readonly string[]`,
+ * which is what `buildFallbackTransport()` consumes. Same shape for the L1
+ * (ethereum) and optional archive/proof variants.
+ */
+export type JinnConfig = Omit<z.infer<typeof JinnConfigSchema>, 'rpcUrl' | 'archiveRpcUrl' | 'l2ProofRpcUrl' | 'ethereumRpcUrl' | 'ethereumArchiveRpcUrl' | 'tasks' | 'engine'> & {
     rpcUrl: string;
+    rpcUrls: readonly string[];
+    archiveRpcUrl?: string;
+    archiveRpcUrls?: readonly string[];
+    l2ProofRpcUrl?: string;
+    l2ProofRpcUrls?: readonly string[];
+    ethereumRpcUrl?: string;
+    ethereumRpcUrls?: readonly string[];
+    ethereumArchiveRpcUrl?: string;
+    ethereumArchiveRpcUrls?: readonly string[];
     tasks: Task[];
     engine: {
         workingDirRoot: string;
@@ -2282,12 +2228,40 @@ export declare const DEFAULT_CONFIG_PATH: string;
  */
 export declare const DEFAULT_TESTNET_DISCOVERY_URL = "https://jinn-indexer-production.up.railway.app";
 export declare const DEFAULT_TESTNET_ETHEREUM_RPC_URL = "https://ethereum-sepolia-rpc.publicnode.com";
+/**
+ * Default fallback chain for the L2 measurement chain (Base Sepolia) on
+ * testnet. Per AC2 of issue #592:
+ *   slot 0 — `https://base-sepolia.publicnode.com` (no-auth, 50k-block
+ *     getLogs cap, no shared-quota cliff).
+ *   slot 1 — `https://sepolia.base.org` (free public Coinbase endpoint,
+ *     2k-block cap; last-resort backup).
+ * Operators are encouraged to prepend a paid primary key (Alchemy, Tenderly,
+ * etc.) via `rpcUrl` config or `JINN_RPC_URL` / `BASE_SEPOLIA_RPC_URL` env.
+ */
+export declare const DEFAULT_TESTNET_RPC_URLS: readonly string[];
 export type ConfigLoadErrorCode = 'config_file_not_found' | 'config_json_invalid' | 'tasks_file_not_found' | 'tasks_json_invalid' | 'config_invalid';
 export declare class ConfigLoadError extends Error {
     readonly code: ConfigLoadErrorCode;
     readonly details?: Record<string, unknown>;
     constructor(code: ConfigLoadErrorCode, message: string, details?: Record<string, unknown>);
 }
+/**
+ * Translate any legacy short-name-keyed `solverNets` block on the raw parsed
+ * config into manifest-keyed `joinedSolverNets` entries with synthetic
+ * `legacy:<short-name>` keys.
+ *
+ * This is the auto-migration path for operators upgrading past issue #421.
+ * The runtime claim filter remains manifest-digest gated, so synthetic-keyed
+ * entries don't change task eligibility — they exist purely so the diagnostic
+ * surfaces (Overview SOLVING-ON eyebrow, prediction-operator-status) keep
+ * showing the operator's previous SolverNets until they re-join via the SPA.
+ *
+ * Returns the number of legacy entries migrated. Idempotent — calling on an
+ * already-migrated raw config is a no-op.
+ *
+ * @param raw — the JSON-parsed config file contents (mutated in place).
+ */
+export declare function migrateLegacySolverNets(raw: Record<string, unknown>): number;
 /**
  * Load config with resolution: env > config file > defaults.
  *