@terkoizmy/intent-sdk 1.0.0

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

@@ -0,0 +1,220 @@
+/**
+ * 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 { toBridgeIntent } from "../types/intent";
+import { SettlementError, ClaimFailedError, ProofGenerationError } from "../../errors/settlement-errors";
+import { ethers } from "ethers";
+export const DEFAULT_SETTLEMENT_CONFIG = {
+    requiredConfirmations: 3,
+    maxClaimRetries: 3,
+    watchIntervalMs: 30_000,
+};
+// ─────────────────────────────────────────────
+// SettlementManager
+// ─────────────────────────────────────────────
+export class SettlementManager {
+    proofGenerator;
+    proofVerifier;
+    contract;
+    config;
+    /** In-memory settlement records, keyed by intentId */
+    settlements = new Map();
+    /** Cache of original intents to allow retries */
+    intents = new Map();
+    /** Interval ID for watchPendingSettlements */
+    watchInterval = null;
+    constructor(proofGenerator, proofVerifier, contract, config = DEFAULT_SETTLEMENT_CONFIG) {
+        this.proofGenerator = proofGenerator;
+        this.proofVerifier = proofVerifier;
+        this.contract = contract;
+        this.config = config;
+    }
+    // ─────────────────────────────────────────
+    // Public API
+    // ─────────────────────────────────────────
+    /**
+     * 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
+     */
+    async settleIntent(intent, targetTxHash) {
+        this.intents.set(intent.intentId, intent);
+        let settlement = this.settlements.get(intent.intentId);
+        if (!settlement) {
+            settlement = {
+                intentId: intent.intentId,
+                solver: intent.solver || "0x0000000000000000000000000000000000000000",
+                targetTx: targetTxHash,
+                status: "pending",
+                startedAt: Math.floor(Date.now() / 1000),
+                claimAttempts: 0,
+            };
+            this.settlements.set(intent.intentId, settlement);
+        }
+        try {
+            const bridgeIntent = toBridgeIntent(intent);
+            if (!bridgeIntent)
+                throw new SettlementError("Invalid bridge intent");
+            // 1. Build CrossChainOrder first — needed to compute the on-chain intentId
+            //    that the contract derives via keccak256(abi.encode(order)).
+            //    The digest MUST use this on-chain intentId, NOT the SDK's string UUID.
+            const tokenAddr = intent.parsedIntent.parameters.inputTokenAddress || ethers.ZeroAddress;
+            const orderData = intent.parsedIntent.parameters.orderData
+                || ethers.AbiCoder.defaultAbiCoder().encode(["address", "uint256"], [tokenAddr, bridgeIntent.amount]);
+            const nonceRaw = intent.parsedIntent.parameters.nonce;
+            if (!nonceRaw)
+                throw new SettlementError(`Intent ${intent.intentId} is missing required field 'nonce'`);
+            const order = {
+                settlementContract: await this.contract.getAddress(),
+                swapper: intent.user,
+                nonce: BigInt(nonceRaw),
+                originChainId: bridgeIntent.sourceChain,
+                initiateDeadline: intent.parsedIntent.parameters.initiateDeadline
+                    ? Number(intent.parsedIntent.parameters.initiateDeadline)
+                    : intent.deadline,
+                fillDeadline: intent.deadline,
+                orderData: orderData
+            };
+            // 2. Compute on-chain intentId = keccak256(abi.encode(order))
+            //    This MUST match what IntentSettlement.sol computes in claim().
+            const onChainIntentId = ethers.keccak256(ethers.AbiCoder.defaultAbiCoder().encode([
+                "tuple(address settlementContract, address swapper, uint256 nonce, uint32 originChainId, uint32 initiateDeadline, uint32 fillDeadline, bytes orderData)"
+            ], [order]));
+            // 3. Generate Proof using the on-chain intentId
+            //    Contract verifies: toEthSignedMessageHash(keccak256(abi.encodePacked(intentId, "FILLED", msg.sender)))
+            settlement.status = "proving";
+            const proof = await this.proofGenerator.generateSignatureProof({
+                intentId: onChainIntentId,
+                targetTxHash,
+                targetChainId: bridgeIntent.targetChain,
+                amount: bridgeIntent.amount,
+                recipient: bridgeIntent.recipient,
+                confirmations: this.config.requiredConfirmations
+            });
+            settlement.proof = proof;
+            // 4. Verify Proof off-chain (sanity check before spending gas)
+            const expectedOracle = this.config.oracleAddress || settlement.solver;
+            const isValid = await this.proofVerifier.verifySignatureProof(proof, expectedOracle, settlement.solver);
+            if (!isValid) {
+                throw new ProofGenerationError(`Local proof verification failed for intent ${onChainIntentId}`);
+            }
+            // 5. Submit Claim
+            settlement.status = "claiming";
+            const tx = await this.contract.claim(order, proof.solverSignature);
+            settlement.sourceTx = tx.hash;
+            await tx.wait();
+            settlement.status = "completed";
+            settlement.settledAt = Math.floor(Date.now() / 1000);
+            return settlement;
+        }
+        catch (error) {
+            await this.handleClaimFailure(intent.intentId, error);
+            throw new ClaimFailedError(intent.intentId, error.message || String(error));
+        }
+    }
+    /**
+     * 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() {
+        if (this.watchInterval)
+            return;
+        this.watchInterval = setInterval(async () => {
+            for (const settlement of this.settlements.values()) {
+                if (settlement.status === "failed" && settlement.claimAttempts < this.config.maxClaimRetries) {
+                    const intent = this.intents.get(settlement.intentId);
+                    if (intent) {
+                        try {
+                            await this.settleIntent(intent, settlement.targetTx);
+                        }
+                        catch (e) {
+                            if (!(e instanceof ClaimFailedError)) {
+                                console.error(`Unexpected error in watchPendingSettlements for ${settlement.intentId}:`, e);
+                            }
+                        }
+                    }
+                }
+            }
+        }, this.config.watchIntervalMs);
+    }
+    /**
+     * Stop watching pending settlements.
+     */
+    stopWatching() {
+        if (this.watchInterval) {
+            clearInterval(this.watchInterval);
+            this.watchInterval = null;
+        }
+    }
+    /**
+     * 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
+     */
+    async handleClaimFailure(intentId, error) {
+        const settlement = this.settlements.get(intentId);
+        if (!settlement)
+            return;
+        settlement.claimAttempts += 1;
+        settlement.error = error.message;
+        settlement.status = "failed";
+        if (settlement.claimAttempts >= this.config.maxClaimRetries) {
+            console.error(`Intent ${intentId} settlement failed permanently after ${settlement.claimAttempts} attempts. Error: ${error.message}`);
+        }
+        else {
+            console.warn(`Intent ${intentId} claim failed, will retry. Error: ${error.message}`);
+        }
+    }
+    // ─────────────────────────────────────────
+    // Getters
+    // ─────────────────────────────────────────
+    /**
+     * Get a settlement record by intentId.
+     */
+    getSettlement(intentId) {
+        return this.settlements.get(intentId);
+    }
+    /**
+     * Get all settlements with a specific status.
+     */
+    getSettlementsByStatus(status) {
+        return Array.from(this.settlements.values()).filter(s => s.status === status);
+    }
+    /**
+     * Get all settlement records.
+     */
+    getAllSettlements() {
+        return Array.from(this.settlements.values());
+    }
+}
+//# sourceMappingURL=settlement-manager.js.map

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

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

package/dist/solver/types/agent.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Solver Agent Types
+ *
+ * Core types untuk Liquidity Agent yang menangani
+ * intent fulfillment dan cross-chain settlement.
+ */
+import type { Address, ChainId } from "../../types/common";
+/**
+ * Agent operating mode
+ *
+ * - simulate: Dry-run tanpa eksekusi on-chain (untuk testing/development)
+ * - live: Real execution on mainnet/testnet
+ */
+export type AgentMode = "simulate" | "live";
+/**
+ * Current agent status
+ */
+export type AgentStatus = "idle" | "processing" | "rebalancing" | "error";
+/**
+ * Agent Configuration
+ *
+ * Konfigurasi utama untuk menginisialisasi LiquidityAgent.
+ *
+ * CONTOH:
+ *   {
+ *     name: "LiquidityBot-01",
+ *     privateKey: "0xabc...",
+ *     supportedChains: [1, 137],
+ *     supportedTokens: ["USDC"],
+ *     mode: "simulate",
+ *   }
+ */
+export interface AgentConfig {
+    /** Human-readable agent name (e.g., "LiquidityBot-01") */
+    name: string;
+    /** Private key for signing transactions (hex string with 0x prefix) */
+    privateKey: string;
+    /** List of supported chain IDs (e.g., [1, 137] for ETH + Polygon) */
+    supportedChains: ChainId[];
+    /** List of supported token symbols (e.g., ["USDC", "USDT"]) */
+    supportedTokens: string[];
+    /** Operating mode: simulate (dry-run) or live (real execution) */
+    mode: AgentMode;
+    /** Maximum number of intents to process concurrently (default: 5) */
+    maxConcurrentIntents?: number;
+    /** Intent timeout in seconds — reject intents older than this (default: 3600) */
+    intentTimeout?: number;
+    /** Agent's registered on-chain address (derived from privateKey) */
+    agentAddress?: Address;
+}
+/**
+ * Result dari solve() operation
+ *
+ * Berisi status eksekusi, profit, dan metadata.
+ */
+export interface SolutionResult {
+    /** Whether the solve was successful */
+    success: boolean;
+    /** Transaction hash on target chain (if executed) */
+    txHash?: string;
+    /** Net profit in USDC (fee + slippage - gas cost) */
+    profit?: string;
+    /** Output amount received by user */
+    output?: string;
+    /** Error message if failed */
+    error?: string;
+    /** Additional metadata */
+    metadata?: SolutionMetadata;
+}
+/**
+ * Metadata tambahan dari solve result
+ */
+export interface SolutionMetadata {
+    /** Time taken to solve (milliseconds) */
+    solveDurationMs: number;
+    /** Source chain ID */
+    sourceChainId: ChainId;
+    /** Target chain ID */
+    targetChainId: ChainId;
+    /** Gas used on target chain */
+    gasUsed?: string;
+    /** Gas cost in USDC equivalent */
+    gasCostUSD?: string;
+    /** Fee breakdown */
+    feeBreakdown?: {
+        baseFee: string;
+        slippageCapture: string;
+        gasCost: string;
+        totalFee: string;
+    };
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/solver/types/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/solver/types/agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,YAAY,GAAG,aAAa,GAAG,OAAO,CAAC;AAE1E;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,WAAW;IACxB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IAEb,uEAAuE;IACvE,UAAU,EAAE,MAAM,CAAC;IAEnB,qEAAqE;IACrE,eAAe,EAAE,OAAO,EAAE,CAAC;IAE3B,+DAA+D;IAC/D,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1B,kEAAkE;IAClE,IAAI,EAAE,SAAS,CAAC;IAEhB,qEAAqE;IACrE,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC3B,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IAEjB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;IAExB,sBAAsB;IACtB,aAAa,EAAE,OAAO,CAAC;IAEvB,sBAAsB;IACtB,aAAa,EAAE,OAAO,CAAC;IAEvB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,oBAAoB;IACpB,YAAY,CAAC,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KACpB,CAAC;CACL"}

package/dist/solver/types/agent.js

@@ -0,0 +1,8 @@
+/**
+ * Solver Agent Types
+ *
+ * Core types untuk Liquidity Agent yang menangani
+ * intent fulfillment dan cross-chain settlement.
+ */
+export {};
+//# sourceMappingURL=agent.js.map

package/dist/solver/types/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../../src/solver/types/agent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/solver/types/execution.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Execution Types
+ *
+ * Types untuk transaction building dan multi-chain execution.
+ */
+import type { Address, ChainId, Hash } from "../../types/common";
+/**
+ * Raw transaction data
+ *
+ * Representasi transaksi yang siap kirim ke chain.
+ * Compatible dengan ethers.js transaction format.
+ */
+export interface Transaction {
+    /** Target contract address */
+    to: Address;
+    /** Encoded function call data */
+    data: string;
+    /** ETH value to send (in wei, usually "0" for ERC20 ops) */
+    value: string;
+    /** Gas limit */
+    gasLimit: string;
+    /** Chain ID where tx will be executed */
+    chainId: ChainId;
+    /** Transaction nonce (managed by executor) */
+    nonce?: number;
+    /** Max fee per gas (EIP-1559) */
+    maxFeePerGas?: string;
+    /** Max priority fee per gas (EIP-1559) */
+    maxPriorityFeePerGas?: string;
+}
+/**
+ * Execution result (single transaction)
+ */
+export interface ExecutionResult {
+    /** Whether the transaction succeeded */
+    success: boolean;
+    /** Transaction hash */
+    txHash?: Hash;
+    /** Gas used by the transaction */
+    gasUsed?: string;
+    /** Block number where tx was included */
+    blockNumber?: number;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Multi-chain execution status
+ */
+export type ExecutionStatus = "pending" | "source_sent" | "target_sent" | "completed" | "failed";
+/**
+ * Multi-Chain Execution
+ *
+ * Tracks paired execution across source and target chains.
+ * Used by solve() flow:
+ * 1. Send on target chain (fulfill user)
+ * 2. Claim on source chain (get solver's payment)
+ */
+export interface MultiChainExecution {
+    /** Execution result on source chain (claim tx) */
+    sourceTx?: ExecutionResult;
+    /** Execution result on target chain (fulfillment tx) */
+    targetTx?: ExecutionResult;
+    /** Current status of the paired execution */
+    status: ExecutionStatus;
+    /** Timestamp when execution started */
+    startedAt: number;
+    /** Timestamp when execution completed (both chains) */
+    completedAt?: number;
+}
+//# sourceMappingURL=execution.d.ts.map

package/dist/solver/types/execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.d.ts","sourceRoot":"","sources":["../../../src/solver/types/execution.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IACxB,8BAA8B;IAC9B,EAAE,EAAE,OAAO,CAAC;IAEZ,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IAEb,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IAEd,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IAEjB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IAEjB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,iCAAiC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,0CAA0C;IAC1C,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IAEjB,uBAAuB;IACvB,MAAM,CAAC,EAAE,IAAI,CAAC;IAEd,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACrB,SAAS,GACT,aAAa,GACb,aAAa,GACb,WAAW,GACX,QAAQ,CAAC;AAEf;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAChC,kDAAkD;IAClD,QAAQ,CAAC,EAAE,eAAe,CAAC;IAE3B,wDAAwD;IACxD,QAAQ,CAAC,EAAE,eAAe,CAAC;IAE3B,6CAA6C;IAC7C,MAAM,EAAE,eAAe,CAAC;IAExB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAElB,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/solver/types/execution.js

@@ -0,0 +1,7 @@
+/**
+ * Execution Types
+ *
+ * Types untuk transaction building dan multi-chain execution.
+ */
+export {};
+//# sourceMappingURL=execution.js.map

package/dist/solver/types/execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.js","sourceRoot":"","sources":["../../../src/solver/types/execution.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/solver/types/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Solver Types - Barrel Export
+ *
+ * Re-export all solver-specific types from a single entry point.
+ * Usage: import { AgentConfig, SolverIntent, ... } from "./"
+ */
+export * from "./agent";
+export * from "./inventory";
+export * from "./intent";
+export * from "./settlement";
+export * from "./pricing";
+export * from "./execution";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/solver/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/solver/types/index.js

@@ -0,0 +1,13 @@
+/**
+ * Solver Types - Barrel Export
+ *
+ * Re-export all solver-specific types from a single entry point.
+ * Usage: import { AgentConfig, SolverIntent, ... } from "./"
+ */
+export * from "./agent";
+export * from "./inventory";
+export * from "./intent";
+export * from "./settlement";
+export * from "./pricing";
+export * from "./execution";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/solver/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/solver/types/intent.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Solver Intent Types
+ *
+ * Types khusus solver — merepresentasikan intent yang sudah
+ * di-parse dan siap untuk diproses oleh LiquidityAgent.
+ *
+ * Extends dari parser types (StructuredIntent) dengan
+ * menambahkan solver-specific fields.
+ */
+import type { StructuredIntent } from "../../types/intent";
+import type { Address, ChainId, Hash } from "../../types/common";
+/**
+ * Status lifecycle dari sebuah intent di sisi solver
+ *
+ *  pending → matched → fulfilling → fulfilled
+ *                └→ failed
+ *                └→ refunded
+ */
+export type IntentStatus = "pending" | "matched" | "fulfilling" | "fulfilled" | "failed" | "refunded";
+/**
+ * Solver Intent
+ *
+ * Representasi intent dari perspektif solver.
+ * Menggabungkan data dari parser (StructuredIntent) dengan
+ * solver-specific metadata (intentId, hash, signature, dsb).
+ */
+export interface SolverIntent {
+    /** Unique intent ID (uuid or on-chain ID) */
+    intentId: string;
+    /** Keccak256 hash of intent data — used for verification */
+    intentHash: Hash;
+    /** User's wallet address (intent originator) */
+    user: Address;
+    /** User's signature over intentHash */
+    signature: string;
+    /** Deadline timestamp (Unix seconds) — intent expired after this */
+    deadline: number;
+    /** Current status in solver pipeline */
+    status: IntentStatus;
+    /** Original parsed intent from parser */
+    parsedIntent: StructuredIntent;
+    /** Timestamp when solver received this intent */
+    receivedAt: number;
+    /** Solver address yang memproses intent ini */
+    solver?: Address;
+}
+/**
+ * Bridge Intent
+ *
+ * Specialized intent type untuk cross-chain bridge operations.
+ * Ini adalah intent type utama yang di-handle oleh LiquidityAgent.
+ *
+ * CONTOH:
+ *   "Bridge 1000 USDC from Ethereum to Polygon"
+ *   → {
+ *       sourceChain: 1,
+ *       targetChain: 137,
+ *       token: "USDC",
+ *       amount: "1000000000",   // 1000 * 10^6
+ *       recipient: "0xabc...",
+ *       maxSlippage: 50,        // 0.5%
+ *     }
+ */
+export interface BridgeIntent {
+    /** Source chain ID (where user's funds are locked) */
+    sourceChain: ChainId;
+    /** Target chain ID (where solver sends funds) */
+    targetChain: ChainId;
+    /** Token symbol (e.g., "USDC") */
+    token: string;
+    /** Amount in token's smallest unit */
+    amount: string;
+    /** Recipient address on target chain */
+    recipient: Address;
+    /** Maximum acceptable slippage in basis points (100 = 1%) */
+    maxSlippage: number;
+}
+/**
+ * Helper: Extract BridgeIntent dari SolverIntent
+ */
+export declare function toBridgeIntent(intent: SolverIntent): BridgeIntent | null;
+//# sourceMappingURL=intent.d.ts.map

package/dist/solver/types/intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../../src/solver/types/intent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAClB,SAAS,GACT,SAAS,GACT,YAAY,GACZ,WAAW,GACX,QAAQ,GACR,UAAU,CAAC;AAEjB;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IACzB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IAEjB,4DAA4D;IAC5D,UAAU,EAAE,IAAI,CAAC;IAEjB,gDAAgD;IAChD,IAAI,EAAE,OAAO,CAAC;IAEd,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAElB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IAEjB,wCAAwC;IACxC,MAAM,EAAE,YAAY,CAAC;IAErB,yCAAyC;IACzC,YAAY,EAAE,gBAAgB,CAAC;IAE/B,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IAEnB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,YAAY;IACzB,sDAAsD;IACtD,WAAW,EAAE,OAAO,CAAC;IAErB,iDAAiD;IACjD,WAAW,EAAE,OAAO,CAAC;IAErB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IAEd,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IAEf,wCAAwC;IACxC,SAAS,EAAE,OAAO,CAAC;IAEnB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,GAAG,IAAI,CAuBxE"}

package/dist/solver/types/intent.js

@@ -0,0 +1,33 @@
+/**
+ * Solver Intent Types
+ *
+ * Types khusus solver — merepresentasikan intent yang sudah
+ * di-parse dan siap untuk diproses oleh LiquidityAgent.
+ *
+ * Extends dari parser types (StructuredIntent) dengan
+ * menambahkan solver-specific fields.
+ */
+/**
+ * Helper: Extract BridgeIntent dari SolverIntent
+ */
+export function toBridgeIntent(intent) {
+    const params = intent.parsedIntent.parameters;
+    if (intent.parsedIntent.intentType !== "bridge")
+        return null;
+    if (!params.sourceChain ||
+        !params.targetChain ||
+        !params.inputToken ||
+        !params.inputAmount ||
+        !params.recipient) {
+        return null;
+    }
+    return {
+        sourceChain: Number(params.sourceChain),
+        targetChain: Number(params.targetChain),
+        token: params.inputToken,
+        amount: params.inputAmount,
+        recipient: params.recipient,
+        maxSlippage: intent.parsedIntent.constraints.maxSlippage ?? 50,
+    };
+}
+//# sourceMappingURL=intent.js.map

package/dist/solver/types/intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.js","sourceRoot":"","sources":["../../../src/solver/types/intent.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA6FH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAoB;IAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC;IAE9C,IAAI,MAAM,CAAC,YAAY,CAAC,UAAU,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE7D,IACI,CAAC,MAAM,CAAC,WAAW;QACnB,CAAC,MAAM,CAAC,WAAW;QACnB,CAAC,MAAM,CAAC,UAAU;QAClB,CAAC,MAAM,CAAC,WAAW;QACnB,CAAC,MAAM,CAAC,SAAS,EACnB,CAAC;QACC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO;QACH,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAY;QAClD,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAY;QAClD,KAAK,EAAE,MAAM,CAAC,UAAU;QACxB,MAAM,EAAE,MAAM,CAAC,WAAW;QAC1B,SAAS,EAAE,MAAM,CAAC,SAAoB;QACtC,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC,WAAW,IAAI,EAAE;KACjE,CAAC;AACN,CAAC"}