@jinn-network/client 0.1.2 → 0.1.3-canary.12cf8b76

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

@@ -0,0 +1,296 @@
+/**
+ * Canonical OP-Stack storage proof construction for the cross-chain JINN claim
+ * loop. Implements `jinnMessengerMode === 'canonical'`.
+ *
+ * The builder is intended for the verifier-only canary path during testnet
+ * burn-in. Active burn-in still uses MockMessenger; this module constructs
+ * the canonical proof blob so operators can call
+ * `CanonicalOpStackMessenger.verifyClaim` via `eth_call` after finality.
+ *
+ * The proof blob uses the locked ABI:
+ *
+ *        (
+ *          bytes32 disputeGameId,
+ *          bytes outputRootProof,
+ *          bytes[] accountProof,
+ *          bytes[] storageProof,
+ *          uint256 claimId,
+ *          uint256 serviceId,
+ *          uint256 taskCreationWeight,
+ *          uint256 solutionDeliveryWeight,
+ *          uint256 verdictDeliveryWeight,
+ *          address multisig
+ *        )
+ *
+ * The proof uses an account proof + storage proof for
+ * `TaskClaimEmitter.claimSnapshotHashes[claimId]` against the finalized L2
+ * state root. Events are discovery only; L1 canonical verification proves the
+ * stored snapshot hash.
+ *
+ * Tracked follow-up: bd `jinn-mono-7x5` Phase B-canonical.
+ */
+import { decodeEventLog, encodeAbiParameters, getAddress, keccak256, parseAbi, toHex, } from 'viem';
+import { getProof } from 'viem/actions';
+import { getGames } from 'viem/op-stack';
+import { CLAIM_MESSENGER_ABI, CLAIM_TICKET_TOPIC0, JINN_CLAIM_EMITTER_ABI, JINN_DISTRIBUTOR_ABI, } from '../earning/contracts.js';
+export const DISPUTE_GAME_FACTORY_ABI = parseAbi([
+    'function gameAtIndex(uint256) view returns (uint32 gameType_, uint64 timestamp_, address proxy_)',
+]);
+export const DISPUTE_GAME_ABI = parseAbi([
+    'function gameType() view returns (uint32)',
+    'function status() view returns (uint8)',
+    'function resolvedAt() view returns (uint64)',
+    'function rootClaim() view returns (bytes32)',
+    'function wasRespectedGameTypeWhenCreated() view returns (bool)',
+]);
+export const OPTIMISM_PORTAL_ABI = parseAbi([
+    'function respectedGameType() view returns (uint32)',
+    'function proofMaturityDelaySeconds() view returns (uint256)',
+    'function disputeGameFinalityDelaySeconds() view returns (uint256)',
+]);
+const OUTPUT_ROOT_PROOF_ABI = [
+    {
+        type: 'tuple',
+        components: [
+            { name: 'version', type: 'bytes32' },
+            { name: 'stateRoot', type: 'bytes32' },
+            { name: 'messagePasserStorageRoot', type: 'bytes32' },
+            { name: 'latestBlockHash', type: 'bytes32' },
+        ],
+    },
+];
+const CANONICAL_PROOF_ABI = [
+    { name: 'disputeGameId', type: 'bytes32' },
+    { name: 'outputRootProof', type: 'bytes' },
+    { name: 'accountProof', type: 'bytes[]' },
+    { name: 'storageProof', type: 'bytes[]' },
+    { name: 'claimId', type: 'uint256' },
+    { name: 'serviceId', type: 'uint256' },
+    { name: 'taskCreationWeight', type: 'uint256' },
+    { name: 'solutionDeliveryWeight', type: 'uint256' },
+    { name: 'verdictDeliveryWeight', type: 'uint256' },
+    { name: 'multisig', type: 'address' },
+];
+const GAME_STATUS_DEFENDER_WINS = 2;
+const CLAIM_SNAPSHOT_HASHES_SLOT = 1n;
+const OUTPUT_ROOT_VERSION = `0x${'0'.repeat(64)}`;
+const L2_TO_L1_MESSAGE_PASSER = '0x4200000000000000000000000000000000000016';
+/**
+ * Wait until the L2 emit transaction is finalized through the canonical
+ * OP-Stack pipeline (DisputeGame resolved + finality airgap elapsed) and
+ * construct the `bytes proof` blob accepted by CanonicalOpStackMessenger.
+ *
+ * This is deliberately one-shot: if no covering/resolved/finalized dispute
+ * game exists yet, it throws and the daemon retries on a later tick.
+ */
+export async function buildCanonicalProof(clients, inputs) {
+    const { snapshot, l2BlockNumber } = inputs;
+    const game = await selectCoveringDisputeGame(clients, l2BlockNumber);
+    await assertDisputeGameReady(clients, game);
+    const snapshotSlot = claimSnapshotStorageSlot(snapshot.claimId);
+    const [proofBlock, messagePasserProof, snapshotProof] = await Promise.all([
+        clients.l2ProofClient.getBlock({ blockNumber: game.l2BlockNumber }),
+        getProof(clients.l2ProofClient, {
+            address: L2_TO_L1_MESSAGE_PASSER,
+            storageKeys: [],
+            blockNumber: game.l2BlockNumber,
+        }),
+        getProof(clients.l2ProofClient, {
+            address: clients.claimEmitter,
+            storageKeys: [snapshotSlot],
+            blockNumber: game.l2BlockNumber,
+        }),
+    ]);
+    if (!proofBlock.hash)
+        throw new Error('[jinn-claim-loop] proof L2 block is missing hash');
+    const storageProof = snapshotProof.storageProof[0]?.proof;
+    if (!storageProof || storageProof.length === 0) {
+        throw new Error('[jinn-claim-loop] missing storage proof for claimSnapshotHashes[claimId]');
+    }
+    const outputRootProof = encodeAbiParameters(OUTPUT_ROOT_PROOF_ABI, [{
+            version: OUTPUT_ROOT_VERSION,
+            stateRoot: proofBlock.stateRoot,
+            messagePasserStorageRoot: messagePasserProof.storageHash,
+            latestBlockHash: proofBlock.hash,
+        }]);
+    const proof = encodeAbiParameters(CANONICAL_PROOF_ABI, [
+        toHex(game.index, { size: 32 }),
+        outputRootProof,
+        snapshotProof.accountProof,
+        storageProof,
+        snapshot.claimId,
+        snapshot.serviceId,
+        snapshot.taskCreationWeight,
+        snapshot.solutionDeliveryWeight,
+        snapshot.verdictDeliveryWeight,
+        snapshot.multisig,
+    ]);
+    return {
+        proof,
+        snapshot,
+        game,
+        proofBlockNumber: game.l2BlockNumber,
+    };
+}
+export function claimSnapshotStorageSlot(claimId) {
+    return keccak256(encodeAbiParameters([{ type: 'uint256' }, { type: 'uint256' }], [claimId, CLAIM_SNAPSHOT_HASHES_SLOT]));
+}
+export function decodeClaimTicketFromReceipt(logs, claimEmitter, logIndex) {
+    const expectedEmitter = claimEmitter.toLowerCase();
+    const expectedTopic = CLAIM_TICKET_TOPIC0.toLowerCase();
+    const log = logs.find((candidate) => candidate.address.toLowerCase() === expectedEmitter
+        && candidate.topics[0]?.toLowerCase() === expectedTopic
+        && (candidate.logIndex ?? 0) === logIndex);
+    if (!log) {
+        throw new Error(`[jinn-claim-loop] no ClaimTicket log at index ${logIndex}`);
+    }
+    const decoded = decodeEventLog({
+        abi: JINN_CLAIM_EMITTER_ABI,
+        eventName: 'ClaimTicket',
+        data: log.data,
+        topics: log.topics,
+    });
+    const args = decoded.args;
+    return {
+        claimId: args.claimId,
+        serviceId: args.serviceId,
+        taskCreationWeight: args.taskCreationWeight,
+        solutionDeliveryWeight: args.solutionDeliveryWeight,
+        verdictDeliveryWeight: args.verdictDeliveryWeight,
+        multisig: getAddress(args.multisig),
+        claimer: getAddress(args.claimer),
+    };
+}
+export async function selectCoveringDisputeGame(clients, l2BlockNumber) {
+    const games = await getGames(clients.l1Client, {
+        chain: null,
+        targetChain: clients.targetChain,
+        limit: 100,
+    });
+    const covering = games
+        .filter((game) => game.l2BlockNumber >= l2BlockNumber)
+        .sort((a, b) => (a.l2BlockNumber < b.l2BlockNumber ? -1 : 1))[0];
+    if (!covering) {
+        throw new Error(`[jinn-claim-loop] no OP dispute game covers L2 block ${l2BlockNumber}; retry later`);
+    }
+    const [factoryGameType, , proxy] = await clients.l1Client.readContract({
+        address: clients.disputeGameFactory,
+        abi: DISPUTE_GAME_FACTORY_ABI,
+        functionName: 'gameAtIndex',
+        args: [covering.index],
+    });
+    if (proxy === '0x0000000000000000000000000000000000000000') {
+        throw new Error(`[jinn-claim-loop] dispute game ${covering.index} has zero proxy`);
+    }
+    const [proxyGameType, rootClaim] = await Promise.all([
+        clients.l1Client.readContract({
+            address: proxy,
+            abi: DISPUTE_GAME_ABI,
+            functionName: 'gameType',
+        }),
+        clients.l1Client.readContract({
+            address: proxy,
+            abi: DISPUTE_GAME_ABI,
+            functionName: 'rootClaim',
+        }),
+    ]);
+    return {
+        index: covering.index,
+        l2BlockNumber: covering.l2BlockNumber,
+        proxy,
+        factoryGameType,
+        proxyGameType,
+        rootClaim,
+    };
+}
+export async function assertDisputeGameReady(clients, game) {
+    if (game.factoryGameType !== game.proxyGameType) {
+        throw new Error('[jinn-claim-loop] dispute game factory/proxy gameType mismatch');
+    }
+    const [respectedGameType, proofMaturityDelaySeconds, disputeGameFinalityDelaySeconds, status, resolvedAt, wasRespectedGameTypeWhenCreated, latestL1Block,] = await Promise.all([
+        clients.l1Client.readContract({
+            address: clients.optimismPortal,
+            abi: OPTIMISM_PORTAL_ABI,
+            functionName: 'respectedGameType',
+        }),
+        clients.l1Client.readContract({
+            address: clients.optimismPortal,
+            abi: OPTIMISM_PORTAL_ABI,
+            functionName: 'proofMaturityDelaySeconds',
+        }),
+        clients.l1Client.readContract({
+            address: clients.optimismPortal,
+            abi: OPTIMISM_PORTAL_ABI,
+            functionName: 'disputeGameFinalityDelaySeconds',
+        }),
+        clients.l1Client.readContract({
+            address: game.proxy,
+            abi: DISPUTE_GAME_ABI,
+            functionName: 'status',
+        }),
+        clients.l1Client.readContract({
+            address: game.proxy,
+            abi: DISPUTE_GAME_ABI,
+            functionName: 'resolvedAt',
+        }),
+        clients.l1Client.readContract({
+            address: game.proxy,
+            abi: DISPUTE_GAME_ABI,
+            functionName: 'wasRespectedGameTypeWhenCreated',
+        }),
+        clients.l1Client.getBlock({ blockTag: 'latest' }),
+    ]);
+    if (!wasRespectedGameTypeWhenCreated && game.proxyGameType !== respectedGameType) {
+        throw new Error('[jinn-claim-loop] dispute game was not portal-respected when created');
+    }
+    if (status !== GAME_STATUS_DEFENDER_WINS) {
+        throw new Error('[jinn-claim-loop] dispute game is not resolved DEFENDER_WINS');
+    }
+    const finalizedAt = BigInt(resolvedAt) +
+        maxBigInt(BigInt(proofMaturityDelaySeconds), BigInt(disputeGameFinalityDelaySeconds));
+    if (resolvedAt === 0n || latestL1Block.timestamp < finalizedAt) {
+        throw new Error('[jinn-claim-loop] dispute game finality airgap has not elapsed');
+    }
+}
+function maxBigInt(a, b) {
+    return a > b ? a : b;
+}
+/**
+ * Submit `JinnDistributor.claim(proof)` on L1 once a canonical proof has
+ * been constructed. Mirrors the mock-mode submission path; idempotent at
+ * the contract layer.
+ */
+export async function submitCanonicalClaim(l1Client, l1Wallet, distributor, proof) {
+    const account = l1Wallet.account;
+    if (!account)
+        throw new Error('[jinn-claim-loop] L1 wallet has no account configured');
+    const { request } = await l1Client.simulateContract({
+        address: distributor,
+        abi: JINN_DISTRIBUTOR_ABI,
+        functionName: 'claim',
+        args: [proof],
+        account,
+    });
+    return l1Wallet.writeContract(request);
+}
+/**
+ * Verifier-only canonical canary. This intentionally uses `eth_call`
+ * (`readContract`) against the messenger and does not submit
+ * `JinnDistributor.claim`. Burn-in keeps MockMessenger active.
+ */
+export async function verifyCanonicalClaimCanary(l1Client, messenger, proof) {
+    const [serviceId, taskCreationWeight, solutionDeliveryWeight, verdictDeliveryWeight, multisig,] = await l1Client.readContract({
+        address: messenger,
+        abi: CLAIM_MESSENGER_ABI,
+        functionName: 'verifyClaim',
+        args: [proof],
+    });
+    return {
+        serviceId,
+        taskCreationWeight,
+        solutionDeliveryWeight,
+        verdictDeliveryWeight,
+        multisig,
+    };
+}
+//# sourceMappingURL=jinn-claim-loop-canonical.js.map

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

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

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

@@ -0,0 +1,61 @@
+/**
+ * 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 { type Address, type Hex, type PublicClient, type WalletClient } from 'viem';
+import { CLAIM_TICKET_TOPIC0 } from '../earning/contracts.js';
+export interface MockClaimSnapshot {
+    claimId: bigint;
+    serviceId: bigint;
+    taskCreationWeight: bigint;
+    solutionDeliveryWeight: bigint;
+    verdictDeliveryWeight: bigint;
+    multisig: Address;
+    claimer: Address;
+    /** L2 transaction hash of the emitClaim. */
+    emitTxHash: Hex;
+    /** L2 block number containing emitClaim. */
+    emitBlockNumber: bigint;
+}
+/**
+ * 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 declare function fetchLatestClaimTicket(l2Client: PublicClient, claimEmitter: Address, serviceId: bigint, options?: {
+    fromBlock?: bigint;
+    toBlock?: bigint | 'latest';
+}): Promise<MockClaimSnapshot | null>;
+/**
+ * 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 declare function plantMockFixture(l1Client: PublicClient, l1Wallet: WalletClient, messenger: Address, snapshot: MockClaimSnapshot): Promise<Hex>;
+/**
+ * Encode the MockMessenger proof: `abi.encode(uint256 claimId)`. The
+ * messenger looks up the previously planted fixture by claimId.
+ */
+export declare function encodeMockProof(claimId: bigint): Hex;
+/**
+ * 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 declare function submitMockClaim(l1Client: PublicClient, l1Wallet: WalletClient, distributor: Address, claimId: bigint): Promise<Hex>;
+export { CLAIM_TICKET_TOPIC0 };

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

@@ -0,0 +1,122 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -0,0 +1,123 @@
+/**
+ * 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 when no `distributorAddress` is configured. 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: `jinnClaimLoopIntervalMs` (default 1h), `jinnMessengerMode`
+ * (`canonical` | `mock`). The `mock` path requires the daemon's L1 wallet to
+ * be the MockMessenger's owner (set at deploy).
+ *
+ * Automated `run()` / `runOnce()` **only execute mock-mode** emit→fixture→claim.
+ * When `jinnMessengerMode === 'canonical'`, scheduled 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.
+ */
+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 interface JinnClaimLoopConfig {
+    intervalMs: number;
+    /** 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;
+    /** Loop forever, sleeping `intervalMs` between ticks. */
+    run(): Promise<void>;
+}