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

package/dist/index.d.ts

@@ -8,17 +8,26 @@ 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 { 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;
+/** 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;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"}

package/dist/index.js

@@ -1,25 +1,66 @@
 import { JupiterSwapActionProvider } from './providers/jupiter-swap/index.js';
+import { ZeroExSwapActionProvider } from './providers/zerox-swap/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';
 // 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) {
+/**
+ * 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);
+            },
         },
     ];
-    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":"AAOA,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,6BAA6B;AAC7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAG/F,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAG5I,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;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAA0B,EAC1B,cAA8B;IAE9B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,SAAS,GAIV;QACH;YACE,GAAG,EAAE,cAAc;YACnB,UAAU,EAAE,8BAA8B;YAC1C,OAAO,EAAE,GAAG,EAAE;gBACZ,MAAM,MAAM,GAAmE;oBAC7E,OAAO,EAAE,IAAI;oBACb,UAAU,EAAE,cAAc,CAAC,GAAG,CAAC,mCAAmC,CAAC;oBACnE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,8BAA8B,CAAC;oBAC1D,kBAAkB,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;oBAC3F,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;oBACnF,iBAAiB,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;oBAC1F,eAAe,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;oBACrF,gBAAgB,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;iBACxF,CAAC;gBACF,OAAO,IAAI,yBAAyB,CAAC,MAAM,CAAC,CAAC;YAC/C,CAAC;SACF;QACD;YACE,GAAG,EAAE,YAAY;YACjB,UAAU,EAAE,4BAA4B;YACxC,OAAO,EAAE,GAAG,EAAE;gBACZ,MAAM,MAAM,GAAyE;oBACnF,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,4BAA4B,CAAC;oBACxD,kBAAkB,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC;oBACzF,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;oBACjF,gBAAgB,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;iBACtF,CAAC;gBACF,OAAO,IAAI,wBAAwB,CAAC,MAAM,CAAC,CAAC;YAC9C,CAAC;SACF;KACF,CAAC;IAEF,KAAK,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,SAAS,EAAE,CAAC;QACrD,IAAI,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,MAAM,EAAE,CAAC;YAC9C,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,OAAO,EAAE,CAAC;gBAC3B,IAAI,QAAQ,EAAE,CAAC;oBACb,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;oBAC5B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACnB,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACpB,CAAC;YACH,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"}

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

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

@@ -0,0 +1,641 @@
+/**
+ * Zod schemas for 0x Swap API v2 responses.
+ * Runtime validation to detect API drift early.
+ *
+ * Endpoints:
+ * - /swap/allowance-holder/price  -> PriceResponseSchema
+ * - /swap/allowance-holder/quote  -> QuoteResponseSchema
+ */
+import { z } from 'zod';
+export declare const PriceResponseSchema: z.ZodObject<{
+    blockNumber: z.ZodString;
+    buyAmount: z.ZodString;
+    buyToken: z.ZodString;
+    fees: z.ZodObject<{
+        integratorFee: z.ZodNullable<z.ZodUnknown>;
+        zeroExFee: z.ZodNullable<z.ZodObject<{
+            amount: z.ZodString;
+            token: z.ZodString;
+            type: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            amount: string;
+            token: string;
+        }, {
+            type: string;
+            amount: string;
+            token: string;
+        }>>;
+        gasFee: z.ZodNullable<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        zeroExFee: {
+            type: string;
+            amount: string;
+            token: string;
+        } | null;
+        integratorFee?: unknown;
+        gasFee?: unknown;
+    }, {
+        zeroExFee: {
+            type: string;
+            amount: string;
+            token: string;
+        } | null;
+        integratorFee?: unknown;
+        gasFee?: unknown;
+    }>;
+    gas: z.ZodString;
+    gasPrice: z.ZodString;
+    liquidityAvailable: z.ZodBoolean;
+    minBuyAmount: z.ZodString;
+    route: z.ZodObject<{
+        fills: z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+            source: z.ZodString;
+            proportionBps: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }, {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }>, "many">;
+        tokens: z.ZodArray<z.ZodObject<{
+            address: z.ZodString;
+            symbol: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            symbol: string;
+            address: string;
+        }, {
+            symbol: string;
+            address: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        fills: {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }[];
+        tokens: {
+            symbol: string;
+            address: string;
+        }[];
+    }, {
+        fills: {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }[];
+        tokens: {
+            symbol: string;
+            address: string;
+        }[];
+    }>;
+    sellAmount: z.ZodString;
+    sellToken: z.ZodString;
+    totalNetworkFee: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    blockNumber: z.ZodString;
+    buyAmount: z.ZodString;
+    buyToken: z.ZodString;
+    fees: z.ZodObject<{
+        integratorFee: z.ZodNullable<z.ZodUnknown>;
+        zeroExFee: z.ZodNullable<z.ZodObject<{
+            amount: z.ZodString;
+            token: z.ZodString;
+            type: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            amount: string;
+            token: string;
+        }, {
+            type: string;
+            amount: string;
+            token: string;
+        }>>;
+        gasFee: z.ZodNullable<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        zeroExFee: {
+            type: string;
+            amount: string;
+            token: string;
+        } | null;
+        integratorFee?: unknown;
+        gasFee?: unknown;
+    }, {
+        zeroExFee: {
+            type: string;
+            amount: string;
+            token: string;
+        } | null;
+        integratorFee?: unknown;
+        gasFee?: unknown;
+    }>;
+    gas: z.ZodString;
+    gasPrice: z.ZodString;
+    liquidityAvailable: z.ZodBoolean;
+    minBuyAmount: z.ZodString;
+    route: z.ZodObject<{
+        fills: z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+            source: z.ZodString;
+            proportionBps: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }, {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }>, "many">;
+        tokens: z.ZodArray<z.ZodObject<{
+            address: z.ZodString;
+            symbol: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            symbol: string;
+            address: string;
+        }, {
+            symbol: string;
+            address: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        fills: {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }[];
+        tokens: {
+            symbol: string;
+            address: string;
+        }[];
+    }, {
+        fills: {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }[];
+        tokens: {
+            symbol: string;
+            address: string;
+        }[];
+    }>;
+    sellAmount: z.ZodString;
+    sellToken: z.ZodString;
+    totalNetworkFee: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    blockNumber: z.ZodString;
+    buyAmount: z.ZodString;
+    buyToken: z.ZodString;
+    fees: z.ZodObject<{
+        integratorFee: z.ZodNullable<z.ZodUnknown>;
+        zeroExFee: z.ZodNullable<z.ZodObject<{
+            amount: z.ZodString;
+            token: z.ZodString;
+            type: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            amount: string;
+            token: string;
+        }, {
+            type: string;
+            amount: string;
+            token: string;
+        }>>;
+        gasFee: z.ZodNullable<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        zeroExFee: {
+            type: string;
+            amount: string;
+            token: string;
+        } | null;
+        integratorFee?: unknown;
+        gasFee?: unknown;
+    }, {
+        zeroExFee: {
+            type: string;
+            amount: string;
+            token: string;
+        } | null;
+        integratorFee?: unknown;
+        gasFee?: unknown;
+    }>;
+    gas: z.ZodString;
+    gasPrice: z.ZodString;
+    liquidityAvailable: z.ZodBoolean;
+    minBuyAmount: z.ZodString;
+    route: z.ZodObject<{
+        fills: z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+            source: z.ZodString;
+            proportionBps: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }, {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }>, "many">;
+        tokens: z.ZodArray<z.ZodObject<{
+            address: z.ZodString;
+            symbol: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            symbol: string;
+            address: string;
+        }, {
+            symbol: string;
+            address: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        fills: {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }[];
+        tokens: {
+            symbol: string;
+            address: string;
+        }[];
+    }, {
+        fills: {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }[];
+        tokens: {
+            symbol: string;
+            address: string;
+        }[];
+    }>;
+    sellAmount: z.ZodString;
+    sellToken: z.ZodString;
+    totalNetworkFee: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+export type PriceResponse = z.infer<typeof PriceResponseSchema>;
+export declare const QuoteResponseSchema: z.ZodObject<{
+    blockNumber: z.ZodString;
+    buyAmount: z.ZodString;
+    buyToken: z.ZodString;
+    fees: z.ZodObject<{
+        integratorFee: z.ZodNullable<z.ZodUnknown>;
+        zeroExFee: z.ZodNullable<z.ZodObject<{
+            amount: z.ZodString;
+            token: z.ZodString;
+            type: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            amount: string;
+            token: string;
+        }, {
+            type: string;
+            amount: string;
+            token: string;
+        }>>;
+        gasFee: z.ZodNullable<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        zeroExFee: {
+            type: string;
+            amount: string;
+            token: string;
+        } | null;
+        integratorFee?: unknown;
+        gasFee?: unknown;
+    }, {
+        zeroExFee: {
+            type: string;
+            amount: string;
+            token: string;
+        } | null;
+        integratorFee?: unknown;
+        gasFee?: unknown;
+    }>;
+    gas: z.ZodString;
+    gasPrice: z.ZodString;
+    liquidityAvailable: z.ZodBoolean;
+    minBuyAmount: z.ZodString;
+    route: z.ZodObject<{
+        fills: z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+            source: z.ZodString;
+            proportionBps: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }, {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }>, "many">;
+        tokens: z.ZodArray<z.ZodObject<{
+            address: z.ZodString;
+            symbol: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            symbol: string;
+            address: string;
+        }, {
+            symbol: string;
+            address: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        fills: {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }[];
+        tokens: {
+            symbol: string;
+            address: string;
+        }[];
+    }, {
+        fills: {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }[];
+        tokens: {
+            symbol: string;
+            address: string;
+        }[];
+    }>;
+    sellAmount: z.ZodString;
+    sellToken: z.ZodString;
+    totalNetworkFee: z.ZodString;
+} & {
+    transaction: z.ZodObject<{
+        to: z.ZodString;
+        data: z.ZodString;
+        gas: z.ZodString;
+        gasPrice: z.ZodString;
+        value: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        data: string;
+        gas: string;
+        gasPrice: string;
+        to: string;
+    }, {
+        value: string;
+        data: string;
+        gas: string;
+        gasPrice: string;
+        to: string;
+    }>;
+    permit2: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    blockNumber: z.ZodString;
+    buyAmount: z.ZodString;
+    buyToken: z.ZodString;
+    fees: z.ZodObject<{
+        integratorFee: z.ZodNullable<z.ZodUnknown>;
+        zeroExFee: z.ZodNullable<z.ZodObject<{
+            amount: z.ZodString;
+            token: z.ZodString;
+            type: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            amount: string;
+            token: string;
+        }, {
+            type: string;
+            amount: string;
+            token: string;
+        }>>;
+        gasFee: z.ZodNullable<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        zeroExFee: {
+            type: string;
+            amount: string;
+            token: string;
+        } | null;
+        integratorFee?: unknown;
+        gasFee?: unknown;
+    }, {
+        zeroExFee: {
+            type: string;
+            amount: string;
+            token: string;
+        } | null;
+        integratorFee?: unknown;
+        gasFee?: unknown;
+    }>;
+    gas: z.ZodString;
+    gasPrice: z.ZodString;
+    liquidityAvailable: z.ZodBoolean;
+    minBuyAmount: z.ZodString;
+    route: z.ZodObject<{
+        fills: z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+            source: z.ZodString;
+            proportionBps: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }, {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }>, "many">;
+        tokens: z.ZodArray<z.ZodObject<{
+            address: z.ZodString;
+            symbol: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            symbol: string;
+            address: string;
+        }, {
+            symbol: string;
+            address: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        fills: {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }[];
+        tokens: {
+            symbol: string;
+            address: string;
+        }[];
+    }, {
+        fills: {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }[];
+        tokens: {
+            symbol: string;
+            address: string;
+        }[];
+    }>;
+    sellAmount: z.ZodString;
+    sellToken: z.ZodString;
+    totalNetworkFee: z.ZodString;
+} & {
+    transaction: z.ZodObject<{
+        to: z.ZodString;
+        data: z.ZodString;
+        gas: z.ZodString;
+        gasPrice: z.ZodString;
+        value: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        data: string;
+        gas: string;
+        gasPrice: string;
+        to: string;
+    }, {
+        value: string;
+        data: string;
+        gas: string;
+        gasPrice: string;
+        to: string;
+    }>;
+    permit2: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    blockNumber: z.ZodString;
+    buyAmount: z.ZodString;
+    buyToken: z.ZodString;
+    fees: z.ZodObject<{
+        integratorFee: z.ZodNullable<z.ZodUnknown>;
+        zeroExFee: z.ZodNullable<z.ZodObject<{
+            amount: z.ZodString;
+            token: z.ZodString;
+            type: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            type: string;
+            amount: string;
+            token: string;
+        }, {
+            type: string;
+            amount: string;
+            token: string;
+        }>>;
+        gasFee: z.ZodNullable<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        zeroExFee: {
+            type: string;
+            amount: string;
+            token: string;
+        } | null;
+        integratorFee?: unknown;
+        gasFee?: unknown;
+    }, {
+        zeroExFee: {
+            type: string;
+            amount: string;
+            token: string;
+        } | null;
+        integratorFee?: unknown;
+        gasFee?: unknown;
+    }>;
+    gas: z.ZodString;
+    gasPrice: z.ZodString;
+    liquidityAvailable: z.ZodBoolean;
+    minBuyAmount: z.ZodString;
+    route: z.ZodObject<{
+        fills: z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+            source: z.ZodString;
+            proportionBps: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }, {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }>, "many">;
+        tokens: z.ZodArray<z.ZodObject<{
+            address: z.ZodString;
+            symbol: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            symbol: string;
+            address: string;
+        }, {
+            symbol: string;
+            address: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        fills: {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }[];
+        tokens: {
+            symbol: string;
+            address: string;
+        }[];
+    }, {
+        fills: {
+            from: string;
+            to: string;
+            source: string;
+            proportionBps: string;
+        }[];
+        tokens: {
+            symbol: string;
+            address: string;
+        }[];
+    }>;
+    sellAmount: z.ZodString;
+    sellToken: z.ZodString;
+    totalNetworkFee: z.ZodString;
+} & {
+    transaction: z.ZodObject<{
+        to: z.ZodString;
+        data: z.ZodString;
+        gas: z.ZodString;
+        gasPrice: z.ZodString;
+        value: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: string;
+        data: string;
+        gas: string;
+        gasPrice: string;
+        to: string;
+    }, {
+        value: string;
+        data: string;
+        gas: string;
+        gasPrice: string;
+        to: string;
+    }>;
+    permit2: z.ZodOptional<z.ZodNullable<z.ZodUnknown>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type QuoteResponse = z.infer<typeof QuoteResponseSchema>;
+//# sourceMappingURL=schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/providers/zerox-swap/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAgChB,CAAC;AAEjB,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMhE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gCAShB,CAAC;AAEjB,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

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

@@ -0,0 +1,59 @@
+/**
+ * Zod schemas for 0x Swap API v2 responses.
+ * Runtime validation to detect API drift early.
+ *
+ * Endpoints:
+ * - /swap/allowance-holder/price  -> PriceResponseSchema
+ * - /swap/allowance-holder/quote  -> QuoteResponseSchema
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Price Response (/swap/allowance-holder/price) (ZXSW-02)
+// ---------------------------------------------------------------------------
+export const PriceResponseSchema = z.object({
+    blockNumber: z.string(),
+    buyAmount: z.string(),
+    buyToken: z.string(),
+    fees: z.object({
+        integratorFee: z.unknown().nullable(),
+        zeroExFee: z.object({
+            amount: z.string(),
+            token: z.string(),
+            type: z.string(),
+        }).nullable(),
+        gasFee: z.unknown().nullable(),
+    }),
+    gas: z.string(),
+    gasPrice: z.string(),
+    liquidityAvailable: z.boolean(), // ZXSW-07: must validate this
+    minBuyAmount: z.string(),
+    route: z.object({
+        fills: z.array(z.object({
+            from: z.string(),
+            to: z.string(),
+            source: z.string(),
+            proportionBps: z.string(),
+        })),
+        tokens: z.array(z.object({
+            address: z.string(),
+            symbol: z.string(),
+        })),
+    }),
+    sellAmount: z.string(),
+    sellToken: z.string(),
+    totalNetworkFee: z.string(),
+}).passthrough(); // Allow extra fields from API updates
+// ---------------------------------------------------------------------------
+// Quote Response (/swap/allowance-holder/quote) (ZXSW-03)
+// ---------------------------------------------------------------------------
+export const QuoteResponseSchema = PriceResponseSchema.extend({
+    transaction: z.object({
+        to: z.string(), // AllowanceHolder contract
+        data: z.string(), // calldata (hex)
+        gas: z.string(),
+        gasPrice: z.string(),
+        value: z.string(), // native token value (wei)
+    }),
+    permit2: z.unknown().nullable().optional(), // null for AllowanceHolder flow
+}).passthrough();
+//# sourceMappingURL=schemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/providers/zerox-swap/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,0DAA0D;AAC1D,8EAA8E;AAE9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;QACrC,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC;YAClB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;YAClB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;YACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;SACjB,CAAC,CAAC,QAAQ,EAAE;QACb,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC;IACF,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,EAAG,8BAA8B;IAChE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IACxB,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;YACtB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;YACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;YAClB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;SAC1B,CAAC,CAAC;QACH,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;YACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;YACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;SACnB,CAAC,CAAC;KACJ,CAAC;IACF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;CAC5B,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,sCAAsC;AAIxD,8EAA8E;AAC9E,0DAA0D;AAC1D,8EAA8E;AAE9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAC,MAAM,CAAC;IAC5D,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAO,2BAA2B;QAChD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAK,iBAAiB;QACtC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAI,2BAA2B;KACjD,CAAC;IACF,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,EAAG,gCAAgC;CAC9E,CAAC,CAAC,WAAW,EAAE,CAAC"}

package/dist/providers/zerox-swap/zerox-api-client.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 0x Swap REST API client (v2).
+ * Wraps /swap/allowance-holder/price and /swap/allowance-holder/quote endpoints.
+ *
+ * All requests include chainId as query parameter and 0x-version: v2 header.
+ * Auth is via 0x-api-key header (optional for price, required for quote).
+ */
+import { ActionApiClient } from '../../common/action-api-client.js';
+import type { PriceResponse, QuoteResponse } from './schemas.js';
+import type { ZeroExSwapConfig } from './config.js';
+export declare class ZeroExApiClient extends ActionApiClient {
+    private readonly chainId;
+    constructor(config: ZeroExSwapConfig, chainId: number);
+    getPrice(params: {
+        sellToken: string;
+        buyToken: string;
+        sellAmount: string;
+        taker: string;
+        slippageBps: number;
+    }): Promise<PriceResponse>;
+    getQuote(params: {
+        sellToken: string;
+        buyToken: string;
+        sellAmount: string;
+        taker: string;
+        slippageBps: number;
+    }): Promise<QuoteResponse>;
+}
+//# sourceMappingURL=zerox-api-client.d.ts.map

package/dist/providers/zerox-swap/zerox-api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zerox-api-client.d.ts","sourceRoot":"","sources":["../../../src/providers/zerox-swap/zerox-api-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,qBAAa,eAAgB,SAAQ,eAAe;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM;IAW/C,QAAQ,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,aAAa,CAAC;IAWpB,QAAQ,CAAC,MAAM,EAAE;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,aAAa,CAAC;CAU3B"}

package/dist/providers/zerox-swap/zerox-api-client.js

@@ -0,0 +1,43 @@
+/**
+ * 0x Swap REST API client (v2).
+ * Wraps /swap/allowance-holder/price and /swap/allowance-holder/quote endpoints.
+ *
+ * All requests include chainId as query parameter and 0x-version: v2 header.
+ * Auth is via 0x-api-key header (optional for price, required for quote).
+ */
+import { ActionApiClient } from '../../common/action-api-client.js';
+import { PriceResponseSchema, QuoteResponseSchema } from './schemas.js';
+export class ZeroExApiClient extends ActionApiClient {
+    chainId;
+    constructor(config, chainId) {
+        const headers = {
+            '0x-version': 'v2', // ZXSW-01
+        };
+        if (config.apiKey) {
+            headers['0x-api-key'] = config.apiKey; // ZXSW-01
+        }
+        super(config.apiBaseUrl, config.requestTimeoutMs, headers); // ZXSW-10
+        this.chainId = chainId;
+    }
+    async getPrice(params) {
+        return this.get('swap/allowance-holder/price', PriceResponseSchema, {
+            chainId: String(this.chainId), // ZXSW-01
+            sellToken: params.sellToken,
+            buyToken: params.buyToken,
+            sellAmount: params.sellAmount,
+            taker: params.taker,
+            slippageBps: String(params.slippageBps),
+        });
+    }
+    async getQuote(params) {
+        return this.get('swap/allowance-holder/quote', QuoteResponseSchema, {
+            chainId: String(this.chainId), // ZXSW-01
+            sellToken: params.sellToken,
+            buyToken: params.buyToken,
+            sellAmount: params.sellAmount,
+            taker: params.taker,
+            slippageBps: String(params.slippageBps),
+        });
+    }
+}
+//# sourceMappingURL=zerox-api-client.js.map

package/dist/providers/zerox-swap/zerox-api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zerox-api-client.js","sourceRoot":"","sources":["../../../src/providers/zerox-swap/zerox-api-client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAIxE,MAAM,OAAO,eAAgB,SAAQ,eAAe;IACjC,OAAO,CAAS;IAEjC,YAAY,MAAwB,EAAE,OAAe;QACnD,MAAM,OAAO,GAA2B;YACtC,YAAY,EAAE,IAAI,EAAW,UAAU;SACxC,CAAC;QACF,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAE,UAAU;QACpD,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC,CAAE,UAAU;QACvE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAMd;QACC,OAAO,IAAI,CAAC,GAAG,CAAC,6BAA6B,EAAE,mBAAmB,EAAE;YAClE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAG,UAAU;YAC1C,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;SACxC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAMd;QACC,OAAO,IAAI,CAAC,GAAG,CAAC,6BAA6B,EAAE,mBAAmB,EAAE;YAClE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAG,UAAU;YAC1C,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;SACxC,CAAC,CAAC;IACL,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waiaas/actions",
-  "version": "2.6.0-rc.7",
+  "version": "2.6.0-rc.8",
   "description": "WAIaaS built-in DeFi Action Provider implementations",
   "license": "MIT",
   "type": "module",
@@ -29,7 +29,7 @@
   ],
   "dependencies": {
     "zod": "^3.24.0",
-    "@waiaas/core": "2.6.0-rc.7"
+    "@waiaas/core": "2.6.0-rc.8"
   },
   "devDependencies": {
     "@types/node": "^25.2.3",