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

package/README.md

@@ -0,0 +1,158 @@
+# WAIaaS
+
+**Wallet-as-a-Service for AI Agents**
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/Node.js-22_LTS-green.svg)](https://nodejs.org/)
+[![Tests](https://img.shields.io/badge/Tests-3%2C599_passing-brightgreen.svg)](#)
+
+A self-hosted wallet daemon that lets AI agents perform on-chain transactions securely -- while the owner keeps full control of funds.
+
+## The Problem
+
+AI agents that need to transact on-chain face an impossible choice: hold private keys (and risk total loss if compromised) or depend on a centralized custodian (single point of failure, trust dependency).
+
+WAIaaS bridges the gap -- agents handle small transactions instantly, large amounts require owner approval, and everything runs on your machine with no third-party dependency.
+
+## How It Works
+
+WAIaaS is a local daemon that sits between your AI agent and the blockchain:
+
+- **3-tier authentication** -- Separate roles for the daemon operator (masterAuth), fund owner (ownerAuth), and AI agent (sessionAuth)
+- **4-tier policy engine** -- Transactions are auto-classified by USD value into INSTANT / NOTIFY / DELAY / APPROVAL tiers
+- **12 policy types** -- Cumulative spend limits, token allowlists, contract whitelists, approved spenders, and more
+- **Defense in depth** -- Kill Switch, AutoStop engine, audit logging, 4-channel notifications
+
+See [Security Model](docs/security-model.md) for full details.
+
+## Quick Start
+
+```bash
+npm install -g @waiaas/cli
+waiaas init                        # Create data directory + config.toml
+waiaas start                       # Start daemon (sets master password on first run)
+waiaas quickset --mode testnet     # Create wallets + MCP sessions in one step
+```
+
+The `quickset` command does everything you need to get started:
+
+1. Creates **Solana Devnet + EVM Sepolia** wallets automatically
+2. Issues **MCP session tokens** for each wallet
+3. Outputs a **Claude Desktop MCP config** snippet -- just copy and paste
+
+> Starting with mainnet? Use `waiaas quickset --mode mainnet` to create Solana Mainnet + EVM Ethereum Mainnet wallets instead. Mainnet mode recommends configuring spending limits and registering an owner wallet for high-value transaction approval.
+
+### Admin UI
+
+After starting the daemon, manage everything from the admin panel at `http://127.0.0.1:3100/admin` (masterAuth required).
+
+## Connect Your AI Agent
+
+After quickset, choose one of two integration paths:
+
+### Path A: MCP (Claude Desktop / Claude Code)
+
+For AI agents that support the [Model Context Protocol](https://modelcontextprotocol.io):
+
+```bash
+# quickset already printed the MCP config JSON -- paste it into
+# ~/Library/Application Support/Claude/claude_desktop_config.json
+# Or auto-register with all wallets:
+waiaas mcp setup --all
+```
+
+The daemon runs as an MCP server. Your agent calls wallet tools directly -- send tokens, check balances, manage policies -- all through the MCP protocol.
+
+### Path B: Skill Files (Any AI Agent)
+
+For agents that don't support MCP, or when you prefer REST API integration:
+
+```bash
+npx @waiaas/skills add all
+```
+
+This adds `.skill.md` instruction files to your project. Include them in your agent's context and it learns the WAIaaS API automatically. Available skills: `quickstart`, `wallet`, `transactions`, `policies`, `admin`, `actions`, `x402`.
+
+## Alternative: Docker
+
+```bash
+git clone https://github.com/minho-yoo/waiaas.git && cd waiaas
+docker compose up -d
+```
+
+The daemon listens on `http://127.0.0.1:3100`.
+
+## Using the SDK
+
+```typescript
+import { WAIaaSClient } from '@waiaas/sdk';
+
+const client = new WAIaaSClient({
+  baseUrl: 'http://127.0.0.1:3100',
+  sessionToken: process.env.WAIAAS_SESSION_TOKEN,
+});
+
+const balance = await client.getBalance();
+console.log(`Balance: ${balance.balance} ${balance.symbol}`);
+
+const tx = await client.sendToken({
+  to: 'recipient-address...',
+  amount: '0.1',
+});
+console.log(`Transaction: ${tx.id}`);
+```
+
+## Admin UI
+
+Access the admin panel at `http://127.0.0.1:3100/admin` with your master password:
+
+- **Dashboard** -- System overview, wallet balances, recent transactions
+- **Wallets** -- Create, manage, and monitor wallets across chains; RPC endpoints, balance monitoring, and WalletConnect settings
+- **Sessions** -- Issue and revoke agent session tokens; session lifetime and rate limit settings
+- **Policies** -- Configure 12 policy types with visual form editors; default deny and tier settings
+- **Notifications** -- Channel status and delivery logs; Telegram, Discord, ntfy, and Slack settings
+- **Security** -- Kill Switch emergency controls, AutoStop protection rules, JWT rotation
+- **System** -- API keys, display currency, price oracle, rate limits, log level, and daemon shutdown
+
+Features include settings search (Ctrl+K / Cmd+K) and unsaved changes protection.
+
+Enabled by default (`admin_ui = true` in config.toml).
+
+## Supported Networks
+
+| Chain | Environment | Networks |
+|-------|-------------|----------|
+| Solana | mainnet | mainnet |
+| Solana | testnet | devnet, testnet |
+| EVM | mainnet | ethereum-mainnet, polygon-mainnet, arbitrum-mainnet, optimism-mainnet, base-mainnet |
+| EVM | testnet | ethereum-sepolia, polygon-amoy, arbitrum-sepolia, optimism-sepolia, base-sepolia |
+
+13 networks total (Solana 3 + EVM 10).
+
+## Features
+
+- **Self-hosted local daemon** -- No central server; keys never leave your machine
+- **Multi-chain** -- Solana (SPL / Token-2022) and EVM (ERC-20) via `IChainAdapter`
+- **Token, contract, and DeFi** -- Native transfers, token transfers, contract calls, approve, batch transactions, Action Provider plugins (Jupiter Swap, etc.)
+- **USD policy evaluation** -- Price oracles (CoinGecko / Pyth / Chainlink) evaluate all transactions in USD
+- **x402 payments** -- Automatic HTTP 402 payment handling with EIP-3009 signatures
+- **Multiple interfaces** -- REST API, TypeScript SDK, Python SDK, MCP server, CLI, Admin Web UI, Tauri Desktop, Telegram Bot
+- **Skill files** -- Pre-built instruction files that teach AI agents how to use the API
+
+## Documentation
+
+| Document | Description |
+|----------|-------------|
+| [Security Model](docs/security-model.md) | Authentication, policy engine, Kill Switch, AutoStop |
+| [Deployment Guide](docs/deployment.md) | Docker, npm, configuration reference |
+| [API Reference](docs/api-reference.md) | REST API endpoints and authentication |
+| [Agent Skills Integration](docs/guides/agent-skills-integration.md) | Universal guide for 27+ AI agent platforms |
+| [Claude Code Integration](docs/guides/claude-code-integration.md) | Skill files + MCP server setup for Claude Code |
+| [OpenClaw Integration](docs/guides/openclaw-integration.md) | Quick setup for OpenClaw bot |
+| [Wallet SDK Integration](docs/wallet-sdk-integration.md) | Integration guide for wallet developers |
+| [Why WAIaaS?](docs/why-waiaas/) | Background on AI agent wallet security |
+| [Contributing](CONTRIBUTING.md) | Development setup, code style, testing, PR guidelines |
+
+## License
+
+[MIT](LICENSE) -- Copyright (c) 2026 WAIaaS Contributors

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