@terkoizmy/intent-sdk 1.0.0

package/dist/shared/wallet-manager/wallet-manager.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Wallet Manager
+ *
+ * Manages solver's wallet across multiple EVM chains.
+ * Single private key → multiple chain connections.
+ *
+ * NOTE: Ini adalah lightweight abstraction tanpa dependency ethers.js.
+ * Di Phase B+ akan di-extend dengan actual ethers.Wallet integration.
+ * Untuk sekarang, menyediakan interface dan basic key management.
+ *
+ * USAGE:
+ *   const wallet = new WalletManager("0xprivatekey...", chainRegistry, providerManager);
+ *   const address = wallet.getAddress();
+ *   const sig = await wallet.signMessage("hello");
+ */
+import type { Address, ChainId, Hash } from "../../types/common";
+/**
+ * Wallet signer interface
+ *
+ * Abstraction atas signing — bisa di-implement dengan ethers.js, viem, atau mock.
+ */
+export interface WalletSigner {
+    /** Get the wallet address */
+    getAddress(): Address;
+    /** Sign arbitrary message */
+    signMessage(message: string): Promise<string>;
+    /** Sign typed data (EIP-712) */
+    signTypedData?(domain: object, types: object, value: object): Promise<string>;
+    /**
+     * Send a transaction (sign and broadcast).
+     *
+     * @param tx - Transaction payload
+     * @returns Transaction hash
+     */
+    sendTransaction?(tx: {
+        to: Address;
+        data?: `0x${string}`;
+        value?: bigint;
+        gas?: bigint;
+    }): Promise<Hash | string>;
+}
+/**
+ * WalletManager
+ *
+ * Mengelola private key solver dan menyediakan signing capabilities.
+ * Address sama di semua EVM chains (derived dari private key).
+ */
+export declare class WalletManager {
+    private readonly privateKey;
+    private cachedAddress;
+    /**
+     * Custom signer factory — inject ethers.js or viem signer externally.
+     * Jika tidak disediakan, WalletManager hanya mengelola key storage.
+     */
+    private signerFactory?;
+    constructor(privateKey: string, signerFactory?: (privateKey: string, chainId: ChainId) => WalletSigner);
+    /**
+     * Set or update the signer factory after instantiation.
+     */
+    setSignerFactory(factory: (privateKey: string, chainId: ChainId) => WalletSigner): void;
+    /**
+     * Get solver's address (same across all EVM chains).
+     *
+     * Jika signer factory tersedia, derive dari signer.
+     * Otherwise, compute from private key secara manual.
+     */
+    getAddress(): Address;
+    /**
+     * Sign an arbitrary message with the solver's private key.
+     *
+     * Requires signerFactory to be configured.
+     */
+    signMessage(message: string): Promise<string>;
+    /**
+     * Send a transaction using the solver's configured signer for the chain.
+     */
+    sendTransaction(chainId: ChainId, tx: {
+        to: Address;
+        data?: `0x${string}`;
+        value?: bigint;
+        gas?: bigint;
+    }): Promise<Hash | string>;
+    /**
+     * Get a signer for a specific chain.
+
+     *
+     * The returned signer has the same address but is connected
+     * to the provider for the specified chain.
+     */
+    getSigner(chainId: ChainId): WalletSigner;
+    /**
+     * Get private key (careful — only use internally).
+     */
+    getPrivateKey(): string;
+}
+//# sourceMappingURL=wallet-manager.d.ts.map

package/dist/shared/wallet-manager/wallet-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-manager.d.ts","sourceRoot":"","sources":["../../../src/shared/wallet-manager/wallet-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAEjE;;;;GAIG;AACH,MAAM,WAAW,YAAY;IACzB,6BAA6B;IAC7B,UAAU,IAAI,OAAO,CAAC;IAEtB,6BAA6B;IAC7B,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9C,gCAAgC;IAChC,aAAa,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9E;;;;;OAKG;IACH,eAAe,CAAC,CAAC,EAAE,EAAE;QACjB,EAAE,EAAE,OAAO,CAAC;QACZ,IAAI,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,GAAG,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;CAC9B;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,aAAa,CAAwB;IAE7C;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAC,CAAyD;gBAG3E,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,YAAY;IAU1E;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,YAAY,GAAG,IAAI;IAKvF;;;;;OAKG;IACH,UAAU,IAAI,OAAO;IAkBrB;;;;OAIG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKnD;;OAEG;IACG,eAAe,CACjB,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GACxE,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC;IAQzB;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,YAAY;IAUzC;;OAEG;IACH,aAAa,IAAI,MAAM;CAG1B"}

package/dist/shared/wallet-manager/wallet-manager.js

@@ -0,0 +1,104 @@
+/**
+ * Wallet Manager
+ *
+ * Manages solver's wallet across multiple EVM chains.
+ * Single private key → multiple chain connections.
+ *
+ * NOTE: Ini adalah lightweight abstraction tanpa dependency ethers.js.
+ * Di Phase B+ akan di-extend dengan actual ethers.Wallet integration.
+ * Untuk sekarang, menyediakan interface dan basic key management.
+ *
+ * USAGE:
+ *   const wallet = new WalletManager("0xprivatekey...", chainRegistry, providerManager);
+ *   const address = wallet.getAddress();
+ *   const sig = await wallet.signMessage("hello");
+ */
+/**
+ * WalletManager
+ *
+ * Mengelola private key solver dan menyediakan signing capabilities.
+ * Address sama di semua EVM chains (derived dari private key).
+ */
+export class WalletManager {
+    privateKey;
+    cachedAddress = null;
+    /**
+     * Custom signer factory — inject ethers.js or viem signer externally.
+     * Jika tidak disediakan, WalletManager hanya mengelola key storage.
+     */
+    signerFactory;
+    constructor(privateKey, signerFactory) {
+        if (!privateKey || !privateKey.startsWith("0x")) {
+            throw new Error("Private key must be a hex string starting with 0x");
+        }
+        this.privateKey = privateKey;
+        this.signerFactory = signerFactory;
+    }
+    /**
+     * Set or update the signer factory after instantiation.
+     */
+    setSignerFactory(factory) {
+        this.signerFactory = factory;
+        this.cachedAddress = null; // Invalidate cached address
+    }
+    /**
+     * Get solver's address (same across all EVM chains).
+     *
+     * Jika signer factory tersedia, derive dari signer.
+     * Otherwise, compute from private key secara manual.
+     */
+    getAddress() {
+        if (this.cachedAddress)
+            return this.cachedAddress;
+        if (this.signerFactory) {
+            // Use signer factory to get address (any chain works, address is same)
+            const signer = this.signerFactory(this.privateKey, 1);
+            this.cachedAddress = signer.getAddress();
+            return this.cachedAddress;
+        }
+        // Placeholder: In production, derive from private key using elliptic curve
+        // For now, store as-is (actual derivation requires crypto library)
+        throw new Error("WalletManager requires a signerFactory to derive address. " +
+            "Provide one via constructor or use ethers.js integration.");
+    }
+    /**
+     * Sign an arbitrary message with the solver's private key.
+     *
+     * Requires signerFactory to be configured.
+     */
+    async signMessage(message) {
+        const signer = this.getSigner(1); // Chain doesn't matter for signing
+        return signer.signMessage(message);
+    }
+    /**
+     * Send a transaction using the solver's configured signer for the chain.
+     */
+    async sendTransaction(chainId, tx) {
+        const signer = this.getSigner(chainId);
+        if (!signer.sendTransaction) {
+            throw new Error(`Configured signer for chain ${chainId} does not support sendTransaction`);
+        }
+        return signer.sendTransaction(tx);
+    }
+    /**
+     * Get a signer for a specific chain.
+
+     *
+     * The returned signer has the same address but is connected
+     * to the provider for the specified chain.
+     */
+    getSigner(chainId) {
+        if (!this.signerFactory) {
+            throw new Error("WalletManager requires a signerFactory. " +
+                "Provide one via constructor.");
+        }
+        return this.signerFactory(this.privateKey, chainId);
+    }
+    /**
+     * Get private key (careful — only use internally).
+     */
+    getPrivateKey() {
+        return this.privateKey;
+    }
+}
+//# sourceMappingURL=wallet-manager.js.map

package/dist/shared/wallet-manager/wallet-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-manager.js","sourceRoot":"","sources":["../../../src/shared/wallet-manager/wallet-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiCH;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IACL,UAAU,CAAS;IAC5B,aAAa,GAAmB,IAAI,CAAC;IAE7C;;;OAGG;IACK,aAAa,CAA0D;IAE/E,YACI,UAAkB,EAClB,aAAsE;QAEtE,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACzE,CAAC;QAED,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,OAA+D;QAC5E,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC,4BAA4B;IAC3D,CAAC;IAED;;;;;OAKG;IACH,UAAU;QACN,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC,aAAa,CAAC;QAElD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,uEAAuE;YACvE,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;YACtD,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC,aAAa,CAAC;QAC9B,CAAC;QAED,2EAA2E;QAC3E,mEAAmE;QACnE,MAAM,IAAI,KAAK,CACX,4DAA4D;YAC5D,2DAA2D,CAC9D,CAAC;IACN,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CAAC,OAAe;QAC7B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,mCAAmC;QACrE,OAAO,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CACjB,OAAgB,EAChB,EAAuE;QAEvE,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,+BAA+B,OAAO,mCAAmC,CAAC,CAAC;QAC/F,CAAC;QACD,OAAO,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,OAAgB;QACtB,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACX,0CAA0C;gBAC1C,8BAA8B,CACjC,CAAC;QACN,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,aAAa;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;CACJ"}

package/dist/solver/agent/agent-config.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Agent Config — Phase F
+ *
+ * Aggregates all sub-module configurations into a single
+ * LiquidityAgentConfig struct. Provides `buildAgentConfig()`
+ * that applies SDK defaults so callers only need to specify overrides.
+ *
+ * Used by: LiquidityAgent constructor
+ */
+import type { AgentConfig } from "../types/agent";
+import type { PricingConfig } from "../types/pricing";
+import type { InventoryManagerConfig } from "../inventory/inventory-manager";
+import type { SettlementConfig } from "../settlement/settlement-manager";
+/**
+ * Full configuration for a LiquidityAgent instance.
+ *
+ * Combines agent identity, pricing engine config, inventory
+ * management config, and settlement config into a single object.
+ *
+ * EXAMPLE:
+ *   const config = buildAgentConfig({
+ *       agent: {
+ *           name: "LiquidityBot-01",
+ *           privateKey: "0xabc...",
+ *           supportedChains: [1, 137],
+ *           supportedTokens: ["USDC"],
+ *           mode: "simulate",
+ *       },
+ *       contractAddress: "0xSettlementContractAddress",
+ *   });
+ */
+export interface LiquidityAgentConfig {
+    /** Core agent identity and behavior */
+    agent: AgentConfig;
+    /** Fee calculation parameters */
+    pricing: PricingConfig;
+    /** Inventory reserve and management parameters */
+    inventory: InventoryManagerConfig;
+    /** Settlement confirmation and retry parameters */
+    settlement: SettlementConfig;
+    /** Deployed IntentSettlement contract address */
+    contractAddress: string;
+    /** Map of chainId → RPC URL for connecting to chains */
+    rpcUrls: Record<number, string>;
+}
+/**
+ * Build a complete LiquidityAgentConfig by merging partial overrides
+ * with SDK defaults.
+ *
+ * Only `agent.privateKey` and `contractAddress` are truly required
+ * for a real deployment; everything else has sensible defaults.
+ *
+ * @param partial - Partial config object. Nested objects are shallow-merged.
+ * @returns Fully populated LiquidityAgentConfig
+ */
+export declare function buildAgentConfig(partial: Partial<LiquidityAgentConfig> & {
+    agent?: Partial<AgentConfig>;
+    pricing?: Partial<PricingConfig>;
+    inventory?: Partial<InventoryManagerConfig>;
+    settlement?: Partial<SettlementConfig>;
+}): LiquidityAgentConfig;
+//# sourceMappingURL=agent-config.d.ts.map

package/dist/solver/agent/agent-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-config.d.ts","sourceRoot":"","sources":["../../../src/solver/agent/agent-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAOzE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,oBAAoB;IACjC,uCAAuC;IACvC,KAAK,EAAE,WAAW,CAAC;IAEnB,iCAAiC;IACjC,OAAO,EAAE,aAAa,CAAC;IAEvB,kDAAkD;IAClD,SAAS,EAAE,sBAAsB,CAAC;IAElC,mDAAmD;IACnD,UAAU,EAAE,gBAAgB,CAAC;IAE7B,iDAAiD;IACjD,eAAe,EAAE,MAAM,CAAC;IAExB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAqCD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC5B,OAAO,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC5C,UAAU,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC1C,GACF,oBAAoB,CAStB"}

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

@@ -0,0 +1,59 @@
+/**
+ * Agent Config — Phase F
+ *
+ * Aggregates all sub-module configurations into a single
+ * LiquidityAgentConfig struct. Provides `buildAgentConfig()`
+ * that applies SDK defaults so callers only need to specify overrides.
+ *
+ * Used by: LiquidityAgent constructor
+ */
+// ─────────────────────────────────────────────
+// Defaults
+// ─────────────────────────────────────────────
+const DEFAULT_AGENT = {
+    name: "LiquidityAgent",
+    privateKey: "0x0000000000000000000000000000000000000000000000000000000000000001",
+    supportedChains: [1, 137],
+    supportedTokens: ["USDC"],
+    mode: "simulate",
+    maxConcurrentIntents: 5,
+    intentTimeout: 3600,
+};
+const DEFAULT_PRICING = {
+    baseFeePercent: 0.005,
+    minFeeUSD: 1,
+    maxFeePercent: 0.03,
+    slippageSharePercent: 0.5,
+};
+const DEFAULT_INVENTORY = {
+    minReservePercent: 0.1,
+};
+const DEFAULT_SETTLEMENT = {
+    requiredConfirmations: 3,
+    maxClaimRetries: 3,
+    watchIntervalMs: 30_000,
+};
+// ─────────────────────────────────────────────
+// Builder
+// ─────────────────────────────────────────────
+/**
+ * Build a complete LiquidityAgentConfig by merging partial overrides
+ * with SDK defaults.
+ *
+ * Only `agent.privateKey` and `contractAddress` are truly required
+ * for a real deployment; everything else has sensible defaults.
+ *
+ * @param partial - Partial config object. Nested objects are shallow-merged.
+ * @returns Fully populated LiquidityAgentConfig
+ */
+export function buildAgentConfig(partial) {
+    return {
+        agent: { ...DEFAULT_AGENT, ...(partial.agent ?? {}) },
+        pricing: { ...DEFAULT_PRICING, ...(partial.pricing ?? {}) },
+        inventory: { ...DEFAULT_INVENTORY, ...(partial.inventory ?? {}) },
+        settlement: { ...DEFAULT_SETTLEMENT, ...(partial.settlement ?? {}) },
+        contractAddress: partial.contractAddress ?? "0x0000000000000000000000000000000000000000",
+        rpcUrls: partial.rpcUrls ?? {},
+    };
+}
+//# sourceMappingURL=agent-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-config.js","sourceRoot":"","sources":["../../../src/solver/agent/agent-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkDH,gDAAgD;AAChD,WAAW;AACX,gDAAgD;AAEhD,MAAM,aAAa,GAAgB;IAC/B,IAAI,EAAE,gBAAgB;IACtB,UAAU,EAAE,oEAAoE;IAChF,eAAe,EAAE,CAAC,CAAC,EAAE,GAAG,CAAc;IACtC,eAAe,EAAE,CAAC,MAAM,CAAC;IACzB,IAAI,EAAE,UAAuB;IAC7B,oBAAoB,EAAE,CAAC;IACvB,aAAa,EAAE,IAAI;CACtB,CAAC;AAEF,MAAM,eAAe,GAAkB;IACnC,cAAc,EAAE,KAAK;IACrB,SAAS,EAAE,CAAC;IACZ,aAAa,EAAE,IAAI;IACnB,oBAAoB,EAAE,GAAG;CAC5B,CAAC;AAEF,MAAM,iBAAiB,GAA2B;IAC9C,iBAAiB,EAAE,GAAG;CACzB,CAAC;AAEF,MAAM,kBAAkB,GAAqB;IACzC,qBAAqB,EAAE,CAAC;IACxB,eAAe,EAAE,CAAC;IAClB,eAAe,EAAE,MAAM;CAC1B,CAAC;AAEF,gDAAgD;AAChD,UAAU;AACV,gDAAgD;AAEhD;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAC5B,OAKC;IAED,OAAO;QACH,KAAK,EAAE,EAAE,GAAG,aAAa,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE;QACrD,OAAO,EAAE,EAAE,GAAG,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE;QAC3D,SAAS,EAAE,EAAE,GAAG,iBAAiB,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE;QACjE,UAAU,EAAE,EAAE,GAAG,kBAAkB,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE;QACpE,eAAe,EAAE,OAAO,CAAC,eAAe,IAAI,4CAA4C;QACxF,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;KACjC,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * Agent Module — Barrel Export
+ */
+export * from "./agent-config";
+export * from "./liquidity-agent";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/solver/agent/index.js

@@ -0,0 +1,6 @@
+/**
+ * Agent Module — Barrel Export
+ */
+export * from "./agent-config";
+export * from "./liquidity-agent";
+//# sourceMappingURL=index.js.map

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

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

package/dist/solver/agent/liquidity-agent.d.ts

@@ -0,0 +1,118 @@
+/**
+ * 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 type { Address } from "../../types/common";
+import type { AgentStatus, SolutionResult } from "../types/agent";
+import type { SolverIntent } from "../types/intent";
+import type { PricingResult } from "../types/pricing";
+import type { InventoryManager } from "../inventory/inventory-manager";
+import type { DynamicPricing } from "../pricing/dynamic-pricing";
+import type { SettlementManager } from "../settlement/settlement-manager";
+import type { WalletManager } from "../../shared/wallet-manager/wallet-manager";
+import type { LiquidityAgentConfig } from "./agent-config";
+export declare class LiquidityAgent {
+    private readonly inventoryManager;
+    private readonly dynamicPricing;
+    private readonly settlementManager;
+    private readonly walletManager;
+    private readonly config;
+    private status;
+    private agentAddress;
+    constructor(inventoryManager: InventoryManager, dynamicPricing: DynamicPricing, settlementManager: SettlementManager, walletManager: WalletManager, config: LiquidityAgentConfig);
+    /**
+     * Initialize the agent: load on-chain balances and derive the agent address.
+     *
+     * Must be called before solve() / canSolve() / getQuote().
+     */
+    initialize(): Promise<void>;
+    /**
+     * 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: SolverIntent): boolean;
+    /**
+     * 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: SolverIntent): PricingResult;
+    /**
+     * 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
+     */
+    solve(intent: SolverIntent): Promise<SolutionResult>;
+    /**
+     * Start the agent: begin watching for pending settlements.
+     *
+     * @param _mempoolUrl - Reserved for Phase G mempool integration
+     */
+    start(_mempoolUrl?: string): void;
+    /**
+     * Stop the agent: stop settlement watcher.
+     */
+    stop(): void;
+    /**
+     * Get the current agent status.
+     */
+    getStatus(): AgentStatus;
+    /**
+     * Get the agent's on-chain address.
+     */
+    getAgentAddress(): Address | null;
+    /**
+     * 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
+     */
+    private sendOnTargetChain;
+    /**
+     * Build an error SolutionResult.
+     */
+    private errorResult;
+}
+//# sourceMappingURL=liquidity-agent.d.ts.map

package/dist/solver/agent/liquidity-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liquidity-agent.d.ts","sourceRoot":"","sources":["../../../src/solver/agent/liquidity-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAoB,MAAM,gBAAgB,CAAC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,iBAAiB,CAAC;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4CAA4C,CAAC;AAEhF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAO3D,qBAAa,cAAc;IAKnB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAR3B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,YAAY,CAAwB;gBAGvB,gBAAgB,EAAE,gBAAgB,EAClC,cAAc,EAAE,cAAc,EAC9B,iBAAiB,EAAE,iBAAiB,EACpC,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,oBAAoB;IAOjD;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO;IA6BvC;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa;IAI7C;;;;;;;;;;;;;;;;;OAiBG;IACG,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAgH1D;;;;OAIG;IACH,KAAK,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAKjC;;OAEG;IACH,IAAI,IAAI,IAAI;IAKZ;;OAEG;IACH,SAAS,IAAI,WAAW;IAIxB;;OAEG;IACH,eAAe,IAAI,OAAO,GAAG,IAAI;IAQjC;;;;;;;;;;OAUG;YACW,iBAAiB;IAqC/B;;OAEG;IACH,OAAO,CAAC,WAAW;CAqBtB"}