@terkoizmy/intent-sdk 1.0.0

package/dist/solver/agent/liquidity-agent.js

@@ -0,0 +1,285 @@
+/**
+ * Liquidity Agent — Phase F
+ *
+ * Core orchestrator that ties together all solver subsystems
+ * (Inventory, Pricing, Settlement) into a single agent that can
+ * evaluate, price, and solve cross-chain bridge intents.
+ *
+ * Lifecycle:
+ *   1. new LiquidityAgent(deps, config)
+ *   2. await agent.initialize()   → loads balances, derives address
+ *   3. agent.start()              → begins watching settlements
+ *   4. await agent.solve(intent)  → full solve cycle
+ *   5. agent.stop()               → cleanup
+ *
+ * Used by: SDK consumer (examples/autonomous-agent.ts, Phase K)
+ */
+import { toBridgeIntent } from "../types/intent";
+import { UnsupportedIntentError, IntentExpiredError } from "../../errors/solver-errors";
+import { encodeTransferData } from "../../shared/utils/erc20-utils";
+// ─────────────────────────────────────────────
+// LiquidityAgent
+// ─────────────────────────────────────────────
+export class LiquidityAgent {
+    inventoryManager;
+    dynamicPricing;
+    settlementManager;
+    walletManager;
+    config;
+    status = "idle";
+    agentAddress = null;
+    constructor(inventoryManager, dynamicPricing, settlementManager, walletManager, config) {
+        this.inventoryManager = inventoryManager;
+        this.dynamicPricing = dynamicPricing;
+        this.settlementManager = settlementManager;
+        this.walletManager = walletManager;
+        this.config = config;
+    }
+    // ─────────────────────────────────────────
+    // Public API
+    // ─────────────────────────────────────────
+    /**
+     * Initialize the agent: load on-chain balances and derive the agent address.
+     *
+     * Must be called before solve() / canSolve() / getQuote().
+     */
+    async initialize() {
+        this.agentAddress = this.walletManager.getAddress();
+        await this.inventoryManager.loadBalances();
+        this.status = "idle";
+    }
+    /**
+     * Check whether this agent can solve a given intent.
+     *
+     * Validation order:
+     *   1. Intent type must be "bridge"
+     *   2. Source and target chains must be in supportedChains
+     *   3. Token must be in supportedTokens
+     *   4. Intent must not be expired (deadline > now)
+     *   5. Inventory must have enough to fulfill (canFulfill)
+     *
+     * @param intent - SolverIntent to evaluate
+     * @returns true if solvable, false otherwise
+     */
+    canSolve(intent) {
+        // 1. Type check
+        if (intent.parsedIntent.intentType !== "bridge")
+            return false;
+        // 2. Extract bridge params
+        const bridgeIntent = toBridgeIntent(intent);
+        if (!bridgeIntent)
+            return false;
+        // 3. Chain support
+        const { supportedChains, supportedTokens } = this.config.agent;
+        if (!supportedChains.includes(bridgeIntent.sourceChain))
+            return false;
+        if (!supportedChains.includes(bridgeIntent.targetChain))
+            return false;
+        // 4. Token support
+        if (!supportedTokens.includes(bridgeIntent.token.toUpperCase()))
+            return false;
+        // 5. Expiry check
+        const nowSeconds = Math.floor(Date.now() / 1000);
+        if (intent.deadline <= nowSeconds)
+            return false;
+        // 6. Inventory sufficiency on target chain
+        const amount = BigInt(bridgeIntent.amount);
+        if (!this.inventoryManager.canFulfill(bridgeIntent.targetChain, bridgeIntent.token, amount)) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Get a price quote for a given intent via the DynamicPricing engine.
+     *
+     * Does NOT lock inventory or execute anything.
+     *
+     * @param intent - SolverIntent to price
+     * @returns PricingResult with full fee breakdown
+     */
+    getQuote(intent) {
+        return this.dynamicPricing.getPrice(intent);
+    }
+    /**
+     * Full solve cycle for a single intent.
+     *
+     * Steps:
+     *   1. Validate via canSolve()
+     *   2. Price via getQuote()
+     *   3. Check profitability (shouldReject)
+     *   4. Lock inventory on target chain
+     *   5. Send funds on target chain (simulate or live)
+     *   6. Confirm deduction from inventory
+     *   7. Trigger settlement (proof + claim)
+     *   8. Return SolutionResult
+     *
+     * On any failure after lock, inventory is unlocked automatically.
+     *
+     * @param intent - SolverIntent to solve
+     * @returns SolutionResult with success/error details
+     */
+    async solve(intent) {
+        const startTime = Date.now();
+        this.status = "processing";
+        try {
+            // 1. Validate
+            if (intent.parsedIntent.intentType !== "bridge") {
+                throw new UnsupportedIntentError(intent.parsedIntent.intentType, "Only bridge intents are supported");
+            }
+            const bridgeIntent = toBridgeIntent(intent);
+            if (!bridgeIntent) {
+                throw new UnsupportedIntentError("bridge", "Invalid bridge parameters");
+            }
+            // Check expiry
+            const nowSeconds = Math.floor(Date.now() / 1000);
+            if (intent.deadline <= nowSeconds) {
+                throw new IntentExpiredError(intent.intentId, intent.deadline);
+            }
+            // Check inventory can fulfill
+            const amount = BigInt(bridgeIntent.amount);
+            if (!this.inventoryManager.canFulfill(bridgeIntent.targetChain, bridgeIntent.token, amount)) {
+                return this.errorResult("Insufficient inventory on target chain", startTime, bridgeIntent);
+            }
+            // 2. Price
+            const pricing = this.getQuote(intent);
+            // 3. Check profitability
+            if (this.dynamicPricing.shouldReject(bridgeIntent.targetChain, amount, bridgeIntent.token)) {
+                return this.errorResult("Inventory too low — rejected by dynamic pricing", startTime, bridgeIntent);
+            }
+            // 4. Lock inventory
+            this.inventoryManager.lockAmount(bridgeIntent.targetChain, bridgeIntent.token, amount, intent.intentId);
+            let targetTxHash;
+            try {
+                // 5. Send on target chain
+                targetTxHash = await this.sendOnTargetChain(intent, bridgeIntent, pricing);
+                // 6. Confirm deduction
+                this.inventoryManager.confirmDeduction(bridgeIntent.targetChain, bridgeIntent.token, amount, intent.intentId);
+            }
+            catch (sendError) {
+                // Unlock on failure
+                this.inventoryManager.unlockAmount(bridgeIntent.targetChain, bridgeIntent.token, amount, intent.intentId);
+                return this.errorResult(`Send failed: ${sendError.message || String(sendError)}`, startTime, bridgeIntent);
+            }
+            // 7. Trigger settlement
+            try {
+                await this.settlementManager.settleIntent(intent, targetTxHash);
+            }
+            catch (settlementError) {
+                // Settlement failure is non-fatal for the solve result —
+                // the funds were already sent to the user. Settlement will be retried
+                // by the watcher. Log but don't fail the result.
+                console.warn(`Settlement for ${intent.intentId} deferred: ${settlementError.message}`);
+            }
+            // 8. Build success result
+            const durationMs = Date.now() - startTime;
+            this.status = "idle";
+            return {
+                success: true,
+                txHash: targetTxHash,
+                profit: pricing.solverProfit,
+                output: pricing.userReceives,
+                metadata: {
+                    solveDurationMs: durationMs,
+                    sourceChainId: bridgeIntent.sourceChain,
+                    targetChainId: bridgeIntent.targetChain,
+                    feeBreakdown: {
+                        baseFee: pricing.baseFee,
+                        slippageCapture: pricing.slippageCapture,
+                        gasCost: pricing.gasCost,
+                        totalFee: pricing.totalFee,
+                    },
+                },
+            };
+        }
+        catch (error) {
+            this.status = "idle";
+            return {
+                success: false,
+                error: error.message || String(error),
+            };
+        }
+    }
+    /**
+     * Start the agent: begin watching for pending settlements.
+     *
+     * @param _mempoolUrl - Reserved for Phase G mempool integration
+     */
+    start(_mempoolUrl) {
+        this.status = "processing";
+        this.settlementManager.watchPendingSettlements();
+    }
+    /**
+     * Stop the agent: stop settlement watcher.
+     */
+    stop() {
+        this.settlementManager.stopWatching();
+        this.status = "idle";
+    }
+    /**
+     * Get the current agent status.
+     */
+    getStatus() {
+        return this.status;
+    }
+    /**
+     * Get the agent's on-chain address.
+     */
+    getAgentAddress() {
+        return this.agentAddress;
+    }
+    // ─────────────────────────────────────────
+    // Private
+    // ─────────────────────────────────────────
+    /**
+     * Send funds to the intent recipient on the target chain.
+     *
+     * In **simulate** mode: generates a fake txHash from the intentId.
+     * In **live** mode: executes a real ERC-20 transfer via WalletManager.
+     *
+     * @param intent       - The intent being solved
+     * @param bridgeIntent - Extracted bridge parameters
+     * @param _pricing     - Pricing result (reserved for future gas limit calc)
+     * @returns Target chain transaction hash
+     */
+    async sendOnTargetChain(intent, bridgeIntent, _pricing) {
+        if (this.config.agent.mode === "simulate") {
+            // Simulate: generate deterministic fake hash
+            const ramdomHex = Math.random().toString(16).slice(2) + Math.random().toString(16).slice(2);
+            const fakeHash = `0x${ramdomHex.padEnd(64, "0").slice(0, 64)}`;
+            return fakeHash;
+        }
+        // Live mode: build and send ERC-20 transfer
+        const tokenAddress = intent.parsedIntent.parameters.outputTokenAddress || intent.parsedIntent.parameters.inputTokenAddress;
+        if (!tokenAddress) {
+            throw new Error(`Token address required for live mode transfer (${bridgeIntent.token})`);
+        }
+        // Generate calldata using custom ERC-20 utils
+        const data = encodeTransferData(bridgeIntent.recipient, BigInt(_pricing.userReceives));
+        // Sign and broadcast the transaction via the WalletManager
+        const txHash = await this.walletManager.sendTransaction(bridgeIntent.targetChain, {
+            to: tokenAddress,
+            data,
+            value: 0n,
+        });
+        return txHash;
+    }
+    /**
+     * Build an error SolutionResult.
+     */
+    errorResult(message, startTime, bridgeIntent) {
+        this.status = "idle";
+        const result = {
+            success: false,
+            error: message,
+        };
+        if (bridgeIntent) {
+            result.metadata = {
+                solveDurationMs: Date.now() - startTime,
+                sourceChainId: bridgeIntent.sourceChain,
+                targetChainId: bridgeIntent.targetChain,
+            };
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=liquidity-agent.js.map

package/dist/solver/agent/liquidity-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquidity-agent.js","sourceRoot":"","sources":["../../../src/solver/agent/liquidity-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAMjD,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAExF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,gDAAgD;AAChD,iBAAiB;AACjB,gDAAgD;AAEhD,MAAM,OAAO,cAAc;IAKF;IACA;IACA;IACA;IACA;IARb,MAAM,GAAgB,MAAM,CAAC;IAC7B,YAAY,GAAmB,IAAI,CAAC;IAE5C,YACqB,gBAAkC,EAClC,cAA8B,EAC9B,iBAAoC,EACpC,aAA4B,EAC5B,MAA4B;QAJ5B,qBAAgB,GAAhB,gBAAgB,CAAkB;QAClC,mBAAc,GAAd,cAAc,CAAgB;QAC9B,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,kBAAa,GAAb,aAAa,CAAe;QAC5B,WAAM,GAAN,MAAM,CAAsB;IAC7C,CAAC;IAEL,4CAA4C;IAC5C,aAAa;IACb,4CAA4C;IAE5C;;;;OAIG;IACH,KAAK,CAAC,UAAU;QACZ,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC;QACpD,MAAM,IAAI,CAAC,gBAAgB,CAAC,YAAY,EAAE,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,MAAoB;QACzB,gBAAgB;QAChB,IAAI,MAAM,CAAC,YAAY,CAAC,UAAU,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QAE9D,2BAA2B;QAC3B,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,YAAY;YAAE,OAAO,KAAK,CAAC;QAEhC,mBAAmB;QACnB,MAAM,EAAE,eAAe,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/D,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,YAAY,CAAC,WAAW,CAAC;YAAE,OAAO,KAAK,CAAC;QACtE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,YAAY,CAAC,WAAW,CAAC;YAAE,OAAO,KAAK,CAAC;QAEtE,mBAAmB;QACnB,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;QAE9E,kBAAkB;QAClB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QACjD,IAAI,MAAM,CAAC,QAAQ,IAAI,UAAU;YAAE,OAAO,KAAK,CAAC;QAEhD,2CAA2C;QAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;YAC1F,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAoB;QACzB,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,KAAK,CAAC,KAAK,CAAC,MAAoB;QAC5B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;QAC3B,IAAI,CAAC;YAED,cAAc;YACd,IAAI,MAAM,CAAC,YAAY,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;gBAC9C,MAAM,IAAI,sBAAsB,CAAC,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,mCAAmC,CAAC,CAAC;YAC1G,CAAC;YAED,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YAC5C,IAAI,CAAC,YAAY,EAAE,CAAC;gBAChB,MAAM,IAAI,sBAAsB,CAAC,QAAQ,EAAE,2BAA2B,CAAC,CAAC;YAC5E,CAAC;YAED,eAAe;YACf,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;YACjD,IAAI,MAAM,CAAC,QAAQ,IAAI,UAAU,EAAE,CAAC;gBAChC,MAAM,IAAI,kBAAkB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YACnE,CAAC;YAED,8BAA8B;YAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YAC3C,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;gBAC1F,OAAO,IAAI,CAAC,WAAW,CAAC,wCAAwC,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;YAC/F,CAAC;YAED,WAAW;YACX,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAEtC,yBAAyB;YACzB,IAAI,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzF,OAAO,IAAI,CAAC,WAAW,CAAC,iDAAiD,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;YACxG,CAAC;YAED,oBAAoB;YACpB,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAC5B,YAAY,CAAC,WAAW,EACxB,YAAY,CAAC,KAAK,EAClB,MAAM,EACN,MAAM,CAAC,QAAQ,CAClB,CAAC;YAEF,IAAI,YAAkB,CAAC;YAEvB,IAAI,CAAC;gBACD,0BAA0B;gBAC1B,YAAY,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;gBAE3E,uBAAuB;gBACvB,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAClC,YAAY,CAAC,WAAW,EACxB,YAAY,CAAC,KAAK,EAClB,MAAM,EACN,MAAM,CAAC,QAAQ,CAClB,CAAC;YACN,CAAC;YAAC,OAAO,SAAc,EAAE,CAAC;gBACtB,oBAAoB;gBACpB,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAC9B,YAAY,CAAC,WAAW,EACxB,YAAY,CAAC,KAAK,EAClB,MAAM,EACN,MAAM,CAAC,QAAQ,CAClB,CAAC;gBACF,OAAO,IAAI,CAAC,WAAW,CACnB,gBAAgB,SAAS,CAAC,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,EACxD,SAAS,EACT,YAAY,CACf,CAAC;YACN,CAAC;YAED,wBAAwB;YACxB,IAAI,CAAC;gBACD,MAAM,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YACpE,CAAC;YAAC,OAAO,eAAoB,EAAE,CAAC;gBAC5B,yDAAyD;gBACzD,sEAAsE;gBACtE,iDAAiD;gBACjD,OAAO,CAAC,IAAI,CACR,kBAAkB,MAAM,CAAC,QAAQ,cAAc,eAAe,CAAC,OAAO,EAAE,CAC3E,CAAC;YACN,CAAC;YACD,0BAA0B;YAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAE1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YACrB,OAAO;gBACH,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,YAAY;gBACpB,MAAM,EAAE,OAAO,CAAC,YAAY;gBAC5B,MAAM,EAAE,OAAO,CAAC,YAAY;gBAC5B,QAAQ,EAAE;oBACN,eAAe,EAAE,UAAU;oBAC3B,aAAa,EAAE,YAAY,CAAC,WAAW;oBACvC,aAAa,EAAE,YAAY,CAAC,WAAW;oBACvC,YAAY,EAAE;wBACV,OAAO,EAAE,OAAO,CAAC,OAAO;wBACxB,eAAe,EAAE,OAAO,CAAC,eAAe;wBACxC,OAAO,EAAE,OAAO,CAAC,OAAO;wBACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;qBAC7B;iBACJ;aACJ,CAAC;QACN,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YACrB,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC;aACxC,CAAC;QACN,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAoB;QACtB,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;QAC3B,IAAI,CAAC,iBAAiB,CAAC,uBAAuB,EAAE,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,IAAI;QACA,IAAI,CAAC,iBAAiB,CAAC,YAAY,EAAE,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,SAAS;QACL,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,eAAe;QACX,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED,4CAA4C;IAC5C,UAAU;IACV,4CAA4C;IAE5C;;;;;;;;;;OAUG;IACK,KAAK,CAAC,iBAAiB,CAC3B,MAAoB,EACpB,YAA0B,EAC1B,QAAuB;QAEvB,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YACxC,6CAA6C;YAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC5F,MAAM,QAAQ,GAAG,KAAK,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YAC/D,OAAO,QAAgB,CAAC;QAC5B,CAAC;QAED,4CAA4C;QAC5C,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,kBAAkB,IAAI,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,iBAAiB,CAAC;QAE3H,IAAI,CAAC,YAAY,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,kDAAkD,YAAY,CAAC,KAAK,GAAG,CAAC,CAAC;QAC7F,CAAC;QAED,8CAA8C;QAC9C,MAAM,IAAI,GAAG,kBAAkB,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;QAGvF,2DAA2D;QAC3D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,eAAe,CACnD,YAAY,CAAC,WAAW,EACxB;YACI,EAAE,EAAE,YAAuB;YAC3B,IAAI;YACJ,KAAK,EAAE,EAAE;SACZ,CACJ,CAAC;QAGF,OAAO,MAAc,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,WAAW,CACf,OAAe,EACf,SAAiB,EACjB,YAA2B;QAE3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,MAAM,GAAmB;YAC3B,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,OAAO;SACjB,CAAC;QAEF,IAAI,YAAY,EAAE,CAAC;YACf,MAAM,CAAC,QAAQ,GAAG;gBACd,eAAe,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBACvC,aAAa,EAAE,YAAY,CAAC,WAAW;gBACvC,aAAa,EAAE,YAAY,CAAC,WAAW;aAC1C,CAAC;QACN,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;CACJ"}

package/dist/solver/contracts/intent-settlement/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./intent-settlement";
+//# sourceMappingURL=index.d.ts.map

package/dist/solver/contracts/intent-settlement/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/solver/contracts/intent-settlement/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/solver/contracts/intent-settlement/index.js

@@ -0,0 +1,2 @@
+export * from "./intent-settlement";
+//# sourceMappingURL=index.js.map

package/dist/solver/contracts/intent-settlement/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/solver/contracts/intent-settlement/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/solver/contracts/intent-settlement/intent-settlement.d.ts

@@ -0,0 +1,22 @@
+import { ethers, ContractTransactionResponse } from "ethers";
+export interface CrossChainOrder {
+    settlementContract: string;
+    swapper: string;
+    nonce: bigint;
+    originChainId: number;
+    initiateDeadline: number;
+    fillDeadline: number;
+    orderData: string;
+}
+export declare class IntentSettlementContract {
+    private contract;
+    constructor(address: string, providerOrSigner: ethers.Provider | ethers.Signer);
+    updateSigner(signer: ethers.Signer): void;
+    open(order: CrossChainOrder, signature: string, orderData: string): Promise<ContractTransactionResponse>;
+    claim(order: CrossChainOrder, oracleSignature: string): Promise<ContractTransactionResponse>;
+    refund(order: CrossChainOrder): Promise<ContractTransactionResponse>;
+    isSettled(intentId: string): Promise<boolean>;
+    waitForLockEvent(intentId: string, timeoutMs?: number): Promise<boolean>;
+    getAddress(): Promise<string>;
+}
+//# sourceMappingURL=intent-settlement.d.ts.map

package/dist/solver/contracts/intent-settlement/intent-settlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-settlement.d.ts","sourceRoot":"","sources":["../../../../src/solver/contracts/intent-settlement/intent-settlement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAY,2BAA2B,EAAE,MAAM,QAAQ,CAAC;AAEvE,MAAM,WAAW,eAAe;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACrB;AAeD,qBAAa,wBAAwB;IACjC,OAAO,CAAC,QAAQ,CAAW;gBAEf,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM;IAI9E,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM;IAI5B,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAIxG,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAI5F,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAIpE,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7C,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,MAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAwBrF,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;CAGhC"}

package/dist/solver/contracts/intent-settlement/intent-settlement.js

@@ -0,0 +1,58 @@
+import { Contract } from "ethers";
+// import { IntentSettlement } from "../../../contracts/typechain-types"; // Type-only import if available, else omit
+// Human-Readable ABI for IntentSettlement
+const INTENT_SETTLEMENT_ABI = [
+    "function open(tuple(address settlementContract, address swapper, uint256 nonce, uint32 originChainId, uint32 initiateDeadline, uint32 fillDeadline, bytes orderData) order, bytes signature, bytes orderData) external",
+    "function claim(tuple(address settlementContract, address swapper, uint256 nonce, uint32 originChainId, uint32 initiateDeadline, uint32 fillDeadline, bytes orderData) order, bytes signature) external",
+    "function refund(tuple(address settlementContract, address swapper, uint256 nonce, uint32 originChainId, uint32 initiateDeadline, uint32 fillDeadline, bytes orderData) order) external",
+    "function isIntentSettled(bytes32 intentId) view returns (bool)",
+    "event FundsLocked(bytes32 indexed intentId, address indexed swapper, address token, uint256 amount)",
+    "event FundsClaimed(bytes32 indexed intentId, address indexed solver, uint256 amount)",
+    "event FundsRefunded(bytes32 indexed intentId, address indexed swapper, uint256 amount)"
+];
+export class IntentSettlementContract {
+    contract;
+    constructor(address, providerOrSigner) {
+        this.contract = new Contract(address, INTENT_SETTLEMENT_ABI, providerOrSigner);
+    }
+    updateSigner(signer) {
+        this.contract = new Contract(this.contract.target, INTENT_SETTLEMENT_ABI, signer);
+    }
+    async open(order, signature, orderData) {
+        return await this.contract.open(order, signature, orderData);
+    }
+    async claim(order, oracleSignature) {
+        return await this.contract.claim(order, oracleSignature);
+    }
+    async refund(order) {
+        return await this.contract.refund(order);
+    }
+    async isSettled(intentId) {
+        return await this.contract.isIntentSettled(intentId);
+    }
+    async waitForLockEvent(intentId, timeoutMs = 60000) {
+        // Basic polling or event listener logic
+        const topic = this.contract.interface.getEvent("FundsLocked").topicHash;
+        const filter = {
+            address: await this.contract.getAddress(),
+            topics: [topic, intentId]
+        };
+        const provider = this.contract.runner?.provider;
+        if (!provider)
+            throw new Error("No provider available");
+        return new Promise((resolve) => {
+            const timeout = setTimeout(() => {
+                this.contract.removeAllListeners(filter);
+                resolve(false);
+            }, timeoutMs);
+            this.contract.once(filter, () => {
+                clearTimeout(timeout);
+                resolve(true);
+            });
+        });
+    }
+    getAddress() {
+        return this.contract.getAddress();
+    }
+}
+//# sourceMappingURL=intent-settlement.js.map

package/dist/solver/contracts/intent-settlement/intent-settlement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-settlement.js","sourceRoot":"","sources":["../../../../src/solver/contracts/intent-settlement/intent-settlement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,QAAQ,EAA+B,MAAM,QAAQ,CAAC;AAWvE,qHAAqH;AAGrH,0CAA0C;AAC1C,MAAM,qBAAqB,GAAG;IAC1B,wNAAwN;IACxN,wMAAwM;IACxM,wLAAwL;IACxL,gEAAgE;IAChE,qGAAqG;IACrG,sFAAsF;IACtF,wFAAwF;CAC3F,CAAC;AAEF,MAAM,OAAO,wBAAwB;IACzB,QAAQ,CAAW;IAE3B,YAAY,OAAe,EAAE,gBAAiD;QAC1E,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,CAAC,CAAC;IACnF,CAAC;IAED,YAAY,CAAC,MAAqB;QAC9B,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,EAAE,MAAM,CAAC,CAAC;IACtF,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAsB,EAAE,SAAiB,EAAE,SAAiB;QACnE,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAsB,EAAE,eAAuB;QACvD,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAsB;QAC/B,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAgB;QAC5B,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,QAAgB,EAAE,YAAoB,KAAK;QAC9D,wCAAwC;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAE,CAAC,SAAS,CAAC;QACzE,MAAM,MAAM,GAAG;YACX,OAAO,EAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE;YACzC,MAAM,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;SAC5B,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;QAChD,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAExD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC3B,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,MAAa,CAAC,CAAC;gBAChD,OAAO,CAAC,KAAK,CAAC,CAAC;YACnB,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAa,EAAE,GAAG,EAAE;gBACnC,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,OAAO,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACP,CAAC,CAAC,CAAC;IACP,CAAC;IAED,UAAU;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACtC,CAAC;CACJ"}

package/dist/solver/contracts/intent-settlement/viem-settlement-contract.d.ts

@@ -0,0 +1,226 @@
+/**
+ * IntentSettlement Viem Contract Wrapper
+ *
+ * Phase E: Contract Deployment & Live Settlement
+ *
+ * A viem-native interface to the deployed `IntentSettlement.sol` contract.
+ * Replaces the old ethers.js-based `IntentSettlementContract` for live
+ * on-chain settlement calls.
+ *
+ * Unlike the ethers wrapper, this implementation:
+ * - Uses `viem`'s `getContract` + `walletClient` for signing and broadcasting
+ * - Parses `IntentFilled` events directly from transaction receipts
+ * - Returns tx hash as a plain string for easy tracking
+ *
+ * Stage 3 — Phase E
+ */
+import type { Address, Hash } from "../../../types/common";
+import type { PublicClient, WalletClient } from "viem";
+export declare const INTENT_SETTLEMENT_ABI: readonly [{
+    readonly type: "function";
+    readonly name: "open";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "order";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "settlementContract";
+            readonly type: "address";
+        }, {
+            readonly name: "swapper";
+            readonly type: "address";
+        }, {
+            readonly name: "nonce";
+            readonly type: "uint256";
+        }, {
+            readonly name: "originChainId";
+            readonly type: "uint32";
+        }, {
+            readonly name: "initiateDeadline";
+            readonly type: "uint32";
+        }, {
+            readonly name: "fillDeadline";
+            readonly type: "uint32";
+        }, {
+            readonly name: "orderData";
+            readonly type: "bytes";
+        }];
+    }, {
+        readonly name: "signature";
+        readonly type: "bytes";
+    }, {
+        readonly name: "orderData";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "claim";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "order";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "settlementContract";
+            readonly type: "address";
+        }, {
+            readonly name: "swapper";
+            readonly type: "address";
+        }, {
+            readonly name: "nonce";
+            readonly type: "uint256";
+        }, {
+            readonly name: "originChainId";
+            readonly type: "uint32";
+        }, {
+            readonly name: "initiateDeadline";
+            readonly type: "uint32";
+        }, {
+            readonly name: "fillDeadline";
+            readonly type: "uint32";
+        }, {
+            readonly name: "orderData";
+            readonly type: "bytes";
+        }];
+    }, {
+        readonly name: "signature";
+        readonly type: "bytes";
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "refund";
+    readonly stateMutability: "nonpayable";
+    readonly inputs: readonly [{
+        readonly name: "order";
+        readonly type: "tuple";
+        readonly components: readonly [{
+            readonly name: "settlementContract";
+            readonly type: "address";
+        }, {
+            readonly name: "swapper";
+            readonly type: "address";
+        }, {
+            readonly name: "nonce";
+            readonly type: "uint256";
+        }, {
+            readonly name: "originChainId";
+            readonly type: "uint32";
+        }, {
+            readonly name: "initiateDeadline";
+            readonly type: "uint32";
+        }, {
+            readonly name: "fillDeadline";
+            readonly type: "uint32";
+        }, {
+            readonly name: "orderData";
+            readonly type: "bytes";
+        }];
+    }];
+    readonly outputs: readonly [];
+}, {
+    readonly type: "function";
+    readonly name: "isIntentSettled";
+    readonly stateMutability: "view";
+    readonly inputs: readonly [{
+        readonly name: "intentId";
+        readonly type: "bytes32";
+    }];
+    readonly outputs: readonly [{
+        readonly name: "";
+        readonly type: "bool";
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "FundsLocked";
+    readonly inputs: readonly [{
+        readonly name: "intentId";
+        readonly type: "bytes32";
+        readonly indexed: true;
+    }, {
+        readonly name: "swapper";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "token";
+        readonly type: "address";
+        readonly indexed: false;
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "FundsClaimed";
+    readonly inputs: readonly [{
+        readonly name: "intentId";
+        readonly type: "bytes32";
+        readonly indexed: true;
+    }, {
+        readonly name: "solver";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "amount";
+        readonly type: "uint256";
+        readonly indexed: false;
+    }];
+}, {
+    readonly type: "event";
+    readonly name: "IntentFilled";
+    readonly inputs: readonly [{
+        readonly name: "orderId";
+        readonly type: "bytes32";
+        readonly indexed: true;
+    }, {
+        readonly name: "filler";
+        readonly type: "address";
+        readonly indexed: true;
+    }, {
+        readonly name: "originData";
+        readonly type: "bytes";
+        readonly indexed: false;
+    }, {
+        readonly name: "fillerData";
+        readonly type: "bytes";
+        readonly indexed: false;
+    }];
+}];
+export interface CrossChainOrderViem {
+    settlementContract: Address;
+    swapper: Address;
+    nonce: bigint;
+    originChainId: number;
+    initiateDeadline: number;
+    fillDeadline: number;
+    orderData: `0x${string}`;
+}
+/**
+ * Viem-native wrapper around the deployed `IntentSettlement.sol`.
+ *
+ * Usage:
+ *   const settlement = new ViemSettlementContract(contractAddress, publicClient, walletClient);
+ *   const result = await settlement.claim(order, solverSignature);
+ *   console.log("Settled intent in tx:", result.txHash);
+ */
+export declare class ViemSettlementContract {
+    private readonly address;
+    private readonly publicClient;
+    private readonly walletClient;
+    constructor(address: Address, publicClient: PublicClient, walletClient: WalletClient);
+    /**
+     * Check if a specific intent ID has already been settled on this contract.
+     */
+    isSettled(intentId: `0x${string}`): Promise<boolean>;
+    /**
+     * Call `claim()` using a solver signature as proof.
+     * Alternative to fill() for the claim-based settlement flow.
+     */
+    claim(order: CrossChainOrderViem, solverSignature: `0x${string}`): Promise<{
+        txHash: Hash;
+        blockNumber: bigint;
+    }>;
+    getAddress(): Address;
+}
+//# sourceMappingURL=viem-settlement-contract.d.ts.map

package/dist/solver/contracts/intent-settlement/viem-settlement-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viem-settlement-contract.d.ts","sourceRoot":"","sources":["../../../../src/solver/contracts/intent-settlement/viem-settlement-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAMvD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4GxB,CAAC;AAMX,MAAM,WAAW,mBAAmB;IAChC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,KAAK,MAAM,EAAE,CAAC;CAC5B;AAMD;;;;;;;GAOG;AACH,qBAAa,sBAAsB;IAE3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAFZ,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY;IAG/C;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,KAAK,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAS1D;;;OAGG;IACG,KAAK,CACP,KAAK,EAAE,mBAAmB,EAC1B,eAAe,EAAE,KAAK,MAAM,EAAE,GAC/B,OAAO,CAAC;QAAE,MAAM,EAAE,IAAI,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IA0CjD,UAAU,IAAI,OAAO;CAGxB"}