@waiaas/actions 2.6.0-rc.8 → 2.6.0-rc.9

package/dist/common/async-status-tracker.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Async Status Tracker interface and types for DeFi async operations.
+ *
+ * IAsyncStatusTracker defines the contract for polling-based status tracking
+ * of asynchronous blockchain operations (bridge transfers, unstaking, gas conditions).
+ *
+ * AsyncPollingService (daemon) uses these interfaces to generically poll
+ * registered trackers at configurable intervals.
+ *
+ * @see internal/objectives/m28-00-defi-basic-protocol-design.md (DEFI-04 ASNC-01)
+ */
+import { z } from 'zod';
+/**
+ * All possible bridge_status values for the transactions table.
+ * Used as SSoT for DB CHECK constraint and Zod schema.
+ */
+export declare const BRIDGE_STATUS_VALUES: readonly ["PENDING", "COMPLETED", "FAILED", "BRIDGE_MONITORING", "TIMEOUT", "REFUNDED"];
+/** Bridge status type derived from BRIDGE_STATUS_VALUES SSoT array. */
+export type BridgeStatus = (typeof BRIDGE_STATUS_VALUES)[number];
+/** Zod schema for bridge status validation (SSoT pattern). */
+export declare const BridgeStatusEnum: z.ZodEnum<["PENDING", "COMPLETED", "FAILED", "BRIDGE_MONITORING", "TIMEOUT", "REFUNDED"]>;
+/**
+ * Result returned by IAsyncStatusTracker.checkStatus().
+ *
+ * - state: current tracking state (PENDING continues polling, others are terminal or timeout)
+ * - details: optional tracker-specific metadata merged into bridge_metadata
+ * - nextIntervalOverride: optional override for next poll interval (ms)
+ */
+export interface AsyncTrackingResult {
+    state: 'PENDING' | 'COMPLETED' | 'FAILED' | 'TIMEOUT';
+    details?: Record<string, unknown>;
+    nextIntervalOverride?: number;
+}
+/**
+ * Contract for async status tracking implementations.
+ *
+ * Each tracker monitors a specific type of async operation:
+ * - BridgeStatusTracker: cross-chain bridge transfer completion
+ * - UnstakeStatusTracker: staking withdrawal completion
+ * - GasConditionTracker: gas price condition satisfaction
+ *
+ * Trackers are registered with AsyncPollingService which calls checkStatus()
+ * at pollIntervalMs intervals, up to maxAttempts times.
+ */
+export interface IAsyncStatusTracker {
+    /** Check the current status of an async operation. */
+    checkStatus(txId: string, metadata: Record<string, unknown>): Promise<AsyncTrackingResult>;
+    /** Tracker name used for registration and lookup (e.g., 'bridge', 'unstake', 'gas-condition'). */
+    readonly name: string;
+    /** Maximum number of poll attempts before timeout transition. */
+    readonly maxAttempts: number;
+    /** Polling interval in milliseconds between checkStatus() calls. */
+    readonly pollIntervalMs: number;
+    /**
+     * State transition when maxAttempts is exceeded:
+     * - 'TIMEOUT': Mark bridge_status as TIMEOUT (terminal)
+     * - 'BRIDGE_MONITORING': Transition to reduced-frequency monitoring
+     * - 'CANCELLED': Cancel the transaction (for GAS_WAITING timeout)
+     */
+    readonly timeoutTransition: 'TIMEOUT' | 'BRIDGE_MONITORING' | 'CANCELLED';
+}
+//# sourceMappingURL=async-status-tracker.d.ts.map

package/dist/common/async-status-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-status-tracker.d.ts","sourceRoot":"","sources":["../../src/common/async-status-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;GAGG;AACH,eAAO,MAAM,oBAAoB,yFAOvB,CAAC;AAEX,uEAAuE;AACvE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,2FAA+B,CAAC;AAM7D;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAMD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE3F,kGAAkG;IAClG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,iEAAiE;IACjE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,oEAAoE;IACpE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,EAAE,SAAS,GAAG,mBAAmB,GAAG,WAAW,CAAC;CAC3E"}

package/dist/common/async-status-tracker.js

@@ -0,0 +1,30 @@
+/**
+ * Async Status Tracker interface and types for DeFi async operations.
+ *
+ * IAsyncStatusTracker defines the contract for polling-based status tracking
+ * of asynchronous blockchain operations (bridge transfers, unstaking, gas conditions).
+ *
+ * AsyncPollingService (daemon) uses these interfaces to generically poll
+ * registered trackers at configurable intervals.
+ *
+ * @see internal/objectives/m28-00-defi-basic-protocol-design.md (DEFI-04 ASNC-01)
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Bridge status values (6-value enum for transactions.bridge_status column)
+// ---------------------------------------------------------------------------
+/**
+ * All possible bridge_status values for the transactions table.
+ * Used as SSoT for DB CHECK constraint and Zod schema.
+ */
+export const BRIDGE_STATUS_VALUES = [
+    'PENDING',
+    'COMPLETED',
+    'FAILED',
+    'BRIDGE_MONITORING',
+    'TIMEOUT',
+    'REFUNDED',
+];
+/** Zod schema for bridge status validation (SSoT pattern). */
+export const BridgeStatusEnum = z.enum(BRIDGE_STATUS_VALUES);
+//# sourceMappingURL=async-status-tracker.js.map

package/dist/common/async-status-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-status-tracker.js","sourceRoot":"","sources":["../../src/common/async-status-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,SAAS;IACT,WAAW;IACX,QAAQ;IACR,mBAAmB;IACnB,SAAS;IACT,UAAU;CACF,CAAC;AAKX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -11,9 +11,16 @@ export type { JupiterSwapConfig } from './providers/jupiter-swap/config.js';
 export { ZeroExSwapActionProvider } from './providers/zerox-swap/index.js';
 export { ALLOWANCE_HOLDER_ADDRESSES, ZEROX_SWAP_DEFAULTS, CHAIN_ID_MAP, getAllowanceHolderAddress } from './providers/zerox-swap/config.js';
 export type { ZeroExSwapConfig } from './providers/zerox-swap/config.js';
+export { LiFiActionProvider } from './providers/lifi/index.js';
+export { LIFI_DEFAULTS, LIFI_CHAIN_MAP, getLiFiChainId } from './providers/lifi/config.js';
+export type { LiFiConfig } from './providers/lifi/config.js';
+export { LiFiApiClient } from './providers/lifi/lifi-api-client.js';
+export { BridgeStatusTracker, BridgeMonitoringTracker } from './providers/lifi/bridge-status-tracker.js';
 export { ActionApiClient } from './common/action-api-client.js';
 export { asBps, asPct, clampSlippageBps, bpsToPct, pctToBps } from './common/slippage.js';
 export type { SlippageBps, SlippagePct } from './common/slippage.js';
+export { BRIDGE_STATUS_VALUES, BridgeStatusEnum, } from './common/async-status-tracker.js';
+export type { IAsyncStatusTracker, AsyncTrackingResult, BridgeStatus, } from './common/async-status-tracker.js';
 /** Minimal settings reader interface compatible with SettingsService.get(). */
 export interface SettingsReader {
     get(key: string): string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAKpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC/F,YAAY,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC5I,YAAY,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC1F,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMrE,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CAC3C;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,gBAAgB,EAC1B,cAAc,EAAE,cAAc,GAC7B;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA8DzC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAMpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC/F,YAAY,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC5I,YAAY,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC3F,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAGzG,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC1F,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGrE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,GACb,MAAM,kCAAkC,CAAC;AAM1C,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CAC3C;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,gBAAgB,EAC1B,cAAc,EAAE,cAAc,GAC7B;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA6EzC"}

package/dist/index.js

@@ -1,13 +1,20 @@
 import { JupiterSwapActionProvider } from './providers/jupiter-swap/index.js';
 import { ZeroExSwapActionProvider } from './providers/zerox-swap/index.js';
+import { LiFiActionProvider } from './providers/lifi/index.js';
 // Re-export provider classes
 export { JupiterSwapActionProvider } from './providers/jupiter-swap/index.js';
 export { JUPITER_PROGRAM_ID, JUPITER_SWAP_DEFAULTS } from './providers/jupiter-swap/config.js';
 export { ZeroExSwapActionProvider } from './providers/zerox-swap/index.js';
 export { ALLOWANCE_HOLDER_ADDRESSES, ZEROX_SWAP_DEFAULTS, CHAIN_ID_MAP, getAllowanceHolderAddress } from './providers/zerox-swap/config.js';
+export { LiFiActionProvider } from './providers/lifi/index.js';
+export { LIFI_DEFAULTS, LIFI_CHAIN_MAP, getLiFiChainId } from './providers/lifi/config.js';
+export { LiFiApiClient } from './providers/lifi/lifi-api-client.js';
+export { BridgeStatusTracker, BridgeMonitoringTracker } from './providers/lifi/bridge-status-tracker.js';
 // Re-export common utilities
 export { ActionApiClient } from './common/action-api-client.js';
 export { asBps, asPct, clampSlippageBps, bpsToPct, pctToBps } from './common/slippage.js';
+// Re-export async status tracker interface and types (v28.3 DEFI-04)
+export { BRIDGE_STATUS_VALUES, BridgeStatusEnum, } from './common/async-status-tracker.js';
 /**
  * Register built-in DeFi action providers from Admin Settings.
  *
@@ -49,6 +56,21 @@ export function registerBuiltInProviders(registry, settingsReader) {
                 return new ZeroExSwapActionProvider(config);
             },
         },
+        {
+            key: 'lifi',
+            enabledKey: 'actions.lifi_enabled',
+            factory: () => {
+                const config = {
+                    enabled: true,
+                    apiBaseUrl: settingsReader.get('actions.lifi_api_base_url'),
+                    apiKey: settingsReader.get('actions.lifi_api_key'),
+                    defaultSlippagePct: Number(settingsReader.get('actions.lifi_default_slippage_pct')),
+                    maxSlippagePct: Number(settingsReader.get('actions.lifi_max_slippage_pct')),
+                    requestTimeoutMs: 15_000,
+                };
+                return new LiFiActionProvider(config);
+            },
+        },
     ];
     for (const { key, enabledKey, factory } of providers) {
         if (settingsReader.get(enabledKey) === 'true') {

package/dist/index.js.map

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

package/dist/providers/lifi/bridge-status-tracker.d.ts

@@ -0,0 +1,37 @@
+/**
+ * LI.FI Bridge Status Trackers — two-phase polling implementation.
+ *
+ * Phase 1: BridgeStatusTracker (active) — 30s x 240 = 2 hours
+ * Phase 2: BridgeMonitoringTracker (reduced) — 5min x 264 = 22 hours
+ *
+ * When active phase times out (240 attempts), timeoutTransition='BRIDGE_MONITORING'
+ * causes AsyncPollingService to transition the TX to the reduced-frequency phase.
+ *
+ * When the reduced phase also times out (264 attempts), timeoutTransition='TIMEOUT'
+ * marks the TX as terminal timeout — manual verification required.
+ *
+ * Total monitoring: 2h active + 22h reduced = 24 hours maximum.
+ *
+ * @see internal/objectives/m28-03-lifi-crosschain-bridge.md (DEFI-04)
+ */
+import type { IAsyncStatusTracker, AsyncTrackingResult } from '../../common/async-status-tracker.js';
+import type { LiFiConfig } from './config.js';
+export declare class BridgeStatusTracker implements IAsyncStatusTracker {
+    readonly name = "bridge";
+    readonly maxAttempts = 240;
+    readonly pollIntervalMs = 30000;
+    readonly timeoutTransition: "BRIDGE_MONITORING";
+    private readonly apiClient;
+    constructor(config: LiFiConfig);
+    checkStatus(_txId: string, metadata: Record<string, unknown>): Promise<AsyncTrackingResult>;
+}
+export declare class BridgeMonitoringTracker implements IAsyncStatusTracker {
+    readonly name = "bridge-monitoring";
+    readonly maxAttempts = 264;
+    readonly pollIntervalMs = 300000;
+    readonly timeoutTransition: "TIMEOUT";
+    private readonly apiClient;
+    constructor(config: LiFiConfig);
+    checkStatus(_txId: string, metadata: Record<string, unknown>): Promise<AsyncTrackingResult>;
+}
+//# sourceMappingURL=bridge-status-tracker.d.ts.map

package/dist/providers/lifi/bridge-status-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-status-tracker.d.ts","sourceRoot":"","sources":["../../../src/providers/lifi/bridge-status-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AACrG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAwE9C,qBAAa,mBAAoB,YAAW,mBAAmB;IAC7D,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,OAAO;IAC3B,QAAQ,CAAC,cAAc,SAAU;IACjC,QAAQ,CAAC,iBAAiB,EAAG,mBAAmB,CAAU;IAE1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;gBAE9B,MAAM,EAAE,UAAU;IAIxB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAelG;AAMD,qBAAa,uBAAwB,YAAW,mBAAmB;IACjE,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,WAAW,OAAO;IAC3B,QAAQ,CAAC,cAAc,UAAW;IAClC,QAAQ,CAAC,iBAAiB,EAAG,SAAS,CAAU;IAEhD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;gBAE9B,MAAM,EAAE,UAAU;IAIxB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAelG"}

package/dist/providers/lifi/bridge-status-tracker.js

@@ -0,0 +1,111 @@
+import { LiFiApiClient } from './lifi-api-client.js';
+// ---------------------------------------------------------------------------
+// Shared status mapping
+// ---------------------------------------------------------------------------
+/**
+ * Map LI.FI status response to AsyncTrackingResult.
+ * Shared by both BridgeStatusTracker and BridgeMonitoringTracker.
+ */
+function mapLiFiStatus(response) {
+    switch (response.status) {
+        case 'DONE':
+            return {
+                state: 'COMPLETED',
+                details: {
+                    destTxHash: response.receiving?.txHash ?? null,
+                    destChainId: response.receiving?.chainId ?? null,
+                    lifiExplorerLink: response.lifiExplorerLink ?? null,
+                    tool: response.tool ?? null,
+                },
+            };
+        case 'FAILED': {
+            // Check for refund via substatus
+            const isRefunded = response.substatus === 'REFUNDED' ||
+                response.substatusMessage?.toLowerCase().includes('refund');
+            if (isRefunded) {
+                return {
+                    state: 'COMPLETED', // Treated as terminal (not PENDING)
+                    details: {
+                        refunded: true,
+                        substatusMessage: response.substatusMessage ?? 'Refunded',
+                        lifiExplorerLink: response.lifiExplorerLink ?? null,
+                    },
+                };
+            }
+            return {
+                state: 'FAILED',
+                details: {
+                    substatusMessage: response.substatusMessage ?? 'Bridge transfer failed',
+                    substatus: response.substatus ?? null,
+                    lifiExplorerLink: response.lifiExplorerLink ?? null,
+                },
+            };
+        }
+        case 'NOT_FOUND':
+        case 'INVALID':
+            // Not yet tracked by LI.FI — keep polling
+            return { state: 'PENDING' };
+        case 'PENDING':
+        default:
+            return {
+                state: 'PENDING',
+                details: {
+                    substatus: response.substatus ?? null,
+                    substatusMessage: response.substatusMessage ?? null,
+                },
+            };
+    }
+}
+// ---------------------------------------------------------------------------
+// Phase 1: Active tracker (30s x 240 = 2 hours)
+// ---------------------------------------------------------------------------
+export class BridgeStatusTracker {
+    name = 'bridge';
+    maxAttempts = 240; // 240 x 30s = 2 hours
+    pollIntervalMs = 30_000; // 30 seconds
+    timeoutTransition = 'BRIDGE_MONITORING';
+    apiClient;
+    constructor(config) {
+        this.apiClient = new LiFiApiClient(config);
+    }
+    async checkStatus(_txId, metadata) {
+        const txHash = metadata.txHash;
+        if (!txHash) {
+            return { state: 'PENDING', details: { error: 'No txHash in metadata' } };
+        }
+        const response = await this.apiClient.getStatus({
+            txHash,
+            bridge: metadata.bridge,
+            fromChain: metadata.fromChainId,
+            toChain: metadata.toChainId,
+        });
+        return mapLiFiStatus(response);
+    }
+}
+// ---------------------------------------------------------------------------
+// Phase 2: Reduced-frequency tracker (5min x 264 = 22 hours)
+// ---------------------------------------------------------------------------
+export class BridgeMonitoringTracker {
+    name = 'bridge-monitoring';
+    maxAttempts = 264; // 264 x 5min = 22 hours
+    pollIntervalMs = 300_000; // 5 minutes
+    timeoutTransition = 'TIMEOUT';
+    apiClient;
+    constructor(config) {
+        this.apiClient = new LiFiApiClient(config);
+    }
+    async checkStatus(_txId, metadata) {
+        const txHash = metadata.txHash;
+        if (!txHash) {
+            return { state: 'PENDING', details: { error: 'No txHash in metadata' } };
+        }
+        const response = await this.apiClient.getStatus({
+            txHash,
+            bridge: metadata.bridge,
+            fromChain: metadata.fromChainId,
+            toChain: metadata.toChainId,
+        });
+        return mapLiFiStatus(response);
+    }
+}
+//# sourceMappingURL=bridge-status-tracker.js.map

package/dist/providers/lifi/bridge-status-tracker.js.map

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

package/dist/providers/lifi/config.d.ts

@@ -0,0 +1,27 @@
+/**
+ * LI.FI cross-chain bridge configuration type, defaults, and chain ID mapping.
+ *
+ * Uses LI.FI API v1 for cross-chain bridge and swap aggregation.
+ * See: https://docs.li.fi/li.fi-api/get-a-quote
+ */
+export interface LiFiConfig {
+    enabled: boolean;
+    apiBaseUrl: string;
+    apiKey: string;
+    defaultSlippagePct: number;
+    maxSlippagePct: number;
+    requestTimeoutMs: number;
+}
+export declare const LIFI_DEFAULTS: LiFiConfig;
+/**
+ * Maps WAIaaS chain/network names to LI.FI chain IDs.
+ * LI.FI uses numeric chain IDs for EVM and special numeric IDs for non-EVM.
+ * See: https://docs.li.fi/list-chains-bridges-dexs-solvers
+ */
+export declare const LIFI_CHAIN_MAP: ReadonlyMap<string, number>;
+/**
+ * Get LI.FI chain ID for a WAIaaS chain name.
+ * @throws Error if chain is not supported by LI.FI integration.
+ */
+export declare function getLiFiChainId(chain: string): number;
+//# sourceMappingURL=config.d.ts.map

package/dist/providers/lifi/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/providers/lifi/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,aAAa,EAAE,UAO3B,CAAC;AAMF;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAerD,CAAC;AAEH;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQpD"}

package/dist/providers/lifi/config.js

@@ -0,0 +1,50 @@
+/**
+ * LI.FI cross-chain bridge configuration type, defaults, and chain ID mapping.
+ *
+ * Uses LI.FI API v1 for cross-chain bridge and swap aggregation.
+ * See: https://docs.li.fi/li.fi-api/get-a-quote
+ */
+export const LIFI_DEFAULTS = {
+    enabled: false,
+    apiBaseUrl: 'https://li.quest/v1',
+    apiKey: '',
+    defaultSlippagePct: 0.03, // 3% (cross-chain needs higher slippage)
+    maxSlippagePct: 0.05, // 5%
+    requestTimeoutMs: 15_000, // LI.FI route computation is slower than single-chain
+};
+// ---------------------------------------------------------------------------
+// Chain ID mapping: WAIaaS chain names -> LI.FI chain IDs
+// ---------------------------------------------------------------------------
+/**
+ * Maps WAIaaS chain/network names to LI.FI chain IDs.
+ * LI.FI uses numeric chain IDs for EVM and special numeric IDs for non-EVM.
+ * See: https://docs.li.fi/list-chains-bridges-dexs-solvers
+ */
+export const LIFI_CHAIN_MAP = new Map([
+    // Solana
+    ['solana', 1151111081099710],
+    ['solana-mainnet', 1151111081099710],
+    // EVM
+    ['ethereum', 1],
+    ['ethereum-mainnet', 1],
+    ['polygon', 137],
+    ['polygon-mainnet', 137],
+    ['arbitrum', 42161],
+    ['arbitrum-mainnet', 42161],
+    ['optimism', 10],
+    ['optimism-mainnet', 10],
+    ['base', 8453],
+    ['base-mainnet', 8453],
+]);
+/**
+ * Get LI.FI chain ID for a WAIaaS chain name.
+ * @throws Error if chain is not supported by LI.FI integration.
+ */
+export function getLiFiChainId(chain) {
+    const id = LIFI_CHAIN_MAP.get(chain.toLowerCase());
+    if (id === undefined) {
+        throw new Error(`Unsupported chain '${chain}' for LI.FI. Supported: ${[...LIFI_CHAIN_MAP.keys()].filter((k) => !k.includes('-')).join(', ')}`);
+    }
+    return id;
+}
+//# sourceMappingURL=config.js.map

package/dist/providers/lifi/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/providers/lifi/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,CAAC,MAAM,aAAa,GAAe;IACvC,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,qBAAqB;IACjC,MAAM,EAAE,EAAE;IACV,kBAAkB,EAAE,IAAI,EAAM,yCAAyC;IACvE,cAAc,EAAE,IAAI,EAAU,KAAK;IACnC,gBAAgB,EAAE,MAAM,EAAM,sDAAsD;CACrF,CAAC;AAEF,8EAA8E;AAC9E,0DAA0D;AAC1D,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAgC,IAAI,GAAG,CAAC;IACjE,SAAS;IACT,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IAC5B,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IACpC,MAAM;IACN,CAAC,UAAU,EAAE,CAAC,CAAC;IACf,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACvB,CAAC,SAAS,EAAE,GAAG,CAAC;IAChB,CAAC,iBAAiB,EAAE,GAAG,CAAC;IACxB,CAAC,UAAU,EAAE,KAAK,CAAC;IACnB,CAAC,kBAAkB,EAAE,KAAK,CAAC;IAC3B,CAAC,UAAU,EAAE,EAAE,CAAC;IAChB,CAAC,kBAAkB,EAAE,EAAE,CAAC;IACxB,CAAC,MAAM,EAAE,IAAI,CAAC;IACd,CAAC,cAAc,EAAE,IAAI,CAAC;CACvB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,EAAE,GAAG,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACnD,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,sBAAsB,KAAK,2BAA2B,CAAC,GAAG,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC9H,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/providers/lifi/index.d.ts

@@ -0,0 +1,16 @@
+import type { IActionProvider, ActionProviderMetadata, ActionDefinition, ActionContext, ContractCallRequest } from '@waiaas/core';
+import { type LiFiConfig } from './config.js';
+export declare class LiFiActionProvider implements IActionProvider {
+    readonly metadata: ActionProviderMetadata;
+    readonly actions: readonly ActionDefinition[];
+    private readonly config;
+    constructor(config?: Partial<LiFiConfig>);
+    resolve(actionName: string, params: Record<string, unknown>, context: ActionContext): Promise<ContractCallRequest[]>;
+    /**
+     * Clamp slippage to [defaultSlippagePct, maxSlippagePct].
+     * Input is decimal (0.03 = 3%). If not provided or <= 0, use default.
+     * If > max, clamp to max.
+     */
+    private clampSlippage;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/lifi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/lifi/index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,KAAK,UAAU,EAAiC,MAAM,aAAa,CAAC;AAoB7E,qBAAa,kBAAmB,YAAW,eAAe;IACxD,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAa;gBAExB,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC;IAiClC,OAAO,CACX,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAoDjC;;;;OAIG;IACH,OAAO,CAAC,aAAa;CAItB"}

package/dist/providers/lifi/index.js

@@ -0,0 +1,121 @@
+/**
+ * LI.FI Cross-Chain Bridge Action Provider.
+ *
+ * Implements IActionProvider to resolve cross-chain bridge and swap requests
+ * into ContractCallRequest arrays via LI.FI /quote API.
+ *
+ * Both 'cross_swap' and 'bridge' actions use the same resolve logic —
+ * LI.FI /quote handles both cases. The distinction is semantic for AI agents:
+ * - bridge = same token across chains (e.g., USDC Ethereum -> USDC Base)
+ * - cross_swap = different tokens across chains (e.g., ETH -> Base USDC)
+ */
+import { z } from 'zod';
+import { ChainError } from '@waiaas/core';
+import { LiFiApiClient } from './lifi-api-client.js';
+import { LIFI_DEFAULTS, getLiFiChainId } from './config.js';
+// ---------------------------------------------------------------------------
+// Input schema for cross_swap and bridge actions
+// ---------------------------------------------------------------------------
+const LiFiCrossSwapInputSchema = z.object({
+    fromChain: z.string().min(1, 'fromChain is required (e.g., solana, ethereum, base)'),
+    toChain: z.string().min(1, 'toChain is required'),
+    fromToken: z.string().min(1, 'fromToken address or symbol is required'),
+    toToken: z.string().min(1, 'toToken address or symbol is required'),
+    fromAmount: z.string().min(1, 'fromAmount is required (in smallest units)'),
+    slippage: z.number().min(0).max(1).optional(), // decimal, e.g. 0.03 = 3%
+    toAddress: z.string().optional(), // defaults to fromAddress (context.walletAddress)
+});
+// ---------------------------------------------------------------------------
+// Provider implementation
+// ---------------------------------------------------------------------------
+export class LiFiActionProvider {
+    metadata;
+    actions;
+    config;
+    constructor(config) {
+        this.config = { ...LIFI_DEFAULTS, ...config };
+        this.metadata = {
+            name: 'lifi',
+            description: 'LI.FI cross-chain bridge and swap aggregator (100+ bridges, 40+ chains)',
+            version: '1.0.0',
+            chains: ['ethereum', 'solana'], // multi-chain provider
+            mcpExpose: true,
+            requiresApiKey: false, // LI.FI works without API key (rate limited)
+            requiredApis: ['lifi'],
+        };
+        this.actions = [
+            {
+                name: 'cross_swap',
+                description: 'Cross-chain bridge and swap via LI.FI aggregator. Moves tokens between different chains (e.g., SOL to Base USDC)',
+                chain: 'ethereum', // primary chain indicator (multi-chain works via fromChain/toChain params)
+                inputSchema: LiFiCrossSwapInputSchema,
+                riskLevel: 'high', // cross-chain operations are higher risk
+                defaultTier: 'DELAY',
+            },
+            {
+                name: 'bridge',
+                description: 'Simple cross-chain bridge via LI.FI. Transfers same token between chains (e.g., USDC from Ethereum to Arbitrum)',
+                chain: 'ethereum',
+                inputSchema: LiFiCrossSwapInputSchema, // same schema
+                riskLevel: 'high',
+                defaultTier: 'DELAY',
+            },
+        ];
+    }
+    async resolve(actionName, params, context) {
+        // Validate action name
+        if (actionName !== 'cross_swap' && actionName !== 'bridge') {
+            throw new ChainError('INVALID_INSTRUCTION', 'ethereum', {
+                message: `Unknown action: ${actionName}. Supported: cross_swap, bridge`,
+            });
+        }
+        // Parse and validate input
+        const input = LiFiCrossSwapInputSchema.parse(params);
+        // Resolve LI.FI chain IDs (throws descriptive error for unsupported chains)
+        let fromChainId;
+        let toChainId;
+        try {
+            fromChainId = getLiFiChainId(input.fromChain);
+            toChainId = getLiFiChainId(input.toChain);
+        }
+        catch (err) {
+            throw new ChainError('INVALID_INSTRUCTION', 'ethereum', {
+                message: err.message,
+            });
+        }
+        // Clamp slippage: default 3%, max 5% (decimal values for LI.FI API)
+        const slippage = this.clampSlippage(input.slippage);
+        // Create API client
+        const apiClient = new LiFiApiClient(this.config);
+        // Get quote from LI.FI /quote
+        const quote = await apiClient.getQuote({
+            fromChain: fromChainId,
+            toChain: toChainId,
+            fromToken: input.fromToken,
+            toToken: input.toToken,
+            fromAmount: input.fromAmount,
+            fromAddress: context.walletAddress,
+            slippage,
+            toAddress: input.toAddress,
+        });
+        // Build ContractCallRequest from the transactionRequest
+        const request = {
+            type: 'CONTRACT_CALL',
+            to: quote.transactionRequest.to,
+            calldata: quote.transactionRequest.data,
+            value: quote.transactionRequest.value,
+        };
+        return [request];
+    }
+    /**
+     * Clamp slippage to [defaultSlippagePct, maxSlippagePct].
+     * Input is decimal (0.03 = 3%). If not provided or <= 0, use default.
+     * If > max, clamp to max.
+     */
+    clampSlippage(input) {
+        if (!input || input <= 0)
+            return this.config.defaultSlippagePct;
+        return Math.min(input, this.config.maxSlippagePct);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/lifi/index.js.map

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

package/dist/providers/lifi/lifi-api-client.d.ts

@@ -0,0 +1,29 @@
+/**
+ * LI.FI REST API client (v1).
+ * Wraps /quote and /status endpoints for cross-chain bridge operations.
+ *
+ * Auth is via x-lifi-api-key header (optional, relaxes rate limits).
+ */
+import { ActionApiClient } from '../../common/action-api-client.js';
+import type { LiFiQuoteResponse, LiFiStatusResponse } from './schemas.js';
+import type { LiFiConfig } from './config.js';
+export declare class LiFiApiClient extends ActionApiClient {
+    constructor(config: LiFiConfig);
+    getQuote(params: {
+        fromChain: number;
+        toChain: number;
+        fromToken: string;
+        toToken: string;
+        fromAmount: string;
+        fromAddress: string;
+        slippage: number;
+        toAddress?: string;
+    }): Promise<LiFiQuoteResponse>;
+    getStatus(params: {
+        txHash: string;
+        bridge?: string;
+        fromChain?: number;
+        toChain?: number;
+    }): Promise<LiFiStatusResponse>;
+}
+//# sourceMappingURL=lifi-api-client.d.ts.map

package/dist/providers/lifi/lifi-api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifi-api-client.d.ts","sourceRoot":"","sources":["../../../src/providers/lifi/lifi-api-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,qBAAa,aAAc,SAAQ,eAAe;gBACpC,MAAM,EAAE,UAAU;IAQxB,QAAQ,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAaxB,SAAS,CAAC,MAAM,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAUhC"}