@jinn-network/client 0.1.0-canary.adfd078d

package/dist/adapters/mech/adapter.js

@@ -0,0 +1,332 @@
+import { base, baseSepolia } from 'viem/chains';
+import { PermanentError } from '../../types/index.js';
+import { createClients } from './safe.js';
+import { buildDesiredStatePayload, buildResultPayload, uploadToIpfs, cidToDigestHex, fetchFromIpfs, parseDesiredStateFromPayload, } from './ipfs.js';
+import { submitRestorationJob, submitEvaluationJob, claimDelivery, getMechDeliveryRate, getTimeoutBounds, decodeMarketplaceRequestLogs, decodeDeliverLogs, callDeliverToMarketplace, scanRestorationJobs, scanEvaluationJobs, } from './contracts.js';
+import { MECH_MARKETPLACE_ABI } from './types.js';
+import { AcceptAllPolicy } from './claim-policy.js';
+import { withRecoverableRetry } from '../../tx-retry.js';
+import { computeEvidenceSimHash } from '../../earning/evidence-simhash.js';
+export class MechAdapter {
+    name = 'mech';
+    publicClient;
+    walletClient;
+    config;
+    stopped = false;
+    requestBlockCursor = 0n;
+    deliveryBlockCursor = 0n;
+    pendingEvaluations = new Map();
+    pendingEvaluationClaims = new Set();
+    // Restoration requests where claimDelivery succeeded but evaluation creation failed.
+    // Swept on each poll cycle so they don't require a new Deliver event.
+    claimedButNotEvaluated = new Set();
+    // Original desired states keyed by request ID (restoration and evaluation)
+    // so we can yield accurate desiredState in DeliveredResult
+    originalStates = new Map();
+    store;
+    claimPolicy;
+    constructor(config, store) {
+        this.config = config;
+        this.store = store;
+        this.claimPolicy = config.claimPolicy ?? new AcceptAllPolicy();
+    }
+    async initialize() {
+        const chain = this.config.chainId === 84532 ? baseSepolia : base;
+        const clients = createClients(this.config.rpcUrl, this.config.agentEoaPrivateKey, chain);
+        this.publicClient = clients.publicClient;
+        this.walletClient = clients.walletClient;
+        const blockNumber = await withRecoverableRetry(async () => this.publicClient.getBlockNumber(), {
+            onRetry: ({ attempt, message }) => {
+                console.error(`[mech] getBlockNumber retry ${attempt}: ${message}`);
+            },
+        });
+        this.requestBlockCursor = blockNumber;
+        this.deliveryBlockCursor = blockNumber;
+        // Recover pending state from on-chain events
+        if (this.store) {
+            await this.recoverPendingState(blockNumber);
+        }
+    }
+    async recoverPendingState(currentBlock) {
+        const fromBlock = this.store?.getLastProcessedBlock() ?? currentBlock;
+        if (fromBlock >= currentBlock)
+            return;
+        console.error(`[mech] Recovering pending state from block ${fromBlock} to ${currentBlock}`);
+        // Scan for restoration jobs this creator posted
+        const restorations = await scanRestorationJobs(this.publicClient, this.config.routerAddress, this.config.safeAddress, fromBlock, currentBlock);
+        // Scan for evaluation jobs this creator posted
+        const evaluations = await scanEvaluationJobs(this.publicClient, this.config.routerAddress, this.config.safeAddress, fromBlock, currentBlock);
+        // Build set of restoration IDs that already have evaluation jobs
+        const hasEvaluation = new Set(evaluations.map(e => e.restorationRequestId));
+        // Check each restoration's delivery status
+        for (const restoration of restorations) {
+            if (hasEvaluation.has(restoration.requestId)) {
+                // Evaluation already created — check if eval delivery needs claiming
+                const evalJob = evaluations.find(e => e.restorationRequestId === restoration.requestId);
+                if (evalJob) {
+                    const evalInfo = await this.publicClient.readContract({
+                        address: this.config.mechMarketplaceAddress,
+                        abi: MECH_MARKETPLACE_ABI,
+                        functionName: 'mapRequestIdInfos',
+                        args: [evalJob.requestId],
+                    });
+                    if (evalInfo[1] === '0x0000000000000000000000000000000000000000') {
+                        // Evaluation not yet delivered — track it
+                        this.pendingEvaluationClaims.add(evalJob.requestId);
+                    }
+                    // If delivered, fully complete — nothing to track
+                }
+                continue;
+            }
+            // No evaluation job yet — check delivery status
+            const info = await this.publicClient.readContract({
+                address: this.config.mechMarketplaceAddress,
+                abi: MECH_MARKETPLACE_ABI,
+                functionName: 'mapRequestIdInfos',
+                args: [restoration.requestId],
+            });
+            const deliveryMech = info[1];
+            if (deliveryMech === '0x0000000000000000000000000000000000000000') {
+                // Not delivered yet — track for evaluation after delivery
+                this.pendingEvaluations.set(restoration.requestId, {
+                    id: restoration.requestId,
+                    description: '', // Original description not available from events, but not needed for evaluation creation
+                });
+            }
+            else {
+                // Delivered but no evaluation — needs claim + evaluation creation
+                this.pendingEvaluations.set(restoration.requestId, {
+                    id: restoration.requestId,
+                    description: '',
+                });
+                this.claimedButNotEvaluated.add(restoration.requestId);
+            }
+        }
+        // Set delivery block cursor to scan from recovery point
+        this.deliveryBlockCursor = fromBlock;
+        const recovered = this.pendingEvaluations.size + this.pendingEvaluationClaims.size + this.claimedButNotEvaluated.size;
+        if (recovered > 0) {
+            console.error(`[mech] Recovered: ${this.pendingEvaluations.size} pending evaluations, ${this.pendingEvaluationClaims.size} pending eval claims, ${this.claimedButNotEvaluated.size} claimed but not evaluated`);
+        }
+    }
+    async postDesiredState(state) {
+        const restorationState = {
+            ...state,
+            type: state.type ?? 'restoration',
+            attemptId: state.attemptId,
+            attemptNumber: state.attemptNumber,
+        };
+        const restorationPayload = buildDesiredStatePayload(restorationState);
+        const restorationCid = await uploadToIpfs(this.config.ipfsRegistryUrl, restorationPayload);
+        const restorationDataHex = cidToDigestHex(restorationCid);
+        const deliveryRate = await getMechDeliveryRate(this.publicClient, this.config.mechContractAddress);
+        const { max: maxTimeout } = await getTimeoutBounds(this.publicClient, this.config.mechMarketplaceAddress);
+        const restorationRequestIds = await submitRestorationJob(this.publicClient, this.walletClient, this.config.safeAddress, this.config.routerAddress, this.config.mechContractAddress, restorationDataHex, deliveryRate, maxTimeout);
+        if (restorationRequestIds.length === 0) {
+            throw new PermanentError('No request IDs returned from router');
+        }
+        const restorationRequestId = restorationRequestIds[0];
+        // Store for evaluation creation after delivery is claimed
+        this.pendingEvaluations.set(restorationRequestId, state);
+        this.originalStates.set(restorationRequestId, { ...state, type: 'restoration' });
+        return restorationRequestId;
+    }
+    async *watchForRequests() {
+        while (!this.stopped) {
+            try {
+                const currentBlock = await this.publicClient.getBlockNumber();
+                if (currentBlock > this.requestBlockCursor) {
+                    const logs = await this.publicClient.getLogs({
+                        address: this.config.mechMarketplaceAddress,
+                        fromBlock: this.requestBlockCursor + 1n,
+                        toBlock: currentBlock,
+                    });
+                    this.requestBlockCursor = currentBlock;
+                    const decoded = decodeMarketplaceRequestLogs(logs);
+                    for (const { requestId, requestDataHex, priorityMech } of decoded) {
+                        if (!this.claimPolicy.shouldAccept({ requestId, requestDataHex, priorityMech })) {
+                            continue;
+                        }
+                        try {
+                            const digest = requestDataHex.startsWith('0x') ? requestDataHex.slice(2) : requestDataHex;
+                            const payload = await fetchFromIpfs(this.config.ipfsGatewayUrl, `f01551220${digest}`);
+                            const desiredState = parseDesiredStateFromPayload(payload);
+                            yield { requestId, desiredState };
+                        }
+                        catch (err) {
+                            console.error(`[mech] Failed to parse request ${requestId}:`, err);
+                        }
+                    }
+                }
+            }
+            catch (err) {
+                console.error('[mech] Error polling for requests:', err);
+            }
+            await new Promise(r => setTimeout(r, this.config.pollIntervalMs));
+        }
+    }
+    async claimRequest(requestId) {
+        const allowed = await this.claimPolicy.confirmClaim(requestId);
+        if (!allowed) {
+            throw new PermanentError(`Claim policy rejected request ${requestId}`);
+        }
+    }
+    async submitResult(requestId, result) {
+        const payload = buildResultPayload(requestId, result);
+        const cid = await uploadToIpfs(this.config.ipfsRegistryUrl, payload);
+        const deliveryDigest = cidToDigestHex(cid);
+        // Safe → AgentMech.deliverToMarketplace() → Marketplace.deliverMarketplace()
+        await callDeliverToMarketplace(this.publicClient, this.walletClient, this.config.safeAddress, this.config.mechContractAddress, [requestId], [deliveryDigest]);
+    }
+    async *watchForDeliveries() {
+        while (!this.stopped) {
+            try {
+                // Retry evaluation creation for claimed restorations that failed previously
+                for (const rid of [...this.claimedButNotEvaluated]) {
+                    await this.tryCreateEvaluationJob(rid);
+                }
+                const currentBlock = await this.publicClient.getBlockNumber();
+                if (currentBlock > this.deliveryBlockCursor) {
+                    const logs = await this.publicClient.getLogs({
+                        address: this.config.mechContractAddress,
+                        fromBlock: this.deliveryBlockCursor + 1n,
+                        toBlock: currentBlock,
+                    });
+                    this.deliveryBlockCursor = currentBlock;
+                    const decoded = decodeDeliverLogs(logs);
+                    for (const { requestId, deliveryDataHex, mechAddress } of decoded) {
+                        // Only claim deliveries for requests this client created
+                        const isOurs = this.pendingEvaluations.has(requestId) || this.pendingEvaluationClaims.has(requestId);
+                        if (!isOurs)
+                            continue;
+                        try {
+                            const variant = this.config.routerClaimDeliveryVariant;
+                            let evidenceHash;
+                            if (variant === 'v2' && this.pendingEvaluations.has(requestId)) {
+                                try {
+                                    const checkpoint = {
+                                        version: 1,
+                                        desiredStateHash: requestId,
+                                        toolCalls: [],
+                                        externalInteractions: [],
+                                        outcome: 'success',
+                                    };
+                                    evidenceHash = computeEvidenceSimHash(checkpoint);
+                                }
+                                catch (err) {
+                                    console.error(`[mech] Failed to compute evidence SimHash for ${requestId}:`, err);
+                                }
+                            }
+                            await claimDelivery(this.publicClient, this.walletClient, this.config.safeAddress, this.config.routerAddress, requestId, {
+                                variant,
+                                evidenceHash,
+                            });
+                        }
+                        catch (err) {
+                            const message = err instanceof Error ? err.message : String(err);
+                            if (message.includes('RequestNotFound')) {
+                                console.error(`[mech] claimDelivery skipped (not a router request): ${requestId}`);
+                                continue;
+                            }
+                            console.error(`[mech] claimDelivery failed for ${requestId}:`, err);
+                            // Don't remove from pending — will retry next poll
+                            continue;
+                        }
+                        // If this was a restoration delivery, fetch result and post the evaluation job
+                        if (this.pendingEvaluations.has(requestId)) {
+                            let restorationResultData;
+                            try {
+                                const digest = deliveryDataHex.startsWith('0x') ? deliveryDataHex.slice(2) : deliveryDataHex;
+                                const payload = await fetchFromIpfs(this.config.ipfsGatewayUrl, `f01551220${digest}`);
+                                restorationResultData = payload.data ?? JSON.stringify(payload);
+                            }
+                            catch (err) {
+                                console.error(`[mech] Failed to fetch restoration result for evaluation: ${requestId}`, err);
+                            }
+                            await this.tryCreateEvaluationJob(requestId, restorationResultData);
+                        }
+                        // If this was an evaluation delivery, just clear the tracking
+                        if (this.pendingEvaluationClaims.has(requestId)) {
+                            this.pendingEvaluationClaims.delete(requestId);
+                        }
+                        // Parse and yield the delivery result
+                        try {
+                            const deliveryDigest = deliveryDataHex.startsWith('0x') ? deliveryDataHex.slice(2) : deliveryDataHex;
+                            const resultPayload = await fetchFromIpfs(this.config.ipfsGatewayUrl, `f01551220${deliveryDigest}`);
+                            const restorationResult = {
+                                data: resultPayload.data ?? JSON.stringify(resultPayload),
+                                artifacts: resultPayload.artifacts,
+                            };
+                            // Use the original desired state — not the result payload
+                            const desiredState = this.originalStates.get(requestId) ?? {
+                                id: requestId,
+                                description: '',
+                            };
+                            yield {
+                                requestId,
+                                desiredState,
+                                result: restorationResult,
+                                deliveryMechAddress: mechAddress,
+                            };
+                            // Clean up after yielding
+                            this.originalStates.delete(requestId);
+                        }
+                        catch (err) {
+                            console.error(`[mech] Failed to parse delivery ${requestId}:`, err);
+                        }
+                    }
+                }
+            }
+            catch (err) {
+                console.error('[mech] Error polling for deliveries:', err);
+            }
+            // Persist block cursor for crash recovery
+            if (this.store && this.deliveryBlockCursor > 0n) {
+                this.store.setLastProcessedBlock(this.deliveryBlockCursor);
+            }
+            await new Promise(r => setTimeout(r, this.config.pollIntervalMs));
+        }
+    }
+    async tryCreateEvaluationJob(requestId, restorationResultData) {
+        if (!this.pendingEvaluations.has(requestId))
+            return;
+        const originalState = this.pendingEvaluations.get(requestId);
+        try {
+            const evaluationState = {
+                ...originalState,
+                type: 'evaluation',
+                restorationRequestId: requestId,
+                context: {
+                    ...originalState.context,
+                    ...(restorationResultData ? { restorationResult: restorationResultData } : {}),
+                },
+            };
+            const evaluationPayload = buildDesiredStatePayload(evaluationState);
+            const evaluationCid = await uploadToIpfs(this.config.ipfsRegistryUrl, evaluationPayload);
+            const evaluationDataHex = cidToDigestHex(evaluationCid);
+            const deliveryRate = await getMechDeliveryRate(this.publicClient, this.config.mechContractAddress);
+            const { max: maxTimeout } = await getTimeoutBounds(this.publicClient, this.config.mechMarketplaceAddress);
+            const evalRequestIds = await submitEvaluationJob(this.publicClient, this.walletClient, this.config.safeAddress, this.config.routerAddress, requestId, this.config.mechContractAddress, evaluationDataHex, deliveryRate, maxTimeout);
+            if (evalRequestIds.length > 0) {
+                this.pendingEvaluationClaims.add(evalRequestIds[0]);
+                // Copy original state to evaluation request ID so delivery can use it
+                const origState = this.originalStates.get(requestId);
+                if (origState) {
+                    this.originalStates.set(evalRequestIds[0], { ...origState, type: 'evaluation' });
+                }
+            }
+            // Success — clean up both tracking sets
+            this.pendingEvaluations.delete(requestId);
+            this.claimedButNotEvaluated.delete(requestId);
+        }
+        catch (err) {
+            console.error(`[mech] Failed to create evaluation job for ${requestId}:`, err);
+            // Track for retry on next poll cycle (doesn't require a new Deliver event)
+            this.claimedButNotEvaluated.add(requestId);
+        }
+    }
+    async stop() {
+        this.stopped = true;
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapters/mech/adapter.js.map

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

package/dist/adapters/mech/claim-policy.d.ts

@@ -0,0 +1,40 @@
+import type { Address, PublicClient, WalletClient } from 'viem';
+export interface RequestCandidate {
+    requestId: string;
+    requestDataHex: string;
+    priorityMech: string;
+}
+/**
+ * ClaimPolicy decides whether an operator should pick up a given request.
+ *
+ * Two-stage filtering:
+ * - shouldAccept(): sync pre-filter on event data (no RPC)
+ * - confirmClaim(): async check + claim attempt before runner starts work
+ */
+export interface ClaimPolicy {
+    shouldAccept(candidate: RequestCandidate): boolean;
+    confirmClaim(requestId: string): Promise<boolean>;
+}
+export declare class AcceptAllPolicy implements ClaimPolicy {
+    shouldAccept(_candidate: RequestCandidate): boolean;
+    confirmClaim(_requestId: string): Promise<boolean>;
+}
+export declare class PriorityWindowPolicy implements ClaimPolicy {
+    private readonly ourMechAddress;
+    private readonly publicClient;
+    private readonly marketplaceAddress;
+    constructor(ourMechAddress: Address, publicClient: PublicClient, marketplaceAddress: Address);
+    shouldAccept(candidate: RequestCandidate): boolean;
+    confirmClaim(requestId: string): Promise<boolean>;
+}
+export declare class OnChainClaimPolicy implements ClaimPolicy {
+    private readonly ourMechAddress;
+    private readonly publicClient;
+    private readonly walletClient;
+    private readonly safeAddress;
+    private readonly marketplaceAddress;
+    private readonly claimRegistryAddress;
+    constructor(ourMechAddress: Address, publicClient: PublicClient, walletClient: WalletClient, safeAddress: Address, marketplaceAddress: Address, claimRegistryAddress: Address);
+    shouldAccept(_candidate: RequestCandidate): boolean;
+    confirmClaim(requestId: string): Promise<boolean>;
+}

package/dist/adapters/mech/claim-policy.js

@@ -0,0 +1,104 @@
+import { MECH_MARKETPLACE_ABI } from './types.js';
+import { claimJob, getJobClaim } from './contracts.js';
+// ── AcceptAllPolicy ──────────────────────────────────────────────────────────
+export class AcceptAllPolicy {
+    shouldAccept(_candidate) {
+        return true;
+    }
+    async confirmClaim(_requestId) {
+        return true;
+    }
+}
+// ── PriorityWindowPolicy ─────────────────────────────────────────────────────
+const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+export class PriorityWindowPolicy {
+    ourMechAddress;
+    publicClient;
+    marketplaceAddress;
+    constructor(ourMechAddress, publicClient, marketplaceAddress) {
+        this.ourMechAddress = ourMechAddress;
+        this.publicClient = publicClient;
+        this.marketplaceAddress = marketplaceAddress;
+    }
+    shouldAccept(candidate) {
+        // Fast accept if we are the priority mech
+        if (candidate.priorityMech.toLowerCase() === this.ourMechAddress.toLowerCase()) {
+            return true;
+        }
+        // Let non-priority through — confirmClaim checks the window
+        return true;
+    }
+    async confirmClaim(requestId) {
+        const info = await this.publicClient.readContract({
+            address: this.marketplaceAddress,
+            abi: MECH_MARKETPLACE_ABI,
+            functionName: 'mapRequestIdInfos',
+            args: [requestId],
+        });
+        const [priorityMech, deliveryMech, , responseTimeout] = info;
+        // Already delivered — skip
+        if (deliveryMech !== ZERO_ADDRESS) {
+            return false;
+        }
+        // We are the priority mech — proceed
+        if (priorityMech.toLowerCase() === this.ourMechAddress.toLowerCase()) {
+            return true;
+        }
+        // Not our priority — only proceed if window expired
+        const block = await this.publicClient.getBlock();
+        return block.timestamp >= responseTimeout;
+    }
+}
+// ── OnChainClaimPolicy ───────────────────────────────────────────────────────
+export class OnChainClaimPolicy {
+    ourMechAddress;
+    publicClient;
+    walletClient;
+    safeAddress;
+    marketplaceAddress;
+    claimRegistryAddress;
+    constructor(ourMechAddress, publicClient, walletClient, safeAddress, marketplaceAddress, claimRegistryAddress) {
+        this.ourMechAddress = ourMechAddress;
+        this.publicClient = publicClient;
+        this.walletClient = walletClient;
+        this.safeAddress = safeAddress;
+        this.marketplaceAddress = marketplaceAddress;
+        this.claimRegistryAddress = claimRegistryAddress;
+    }
+    shouldAccept(_candidate) {
+        return true;
+    }
+    async confirmClaim(requestId) {
+        // 1. Check delivery status
+        const info = await this.publicClient.readContract({
+            address: this.marketplaceAddress,
+            abi: MECH_MARKETPLACE_ABI,
+            functionName: 'mapRequestIdInfos',
+            args: [requestId],
+        });
+        const [priorityMech, deliveryMech, , responseTimeout] = info;
+        if (deliveryMech !== ZERO_ADDRESS) {
+            return false; // Already delivered
+        }
+        // 2. Check priority window
+        const block = await this.publicClient.getBlock();
+        if (priorityMech.toLowerCase() !== this.ourMechAddress.toLowerCase()) {
+            if (block.timestamp < responseTimeout) {
+                return false; // Not our priority window yet
+            }
+        }
+        // 3. Check existing on-chain claim
+        const { claimer, expiresAt } = await getJobClaim(this.publicClient, this.claimRegistryAddress, requestId);
+        if (claimer !== ZERO_ADDRESS && expiresAt > 0n) {
+            // Active claim exists
+            if (claimer.toLowerCase() === this.safeAddress.toLowerCase()) {
+                return true; // We already claimed — idempotent
+            }
+            return false; // Someone else has an active claim
+        }
+        // 4. Claim on-chain via Safe tx
+        const txHash = await claimJob(this.publicClient, this.walletClient, this.safeAddress, this.claimRegistryAddress, requestId);
+        return txHash !== ''; // Empty string = claim failed (already claimed or ineligible)
+    }
+}
+//# sourceMappingURL=claim-policy.js.map

package/dist/adapters/mech/claim-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-policy.js","sourceRoot":"","sources":["../../../src/adapters/mech/claim-policy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAsBvD,gFAAgF;AAEhF,MAAM,OAAO,eAAe;IAC1B,YAAY,CAAC,UAA4B;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,UAAkB;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,gFAAgF;AAEhF,MAAM,YAAY,GAAG,4CAA4C,CAAC;AAElE,MAAM,OAAO,oBAAoB;IAEZ;IACA;IACA;IAHnB,YACmB,cAAuB,EACvB,YAA0B,EAC1B,kBAA2B;QAF3B,mBAAc,GAAd,cAAc,CAAS;QACvB,iBAAY,GAAZ,YAAY,CAAc;QAC1B,uBAAkB,GAAlB,kBAAkB,CAAS;IAC3C,CAAC;IAEJ,YAAY,CAAC,SAA2B;QACtC,0CAA0C;QAC1C,IAAI,SAAS,CAAC,YAAY,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,EAAE,CAAC;YAC/E,OAAO,IAAI,CAAC;QACd,CAAC;QACD,4DAA4D;QAC5D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,SAAiB;QAClC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC;YAChD,OAAO,EAAE,IAAI,CAAC,kBAAkB;YAChC,GAAG,EAAE,oBAAoB;YACzB,YAAY,EAAE,mBAAmB;YACjC,IAAI,EAAE,CAAC,SAAgB,CAAC;SACzB,CAAqD,CAAC;QAEvD,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,AAAD,EAAG,eAAe,CAAC,GAAG,IAAI,CAAC;QAE7D,2BAA2B;QAC3B,IAAI,YAAY,KAAK,YAAY,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,qCAAqC;QACrC,IAAI,YAAY,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,EAAE,CAAC;YACrE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,oDAAoD;QACpD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC,SAAS,IAAI,eAAe,CAAC;IAC5C,CAAC;CACF;AAED,gFAAgF;AAEhF,MAAM,OAAO,kBAAkB;IAEV;IACA;IACA;IACA;IACA;IACA;IANnB,YACmB,cAAuB,EACvB,YAA0B,EAC1B,YAA0B,EAC1B,WAAoB,EACpB,kBAA2B,EAC3B,oBAA6B;QAL7B,mBAAc,GAAd,cAAc,CAAS;QACvB,iBAAY,GAAZ,YAAY,CAAc;QAC1B,iBAAY,GAAZ,YAAY,CAAc;QAC1B,gBAAW,GAAX,WAAW,CAAS;QACpB,uBAAkB,GAAlB,kBAAkB,CAAS;QAC3B,yBAAoB,GAApB,oBAAoB,CAAS;IAC7C,CAAC;IAEJ,YAAY,CAAC,UAA4B;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,SAAiB;QAClC,2BAA2B;QAC3B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC;YAChD,OAAO,EAAE,IAAI,CAAC,kBAAkB;YAChC,GAAG,EAAE,oBAAoB;YACzB,YAAY,EAAE,mBAAmB;YACjC,IAAI,EAAE,CAAC,SAAgB,CAAC;SACzB,CAAqD,CAAC;QAEvD,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,AAAD,EAAG,eAAe,CAAC,GAAG,IAAI,CAAC;QAE7D,IAAI,YAAY,KAAK,YAAY,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC,CAAC,oBAAoB;QACpC,CAAC;QAED,2BAA2B;QAC3B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;QACjD,IAAI,YAAY,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,EAAE,CAAC;YACrE,IAAI,KAAK,CAAC,SAAS,GAAG,eAAe,EAAE,CAAC;gBACtC,OAAO,KAAK,CAAC,CAAC,8BAA8B;YAC9C,CAAC;QACH,CAAC;QAED,mCAAmC;QACnC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,WAAW,CAC9C,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,oBAAoB,EACzB,SAAgB,CACjB,CAAC;QAEF,IAAI,OAAO,KAAK,YAAY,IAAI,SAAS,GAAG,EAAE,EAAE,CAAC;YAC/C,sBAAsB;YACtB,IAAI,OAAO,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC7D,OAAO,IAAI,CAAC,CAAC,kCAAkC;YACjD,CAAC;YACD,OAAO,KAAK,CAAC,CAAC,mCAAmC;QACnD,CAAC;QAED,gCAAgC;QAChC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAC3B,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,oBAAoB,EACzB,SAAgB,CACjB,CAAC;QAEF,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC,8DAA8D;IACtF,CAAC;CACF"}

package/dist/adapters/mech/contracts.d.ts

@@ -0,0 +1,44 @@
+import { type Address, type Hex, type PublicClient, type WalletClient, type Log } from 'viem';
+export declare function submitRestorationJob(publicClient: PublicClient, walletClient: WalletClient, safeAddress: Address, routerAddress: Address, mechAddress: Address, requestDataHex: Hex, priceWei: bigint, responseTimeout: bigint): Promise<string[]>;
+export declare function submitEvaluationJob(publicClient: PublicClient, walletClient: WalletClient, safeAddress: Address, routerAddress: Address, restorationRequestId: Hex, mechAddress: Address, requestDataHex: Hex, priceWei: bigint, responseTimeout: bigint): Promise<string[]>;
+export interface ClaimDeliveryOptions {
+    variant: 'v1' | 'v2';
+    /** V2 only; ignored for V1. */
+    evidenceHash?: Hex;
+}
+export declare function claimDelivery(publicClient: PublicClient, walletClient: WalletClient, safeAddress: Address, routerAddress: Address, requestId: Hex, options: ClaimDeliveryOptions): Promise<Hex>;
+export declare function claimJob(publicClient: PublicClient, walletClient: WalletClient, safeAddress: Address, claimRegistryAddress: Address, requestId: Hex): Promise<string>;
+export declare function getJobClaim(publicClient: PublicClient, claimRegistryAddress: Address, requestId: Hex): Promise<{
+    claimer: Address;
+    expiresAt: bigint;
+}>;
+export declare function getMechDeliveryRate(publicClient: PublicClient, mechAddress: Address): Promise<bigint>;
+export declare function getTimeoutBounds(publicClient: PublicClient, marketplaceAddress: Address): Promise<{
+    min: bigint;
+    max: bigint;
+}>;
+export declare function pollDeliverEvents(publicClient: PublicClient, mechAddress: Address, fromBlock: bigint, toBlock: bigint): Promise<Log[]>;
+export interface RestorationJobRecord {
+    requestId: string;
+    creator: string;
+}
+export interface EvaluationJobRecord {
+    requestId: string;
+    restorationRequestId: string;
+    creator: string;
+}
+export declare function scanRestorationJobs(publicClient: PublicClient, routerAddress: Address, creator: Address, fromBlock: bigint, toBlock: bigint): Promise<RestorationJobRecord[]>;
+export declare function scanEvaluationJobs(publicClient: PublicClient, routerAddress: Address, creator: Address, fromBlock: bigint, toBlock: bigint): Promise<EvaluationJobRecord[]>;
+export interface DecodedMarketplaceRequest {
+    requestId: string;
+    requestDataHex: string;
+    priorityMech: string;
+}
+export declare function decodeMarketplaceRequestLogs(logs: Log[]): DecodedMarketplaceRequest[];
+export interface DecodedDeliverEvent {
+    requestId: string;
+    deliveryDataHex: string;
+    mechAddress: string;
+}
+export declare function decodeDeliverLogs(logs: Log[]): DecodedDeliverEvent[];
+export declare function callDeliverToMarketplace(publicClient: PublicClient, walletClient: WalletClient, safeAddress: Address, mechContractAddress: Address, requestIds: Hex[], datas: Hex[]): Promise<Hex>;