@waiaas/actions 2.6.0-rc.7 → 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

@@ -8,17 +8,33 @@ import type { IActionProvider } from '@waiaas/core';
 export { JupiterSwapActionProvider } from './providers/jupiter-swap/index.js';
 export { JUPITER_PROGRAM_ID, JUPITER_SWAP_DEFAULTS } from './providers/jupiter-swap/config.js';
 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';
-interface ActionsConfig {
-    jupiter_swap?: Partial<import('./providers/jupiter-swap/config.js').JupiterSwapConfig>;
-    [key: string]: unknown;
+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;
 }
 interface ProviderRegistry {
     register(provider: IActionProvider): void;
 }
-export declare function registerBuiltInProviders(registry: ProviderRegistry, actionsConfig?: ActionsConfig): {
+/**
+ * Register built-in DeFi action providers from Admin Settings.
+ *
+ * Reads provider config from SettingsReader (DB > config.toml > default fallback chain).
+ * Each provider is registered when its `actions.{name}_enabled` setting is 'true'.
+ */
+export declare function registerBuiltInProviders(registry: ProviderRegistry, settingsReader: SettingsReader): {
     loaded: string[];
     skipped: 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;AAIpD,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;AAG5E,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,UAAU,aAAa;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC,OAAO,oCAAoC,EAAE,iBAAiB,CAAC,CAAC;IACvF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CAC3C;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,gBAAgB,EAC1B,aAAa,CAAC,EAAE,aAAa,GAC5B;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA2BzC"}
+{"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,25 +1,88 @@
 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';
-export function registerBuiltInProviders(registry, actionsConfig) {
+// 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.
+ *
+ * Reads provider config from SettingsReader (DB > config.toml > default fallback chain).
+ * Each provider is registered when its `actions.{name}_enabled` setting is 'true'.
+ */
+export function registerBuiltInProviders(registry, settingsReader) {
     const loaded = [];
     const skipped = [];
     const providers = [
         {
             key: 'jupiter_swap',
-            factory: () => new JupiterSwapActionProvider(actionsConfig?.jupiter_swap),
+            enabledKey: 'actions.jupiter_swap_enabled',
+            factory: () => {
+                const config = {
+                    enabled: true,
+                    apiBaseUrl: settingsReader.get('actions.jupiter_swap_api_base_url'),
+                    apiKey: settingsReader.get('actions.jupiter_swap_api_key'),
+                    defaultSlippageBps: Number(settingsReader.get('actions.jupiter_swap_default_slippage_bps')),
+                    maxSlippageBps: Number(settingsReader.get('actions.jupiter_swap_max_slippage_bps')),
+                    maxPriceImpactPct: Number(settingsReader.get('actions.jupiter_swap_max_price_impact_pct')),
+                    jitoTipLamports: Number(settingsReader.get('actions.jupiter_swap_jito_tip_lamports')),
+                    requestTimeoutMs: Number(settingsReader.get('actions.jupiter_swap_request_timeout_ms')),
+                };
+                return new JupiterSwapActionProvider(config);
+            },
+        },
+        {
+            key: 'zerox_swap',
+            enabledKey: 'actions.zerox_swap_enabled',
+            factory: () => {
+                const config = {
+                    enabled: true,
+                    apiKey: settingsReader.get('actions.zerox_swap_api_key'),
+                    defaultSlippageBps: Number(settingsReader.get('actions.zerox_swap_default_slippage_bps')),
+                    maxSlippageBps: Number(settingsReader.get('actions.zerox_swap_max_slippage_bps')),
+                    requestTimeoutMs: Number(settingsReader.get('actions.zerox_swap_request_timeout_ms')),
+                };
+                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, factory } of providers) {
-        const cfg = actionsConfig?.[key];
-        if (cfg?.enabled) {
+    for (const { key, enabledKey, factory } of providers) {
+        if (settingsReader.get(enabledKey) === 'true') {
             try {
-                registry.register(factory());
-                loaded.push(key);
+                const provider = factory();
+                if (provider) {
+                    registry.register(provider);
+                    loaded.push(key);
+                }
+                else {
+                    skipped.push(key);
+                }
             }
             catch (err) {
                 console.warn(`Built-in provider '${key}' registration failed:`, err);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAE9E,6BAA6B;AAC7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAG/F,6BAA6B;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAgB1F,MAAM,UAAU,wBAAwB,CACtC,QAA0B,EAC1B,aAA6B;IAE7B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,SAAS,GAA2D;QACxE;YACE,GAAG,EAAE,cAAc;YACnB,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,yBAAyB,CAAC,aAAa,EAAE,YAAY,CAAC;SAC1E;KACF,CAAC;IAEF,KAAK,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,SAAS,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC,GAAG,CAAsC,CAAC;QACtE,IAAI,GAAG,EAAE,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,sBAAsB,GAAG,wBAAwB,EAAE,GAAG,CAAC,CAAC;gBACrE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}
+{"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"}