@waiaas/actions 2.6.0-rc.8 → 2.6.0

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"}

package/dist/providers/lifi/lifi-api-client.js

@@ -0,0 +1,42 @@
+/**
+ * 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 { LiFiQuoteResponseSchema, LiFiStatusResponseSchema } from './schemas.js';
+export class LiFiApiClient extends ActionApiClient {
+    constructor(config) {
+        const headers = {};
+        if (config.apiKey) {
+            headers['x-lifi-api-key'] = config.apiKey;
+        }
+        super(config.apiBaseUrl, config.requestTimeoutMs, headers);
+    }
+    async getQuote(params) {
+        return this.get('quote', LiFiQuoteResponseSchema, {
+            fromChainId: String(params.fromChain),
+            toChainId: String(params.toChain),
+            fromToken: params.fromToken,
+            toToken: params.toToken,
+            fromAmount: params.fromAmount,
+            fromAddress: params.fromAddress,
+            slippage: String(params.slippage),
+            ...(params.toAddress ? { toAddress: params.toAddress } : {}),
+        });
+    }
+    async getStatus(params) {
+        const queryParams = {
+            txHash: params.txHash,
+        };
+        if (params.bridge)
+            queryParams.bridge = params.bridge;
+        if (params.fromChain)
+            queryParams.fromChain = String(params.fromChain);
+        if (params.toChain)
+            queryParams.toChain = String(params.toChain);
+        return this.get('status', LiFiStatusResponseSchema, queryParams);
+    }
+}
+//# sourceMappingURL=lifi-api-client.js.map

package/dist/providers/lifi/lifi-api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifi-api-client.js","sourceRoot":"","sources":["../../../src/providers/lifi/lifi-api-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAIjF,MAAM,OAAO,aAAc,SAAQ,eAAe;IAChD,YAAY,MAAkB;QAC5B,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5C,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MASd;QACC,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,uBAAuB,EAAE;YAChD,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;YACrC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;YACjC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;YACjC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAKf;QACC,MAAM,WAAW,GAA2B;YAC1C,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC;QACF,IAAI,MAAM,CAAC,MAAM;YAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QACtD,IAAI,MAAM,CAAC,SAAS;YAAE,WAAW,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACvE,IAAI,MAAM,CAAC,OAAO;YAAE,WAAW,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAEjE,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,wBAAwB,EAAE,WAAW,CAAC,CAAC;IACnE,CAAC;CACF"}