@waiaas/actions 2.6.0-rc.10

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/providers/lifi/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAgDpB,CAAC;AAEjB,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAMxE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAsBrB,CAAC;AAEjB,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/providers/lifi/schemas.js

@@ -0,0 +1,91 @@
+/**
+ * Zod schemas for LI.FI API v1 responses.
+ * Runtime validation to detect API drift early.
+ *
+ * Endpoints:
+ * - /quote   -> LiFiQuoteResponseSchema
+ * - /status  -> LiFiStatusResponseSchema
+ *
+ * See: https://docs.li.fi/li.fi-api/get-a-quote
+ * See: https://docs.li.fi/li.fi-api/check-the-status-of-your-cross-chain-transactions
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Quote Response (/quote) (LIFI-01)
+// ---------------------------------------------------------------------------
+export const LiFiQuoteResponseSchema = z.object({
+    id: z.string(),
+    type: z.string(), // 'lifi' or 'swap'
+    tool: z.string(), // e.g., 'stargate', 'across', 'wormhole'
+    toolDetails: z.object({
+        key: z.string(),
+        name: z.string(),
+        logoURI: z.string().optional(),
+    }).passthrough().optional(),
+    action: z.object({
+        fromChainId: z.number(),
+        toChainId: z.number(),
+        fromToken: z.object({
+            address: z.string(),
+            symbol: z.string(),
+            decimals: z.number(),
+            chainId: z.number(),
+        }).passthrough(),
+        toToken: z.object({
+            address: z.string(),
+            symbol: z.string(),
+            decimals: z.number(),
+            chainId: z.number(),
+        }).passthrough(),
+        fromAmount: z.string(),
+        slippage: z.number(),
+        fromAddress: z.string(),
+        toAddress: z.string().optional(),
+    }).passthrough(),
+    estimate: z.object({
+        fromAmount: z.string(),
+        toAmount: z.string(),
+        toAmountMin: z.string(),
+        approvalAddress: z.string().optional(),
+        executionDuration: z.number(), // estimated seconds
+        feeCosts: z.array(z.unknown()).optional(),
+        gasCosts: z.array(z.unknown()).optional(),
+    }).passthrough(),
+    transactionRequest: z.object({
+        data: z.string(), // calldata (hex)
+        to: z.string(), // target contract
+        value: z.string(), // native value (hex or decimal)
+        from: z.string(),
+        chainId: z.number(),
+        gasLimit: z.string().optional(),
+        gasPrice: z.string().optional(),
+    }).passthrough(),
+    includedSteps: z.array(z.unknown()).optional(),
+}).passthrough();
+// ---------------------------------------------------------------------------
+// Status Response (/status) (LIFI-02)
+// ---------------------------------------------------------------------------
+export const LiFiStatusResponseSchema = z.object({
+    transactionId: z.string().optional(),
+    sending: z.object({
+        txHash: z.string(),
+        txLink: z.string().optional(),
+        chainId: z.number(),
+        amount: z.string().optional(),
+        token: z.unknown().optional(),
+    }).passthrough().optional(),
+    receiving: z.object({
+        txHash: z.string().optional(),
+        txLink: z.string().optional(),
+        chainId: z.number().optional(),
+        amount: z.string().optional(),
+        token: z.unknown().optional(),
+    }).passthrough().optional(),
+    lifiExplorerLink: z.string().optional(),
+    status: z.enum(['PENDING', 'DONE', 'FAILED', 'NOT_FOUND', 'INVALID']),
+    substatus: z.string().optional(),
+    substatusMessage: z.string().optional(),
+    tool: z.string().optional(),
+    bridgeExplorerLink: z.string().optional(),
+}).passthrough();
+//# sourceMappingURL=schemas.js.map

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

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

package/dist/providers/zerox-swap/config.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 0x Swap configuration type, defaults, and AllowanceHolder address mapping.
+ *
+ * Uses 0x Swap API v2 with the AllowanceHolder flow (not Permit2).
+ * See: https://0x.org/docs/api#tag/Swap
+ */
+export interface ZeroExSwapConfig {
+    enabled: boolean;
+    apiBaseUrl: string;
+    apiKey: string;
+    defaultSlippageBps: number;
+    maxSlippageBps: number;
+    requestTimeoutMs: number;
+}
+export declare const ZEROX_SWAP_DEFAULTS: ZeroExSwapConfig;
+/**
+ * Supported chain IDs for 0x Swap API v2 AllowanceHolder flow.
+ * Cancun 19 chains + Mantle = 20 total.
+ */
+export declare const ALLOWANCE_HOLDER_ADDRESSES: ReadonlyMap<number, string>;
+/**
+ * Get AllowanceHolder contract address for a given chain ID.
+ * @throws Error if chain ID is not supported by 0x Swap API.
+ */
+export declare function getAllowanceHolderAddress(chainId: number): string;
+/**
+ * Maps WAIaaS network type names to EVM chain IDs.
+ * Only includes mainnet networks that are supported by both WAIaaS and 0x API.
+ */
+export declare const CHAIN_ID_MAP: Record<string, number>;
+//# sourceMappingURL=config.d.ts.map

package/dist/providers/zerox-swap/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/providers/zerox-swap/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,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,mBAAmB,EAAE,gBAOjC,CAAC;AAQF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAqBjE,CAAC;AAEH;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQjE;AAMD;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAM/C,CAAC"}

package/dist/providers/zerox-swap/config.js

@@ -0,0 +1,70 @@
+/**
+ * 0x Swap configuration type, defaults, and AllowanceHolder address mapping.
+ *
+ * Uses 0x Swap API v2 with the AllowanceHolder flow (not Permit2).
+ * See: https://0x.org/docs/api#tag/Swap
+ */
+export const ZEROX_SWAP_DEFAULTS = {
+    enabled: false,
+    apiBaseUrl: 'https://api.0x.org',
+    apiKey: '',
+    defaultSlippageBps: 100, // 1% (ZXSW-06)
+    maxSlippageBps: 500, // 5% (ZXSW-06)
+    requestTimeoutMs: 10_000, // (ZXSW-10)
+};
+// ---------------------------------------------------------------------------
+// AllowanceHolder contract address (same on all supported chains) (ZXSW-09)
+// ---------------------------------------------------------------------------
+const ALLOWANCE_HOLDER_ADDRESS = '0x0000000000001fF3684f28c67538d4D072C22734';
+/**
+ * Supported chain IDs for 0x Swap API v2 AllowanceHolder flow.
+ * Cancun 19 chains + Mantle = 20 total.
+ */
+export const ALLOWANCE_HOLDER_ADDRESSES = new Map([
+    [1, ALLOWANCE_HOLDER_ADDRESS], // Ethereum
+    [10, ALLOWANCE_HOLDER_ADDRESS], // Optimism
+    [56, ALLOWANCE_HOLDER_ADDRESS], // BNB Chain
+    [130, ALLOWANCE_HOLDER_ADDRESS], // Unichain
+    [137, ALLOWANCE_HOLDER_ADDRESS], // Polygon
+    [1329, ALLOWANCE_HOLDER_ADDRESS], // SEI
+    [1868, ALLOWANCE_HOLDER_ADDRESS], // Soneium
+    [2741, ALLOWANCE_HOLDER_ADDRESS], // Abstract
+    [5000, ALLOWANCE_HOLDER_ADDRESS], // Mantle
+    [8453, ALLOWANCE_HOLDER_ADDRESS], // Base
+    [33139, ALLOWANCE_HOLDER_ADDRESS], // Apechain
+    [34443, ALLOWANCE_HOLDER_ADDRESS], // Mode
+    [42161, ALLOWANCE_HOLDER_ADDRESS], // Arbitrum
+    [42220, ALLOWANCE_HOLDER_ADDRESS], // Celo
+    [43114, ALLOWANCE_HOLDER_ADDRESS], // Avalanche
+    [57073, ALLOWANCE_HOLDER_ADDRESS], // Ink
+    [59144, ALLOWANCE_HOLDER_ADDRESS], // Linea
+    [80084, ALLOWANCE_HOLDER_ADDRESS], // Berachain
+    [81457, ALLOWANCE_HOLDER_ADDRESS], // Blast
+    [534352, ALLOWANCE_HOLDER_ADDRESS], // Scroll
+]);
+/**
+ * Get AllowanceHolder contract address for a given chain ID.
+ * @throws Error if chain ID is not supported by 0x Swap API.
+ */
+export function getAllowanceHolderAddress(chainId) {
+    const address = ALLOWANCE_HOLDER_ADDRESSES.get(chainId);
+    if (!address) {
+        throw new Error(`Unsupported chain ID ${chainId} for 0x Swap. Supported: ${[...ALLOWANCE_HOLDER_ADDRESSES.keys()].join(', ')}`);
+    }
+    return address;
+}
+// ---------------------------------------------------------------------------
+// Network name -> Chain ID mapping (only networks in NETWORK_TYPES)
+// ---------------------------------------------------------------------------
+/**
+ * Maps WAIaaS network type names to EVM chain IDs.
+ * Only includes mainnet networks that are supported by both WAIaaS and 0x API.
+ */
+export const CHAIN_ID_MAP = {
+    'ethereum-mainnet': 1,
+    'polygon-mainnet': 137,
+    'arbitrum-mainnet': 42161,
+    'optimism-mainnet': 10,
+    'base-mainnet': 8453,
+};
+//# sourceMappingURL=config.js.map

package/dist/providers/zerox-swap/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/providers/zerox-swap/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,CAAC,MAAM,mBAAmB,GAAqB;IACnD,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,oBAAoB;IAChC,MAAM,EAAE,EAAE;IACV,kBAAkB,EAAE,GAAG,EAAI,eAAe;IAC1C,cAAc,EAAE,GAAG,EAAQ,eAAe;IAC1C,gBAAgB,EAAE,MAAM,EAAG,YAAY;CACxC,CAAC;AAEF,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAE9E,MAAM,wBAAwB,GAAG,4CAA4C,CAAC;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAgC,IAAI,GAAG,CAAC;IAC7E,CAAC,CAAC,EAAE,wBAAwB,CAAC,EAAQ,WAAW;IAChD,CAAC,EAAE,EAAE,wBAAwB,CAAC,EAAO,WAAW;IAChD,CAAC,EAAE,EAAE,wBAAwB,CAAC,EAAO,YAAY;IACjD,CAAC,GAAG,EAAE,wBAAwB,CAAC,EAAM,WAAW;IAChD,CAAC,GAAG,EAAE,wBAAwB,CAAC,EAAM,UAAU;IAC/C,CAAC,IAAI,EAAE,wBAAwB,CAAC,EAAK,MAAM;IAC3C,CAAC,IAAI,EAAE,wBAAwB,CAAC,EAAK,UAAU;IAC/C,CAAC,IAAI,EAAE,wBAAwB,CAAC,EAAK,WAAW;IAChD,CAAC,IAAI,EAAE,wBAAwB,CAAC,EAAK,SAAS;IAC9C,CAAC,IAAI,EAAE,wBAAwB,CAAC,EAAK,OAAO;IAC5C,CAAC,KAAK,EAAE,wBAAwB,CAAC,EAAI,WAAW;IAChD,CAAC,KAAK,EAAE,wBAAwB,CAAC,EAAI,OAAO;IAC5C,CAAC,KAAK,EAAE,wBAAwB,CAAC,EAAI,WAAW;IAChD,CAAC,KAAK,EAAE,wBAAwB,CAAC,EAAI,OAAO;IAC5C,CAAC,KAAK,EAAE,wBAAwB,CAAC,EAAI,YAAY;IACjD,CAAC,KAAK,EAAE,wBAAwB,CAAC,EAAI,MAAM;IAC3C,CAAC,KAAK,EAAE,wBAAwB,CAAC,EAAI,QAAQ;IAC7C,CAAC,KAAK,EAAE,wBAAwB,CAAC,EAAI,YAAY;IACjD,CAAC,KAAK,EAAE,wBAAwB,CAAC,EAAI,QAAQ;IAC7C,CAAC,MAAM,EAAE,wBAAwB,CAAC,EAAG,SAAS;CAC/C,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAe;IACvD,MAAM,OAAO,GAAG,0BAA0B,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,wBAAwB,OAAO,4BAA4B,CAAC,GAAG,0BAA0B,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/G,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,oEAAoE;AACpE,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,kBAAkB,EAAE,CAAC;IACrB,iBAAiB,EAAE,GAAG;IACtB,kBAAkB,EAAE,KAAK;IACzB,kBAAkB,EAAE,EAAE;IACtB,cAAc,EAAE,IAAI;CACrB,CAAC"}

package/dist/providers/zerox-swap/index.d.ts

@@ -0,0 +1,10 @@
+import type { IActionProvider, ActionProviderMetadata, ActionDefinition, ActionContext, ContractCallRequest } from '@waiaas/core';
+import { type ZeroExSwapConfig } from './config.js';
+export declare class ZeroExSwapActionProvider implements IActionProvider {
+    readonly metadata: ActionProviderMetadata;
+    readonly actions: readonly ActionDefinition[];
+    private readonly config;
+    constructor(config?: Partial<ZeroExSwapConfig>);
+    resolve(actionName: string, params: Record<string, unknown>, context: ActionContext): Promise<ContractCallRequest[]>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/zerox-swap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/zerox-swap/index.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,KAAK,gBAAgB,EAItB,MAAM,aAAa,CAAC;AAwCrB,qBAAa,wBAAyB,YAAW,eAAe;IAC9D,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAE9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAE9B,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAyBxC,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;CA4ElC"}

package/dist/providers/zerox-swap/index.js

@@ -0,0 +1,131 @@
+/**
+ * 0x Swap Action Provider.
+ *
+ * Implements IActionProvider to resolve 0x DEX swap requests
+ * into ContractCallRequest arrays for the sequential pipeline.
+ *
+ * ERC-20 sells produce [approve, swap] (2 elements).
+ * Native ETH sells produce [swap] (1 element).
+ */
+import { z } from 'zod';
+import { ChainError } from '@waiaas/core';
+import { ZeroExApiClient } from './zerox-api-client.js';
+import { ZEROX_SWAP_DEFAULTS, getAllowanceHolderAddress, CHAIN_ID_MAP, } from './config.js';
+import { clampSlippageBps, asBps } from '../../common/slippage.js';
+// ---------------------------------------------------------------------------
+// Native ETH placeholder address used by 0x API
+// ---------------------------------------------------------------------------
+const NATIVE_ETH_ADDRESS = '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee';
+// ---------------------------------------------------------------------------
+// ERC-20 approve calldata encoder
+// ---------------------------------------------------------------------------
+/**
+ * Encode ERC-20 approve(address spender, uint256 amount) calldata.
+ * Function selector: 0x095ea7b3
+ */
+function encodeApproveCalldata(spender, amount) {
+    const selector = '0x095ea7b3';
+    const paddedSpender = spender.slice(2).toLowerCase().padStart(64, '0');
+    const paddedAmount = BigInt(amount).toString(16).padStart(64, '0');
+    return `${selector}${paddedSpender}${paddedAmount}`;
+}
+// ---------------------------------------------------------------------------
+// Input schema for the swap action
+// ---------------------------------------------------------------------------
+const SwapInputSchema = z.object({
+    sellToken: z.string().min(1, 'sellToken is required'),
+    buyToken: z.string().min(1, 'buyToken is required'),
+    sellAmount: z.string().min(1, 'sellAmount is required (in smallest units)'),
+    slippageBps: z.number().int().optional(),
+    chainId: z.number().int().optional(),
+});
+// ---------------------------------------------------------------------------
+// Provider implementation
+// ---------------------------------------------------------------------------
+export class ZeroExSwapActionProvider {
+    metadata;
+    actions;
+    config;
+    constructor(config) {
+        this.config = { ...ZEROX_SWAP_DEFAULTS, ...config };
+        this.metadata = {
+            name: 'zerox_swap',
+            description: '0x DEX aggregator for EVM token swaps via AllowanceHolder flow',
+            version: '1.0.0',
+            chains: ['ethereum'],
+            mcpExpose: true,
+            requiresApiKey: true,
+            requiredApis: ['0x'],
+        };
+        this.actions = [
+            {
+                name: 'swap',
+                description: 'Swap tokens on EVM chains via 0x aggregator with slippage protection and AllowanceHolder approval',
+                chain: 'ethereum',
+                inputSchema: SwapInputSchema,
+                riskLevel: 'medium',
+                defaultTier: 'DELAY',
+            },
+        ];
+    }
+    async resolve(actionName, params, context) {
+        // Validate action name
+        if (actionName !== 'swap') {
+            throw new ChainError('INVALID_INSTRUCTION', 'ethereum', { message: `Unknown action: ${actionName}` });
+        }
+        // Parse and validate input
+        const input = SwapInputSchema.parse(params);
+        // SAFE-05: Block same-token swap
+        if (input.sellToken.toLowerCase() === input.buyToken.toLowerCase()) {
+            throw new ChainError('INVALID_INSTRUCTION', 'ethereum', { message: 'Cannot swap a token for itself' });
+        }
+        // Resolve chainId: explicit input > CHAIN_ID_MAP lookup > default 1 (Ethereum mainnet)
+        const chainId = input.chainId ?? CHAIN_ID_MAP['ethereum-mainnet'] ?? 1;
+        // ZXSW-06: Clamp slippage -- default 100bps (1%), max 500bps (5%)
+        const slippageBps = clampSlippageBps(input.slippageBps ?? 0, asBps(this.config.defaultSlippageBps), asBps(this.config.maxSlippageBps));
+        // Create API client with resolved chainId
+        const apiClient = new ZeroExApiClient(this.config, chainId);
+        // Get quote from 0x API
+        const quote = await apiClient.getQuote({
+            sellToken: input.sellToken,
+            buyToken: input.buyToken,
+            sellAmount: input.sellAmount,
+            taker: context.walletAddress,
+            slippageBps,
+        });
+        // ZXSW-07: Check liquidity availability
+        if (!quote.liquidityAvailable) {
+            throw new ChainError('INVALID_INSTRUCTION', 'ethereum', {
+                message: 'No liquidity available for this swap pair',
+            });
+        }
+        // ZXSW-09: Validate AllowanceHolder address
+        const expectedAllowanceHolder = getAllowanceHolderAddress(chainId);
+        if (quote.transaction.to.toLowerCase() !== expectedAllowanceHolder.toLowerCase()) {
+            throw new ChainError('INVALID_INSTRUCTION', 'ethereum', {
+                message: `AllowanceHolder address mismatch: expected ${expectedAllowanceHolder}, got ${quote.transaction.to}`,
+            });
+        }
+        // Build result array
+        const isNativeEthSell = input.sellToken.toLowerCase() === NATIVE_ETH_ADDRESS;
+        const swapRequest = {
+            type: 'CONTRACT_CALL',
+            to: quote.transaction.to,
+            calldata: quote.transaction.data,
+            value: quote.transaction.value,
+        };
+        if (isNativeEthSell) {
+            // Native ETH sell: single swap element
+            return [swapRequest];
+        }
+        // ERC-20 sell: approve + swap (ZXSW-04)
+        const approveRequest = {
+            type: 'CONTRACT_CALL',
+            to: input.sellToken,
+            calldata: encodeApproveCalldata(expectedAllowanceHolder, input.sellAmount),
+            value: '0',
+        };
+        return [approveRequest, swapRequest];
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/zerox-swap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/providers/zerox-swap/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAQ1C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAEL,mBAAmB,EACnB,yBAAyB,EACzB,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEnE,8EAA8E;AAC9E,gDAAgD;AAChD,8EAA8E;AAE9E,MAAM,kBAAkB,GAAG,4CAA4C,CAAC;AAExE,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,qBAAqB,CAAC,OAAe,EAAE,MAAc;IAC5D,MAAM,QAAQ,GAAG,YAAY,CAAC;IAC9B,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACvE,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACnE,OAAO,GAAG,QAAQ,GAAG,aAAa,GAAG,YAAY,EAAE,CAAC;AACtD,CAAC;AAED,8EAA8E;AAC9E,mCAAmC;AACnC,8EAA8E;AAE9E,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC;IACrD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,sBAAsB,CAAC;IACnD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,4CAA4C,CAAC;IAC3E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAC;AAEH,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E,MAAM,OAAO,wBAAwB;IAC1B,QAAQ,CAAyB;IACjC,OAAO,CAA8B;IAE7B,MAAM,CAAmB;IAE1C,YAAY,MAAkC;QAC5C,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,mBAAmB,EAAE,GAAG,MAAM,EAAE,CAAC;QAEpD,IAAI,CAAC,QAAQ,GAAG;YACd,IAAI,EAAE,YAAY;YAClB,WAAW,EAAE,gEAAgE;YAC7E,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,CAAC,UAAU,CAAC;YACpB,SAAS,EAAE,IAAI;YACf,cAAc,EAAE,IAAI;YACpB,YAAY,EAAE,CAAC,IAAI,CAAC;SACrB,CAAC;QAEF,IAAI,CAAC,OAAO,GAAG;YACb;gBACE,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,mGAAmG;gBAChH,KAAK,EAAE,UAAU;gBACjB,WAAW,EAAE,eAAe;gBAC5B,SAAS,EAAE,QAAQ;gBACnB,WAAW,EAAE,OAAO;aACrB;SACO,CAAC;IACb,CAAC;IAED,KAAK,CAAC,OAAO,CACX,UAAkB,EAClB,MAA+B,EAC/B,OAAsB;QAEtB,uBAAuB;QACvB,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;YAC1B,MAAM,IAAI,UAAU,CAAC,qBAAqB,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,mBAAmB,UAAU,EAAE,EAAE,CAAC,CAAC;QACxG,CAAC;QAED,2BAA2B;QAC3B,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAE5C,iCAAiC;QACjC,IAAI,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,CAAC;YACnE,MAAM,IAAI,UAAU,CAAC,qBAAqB,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC,CAAC;QACzG,CAAC;QAED,uFAAuF;QACvF,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,YAAY,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAEvE,kEAAkE;QAClE,MAAM,WAAW,GAAG,gBAAgB,CAClC,KAAK,CAAC,WAAW,IAAI,CAAC,EACtB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC,EACrC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAClC,CAAC;QAEF,0CAA0C;QAC1C,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAE5D,wBAAwB;QACxB,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC;YACrC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,KAAK,EAAE,OAAO,CAAC,aAAa;YAC5B,WAAW;SACZ,CAAC,CAAC;QAEH,wCAAwC;QACxC,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAC;YAC9B,MAAM,IAAI,UAAU,CAAC,qBAAqB,EAAE,UAAU,EAAE;gBACtD,OAAO,EAAE,2CAA2C;aACrD,CAAC,CAAC;QACL,CAAC;QAED,4CAA4C;QAC5C,MAAM,uBAAuB,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;QACnE,IAAI,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,uBAAuB,CAAC,WAAW,EAAE,EAAE,CAAC;YACjF,MAAM,IAAI,UAAU,CAAC,qBAAqB,EAAE,UAAU,EAAE;gBACtD,OAAO,EAAE,8CAA8C,uBAAuB,SAAS,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE;aAC9G,CAAC,CAAC;QACL,CAAC;QAED,qBAAqB;QACrB,MAAM,eAAe,GAAG,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,KAAK,kBAAkB,CAAC;QAE7E,MAAM,WAAW,GAAwB;YACvC,IAAI,EAAE,eAAe;YACrB,EAAE,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE;YACxB,QAAQ,EAAE,KAAK,CAAC,WAAW,CAAC,IAAI;YAChC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,KAAK;SAC/B,CAAC;QAEF,IAAI,eAAe,EAAE,CAAC;YACpB,uCAAuC;YACvC,OAAO,CAAC,WAAW,CAAC,CAAC;QACvB,CAAC;QAED,wCAAwC;QACxC,MAAM,cAAc,GAAwB;YAC1C,IAAI,EAAE,eAAe;YACrB,EAAE,EAAE,KAAK,CAAC,SAAS;YACnB,QAAQ,EAAE,qBAAqB,CAAC,uBAAuB,EAAE,KAAK,CAAC,UAAU,CAAC;YAC1E,KAAK,EAAE,GAAG;SACX,CAAC;QAEF,OAAO,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IACvC,CAAC;CACF"}