@terkoizmy/intent-sdk 1.0.0

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

@@ -0,0 +1,204 @@
+/**
+ * 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
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// ABI
+// ─────────────────────────────────────────────────────────────────────────────
+export const INTENT_SETTLEMENT_ABI = [
+    // open() - called by swapper to lock funds intent
+    {
+        type: "function",
+        name: "open",
+        stateMutability: "nonpayable",
+        inputs: [
+            {
+                name: "order",
+                type: "tuple",
+                components: [
+                    { name: "settlementContract", type: "address" },
+                    { name: "swapper", type: "address" },
+                    { name: "nonce", type: "uint256" },
+                    { name: "originChainId", type: "uint32" },
+                    { name: "initiateDeadline", type: "uint32" },
+                    { name: "fillDeadline", type: "uint32" },
+                    { name: "orderData", type: "bytes" },
+                ],
+            },
+            { name: "signature", type: "bytes" },
+            { name: "orderData", type: "bytes" },
+        ],
+        outputs: [],
+    },
+    // claim() - alternative to fill(), called by solver after target-chain proof
+    {
+        type: "function",
+        name: "claim",
+        stateMutability: "nonpayable",
+        inputs: [
+            {
+                name: "order",
+                type: "tuple",
+                components: [
+                    { name: "settlementContract", type: "address" },
+                    { name: "swapper", type: "address" },
+                    { name: "nonce", type: "uint256" },
+                    { name: "originChainId", type: "uint32" },
+                    { name: "initiateDeadline", type: "uint32" },
+                    { name: "fillDeadline", type: "uint32" },
+                    { name: "orderData", type: "bytes" },
+                ],
+            },
+            { name: "signature", type: "bytes" },
+        ],
+        outputs: [],
+    },
+    // refund() - returns locked funds to swapper after fillDeadline expires
+    {
+        type: "function",
+        name: "refund",
+        stateMutability: "nonpayable",
+        inputs: [
+            {
+                name: "order",
+                type: "tuple",
+                components: [
+                    { name: "settlementContract", type: "address" },
+                    { name: "swapper", type: "address" },
+                    { name: "nonce", type: "uint256" },
+                    { name: "originChainId", type: "uint32" },
+                    { name: "initiateDeadline", type: "uint32" },
+                    { name: "fillDeadline", type: "uint32" },
+                    { name: "orderData", type: "bytes" },
+                ],
+            },
+        ],
+        outputs: [],
+    },
+    // isIntentSettled()
+    {
+        type: "function",
+        name: "isIntentSettled",
+        stateMutability: "view",
+        inputs: [{ name: "intentId", type: "bytes32" }],
+        outputs: [{ name: "", type: "bool" }],
+    },
+    // Events
+    {
+        type: "event",
+        name: "FundsLocked",
+        inputs: [
+            { name: "intentId", type: "bytes32", indexed: true },
+            { name: "swapper", type: "address", indexed: true },
+            { name: "token", type: "address", indexed: false },
+            { name: "amount", type: "uint256", indexed: false },
+        ],
+    },
+    {
+        type: "event",
+        name: "FundsClaimed",
+        inputs: [
+            { name: "intentId", type: "bytes32", indexed: true },
+            { name: "solver", type: "address", indexed: true },
+            { name: "amount", type: "uint256", indexed: false },
+        ],
+    },
+    {
+        type: "event",
+        name: "IntentFilled",
+        inputs: [
+            { name: "orderId", type: "bytes32", indexed: true },
+            { name: "filler", type: "address", indexed: true },
+            { name: "originData", type: "bytes", indexed: false },
+            { name: "fillerData", type: "bytes", indexed: false },
+        ],
+    },
+];
+// ─────────────────────────────────────────────────────────────────────────────
+// ViemSettlementContract
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * 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 class ViemSettlementContract {
+    address;
+    publicClient;
+    walletClient;
+    constructor(address, publicClient, walletClient) {
+        this.address = address;
+        this.publicClient = publicClient;
+        this.walletClient = walletClient;
+    }
+    /**
+     * Check if a specific intent ID has already been settled on this contract.
+     */
+    async isSettled(intentId) {
+        return await this.publicClient.readContract({
+            address: this.address,
+            abi: INTENT_SETTLEMENT_ABI,
+            functionName: "isIntentSettled",
+            args: [intentId],
+        });
+    }
+    /**
+     * Call `claim()` using a solver signature as proof.
+     * Alternative to fill() for the claim-based settlement flow.
+     */
+    async claim(order, solverSignature) {
+        console.log("claim log 1");
+        if (!this.walletClient.account) {
+            throw new Error("WalletClient has no account attached");
+        }
+        // Step 1: Simulate the tx first to catch reverts early
+        try {
+            await this.publicClient.simulateContract({
+                address: this.address,
+                abi: INTENT_SETTLEMENT_ABI,
+                functionName: "claim",
+                args: [order, solverSignature],
+                account: this.walletClient.account,
+            });
+        }
+        catch (error) {
+            console.error(`[Settlement] Simulation failed for claim():`);
+            const fs = require('fs');
+            fs.writeFileSync('debug.json', JSON.stringify(error, (key, value) => typeof value === 'bigint' ? value.toString() : value, 2));
+            throw new Error(`Simulation failed: ${error.message}`);
+        }
+        const txHash = await this.walletClient.writeContract({
+            chain: this.walletClient.chain,
+            address: this.address,
+            abi: INTENT_SETTLEMENT_ABI,
+            functionName: "claim",
+            args: [order, solverSignature],
+            account: this.walletClient.account,
+        });
+        console.log(`[Settlement] Broadcasted claim() tx: ${txHash}`);
+        const receipt = await this.publicClient.waitForTransactionReceipt({ hash: txHash });
+        if (receipt.status !== "success") {
+            throw new Error(`Claim transaction reverted: ${txHash}`);
+        }
+        return { txHash, blockNumber: receipt.blockNumber };
+    }
+    getAddress() {
+        return this.address;
+    }
+}
+//# sourceMappingURL=viem-settlement-contract.js.map

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

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

package/dist/solver/index.d.ts

@@ -0,0 +1,87 @@
+/**
+ * IntentSolver — Phase K
+ *
+ * Public-facing wrapper class that encapsulates all solver subsystems
+ * into a single, easy-to-use interface.
+ */
+import { LiquidityAgent } from "./agent/liquidity-agent";
+import { type LiquidityAgentConfig } from "./agent/agent-config";
+import { InventoryManager } from "./inventory/inventory-manager";
+import { DynamicPricing } from "./pricing/dynamic-pricing";
+import { SettlementManager } from "./settlement/settlement-manager";
+import { ProofGenerator } from "./settlement/proof-generator";
+import { ProofVerifier } from "./settlement/proof-verifier";
+import { IntentSettlementContract } from "./contracts/intent-settlement/intent-settlement";
+import { WalletManager } from "../shared/wallet-manager/wallet-manager";
+import { RPCProviderManager } from "../shared/rpc/provider-manager";
+import { ChainRegistry } from "../shared/chain-registry/registry";
+import { TokenRegistry } from "../shared/token-registry/registry";
+import { MempoolMonitor } from "./mempool/mempool-monitor";
+import { MempoolClient } from "./mempool/mempool-client";
+import { IntentFilter } from "./mempool/intent-filter";
+import { SolutionSubmitter } from "./mempool/solution-submitter";
+import { ProfitTracker } from "./monitoring/profit-tracker";
+import type { SolverIntent } from "./types/intent";
+import type { SolutionResult } from "./types/agent";
+import type { PricingResult } from "./types/pricing";
+export declare class IntentSolver {
+    readonly config: LiquidityAgentConfig;
+    readonly chainRegistry: ChainRegistry;
+    readonly tokenRegistry: TokenRegistry;
+    readonly rpcProviderManager: RPCProviderManager;
+    readonly walletManager: WalletManager;
+    readonly inventoryManager: InventoryManager;
+    readonly dynamicPricing: DynamicPricing;
+    readonly proofGenerator: ProofGenerator;
+    readonly proofVerifier: ProofVerifier;
+    readonly settlementContract: IntentSettlementContract;
+    readonly settlementManager: SettlementManager;
+    readonly agent: LiquidityAgent;
+    readonly mempoolClient: MempoolClient;
+    readonly intentFilter: IntentFilter;
+    readonly solutionSubmitter: SolutionSubmitter;
+    readonly profitTracker: ProfitTracker;
+    readonly mempoolMonitor: MempoolMonitor;
+    constructor(userConfig: Partial<LiquidityAgentConfig> & {
+        agent: {
+            privateKey: string;
+        };
+    });
+    /**
+     * Initialize non-blocking resources (e.g. fetch initial balances, derive address)
+     * Must be called before `solve` or `start`.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Start the background mempool listener to automatically process intents
+     */
+    start(mempoolUrl: string): void;
+    /**
+     * Stop background processes and disconnect WebSockets
+     */
+    stop(): void;
+    /**
+     * Get a quote for a bridge intent
+     */
+    getQuote(intent: SolverIntent): PricingResult;
+    /**
+     * Check if the agent wants and can solve this intent
+     */
+    canSolve(intent: SolverIntent): boolean;
+    /**
+     * Attempt to solve an intent directly (bypasses mempool listener)
+     */
+    solve(intent: SolverIntent): Promise<SolutionResult>;
+    /**
+     * Check the current state of the agent
+     */
+    getStatus(): import("..").AgentStatus;
+    /**
+     * Fetch profit and operational metrics
+     */
+    getStats(): {
+        profitStats: import("./monitoring").ProfitStats;
+        mempoolStats: import("./mempool").MempoolStats;
+    };
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/solver/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAoB,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAI5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,qBAAa,YAAY;IACrB,SAAgB,MAAM,EAAE,oBAAoB,CAAC;IAG7C,SAAgB,aAAa,EAAE,aAAa,CAAC;IAC7C,SAAgB,aAAa,EAAE,aAAa,CAAC;IAC7C,SAAgB,kBAAkB,EAAE,kBAAkB,CAAC;IACvD,SAAgB,aAAa,EAAE,aAAa,CAAC;IAC7C,SAAgB,gBAAgB,EAAE,gBAAgB,CAAC;IACnD,SAAgB,cAAc,EAAE,cAAc,CAAC;IAC/C,SAAgB,cAAc,EAAE,cAAc,CAAC;IAC/C,SAAgB,aAAa,EAAE,aAAa,CAAC;IAC7C,SAAgB,kBAAkB,EAAE,wBAAwB,CAAC;IAC7D,SAAgB,iBAAiB,EAAE,iBAAiB,CAAC;IACrD,SAAgB,KAAK,EAAE,cAAc,CAAC;IAGtC,SAAgB,aAAa,EAAE,aAAa,CAAC;IAC7C,SAAgB,YAAY,EAAE,YAAY,CAAC;IAC3C,SAAgB,iBAAiB,EAAE,iBAAiB,CAAC;IACrD,SAAgB,aAAa,EAAE,aAAa,CAAC;IAC7C,SAAgB,cAAc,EAAE,cAAc,CAAC;gBAEnC,UAAU,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG;QAAE,KAAK,EAAE;YAAE,UAAU,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;IAwFzF;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC;;OAEG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAK/B;;OAEG;IACH,IAAI,IAAI,IAAI;IAKZ;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa;IAI7C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO;IAIvC;;OAEG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAe1D;;OAEG;IACH,SAAS;IAIT;;OAEG;IACH,QAAQ;;;;CAMX"}

package/dist/solver/index.js

@@ -0,0 +1,167 @@
+/**
+ * IntentSolver — Phase K
+ *
+ * Public-facing wrapper class that encapsulates all solver subsystems
+ * into a single, easy-to-use interface.
+ */
+import { LiquidityAgent } from "./agent/liquidity-agent";
+import { buildAgentConfig } from "./agent/agent-config";
+import { InventoryManager } from "./inventory/inventory-manager";
+import { DynamicPricing } from "./pricing/dynamic-pricing";
+import { SettlementManager } from "./settlement/settlement-manager";
+import { ProofGenerator } from "./settlement/proof-generator";
+import { ProofVerifier } from "./settlement/proof-verifier";
+import { IntentSettlementContract } from "./contracts/intent-settlement/intent-settlement";
+import { WalletManager } from "../shared/wallet-manager/wallet-manager";
+import { RPCProviderManager } from "../shared/rpc/provider-manager";
+import { ChainRegistry } from "../shared/chain-registry/registry";
+import { SUPPORTED_CHAINS } from "../config/chains";
+import { TokenRegistry } from "../shared/token-registry/registry";
+import { MempoolMonitor } from "./mempool/mempool-monitor";
+import { MempoolClient } from "./mempool/mempool-client";
+import { IntentFilter } from "./mempool/intent-filter";
+import { SolutionSubmitter } from "./mempool/solution-submitter";
+import { ProfitTracker } from "./monitoring/profit-tracker";
+import { ethers } from "ethers";
+export class IntentSolver {
+    config;
+    // Core Subsystems exposed if advanced users need them
+    chainRegistry;
+    tokenRegistry;
+    rpcProviderManager;
+    walletManager;
+    inventoryManager;
+    dynamicPricing;
+    proofGenerator;
+    proofVerifier;
+    settlementContract;
+    settlementManager;
+    agent;
+    // Mempool & Monitoring
+    mempoolClient;
+    intentFilter;
+    solutionSubmitter;
+    profitTracker;
+    mempoolMonitor;
+    constructor(userConfig) {
+        // Deep merge user config with SDK defaults
+        this.config = buildAgentConfig(userConfig);
+        // 1. Foundation layer
+        this.chainRegistry = new ChainRegistry();
+        this.chainRegistry.registerAll(SUPPORTED_CHAINS);
+        this.tokenRegistry = new TokenRegistry();
+        this.rpcProviderManager = new RPCProviderManager();
+        const signerFactory = (privateKey, chainId) => {
+            // Provide a basic wrapper compatible with both ethers and our WalletSigner interface
+            const wallet = new ethers.Wallet(privateKey);
+            return {
+                getAddress: () => wallet.address,
+                signMessage: async (msg) => wallet.signMessage(msg),
+                signTypedData: async (domain, types, value) => wallet.signTypedData(domain, types, value)
+            };
+        };
+        this.walletManager = new WalletManager(this.config.agent.privateKey, signerFactory);
+        // 2. Inventory & Pricing
+        this.inventoryManager = new InventoryManager(this.walletManager, this.tokenRegistry, this.chainRegistry, this.rpcProviderManager, this.config.inventory);
+        this.dynamicPricing = new DynamicPricing(this.config.pricing, this.inventoryManager);
+        // 3. Settlement
+        // Create an adapter for IProviderForProof
+        const providerForProof = {
+            getTransactionReceipt: async (chainId, txHash) => {
+                const provider = this.rpcProviderManager.getProvider(chainId);
+                return provider.getTransactionReceipt(txHash);
+            },
+            getBlockNumber: async (chainId) => {
+                return this.rpcProviderManager.getProvider(chainId).getBlockNumber();
+            }
+        };
+        // Use the primary chain signer as the proof signer
+        const primaryChain = this.config.agent.supportedChains[0] || 1;
+        const proofSigner = this.walletManager.getSigner(primaryChain);
+        this.proofGenerator = new ProofGenerator(proofSigner, providerForProof);
+        this.proofVerifier = new ProofVerifier();
+        // Initialize the contract wrapper with ethers.Wallet for proper signing
+        const settlementSigner = new ethers.Wallet(this.config.agent.privateKey);
+        this.settlementContract = new IntentSettlementContract(this.config.contractAddress, settlementSigner);
+        this.settlementManager = new SettlementManager(this.proofGenerator, this.proofVerifier, this.settlementContract, this.config.settlement);
+        // 4. Core Agent Orchestrator
+        this.agent = new LiquidityAgent(this.inventoryManager, this.dynamicPricing, this.settlementManager, this.walletManager, this.config);
+        // 5. Monitoring
+        this.profitTracker = new ProfitTracker();
+        // 6. Mempool integration
+        this.mempoolClient = new MempoolClient();
+        this.intentFilter = new IntentFilter(this.agent);
+        this.solutionSubmitter = new SolutionSubmitter(this.mempoolClient);
+        this.mempoolMonitor = new MempoolMonitor(this.mempoolClient, this.intentFilter, this.agent, this.solutionSubmitter);
+    }
+    /**
+     * Initialize non-blocking resources (e.g. fetch initial balances, derive address)
+     * Must be called before `solve` or `start`.
+     */
+    async initialize() {
+        // Inject provider into settlement signer
+        const primaryChain = this.config.agent.supportedChains[0] || 1;
+        const config = this.chainRegistry.get(primaryChain);
+        if (config && config.rpcUrl) {
+            const provider = new ethers.JsonRpcProvider(config.rpcUrl);
+            const connectedSigner = new ethers.Wallet(this.config.agent.privateKey, provider);
+            this.settlementContract.updateSigner(connectedSigner);
+        }
+        await this.agent.initialize();
+    }
+    /**
+     * Start the background mempool listener to automatically process intents
+     */
+    start(mempoolUrl) {
+        this.mempoolClient.connect(mempoolUrl);
+        this.mempoolMonitor.start();
+    }
+    /**
+     * Stop background processes and disconnect WebSockets
+     */
+    stop() {
+        this.mempoolMonitor.stop();
+        this.agent.stop();
+    }
+    /**
+     * Get a quote for a bridge intent
+     */
+    getQuote(intent) {
+        return this.agent.getQuote(intent);
+    }
+    /**
+     * Check if the agent wants and can solve this intent
+     */
+    canSolve(intent) {
+        return this.agent.canSolve(intent);
+    }
+    /**
+     * Attempt to solve an intent directly (bypasses mempool listener)
+     */
+    async solve(intent) {
+        // Track standalone solves as well
+        if (this.canSolve(intent)) {
+            const pricing = this.getQuote(intent);
+            this.profitTracker.recordAttempt(intent.intentId, pricing);
+        }
+        const result = await this.agent.solve(intent);
+        this.profitTracker.recordResult(intent.intentId, result.success, result.gasUsed || "0");
+        return result;
+    }
+    /**
+     * Check the current state of the agent
+     */
+    getStatus() {
+        return this.agent.getStatus();
+    }
+    /**
+     * Fetch profit and operational metrics
+     */
+    getStats() {
+        return {
+            profitStats: this.profitTracker.getStats(),
+            mempoolStats: this.mempoolMonitor.getStats()
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/solver/index.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * Inventory Module — Barrel Export
+ */
+export * from "./inventory-manager";
+export * from "./inventory-monitor";
+export * from "./rebalancer";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/solver/inventory/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC"}

package/dist/solver/inventory/index.js

@@ -0,0 +1,7 @@
+/**
+ * Inventory Module — Barrel Export
+ */
+export * from "./inventory-manager";
+export * from "./inventory-monitor";
+export * from "./rebalancer";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/solver/inventory/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC"}

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

@@ -0,0 +1,135 @@
+/**
+ * Inventory Manager
+ *
+ * Tracks USDC/token balances across all supported chains.
+ * Handles locking/unlocking for pending intents and
+ * balance snapshots for decision-making.
+ *
+ * Lifecycle per intent:
+ *   loadBalances() → canFulfill() → lockAmount()
+ *   → (success) confirmDeduction() → unlockAmount()
+ *   → (failure) unlockAmount()
+ */
+import type { ChainId } from "../../types/common";
+import type { InventorySnapshot } from "../types/inventory";
+import type { TokenRegistry } from "../../shared/token-registry/registry";
+import type { ChainRegistry } from "../../shared/chain-registry/registry";
+import type { RPCProviderManager } from "../../shared/rpc/provider-manager";
+import type { WalletManager } from "../../shared/wallet-manager/wallet-manager";
+/**
+ * Parameters untuk konstruksi InventoryManager
+ */
+export interface InventoryManagerConfig {
+    /** Minimum reserve percentage to always keep per chain (0–1) */
+    minReservePercent: number;
+}
+export declare class InventoryManager {
+    private readonly walletManager;
+    private readonly tokenRegistry;
+    private readonly chainRegistry;
+    private readonly providerManager;
+    private readonly config;
+    /**
+     * Map of chainId:tokenSymbol → InventoryBalance
+     * Format key: `${chainId}:${token}` e.g. "137:USDC"
+     */
+    private balances;
+    /**
+     * Track active locks per intent: intentId → list of lock keys
+     * Used to release all locks by intentId on success/failure.
+     */
+    private locks;
+    constructor(walletManager: WalletManager, tokenRegistry: TokenRegistry, chainRegistry: ChainRegistry, providerManager: RPCProviderManager, config: InventoryManagerConfig);
+    /** Generate composite map key */
+    private key;
+    /**
+     * Load on-chain balances for all registered chains and supported tokens.
+     *
+     * Calls ERC20.balanceOf(agentAddress) on each (chain, token) pair.
+     * Safe to call repeatedly (e.g., from InventoryMonitor polling).
+     * Preserves existing locked amounts so in-flight intent locks are not lost.
+     */
+    loadBalances(): Promise<void>;
+    /**
+     * Refresh the balance of a specific token on a specific chain.
+     * Useful for targeted updates after a successful transfer without
+     * reloading the entire multi-chain inventory.
+     *
+     * @param chainId - Chain to query
+     * @param tokenSymbol - Token symbol to query (e.g. "USDC")
+     */
+    refreshBalance(chainId: ChainId, tokenSymbol: string): Promise<void>;
+    /**
+     * Get current available balance (available - locked) for a token on a chain.
+     *
+     * @param chainId - Chain to query
+     * @param token   - Token symbol (e.g. "USDC")
+     * @returns Available balance in token's smallest unit. Returns 0n if not tracked.
+     */
+    getBalance(chainId: ChainId, token: string): bigint;
+    /**
+     * Get total available balance across all chains for a token.
+     *
+     * Useful for global profitability checks.
+     *
+     * @param token - Token symbol (e.g. "USDC")
+     * @returns Sum of (available - locked) across all chains
+     */
+    getTotalBalance(token: string): bigint;
+    /**
+     * Check if we have enough balance to fulfill an intent.
+     *
+     * Must maintain minReservePercent after the deduction.
+     * Formula: available - locked - amount >= total * minReservePercent
+     *
+     * @param chainId - Target chain for fulfillment
+     * @param token   - Token to send
+     * @param amount  - Amount required (in smallest unit)
+     * @returns true if we can safely fill without breaching reserve
+     */
+    canFulfill(chainId: ChainId, token: string, amount: bigint): boolean;
+    /**
+     * Lock an amount for a pending intent (reserve it).
+     *
+     * Throws InsufficientInventoryError if not enough available.
+     * Throws InventoryLockError if lock already exists for intentId+token+chain.
+     *
+     * @param chainId  - Chain where funds will be sent
+     * @param token    - Token to lock
+     * @param amount   - Amount to lock
+     * @param intentId - Intent ID for tracking (used in unlock/confirm)
+     */
+    lockAmount(chainId: ChainId, token: string, amount: bigint, intentId: string): void;
+    /**
+     * Release a previously locked amount (on success or failure).
+     *
+     * Safe to call even if intent wasn't locked (idempotent).
+     * Throws in dev mode if `amount` does not match the stored lock amount
+     * (helps catch accounting bugs early).
+     *
+     * @param chainId  - Chain of the lock
+     * @param token    - Token to unlock
+     * @param amount   - Expected amount to unlock (validated against stored lock)
+     * @param intentId - Intent ID (must match the original lockAmount call)
+     */
+    unlockAmount(chainId: ChainId, token: string, amount: bigint, intentId: string): void;
+    /**
+     * Permanently deduct balance after successfully sending to user.
+     *
+     * Called after the target chain tx is confirmed. Reduces both
+     * available and locked (since we locked it first).
+     *
+     * @param chainId  - Chain where send happened
+     * @param token    - Token that was sent
+     * @param amount   - Amount sent
+     * @param intentId - Intent ID for tracking
+     */
+    confirmDeduction(chainId: ChainId, token: string, amount: bigint, intentId: string): void;
+    /**
+     * Get a full snapshot of all current balances and total USD value.
+     *
+     * @returns InventorySnapshot with all chain balances and a timestamp
+     */
+    getSnapshot(): InventorySnapshot;
+}
+//# sourceMappingURL=inventory-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inventory-manager.d.ts","sourceRoot":"","sources":["../../../src/solver/inventory/inventory-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAE1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAIhF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,gEAAgE;IAChE,iBAAiB,EAAE,MAAM,CAAC;CAC7B;AAED,qBAAa,gBAAgB;IAcrB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAjB3B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAA4C;IAE5D;;;OAGG;IACH,OAAO,CAAC,KAAK,CAAkE;gBAG1D,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,aAAa,EAC5B,aAAa,EAAE,aAAa,EAC5B,eAAe,EAAE,kBAAkB,EACnC,MAAM,EAAE,sBAAsB;IAOnD,iCAAiC;IACjC,OAAO,CAAC,GAAG;IAQX;;;;;;OAMG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAyCnC;;;;;;;OAOG;IACG,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B1E;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAWnD;;;;;;;OAOG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IActC;;;;;;;;;;OAUG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAyBpE;;;;;;;;;;OAUG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAsCnF;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAwCrF;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAkCzF;;;;OAIG;IACH,WAAW,IAAI,iBAAiB;CAoBnC"}