@terkoizmy/intent-sdk 1.0.0

package/dist/solver/settlement/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/solver/settlement/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}

package/dist/solver/settlement/index.js

@@ -0,0 +1,7 @@
+/**
+ * Settlement Module — Barrel Export
+ */
+export * from "./proof-generator";
+export * from "./proof-verifier";
+export * from "./settlement-manager";
+//# sourceMappingURL=index.js.map

package/dist/solver/settlement/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/solver/settlement/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC"}

package/dist/solver/settlement/live-settlement-manager.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Viem-based Live Settlement Manager
+ *
+ * Phase E: Contract Deployment & Live Settlement
+ *
+ * This manager replaces the ethers.js-based SettlementManager for
+ * live, on-chain settlement flows. It uses the ViemSettlementContract
+ * to call claim() on the deployed IntentSettlement.sol.
+ *
+ * The lifecycle is:
+ *   1. Solver sends tokens on target chain → gets txHash (Phase C)
+ *   2. Call settleOnChain() → builds & broadcasts claim() tx on source chain
+ *   3. Parse IntentFilled event from receipt
+ *   4. Return settlement record
+ *
+ * Stage 3 — Phase E
+ */
+import type { Address, Hash } from "../../types/common";
+import { ViemSettlementContract } from "../contracts/intent-settlement/viem-settlement-contract";
+export interface LiveSettlementParams {
+    /** Unique identifier for this intent */
+    intentId: string;
+    /** Address of the user who initiated the order */
+    swapper: Address;
+    /** Token address on the source chain */
+    token: Address;
+    /** Amount in token's smallest unit */
+    amount: bigint;
+    /** Recipient on target chain */
+    recipient: Address;
+    /** Nonce used in the original order */
+    nonce: bigint;
+    /** Origin chain (source chain where funds are locked) */
+    originChainId: number;
+    /** Deadline for order initiation */
+    initiateDeadline: number;
+    /** Deadline for order fill */
+    fillDeadline: number;
+}
+export interface LiveSettlementResult {
+    intentId: string;
+    fillTxHash: Hash;
+    blockNumber: bigint;
+    settledAt: number;
+}
+export declare class LiveSettlementManager {
+    private readonly settlementContract;
+    constructor(settlementContract: ViemSettlementContract);
+    /**
+     * Settle an intent on-chain by calling claim() on the IntentSettlement contract.
+     *
+     * @param params - The settlement parameters derived from the original intent
+     * @param signature - The solver or oracle signature verifying the cross-chain execution
+     * @returns LiveSettlementResult including the claim tx hash
+     */
+    settleOnChain(params: LiveSettlementParams, signature: `0x${string}`): Promise<LiveSettlementResult>;
+    /**
+     * Check if an intent has already been settled on the contract.
+     */
+    isSettled(intentId: `0x${string}`): Promise<boolean>;
+}
+//# sourceMappingURL=live-settlement-manager.d.ts.map

package/dist/solver/settlement/live-settlement-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-settlement-manager.d.ts","sourceRoot":"","sources":["../../../src/solver/settlement/live-settlement-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yDAAyD,CAAC;AAOjG,MAAM,WAAW,oBAAoB;IACjC,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,aAAa,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,gBAAgB,EAAE,MAAM,CAAC;IACzB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACrB;AAMD,qBAAa,qBAAqB;IAE1B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;gBAAlB,kBAAkB,EAAE,sBAAsB;IAG/D;;;;;;OAMG;IACG,aAAa,CAAC,MAAM,EAAE,oBAAoB,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAmC1G;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;CAG7D"}

package/dist/solver/settlement/live-settlement-manager.js

@@ -0,0 +1,68 @@
+/**
+ * Viem-based Live Settlement Manager
+ *
+ * Phase E: Contract Deployment & Live Settlement
+ *
+ * This manager replaces the ethers.js-based SettlementManager for
+ * live, on-chain settlement flows. It uses the ViemSettlementContract
+ * to call claim() on the deployed IntentSettlement.sol.
+ *
+ * The lifecycle is:
+ *   1. Solver sends tokens on target chain → gets txHash (Phase C)
+ *   2. Call settleOnChain() → builds & broadcasts claim() tx on source chain
+ *   3. Parse IntentFilled event from receipt
+ *   4. Return settlement record
+ *
+ * Stage 3 — Phase E
+ */
+import { encodeAbiParameters } from "viem";
+// ─────────────────────────────────────────────────────────────────────────────
+// LiveSettlementManager
+// ─────────────────────────────────────────────────────────────────────────────
+export class LiveSettlementManager {
+    settlementContract;
+    constructor(settlementContract) {
+        this.settlementContract = settlementContract;
+    }
+    /**
+     * Settle an intent on-chain by calling claim() on the IntentSettlement contract.
+     *
+     * @param params - The settlement parameters derived from the original intent
+     * @param signature - The solver or oracle signature verifying the cross-chain execution
+     * @returns LiveSettlementResult including the claim tx hash
+     */
+    async settleOnChain(params, signature) {
+        // Step 1: Build the orderData = abi.encode(token, amount) based on IntentSettlement.sol
+        // Wait, looking at IntentSettlement.sol, orderData is just (address inputToken, uint256 inputAmount)
+        const orderData = encodeAbiParameters([
+            { type: "address", name: "token" },
+            { type: "uint256", name: "amount" },
+        ], [params.token, params.amount]);
+        const settlementAddress = this.settlementContract.getAddress();
+        // Step 2: Build the CrossChainOrder struct
+        const order = {
+            settlementContract: settlementAddress,
+            swapper: params.swapper,
+            nonce: params.nonce,
+            originChainId: params.originChainId,
+            initiateDeadline: params.initiateDeadline,
+            fillDeadline: params.fillDeadline,
+            orderData: orderData
+        };
+        // Step 3: Call claim()
+        const result = await this.settlementContract.claim(order, signature);
+        return {
+            intentId: params.intentId,
+            fillTxHash: result.txHash,
+            blockNumber: result.blockNumber,
+            settledAt: Math.floor(Date.now() / 1000),
+        };
+    }
+    /**
+     * Check if an intent has already been settled on the contract.
+     */
+    async isSettled(intentId) {
+        return await this.settlementContract.isSettled(intentId);
+    }
+}
+//# sourceMappingURL=live-settlement-manager.js.map

package/dist/solver/settlement/live-settlement-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-settlement-manager.js","sourceRoot":"","sources":["../../../src/solver/settlement/live-settlement-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,OAAO,EAAE,mBAAmB,EAAa,MAAM,MAAM,CAAC;AAkCtD,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF,MAAM,OAAO,qBAAqB;IAET;IADrB,YACqB,kBAA0C;QAA1C,uBAAkB,GAAlB,kBAAkB,CAAwB;IAC3D,CAAC;IAEL;;;;;;OAMG;IACH,KAAK,CAAC,aAAa,CAAC,MAA4B,EAAE,SAAwB;QACtE,wFAAwF;QACxF,qGAAqG;QACrG,MAAM,SAAS,GAAG,mBAAmB,CACjC;YACI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE;YAClC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE;SACtC,EACD,CAAC,MAAM,CAAC,KAAsB,EAAE,MAAM,CAAC,MAAM,CAAC,CACjD,CAAC;QAEF,MAAM,iBAAiB,GAAG,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAmB,CAAC;QAEhF,2CAA2C;QAC3C,MAAM,KAAK,GAAG;YACV,kBAAkB,EAAE,iBAAiB;YACrC,OAAO,EAAE,MAAM,CAAC,OAAwB;YACxC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,SAAS,EAAE,SAAS;SACvB,CAAC;QAEF,uBAAuB;QACvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAErE,OAAO;YACH,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,MAAM;YACzB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;SAC3C,CAAC;IACN,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,QAAuB;QACnC,OAAO,MAAM,IAAI,CAAC,kBAAkB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC7D,CAAC;CACJ"}

package/dist/solver/settlement/proof-generator.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Proof Generator — Phase E
+ *
+ * Generates cross-chain proofs (EIP-191 personal signature) that attest
+ * the solver has fulfilled the intent on the target chain.
+ *
+ * Flow:
+ *   1. Solver sends funds on target chain → gets txHash
+ *   2. Wait for N confirmations on target chain
+ *   3. Sign message: keccak256(intentId, "FILLED", solverAddress)
+ *   4. Return CrossChainProof for use in claim()
+ *
+ * Used by: SettlementManager.settleIntent()
+ */
+import type { ChainId, Hash } from "../../types/common";
+import type { CrossChainProof, IProofSigner, IProviderForProof, ProofGenerationParams } from "../types/settlement";
+export declare class ProofGenerator {
+    private readonly signer;
+    private readonly provider;
+    constructor(signer: IProofSigner, provider: IProviderForProof);
+    /**
+     * Generate a cross-chain signature proof.
+     *
+     * Steps:
+     *   1. Wait for sufficient confirmations on target chain
+     *   2. Build digest from intentId and solver address
+     *   3. Sign with oracle's private key
+     *   4. Return CrossChainProof
+     *
+     * @param params - ProofGenerationParams
+     * @returns CrossChainProof ready for claim()
+     * @throws ProofGenerationError if tx not found, reverted, or signing fails
+     */
+    generateSignatureProof(params: ProofGenerationParams): Promise<CrossChainProof>;
+    /**
+     * Wait until a transaction has enough block confirmations.
+     *
+     * Polls the chain every ~2 seconds until:
+     *   currentBlock - txBlock >= requiredConfirmations
+     *
+     * @param txHash - Transaction hash to watch
+     * @param chainId - Chain ID where the tx lives
+     * @param confirmations - Number of confirmations required
+     * @throws ProofGenerationError if tx not found or reverted
+     */
+    waitForConfirmations(txHash: Hash, chainId: ChainId, confirmations: number): Promise<void>;
+}
+//# sourceMappingURL=proof-generator.d.ts.map

package/dist/solver/settlement/proof-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proof-generator.d.ts","sourceRoot":"","sources":["../../../src/solver/settlement/proof-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAQnH,qBAAa,cAAc;IAEnB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,iBAAiB;IAOhD;;;;;;;;;;;;OAYG;IACG,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC;IAoCrF;;;;;;;;;;OAUG;IACG,oBAAoB,CACtB,MAAM,EAAE,IAAI,EACZ,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,MAAM,GACtB,OAAO,CAAC,IAAI,CAAC;CAoBnB"}

package/dist/solver/settlement/proof-generator.js

@@ -0,0 +1,100 @@
+/**
+ * Proof Generator — Phase E
+ *
+ * Generates cross-chain proofs (EIP-191 personal signature) that attest
+ * the solver has fulfilled the intent on the target chain.
+ *
+ * Flow:
+ *   1. Solver sends funds on target chain → gets txHash
+ *   2. Wait for N confirmations on target chain
+ *   3. Sign message: keccak256(intentId, "FILLED", solverAddress)
+ *   4. Return CrossChainProof for use in claim()
+ *
+ * Used by: SettlementManager.settleIntent()
+ */
+import { ethers } from "ethers";
+import { ProofGenerationError } from "../../errors/settlement-errors";
+// ─────────────────────────────────────────────
+// ProofGenerator
+// ─────────────────────────────────────────────
+export class ProofGenerator {
+    signer;
+    provider;
+    constructor(signer, provider) {
+        this.signer = signer;
+        this.provider = provider;
+    }
+    // ─────────────────────────────────────────
+    // Public API
+    // ─────────────────────────────────────────
+    /**
+     * Generate a cross-chain signature proof.
+     *
+     * Steps:
+     *   1. Wait for sufficient confirmations on target chain
+     *   2. Build digest from intentId and solver address
+     *   3. Sign with oracle's private key
+     *   4. Return CrossChainProof
+     *
+     * @param params - ProofGenerationParams
+     * @returns CrossChainProof ready for claim()
+     * @throws ProofGenerationError if tx not found, reverted, or signing fails
+     */
+    async generateSignatureProof(params) {
+        const confirmations = params.confirmations ?? 3;
+        await this.waitForConfirmations(params.targetTxHash, params.targetChainId, confirmations);
+        const receipt = await this.provider.getTransactionReceipt(params.targetChainId, params.targetTxHash);
+        if (!receipt) {
+            throw new ProofGenerationError(`Transaction ${params.targetTxHash} not found`);
+        }
+        if (receipt.status === 0) {
+            throw new ProofGenerationError(`Transaction ${params.targetTxHash} reverted`);
+        }
+        const solverAddress = await this.signer.getAddress();
+        // Keccak256(abi.encodePacked(intentId, "FILLED", solverAddress))
+        const digest = ethers.solidityPackedKeccak256(["bytes32", "string", "address"], [params.intentId, "FILLED", solverAddress]);
+        const signature = await this.signer.signMessage(ethers.getBytes(digest));
+        return {
+            txHash: params.targetTxHash,
+            chainId: params.targetChainId,
+            blockNumber: receipt.blockNumber,
+            solverSignature: signature,
+            signedData: {
+                intentId: params.intentId,
+                targetTxHash: params.targetTxHash,
+                amount: params.amount,
+                recipient: params.recipient,
+            }
+        };
+    }
+    /**
+     * Wait until a transaction has enough block confirmations.
+     *
+     * Polls the chain every ~2 seconds until:
+     *   currentBlock - txBlock >= requiredConfirmations
+     *
+     * @param txHash - Transaction hash to watch
+     * @param chainId - Chain ID where the tx lives
+     * @param confirmations - Number of confirmations required
+     * @throws ProofGenerationError if tx not found or reverted
+     */
+    async waitForConfirmations(txHash, chainId, confirmations) {
+        const maxAttempts = 60; // Up to ~120 seconds
+        const delayMs = 2000;
+        for (let i = 0; i < maxAttempts; i++) {
+            const receipt = await this.provider.getTransactionReceipt(chainId, txHash);
+            if (receipt) {
+                if (receipt.status === 0) {
+                    throw new ProofGenerationError(`Transaction ${txHash} reverted on chain ${chainId}`);
+                }
+                const currentBlock = await this.provider.getBlockNumber(chainId);
+                if (currentBlock - receipt.blockNumber >= confirmations) {
+                    return; // Enough confirmations
+                }
+            }
+            await new Promise((resolve) => setTimeout(resolve, delayMs));
+        }
+        throw new ProofGenerationError(`Timeout waiting for ${confirmations} confirmations on ${txHash}`);
+    }
+}
+//# sourceMappingURL=proof-generator.js.map

package/dist/solver/settlement/proof-generator.js.map

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

package/dist/solver/settlement/proof-verifier.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Proof Verifier — Phase E
+ *
+ * Verifies cross-chain proofs by recovering the signer from
+ * the EIP-712 signature and comparing to the expected solver address.
+ *
+ * Used by:
+ *   - SettlementManager (pre-claim sanity check)
+ *   - Contract's claim() also verifies on-chain, but we check off-chain first
+ *     to avoid wasting gas on invalid proofs
+ */
+import type { Address } from "../../types/common";
+import type { CrossChainProof } from "../types/settlement";
+export declare class ProofVerifier {
+    /**
+     * Verify that a CrossChainProof was signed by the expected oracle/solver.
+     *
+     * Steps:
+     *   1. Reconstruct digest from intentId and expected solver address
+     *   2. Recover signer address from proof.solverSignature
+     *   3. Compare recovered address with expectedSigner
+     *   4. Return true if match, false otherwise
+     *
+     * @param proof - The CrossChainProof to verify
+     * @param expectedSigner - The address we expect to have signed (e.g. Oracle address)
+     * @param solverAddress - The solver address that was injected into the digest
+     * @returns true if proof is valid
+     */
+    verifySignatureProof(proof: CrossChainProof, expectedSigner: Address, solverAddress: Address): Promise<boolean>;
+}
+//# sourceMappingURL=proof-verifier.d.ts.map

package/dist/solver/settlement/proof-verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proof-verifier.d.ts","sourceRoot":"","sources":["../../../src/solver/settlement/proof-verifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAM3D,qBAAa,aAAa;IAEtB;;;;;;;;;;;;;OAaG;IACG,oBAAoB,CACtB,KAAK,EAAE,eAAe,EACtB,cAAc,EAAE,OAAO,EACvB,aAAa,EAAE,OAAO,GACvB,OAAO,CAAC,OAAO,CAAC;CAmBtB"}

package/dist/solver/settlement/proof-verifier.js

@@ -0,0 +1,46 @@
+/**
+ * Proof Verifier — Phase E
+ *
+ * Verifies cross-chain proofs by recovering the signer from
+ * the EIP-712 signature and comparing to the expected solver address.
+ *
+ * Used by:
+ *   - SettlementManager (pre-claim sanity check)
+ *   - Contract's claim() also verifies on-chain, but we check off-chain first
+ *     to avoid wasting gas on invalid proofs
+ */
+import { ethers } from "ethers";
+// ─────────────────────────────────────────────
+// ProofVerifier
+// ─────────────────────────────────────────────
+export class ProofVerifier {
+    /**
+     * Verify that a CrossChainProof was signed by the expected oracle/solver.
+     *
+     * Steps:
+     *   1. Reconstruct digest from intentId and expected solver address
+     *   2. Recover signer address from proof.solverSignature
+     *   3. Compare recovered address with expectedSigner
+     *   4. Return true if match, false otherwise
+     *
+     * @param proof - The CrossChainProof to verify
+     * @param expectedSigner - The address we expect to have signed (e.g. Oracle address)
+     * @param solverAddress - The solver address that was injected into the digest
+     * @returns true if proof is valid
+     */
+    async verifySignatureProof(proof, expectedSigner, solverAddress) {
+        if (!proof.signedData || !proof.signedData.intentId) {
+            return false;
+        }
+        try {
+            const digest = ethers.solidityPackedKeccak256(["bytes32", "string", "address"], [proof.signedData.intentId, "FILLED", solverAddress]);
+            // Recover signer using EIP-191 personal sign recovery
+            const recoveredAddress = ethers.verifyMessage(ethers.getBytes(digest), proof.solverSignature);
+            return recoveredAddress.toLowerCase() === expectedSigner.toLowerCase();
+        }
+        catch (error) {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=proof-verifier.js.map

package/dist/solver/settlement/proof-verifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proof-verifier.js","sourceRoot":"","sources":["../../../src/solver/settlement/proof-verifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,gDAAgD;AAChD,gBAAgB;AAChB,gDAAgD;AAEhD,MAAM,OAAO,aAAa;IAEtB;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,oBAAoB,CACtB,KAAsB,EACtB,cAAuB,EACvB,aAAsB;QAEtB,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YAClD,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,CAAC,uBAAuB,CACzC,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,EAChC,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,CACvD,CAAC;YAEF,sDAAsD;YACtD,MAAM,gBAAgB,GAAG,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;YAE9F,OAAO,gBAAgB,CAAC,WAAW,EAAE,KAAK,cAAc,CAAC,WAAW,EAAE,CAAC;QAC3E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO,KAAK,CAAC;QACjB,CAAC;IACL,CAAC;CACJ"}

package/dist/solver/settlement/settlement-manager.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Settlement Manager — Phase E
+ *
+ * Orchestrates the full settlement lifecycle:
+ *   1. Solver sends funds on target chain → gets targetTxHash
+ *   2. Wait for confirmations on target chain
+ *   3. Generate proof (EIP-191 Oracle signature)
+ *   4. Submit claim() on source chain contract
+ *   5. Track settlement status and handle failures
+ *
+ * Retry policy: max 3 attempts per intent.
+ * After 3 failures → status = "failed", requires manual review.
+ *
+ * Used by: LiquidityAgent.solve() (Phase F)
+ */
+import type { Address, Hash } from "../../types/common";
+import type { Settlement, SettlementStatus } from "../types/settlement";
+import type { SolverIntent } from "../types/intent";
+import type { ProofGenerator } from "./proof-generator";
+import type { ProofVerifier } from "./proof-verifier";
+import type { IntentSettlementContract } from "../contracts/intent-settlement/intent-settlement";
+export interface SettlementConfig {
+    /** Number of block confirmations before generating proof (default: 3) */
+    requiredConfirmations: number;
+    /** Max retry attempts for claim (default: 3) */
+    maxClaimRetries: number;
+    /** Interval (ms) for watchPendingSettlements polling (default: 30_000) */
+    watchIntervalMs: number;
+    /** Oracle address that signs the proof. If not provided, assumes solver is oracle (MVP). */
+    oracleAddress?: Address;
+}
+export declare const DEFAULT_SETTLEMENT_CONFIG: SettlementConfig;
+export declare class SettlementManager {
+    private readonly proofGenerator;
+    private readonly proofVerifier;
+    private readonly contract;
+    private readonly config;
+    /** In-memory settlement records, keyed by intentId */
+    private settlements;
+    /** Cache of original intents to allow retries */
+    private intents;
+    /** Interval ID for watchPendingSettlements */
+    private watchInterval;
+    constructor(proofGenerator: ProofGenerator, proofVerifier: ProofVerifier, contract: IntentSettlementContract, config?: SettlementConfig);
+    /**
+     * Full settlement flow for a single intent.
+     *
+     * Steps:
+     *   1. Create Settlement record with status "pending"
+     *   2. Wait for confirmations on target chain
+     *   3. Generate proof → status "proving"
+     *   4. Verify proof off-chain (sanity check)
+     *   5. Call contract.claim() → status "claiming"
+     *   6. If success → status "completed"
+     *   7. If failure → handleClaimFailure()
+     *
+     * @param intent - SolverIntent being settled
+     * @param targetTxHash - Transaction hash of the fulfillment on target chain
+     * @returns Settlement record
+     * @throws SettlementError on unrecoverable failure
+     */
+    settleIntent(intent: SolverIntent, targetTxHash: Hash): Promise<Settlement>;
+    /**
+     * Start watching for pending settlements and retry claims.
+     *
+     * Runs on an interval (default 30s). For each pending/failed settlement
+     * with remaining retries, attempt to re-settle.
+     */
+    watchPendingSettlements(): void;
+    /**
+     * Stop watching pending settlements.
+     */
+    stopWatching(): void;
+    /**
+     * Handle a claim failure: increment attempts, update status.
+     *
+     * If attempts < maxClaimRetries → keep status "failed" (will be retried by watcher)
+     * If attempts >= maxClaimRetries → status "failed" permanently
+     *
+     * @param intentId - Intent whose claim failed
+     * @param error - Error that caused the failure
+     */
+    handleClaimFailure(intentId: string, error: Error): Promise<void>;
+    /**
+     * Get a settlement record by intentId.
+     */
+    getSettlement(intentId: string): Settlement | undefined;
+    /**
+     * Get all settlements with a specific status.
+     */
+    getSettlementsByStatus(status: SettlementStatus): Settlement[];
+    /**
+     * Get all settlement records.
+     */
+    getAllSettlements(): Settlement[];
+}
+//# sourceMappingURL=settlement-manager.d.ts.map

package/dist/solver/settlement/settlement-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settlement-manager.d.ts","sourceRoot":"","sources":["../../../src/solver/settlement/settlement-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kDAAkD,CAAC;AAQjG,MAAM,WAAW,gBAAgB;IAC7B,yEAAyE;IACzE,qBAAqB,EAAE,MAAM,CAAC;IAE9B,gDAAgD;IAChD,eAAe,EAAE,MAAM,CAAC;IAExB,0EAA0E;IAC1E,eAAe,EAAE,MAAM,CAAC;IAExB,4FAA4F;IAC5F,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,eAAO,MAAM,yBAAyB,EAAE,gBAIvC,CAAC;AAMF,qBAAa,iBAAiB;IAWtB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAb3B,sDAAsD;IACtD,OAAO,CAAC,WAAW,CAAsC;IAEzD,iDAAiD;IACjD,OAAO,CAAC,OAAO,CAAwC;IAEvD,8CAA8C;IAC9C,OAAO,CAAC,aAAa,CAA+C;gBAG/C,cAAc,EAAE,cAAc,EAC9B,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,wBAAwB,EAClC,MAAM,GAAE,gBAA4C;IAOzE;;;;;;;;;;;;;;;;OAgBG;IACG,YAAY,CACd,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,IAAI,GACnB,OAAO,CAAC,UAAU,CAAC;IA0FtB;;;;;OAKG;IACH,uBAAuB,IAAI,IAAI;IAqB/B;;OAEG;IACH,YAAY,IAAI,IAAI;IAOpB;;;;;;;;OAQG;IACG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBvE;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIvD;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,EAAE;IAI9D;;OAEG;IACH,iBAAiB,IAAI,UAAU,EAAE;CAGpC"}