@jinn-network/client 0.1.8 → 0.1.9-canary.02befda9

package/dist/daemon/jinn-claim-loop-mock.js

@@ -1,122 +0,0 @@
-/**
- * MockMessenger submission path for the cross-chain JINN claim loop.
- *
- * Used when `jinnMessengerMode === 'mock'` — primarily for testnet burn-in
- * (Phase D / r5z) when canonical OP-Stack finality is impractical and CI.
- * The daemon's wallet must be the MockMessenger's owner during burn-in;
- * `setFixture` is `onlyOwner`.
- *
- * Flow:
- *   1. Read the latest ClaimTicket event from the TaskClaimEmitter on L2.
- *   2. Plant the matching fixture on the L1 MockMessenger via `setFixture`.
- *   3. Submit `JinnDistributor.claim(abi.encode(claimId))`.
- *
- * The MockMessenger encodes the proof as `abi.encode(uint256 claimId)` —
- * the messenger looks up the planted snapshot fixture and returns it. The
- * distributor's per-service accumulator handles replay; resubmitting the
- * same `proof` mints zero on the second call.
- */
-import { decodeEventLog, encodeAbiParameters, } from 'viem';
-import { CLAIM_TICKET_TOPIC0, JINN_CLAIM_EMITTER_ABI, JINN_DISTRIBUTOR_ABI, MOCK_MESSENGER_ABI, } from '../earning/contracts.js';
-/**
- * Read the latest ClaimTicket emitted by `claimEmitter` for the given
- * `serviceId`, optionally bounded to a recent block range. Returns null when
- * no matching event exists.
- */
-export async function fetchLatestClaimTicket(l2Client, claimEmitter, serviceId, options = {}) {
-    const fromBlock = options.fromBlock ?? 0n;
-    const toBlock = options.toBlock ?? 'latest';
-    const logs = await l2Client.getLogs({
-        address: claimEmitter,
-        event: JINN_CLAIM_EMITTER_ABI[0],
-        args: { serviceId },
-        fromBlock,
-        toBlock,
-    });
-    if (logs.length === 0)
-        return null;
-    // Sort by blockNumber, logIndex; the last one is the latest.
-    logs.sort((a, b) => {
-        const aBn = a.blockNumber ?? 0n;
-        const bBn = b.blockNumber ?? 0n;
-        if (aBn === bBn)
-            return (a.logIndex ?? 0) - (b.logIndex ?? 0);
-        return aBn < bBn ? -1 : 1;
-    });
-    const latest = logs[logs.length - 1];
-    const decoded = decodeEventLog({
-        abi: JINN_CLAIM_EMITTER_ABI,
-        data: latest.data,
-        topics: latest.topics,
-        eventName: 'ClaimTicket',
-    });
-    const args = decoded.args;
-    return {
-        claimId: args.claimId,
-        serviceId: args.serviceId,
-        taskCreationWeight: args.taskCreationWeight,
-        solutionDeliveryWeight: args.solutionDeliveryWeight,
-        verdictDeliveryWeight: args.verdictDeliveryWeight,
-        multisig: args.multisig,
-        claimer: args.claimer,
-        emitTxHash: latest.transactionHash ?? '0x',
-        emitBlockNumber: latest.blockNumber ?? 0n,
-    };
-}
-/**
- * Plant a fixture on the L1 MockMessenger that mirrors the L2 ClaimTicket
- * snapshot exactly. The daemon's L1 wallet must be the MockMessenger's
- * owner. Returns the L1 tx hash.
- */
-export async function plantMockFixture(l1Client, l1Wallet, messenger, snapshot) {
-    const account = l1Wallet.account;
-    if (!account)
-        throw new Error('L1 wallet has no account configured');
-    const { request } = await l1Client.simulateContract({
-        address: messenger,
-        abi: MOCK_MESSENGER_ABI,
-        functionName: 'setFixture',
-        args: [
-            snapshot.claimId,
-            {
-                serviceId: snapshot.serviceId,
-                taskCreationWeight: snapshot.taskCreationWeight,
-                solutionDeliveryWeight: snapshot.solutionDeliveryWeight,
-                verdictDeliveryWeight: snapshot.verdictDeliveryWeight,
-                multisig: snapshot.multisig,
-            },
-        ],
-        account,
-    });
-    return l1Wallet.writeContract(request);
-}
-/**
- * Encode the MockMessenger proof: `abi.encode(uint256 claimId)`. The
- * messenger looks up the previously planted fixture by claimId.
- */
-export function encodeMockProof(claimId) {
-    return encodeAbiParameters([{ type: 'uint256' }], [claimId]);
-}
-/**
- * Submit `JinnDistributor.claim(proof)` on L1. Returns the L1 tx hash.
- *
- * Idempotent at the contract layer — the distributor's per-service
- * accumulator clamps repeated submissions to zero mint.
- */
-export async function submitMockClaim(l1Client, l1Wallet, distributor, claimId) {
-    const account = l1Wallet.account;
-    if (!account)
-        throw new Error('L1 wallet has no account configured');
-    const proof = encodeMockProof(claimId);
-    const { request } = await l1Client.simulateContract({
-        address: distributor,
-        abi: JINN_DISTRIBUTOR_ABI,
-        functionName: 'claim',
-        args: [proof],
-        account,
-    });
-    return l1Wallet.writeContract(request);
-}
-// Re-export for tests that want to assert on the topic0 directly.
-export { CLAIM_TICKET_TOPIC0 };
-//# sourceMappingURL=jinn-claim-loop-mock.js.map

package/dist/daemon/jinn-claim-loop-mock.js.map

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

package/dist/daemon/jinn-claim-loop-wiring.d.ts

@@ -1,33 +0,0 @@
-import type { Address, PublicClient, WalletClient } from 'viem';
-import type { JinnMviConfig } from '../earning/contracts.js';
-import type { FleetStateStore } from '../earning/store.js';
-import type { JinnOnchainNetwork } from '../earning/viem-clients.js';
-import type { Store } from '../store/store.js';
-import type { JinnClaimLoopConfig, JinnClaimSubmissionMode, JinnMessengerMode } from './jinn-claim-loop.js';
-export interface JinnClaimL1ClientBundle {
-    public: PublicClient;
-    wallet: WalletClient;
-}
-export declare function shouldWireJinnClaimL1Signer(args: {
-    enabled: boolean;
-    intervalMs: number;
-    submissionMode: JinnClaimSubmissionMode;
-    distributorAddress?: string;
-    ethereumRpcUrl?: string;
-}): boolean;
-export declare function buildJinnClaimLoopConfig(args: {
-    enabled: boolean;
-    intervalMs: number;
-    submissionMode: JinnClaimSubmissionMode;
-    messengerMode: JinnMessengerMode;
-    mvi: Pick<JinnMviConfig, 'claimEmitter' | 'distributor' | 'messenger'>;
-    l2Client: PublicClient;
-    l2ProofClient?: PublicClient;
-    l2Wallet: WalletClient;
-    l1Clients?: JinnClaimL1ClientBundle;
-    store: FleetStateStore;
-    chain: JinnOnchainNetwork;
-    optimismPortalAddress?: Address;
-    disputeGameFactoryAddress?: Address;
-    jinnStore?: Store;
-}): JinnClaimLoopConfig | undefined;

package/dist/daemon/jinn-claim-loop-wiring.js

@@ -1,40 +0,0 @@
-export function shouldWireJinnClaimL1Signer(args) {
-    return (args.enabled &&
-        args.intervalMs > 0 &&
-        args.submissionMode === 'submit' &&
-        !!args.distributorAddress &&
-        !!args.ethereumRpcUrl);
-}
-export function buildJinnClaimLoopConfig(args) {
-    if (!args.enabled || args.intervalMs <= 0 || !args.mvi.claimEmitter) {
-        return undefined;
-    }
-    const base = {
-        intervalMs: args.intervalMs,
-        submissionMode: args.submissionMode,
-        l2Client: args.l2Client,
-        l2ProofClient: args.l2ProofClient,
-        l2Wallet: args.l2Wallet,
-        store: args.store,
-        chain: args.chain,
-        claimEmitterAddress: args.mvi.claimEmitter,
-        messengerMode: args.messengerMode,
-        optimismPortalAddress: args.optimismPortalAddress,
-        disputeGameFactoryAddress: args.disputeGameFactoryAddress,
-        jinnStore: args.jinnStore,
-    };
-    if (args.submissionMode === 'emit-only') {
-        return base;
-    }
-    if (!args.l1Clients || !args.mvi.distributor || !args.mvi.messenger) {
-        return undefined;
-    }
-    return {
-        ...base,
-        l1Client: args.l1Clients.public,
-        l1Wallet: args.l1Clients.wallet,
-        distributorAddress: args.mvi.distributor,
-        messengerAddress: args.mvi.messenger,
-    };
-}
-//# sourceMappingURL=jinn-claim-loop-wiring.js.map

package/dist/daemon/jinn-claim-loop-wiring.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"jinn-claim-loop-wiring.js","sourceRoot":"","sources":["../../src/daemon/jinn-claim-loop-wiring.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,2BAA2B,CAAC,IAM3C;IACC,OAAO,CACL,IAAI,CAAC,OAAO;QACZ,IAAI,CAAC,UAAU,GAAG,CAAC;QACnB,IAAI,CAAC,cAAc,KAAK,QAAQ;QAChC,CAAC,CAAC,IAAI,CAAC,kBAAkB;QACzB,CAAC,CAAC,IAAI,CAAC,cAAc,CACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAexC;IACC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QACpE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,GAAG;QACX,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,mBAAmB,EAAE,IAAI,CAAC,GAAG,CAAC,YAAuB;QACrD,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;QACjD,yBAAyB,EAAE,IAAI,CAAC,yBAAyB;QACzD,SAAS,EAAE,IAAI,CAAC,SAAS;KACmC,CAAC;IAE/D,IAAI,IAAI,CAAC,cAAc,KAAK,WAAW,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACpE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,GAAG,IAAI;QACP,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM;QAC/B,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM;QAC/B,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,WAAsB;QACnD,gBAAgB,EAAE,IAAI,CAAC,GAAG,CAAC,SAAoB;KAChD,CAAC;AACJ,CAAC"}

package/dist/daemon/jinn-claim-loop.d.ts

@@ -1,130 +0,0 @@
-/**
- * Cross-chain JINN claim loop (Phase B / jinn-mono-7x5).
- *
- * Orchestrates the two-tx flow that turns on-chain protocol work on L2 into
- * JINN mints on L1:
- *
- *   1. Step A — emit on Base. Call `TaskClaimEmitter.emitClaim(serviceId)`
- *      on Base / Base Sepolia. The event records the three counters
- *      (`taskCreationWeight`, `solutionDeliveryWeight`, `verdictDeliveryWeight`)
- *      atomically at one block.
- *   2. Step B — wait for finality. In `canonical` mode, wait for the
- *      OP dispute game to resolve and portal finality to elapse, then build
- *      the OP-Stack storage proof. In `mock` mode, plant the matching fixture on the L1
- *      MockMessenger.
- *   3. Step C — submit on L1. Call `JinnDistributor.claim(proof)` on
- *      Sepolia / Ethereum. The distributor verifies, applies channel
- *      weights, and mints to the operator multisig + DAO Timelock.
- *
- * The loop is disabled unless the operator explicitly enables it. Each tick
- * iterates over staked services in the FleetStateStore. Failures are logged
- * and surfaced via `tick_error` observability events; they don't crash the
- * daemon. Replay protection lives entirely in the distributor's accumulators
- * — repeated submissions are no-ops on the second mint.
- *
- * Configuration: `jinnClaimLoopEnabled`, `jinnClaimLoopIntervalMs` (default
- * 1h), `jinnClaimSubmissionMode` (`emit-only` | `submit`),
- * `jinnMessengerMode` (`canonical` | `mock`). The `mock` submit path requires
- * the daemon's L1 wallet to be the MockMessenger's owner (set at deploy).
- *
- * Automated submit-mode `run()` / `runOnce()` **only execute mock-mode**
- * emit→fixture→claim. When `jinnMessengerMode === 'canonical'`, scheduled
- * submit ticks **skip** emitting: canonical OP-Stack finality is multi-day
- * (see R-1); operators should use mock for burn-in and run
- * `tsx scripts/verify-canonical-canary.ts` for verifier-only proofs after an
- * intentional L2 emit. Emit-only mode stops after the L2 ticket and can run
- * without L1 wiring.
- */
-import type { Address, Hex, PublicClient, WalletClient } from 'viem';
-import type { FleetStateStore } from '../earning/store.js';
-import type { Store } from '../store/store.js';
-export type JinnMessengerMode = 'canonical' | 'mock';
-export type JinnClaimSubmissionMode = 'emit-only' | 'submit';
-export interface JinnClaimLoopConfig {
-    intervalMs: number;
-    /** 'emit-only' records L2 tickets only; 'submit' continues to L1. */
-    submissionMode: JinnClaimSubmissionMode;
-    /** PublicClient bound to the L2 measurement chain (Base / Base Sepolia). */
-    l2Client: PublicClient;
-    /**
-     * Optional archive/proof RPC client for canonical mode. Historical
-     * `eth_getProof` at the dispute game's L2 block can require a stronger
-     * endpoint than the daemon's normal L2 RPC.
-     */
-    l2ProofClient?: PublicClient;
-    /** WalletClient bound to L2 — pays gas for `emitClaim`. */
-    l2Wallet: WalletClient;
-    /** PublicClient bound to the L1 governance chain (Ethereum / Sepolia). */
-    l1Client?: PublicClient;
-    /** WalletClient bound to L1 — pays gas for `setFixture` (mock) + `claim`. */
-    l1Wallet?: WalletClient;
-    /** Per-service state. We tick each service with a stake. */
-    store: FleetStateStore;
-    chain: 'base' | 'base-sepolia';
-    /** L2 TaskClaimEmitter address. Required. */
-    claimEmitterAddress: Address;
-    /** L1 JinnDistributor address. Required. */
-    distributorAddress?: Address;
-    /** L1 messenger address. Required (MockMessenger or CanonicalOpStackMessenger). */
-    messengerAddress?: Address;
-    /** 'canonical' or 'mock'. Defaults to 'canonical'. */
-    messengerMode: JinnMessengerMode;
-    /** Canonical-mode only — L1 OptimismPortal2 anchoring L2 output roots. */
-    optimismPortalAddress?: Address;
-    /** Canonical-mode only — L1 DisputeGameFactory. */
-    disputeGameFactoryAddress?: Address;
-    /** Daemon observability sink. */
-    jinnStore?: Store;
-}
-export interface JinnClaimTickResult {
-    ticks: number;
-    emits: number;
-    submits: number;
-    errors: number;
-}
-/**
- * The orchestrator. One loop, one method per stage so they're individually
- * testable. Failures bubble to `runOnce` which records them and continues
- * to the next service — a single bad service must not stall the fleet.
- */
-export declare class JinnClaimLoop {
-    private readonly config;
-    private stopped;
-    constructor(config: JinnClaimLoopConfig);
-    stop(): void;
-    /**
-     * One tick: iterate the staked services and run emit → wait → submit for
-     * each. Returns counters useful for tests and operational dashboards.
-     */
-    runOnce(): Promise<JinnClaimTickResult>;
-    /**
-     * One service's full Step A → Step B → Step C run. Split out so tests
-     * can drive a single service end-to-end without the iteration scaffold.
-     */
-    tickService(args: {
-        serviceId: bigint;
-        displayIndex: number;
-        multisig: Address;
-    }, result: JinnClaimTickResult): Promise<void>;
-    /** Step A — `TaskClaimEmitter.emitClaim(serviceId)` on L2. */
-    emitOnL2(serviceId: bigint): Promise<Hex>;
-    /** Mock-mode Step B + C: read the L2 event, plant fixture on L1, claim. */
-    submitMock(args: {
-        serviceId: bigint;
-        emitTxHash: Hex;
-        multisig: Address;
-    }): Promise<Hex>;
-    /** Canonical-mode Step B + C: build OP-Stack proof, submit on L1. */
-    submitCanonical(args: {
-        serviceId: bigint;
-        emitTxHash: Hex;
-    }): Promise<Hex>;
-    /**
-     * Read the latest ClaimTicket for `serviceId` near `emitTxHash`. Bounded
-     * to the emit block to avoid scanning the full chain on every tick.
-     */
-    private readSnapshot;
-    private requireL1SubmitConfig;
-    /** Loop forever, sleeping `intervalMs` between ticks. */
-    run(): Promise<void>;
-}

package/dist/daemon/jinn-claim-loop.js

@@ -1,328 +0,0 @@
-/**
- * Cross-chain JINN claim loop (Phase B / jinn-mono-7x5).
- *
- * Orchestrates the two-tx flow that turns on-chain protocol work on L2 into
- * JINN mints on L1:
- *
- *   1. Step A — emit on Base. Call `TaskClaimEmitter.emitClaim(serviceId)`
- *      on Base / Base Sepolia. The event records the three counters
- *      (`taskCreationWeight`, `solutionDeliveryWeight`, `verdictDeliveryWeight`)
- *      atomically at one block.
- *   2. Step B — wait for finality. In `canonical` mode, wait for the
- *      OP dispute game to resolve and portal finality to elapse, then build
- *      the OP-Stack storage proof. In `mock` mode, plant the matching fixture on the L1
- *      MockMessenger.
- *   3. Step C — submit on L1. Call `JinnDistributor.claim(proof)` on
- *      Sepolia / Ethereum. The distributor verifies, applies channel
- *      weights, and mints to the operator multisig + DAO Timelock.
- *
- * The loop is disabled unless the operator explicitly enables it. Each tick
- * iterates over staked services in the FleetStateStore. Failures are logged
- * and surfaced via `tick_error` observability events; they don't crash the
- * daemon. Replay protection lives entirely in the distributor's accumulators
- * — repeated submissions are no-ops on the second mint.
- *
- * Configuration: `jinnClaimLoopEnabled`, `jinnClaimLoopIntervalMs` (default
- * 1h), `jinnClaimSubmissionMode` (`emit-only` | `submit`),
- * `jinnMessengerMode` (`canonical` | `mock`). The `mock` submit path requires
- * the daemon's L1 wallet to be the MockMessenger's owner (set at deploy).
- *
- * Automated submit-mode `run()` / `runOnce()` **only execute mock-mode**
- * emit→fixture→claim. When `jinnMessengerMode === 'canonical'`, scheduled
- * submit ticks **skip** emitting: canonical OP-Stack finality is multi-day
- * (see R-1); operators should use mock for burn-in and run
- * `tsx scripts/verify-canonical-canary.ts` for verifier-only proofs after an
- * intentional L2 emit. Emit-only mode stops after the L2 ticket and can run
- * without L1 wiring.
- */
-import { encodeFunctionData, getAddress } from 'viem';
-import { isOperationalServiceStep } from '../earning/types.js';
-import { base, baseSepolia } from 'viem/chains';
-import { emitEvent } from '../observability/emit-event.js';
-import { displayFleetServiceIndex } from '../earning/fleet-display-index.js';
-import { viemSendTransactionWithRetry, waitForTransactionReceiptWithRetry } from '../tx-retry.js';
-import { CLAIM_TICKET_TOPIC0, JINN_CLAIM_EMITTER_ABI } from '../earning/contracts.js';
-import { fetchLatestClaimTicket, plantMockFixture, submitMockClaim, } from './jinn-claim-loop-mock.js';
-import { buildCanonicalProof, decodeClaimTicketFromReceipt, verifyCanonicalClaimCanary, } from './jinn-claim-loop-canonical.js';
-/**
- * The orchestrator. One loop, one method per stage so they're individually
- * testable. Failures bubble to `runOnce` which records them and continues
- * to the next service — a single bad service must not stall the fleet.
- */
-export class JinnClaimLoop {
-    config;
-    stopped = false;
-    constructor(config) {
-        this.config = config;
-    }
-    stop() {
-        this.stopped = true;
-    }
-    /**
-     * One tick: iterate the staked services and run emit → wait → submit for
-     * each. Returns counters useful for tests and operational dashboards.
-     */
-    async runOnce() {
-        const result = { ticks: 0, emits: 0, submits: 0, errors: 0 };
-        // Spec / Phase D: MockMessenger drives automated Sepolia burn-in; canonical
-        // submit verification is verifier-only and must not spam emitClaim each
-        // interval. Emit-only mode intentionally stops after recording the L2
-        // ticket, so it is allowed to run with any messenger mode.
-        if (this.config.submissionMode === 'submit' && this.config.messengerMode === 'canonical') {
-            const detail = '[jinn-claim] Automated runOnce skips messengerMode=canonical (multi-day OP finality). ' +
-                'Set jinnMessengerMode=mock for Sepolia burn-in, or run `tsx scripts/verify-canonical-canary.ts` ' +
-                'after finality with an existing L2 ClaimTicket tx.';
-            console.warn(detail);
-            if (this.config.jinnStore) {
-                emitEvent(this.config.jinnStore, {
-                    kind: 'jinn_claim_canonical_skip',
-                    outcome: 'warn',
-                    detail,
-                }, 'jinn-claim');
-            }
-            return result;
-        }
-        const state = await this.config.store.load(this.config.chain);
-        for (const svc of state.services) {
-            if (this.stopped)
-                break;
-            // Only services with a multisig + service id are eligible.
-            if (!isOperationalServiceStep(svc.step) && svc.step !== 'mech_deployed')
-                continue;
-            if (svc.service_id == null || !svc.safe_address)
-                continue;
-            const displayIndex = displayFleetServiceIndex(svc);
-            result.ticks++;
-            try {
-                await this.tickService({
-                    serviceId: BigInt(svc.service_id),
-                    displayIndex,
-                    multisig: getAddress(svc.safe_address),
-                }, result);
-            }
-            catch (err) {
-                result.errors++;
-                const detail = err instanceof Error ? err.message : String(err);
-                console.error(`[jinn-claim] Service ${svc.service_id}: ${detail}`);
-                if (this.config.jinnStore) {
-                    emitEvent(this.config.jinnStore, {
-                        kind: 'tick_error',
-                        serviceIndex: displayIndex,
-                        outcome: 'failed',
-                        detail,
-                    }, 'jinn-claim');
-                }
-            }
-        }
-        return result;
-    }
-    /**
-     * One service's full Step A → Step B → Step C run. Split out so tests
-     * can drive a single service end-to-end without the iteration scaffold.
-     */
-    async tickService(args, result) {
-        const { serviceId, displayIndex, multisig } = args;
-        // Step A — emit ClaimTicket on L2.
-        const emitTxHash = await this.emitOnL2(serviceId);
-        result.emits++;
-        if (this.config.jinnStore) {
-            emitEvent(this.config.jinnStore, {
-                kind: 'jinn_claim_emitted',
-                serviceIndex: displayIndex,
-                txHash: emitTxHash,
-                outcome: 'ok',
-                detail: `Emitted ClaimTicket for service ${serviceId}`,
-            }, 'jinn-claim');
-        }
-        if (this.config.submissionMode === 'emit-only') {
-            const snapshot = await this.readSnapshot(serviceId, emitTxHash);
-            if (snapshot.multisig.toLowerCase() !== multisig.toLowerCase()) {
-                throw new Error(`[jinn-claim] L2 ClaimTicket multisig ${snapshot.multisig} does not match ` +
-                    `service multisig ${multisig} — refusing to record emit-only ticket`);
-            }
-            const detail = `Recorded ClaimTicket claimId=${snapshot.claimId} service=${serviceId} ` +
-                `weights=${snapshot.taskCreationWeight}/${snapshot.solutionDeliveryWeight}/` +
-                `${snapshot.verdictDeliveryWeight}`;
-            console.log(`[jinn-claim] Service ${serviceId}: ${detail}`);
-            if (this.config.jinnStore) {
-                emitEvent(this.config.jinnStore, {
-                    kind: 'jinn_claim_ticket_recorded',
-                    serviceIndex: displayIndex,
-                    txHash: emitTxHash,
-                    outcome: 'ok',
-                    detail,
-                }, 'jinn-claim');
-            }
-            return;
-        }
-        // Step B + C — diverge by mode.
-        let submitTxHash;
-        if (this.config.messengerMode === 'mock') {
-            submitTxHash = await this.submitMock({
-                serviceId,
-                emitTxHash,
-                multisig,
-            });
-        }
-        else {
-            submitTxHash = await this.submitCanonical({
-                serviceId,
-                emitTxHash,
-            });
-        }
-        result.submits++;
-        if (this.config.jinnStore) {
-            emitEvent(this.config.jinnStore, {
-                kind: 'jinn_claim_submitted',
-                serviceIndex: displayIndex,
-                txHash: submitTxHash,
-                outcome: 'ok',
-                detail: `Submitted ${this.config.messengerMode} claim for service ${serviceId}`,
-            }, 'jinn-claim');
-        }
-    }
-    /** Step A — `TaskClaimEmitter.emitClaim(serviceId)` on L2. */
-    async emitOnL2(serviceId) {
-        const account = this.config.l2Wallet.account;
-        if (!account)
-            throw new Error('L2 wallet has no account configured');
-        // Pre-flight: surface a revert before we broadcast.
-        await this.config.l2Client.simulateContract({
-            address: this.config.claimEmitterAddress,
-            abi: JINN_CLAIM_EMITTER_ABI,
-            functionName: 'emitClaim',
-            args: [serviceId],
-            account,
-        });
-        // Broadcast through the shared per-EOA nonce ledger (issue #525). emitClaim
-        // is sent from the AGENT EOA — the same EOA the creator/claim/deliver Safe
-        // txs use. A raw `walletClient.writeContract` here auto-fills the nonce from
-        // `getTransactionCount(pending)` OUTSIDE the broadcast lock, so on testnet
-        // (where this loop is enabled by default and fires immediately at startup)
-        // it races the creator's first `createTask` and both pick the same nonce →
-        // "nonce too low". Routing via viemSendTransactionWithRetry serializes the
-        // nonce-read→broadcast against every other agent-EOA broadcaster.
-        const data = encodeFunctionData({
-            abi: JINN_CLAIM_EMITTER_ABI,
-            functionName: 'emitClaim',
-            args: [serviceId],
-        });
-        const hash = await viemSendTransactionWithRetry(this.config.l2Wallet, this.config.l2Client, {
-            account,
-            to: this.config.claimEmitterAddress,
-            data,
-        });
-        await waitForTransactionReceiptWithRetry(this.config.l2Client, hash);
-        return hash;
-    }
-    /** Mock-mode Step B + C: read the L2 event, plant fixture on L1, claim. */
-    async submitMock(args) {
-        const { l1Client, l1Wallet, messengerAddress, distributorAddress } = this.requireL1SubmitConfig();
-        const snapshot = await this.readSnapshot(args.serviceId, args.emitTxHash);
-        if (snapshot.multisig.toLowerCase() !== args.multisig.toLowerCase()) {
-            throw new Error(`[jinn-claim] L2 ClaimTicket multisig ${snapshot.multisig} does not match ` +
-                `service multisig ${args.multisig} — refusing to plant mock fixture`);
-        }
-        // Plant the fixture (daemon wallet must be MockMessenger.owner).
-        const fixtureTx = await plantMockFixture(l1Client, l1Wallet, messengerAddress, snapshot);
-        await waitForTransactionReceiptWithRetry(l1Client, fixtureTx);
-        // Submit the claim on L1.
-        const claimTx = await submitMockClaim(l1Client, l1Wallet, distributorAddress, snapshot.claimId);
-        await waitForTransactionReceiptWithRetry(l1Client, claimTx);
-        return claimTx;
-    }
-    /** Canonical-mode Step B + C: build OP-Stack proof, submit on L1. */
-    async submitCanonical(args) {
-        const { l1Client, messengerAddress } = this.requireL1SubmitConfig();
-        if (!this.config.optimismPortalAddress || !this.config.disputeGameFactoryAddress) {
-            throw new Error('[jinn-claim-loop] canonical mode requires optimismPortalAddress + disputeGameFactoryAddress');
-        }
-        // Use retrying helper for same reason as readSnapshot — RPC eventual consistency.
-        const receipt = await waitForTransactionReceiptWithRetry(this.config.l2Client, args.emitTxHash);
-        const claimLog = receipt.logs.find((log) => log.address.toLowerCase() === this.config.claimEmitterAddress.toLowerCase()
-            && log.topics[0]?.toLowerCase() === CLAIM_TICKET_TOPIC0.toLowerCase());
-        if (!claimLog) {
-            throw new Error(`[jinn-claim-loop] no ClaimTicket log in receipt ${args.emitTxHash}`);
-        }
-        const snapshot = decodeClaimTicketFromReceipt(receipt.logs, this.config.claimEmitterAddress, claimLog.logIndex ?? 0);
-        const result = await buildCanonicalProof({
-            l1Client,
-            l2ProofClient: this.config.l2ProofClient ?? this.config.l2Client,
-            targetChain: this.config.chain === 'base-sepolia' ? baseSepolia : base,
-            optimismPortal: this.config.optimismPortalAddress,
-            disputeGameFactory: this.config.disputeGameFactoryAddress,
-            claimEmitter: this.config.claimEmitterAddress,
-        }, { snapshot, l2BlockNumber: receipt.blockNumber });
-        await verifyCanonicalClaimCanary(l1Client, messengerAddress, result.proof);
-        // Verifier-only canary path: no L1 transaction submitted; return the L2 emit tx.
-        return args.emitTxHash;
-    }
-    /**
-     * Read the latest ClaimTicket for `serviceId` near `emitTxHash`. Bounded
-     * to the emit block to avoid scanning the full chain on every tick.
-     */
-    async readSnapshot(serviceId, emitTxHash) {
-        // Use the retrying helper because Tenderly's L2 RPC is load-balanced and
-        // can return "receipt not found" briefly after the tx lands when the
-        // request hits a backend that hasn't propagated the receipt yet.
-        const receipt = await waitForTransactionReceiptWithRetry(this.config.l2Client, emitTxHash);
-        const claimLog = receipt.logs.find((log) => log.address.toLowerCase() === this.config.claimEmitterAddress.toLowerCase()
-            && log.topics[0]?.toLowerCase() === CLAIM_TICKET_TOPIC0.toLowerCase());
-        if (claimLog) {
-            const snapshot = decodeClaimTicketFromReceipt(receipt.logs, this.config.claimEmitterAddress, claimLog.logIndex ?? 0);
-            if (snapshot.serviceId !== serviceId) {
-                throw new Error(`[jinn-claim] ClaimTicket service ${snapshot.serviceId} does not match expected service ${serviceId}`);
-            }
-            return {
-                ...snapshot,
-                emitTxHash,
-                emitBlockNumber: receipt.blockNumber,
-            };
-        }
-        // Search a small window around the emit block.
-        const fromBlock = receipt.blockNumber > 5n ? receipt.blockNumber - 5n : 0n;
-        const snapshot = await fetchLatestClaimTicket(this.config.l2Client, this.config.claimEmitterAddress, serviceId, { fromBlock, toBlock: 'latest' });
-        if (!snapshot) {
-            throw new Error(`[jinn-claim] no ClaimTicket event for service ${serviceId} near tx ${emitTxHash}`);
-        }
-        return snapshot;
-    }
-    requireL1SubmitConfig() {
-        if (!this.config.l1Client ||
-            !this.config.l1Wallet ||
-            !this.config.distributorAddress ||
-            !this.config.messengerAddress) {
-            throw new Error('[jinn-claim-loop] submit mode requires L1 client, L1 wallet, distributor, and messenger wiring');
-        }
-        return {
-            l1Client: this.config.l1Client,
-            l1Wallet: this.config.l1Wallet,
-            distributorAddress: this.config.distributorAddress,
-            messengerAddress: this.config.messengerAddress,
-        };
-    }
-    /** Loop forever, sleeping `intervalMs` between ticks. */
-    async run() {
-        if (this.config.intervalMs <= 0)
-            return;
-        while (!this.stopped) {
-            try {
-                await this.runOnce();
-            }
-            catch (err) {
-                const detail = err instanceof Error ? err.message : String(err);
-                console.error(`[jinn-claim] Tick failed (non-fatal): ${detail}`);
-                if (this.config.jinnStore) {
-                    emitEvent(this.config.jinnStore, {
-                        kind: 'tick_error',
-                        outcome: 'failed',
-                        detail,
-                    }, 'jinn-claim');
-                }
-            }
-            this.config.jinnStore?.setConfigValue('last_jinn_claim_tick_at', new Date().toISOString());
-            await new Promise((r) => setTimeout(r, this.config.intervalMs));
-        }
-    }
-}
-//# sourceMappingURL=jinn-claim-loop.js.map