@waiaas/actions 2.6.0-rc.8 → 2.6.0

package/README.md

@@ -25,22 +25,69 @@ WAIaaS is a local daemon that sits between your AI agent and the blockchain:
 
 See [Security Model](docs/security-model.md) for full details.
 
+## Architecture
+
+```mermaid
+graph LR
+  subgraph Interfaces
+    SDK["TypeScript SDK"]
+    MCP["MCP Server"]
+    CLI["CLI"]
+    Admin["Admin UI"]
+    Skills["Skill Files"]
+    WalletSDK["Wallet SDK"]
+  end
+
+  subgraph Daemon
+    API["API Layer<br>(Hono + Middleware)"]
+    Services["Service Layer<br>(Policy, Notifications, Kill Switch)"]
+    Pipeline["Transaction Pipeline<br>(6-stage + 8-state)"]
+    Infra["Infrastructure<br>(SQLite, Keystore, Config)"]
+  end
+
+  subgraph Blockchain
+    Solana["Solana"]
+    EVM["EVM Chains"]
+  end
+
+  SDK & MCP & CLI & Admin & Skills & WalletSDK --> API
+  API --> Services --> Pipeline --> Infra
+  Infra --> Solana & EVM
+```
+
+**12 packages** in a monorepo:
+
+- **@waiaas/core** — Shared types, Zod schemas, enums, and interfaces
+- **@waiaas/daemon** — Self-hosted wallet daemon (Hono HTTP server)
+- **@waiaas/adapter-solana** — Solana chain adapter (SPL / Token-2022)
+- **@waiaas/adapter-evm** — EVM chain adapter (ERC-20 via viem)
+- **@waiaas/actions** — DeFi Action Providers (Jupiter, 0x, LI.FI, Lido, Jito)
+- **@waiaas/sdk** — TypeScript client library
+- **@waiaas/mcp** — Model Context Protocol server for AI agents
+- **@waiaas/cli** — Command-line interface
+- **@waiaas/admin** — Preact-based Admin Web UI
+- **@waiaas/wallet-sdk** — Wallet Signing SDK for wallet app integration
+- **@waiaas/push-relay** — Push Relay Server (ntfy → push services)
+- **@waiaas/skills** — Pre-built `.skill.md` instruction files for AI agents
+
+See [Architecture](docs/architecture.md) for the full technical deep-dive.
+
 ## 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
+waiaas quickset --mode mainnet     # 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
+1. Creates **Solana Mainnet + EVM Ethereum Mainnet** 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.
+> We recommend configuring spending limits and registering an owner wallet for high-value transaction approval. For testing, use `waiaas quickset --mode testnet` to create Solana Devnet + EVM Sepolia wallets instead.
 
 ### Admin UI
 
@@ -143,6 +190,7 @@ Enabled by default (`admin_ui = true` in config.toml).
 
 | Document | Description |
 |----------|-------------|
+| [Architecture](docs/architecture.md) | System overview, package structure, pipeline, chain adapters |
 | [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 |

package/dist/common/async-status-tracker.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Async Status Tracker interface and types for DeFi async operations.
+ *
+ * IAsyncStatusTracker defines the contract for polling-based status tracking
+ * of asynchronous blockchain operations (bridge transfers, unstaking, gas conditions).
+ *
+ * AsyncPollingService (daemon) uses these interfaces to generically poll
+ * registered trackers at configurable intervals.
+ *
+ * @see internal/objectives/m28-00-defi-basic-protocol-design.md (DEFI-04 ASNC-01)
+ */
+import { z } from 'zod';
+/**
+ * All possible bridge_status values for the transactions table.
+ * Used as SSoT for DB CHECK constraint and Zod schema.
+ */
+export declare const BRIDGE_STATUS_VALUES: readonly ["PENDING", "COMPLETED", "FAILED", "BRIDGE_MONITORING", "TIMEOUT", "REFUNDED"];
+/** Bridge status type derived from BRIDGE_STATUS_VALUES SSoT array. */
+export type BridgeStatus = (typeof BRIDGE_STATUS_VALUES)[number];
+/** Zod schema for bridge status validation (SSoT pattern). */
+export declare const BridgeStatusEnum: z.ZodEnum<["PENDING", "COMPLETED", "FAILED", "BRIDGE_MONITORING", "TIMEOUT", "REFUNDED"]>;
+/**
+ * Result returned by IAsyncStatusTracker.checkStatus().
+ *
+ * - state: current tracking state (PENDING continues polling, others are terminal or timeout)
+ * - details: optional tracker-specific metadata merged into bridge_metadata
+ * - nextIntervalOverride: optional override for next poll interval (ms)
+ */
+export interface AsyncTrackingResult {
+    state: 'PENDING' | 'COMPLETED' | 'FAILED' | 'TIMEOUT';
+    details?: Record<string, unknown>;
+    nextIntervalOverride?: number;
+}
+/**
+ * Contract for async status tracking implementations.
+ *
+ * Each tracker monitors a specific type of async operation:
+ * - BridgeStatusTracker: cross-chain bridge transfer completion
+ * - UnstakeStatusTracker: staking withdrawal completion
+ * - GasConditionTracker: gas price condition satisfaction
+ *
+ * Trackers are registered with AsyncPollingService which calls checkStatus()
+ * at pollIntervalMs intervals, up to maxAttempts times.
+ */
+export interface IAsyncStatusTracker {
+    /** Check the current status of an async operation. */
+    checkStatus(txId: string, metadata: Record<string, unknown>): Promise<AsyncTrackingResult>;
+    /** Tracker name used for registration and lookup (e.g., 'bridge', 'unstake', 'gas-condition'). */
+    readonly name: string;
+    /** Maximum number of poll attempts before timeout transition. */
+    readonly maxAttempts: number;
+    /** Polling interval in milliseconds between checkStatus() calls. */
+    readonly pollIntervalMs: number;
+    /**
+     * State transition when maxAttempts is exceeded:
+     * - 'TIMEOUT': Mark bridge_status as TIMEOUT (terminal)
+     * - 'BRIDGE_MONITORING': Transition to reduced-frequency monitoring
+     * - 'CANCELLED': Cancel the transaction (for GAS_WAITING timeout)
+     */
+    readonly timeoutTransition: 'TIMEOUT' | 'BRIDGE_MONITORING' | 'CANCELLED';
+}
+//# sourceMappingURL=async-status-tracker.d.ts.map

package/dist/common/async-status-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-status-tracker.d.ts","sourceRoot":"","sources":["../../src/common/async-status-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;GAGG;AACH,eAAO,MAAM,oBAAoB,yFAOvB,CAAC;AAEX,uEAAuE;AACvE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,8DAA8D;AAC9D,eAAO,MAAM,gBAAgB,2FAA+B,CAAC;AAM7D;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAMD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC,sDAAsD;IACtD,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE3F,kGAAkG;IAClG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,iEAAiE;IACjE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,oEAAoE;IACpE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC;;;;;OAKG;IACH,QAAQ,CAAC,iBAAiB,EAAE,SAAS,GAAG,mBAAmB,GAAG,WAAW,CAAC;CAC3E"}

package/dist/common/async-status-tracker.js

@@ -0,0 +1,30 @@
+/**
+ * Async Status Tracker interface and types for DeFi async operations.
+ *
+ * IAsyncStatusTracker defines the contract for polling-based status tracking
+ * of asynchronous blockchain operations (bridge transfers, unstaking, gas conditions).
+ *
+ * AsyncPollingService (daemon) uses these interfaces to generically poll
+ * registered trackers at configurable intervals.
+ *
+ * @see internal/objectives/m28-00-defi-basic-protocol-design.md (DEFI-04 ASNC-01)
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Bridge status values (6-value enum for transactions.bridge_status column)
+// ---------------------------------------------------------------------------
+/**
+ * All possible bridge_status values for the transactions table.
+ * Used as SSoT for DB CHECK constraint and Zod schema.
+ */
+export const BRIDGE_STATUS_VALUES = [
+    'PENDING',
+    'COMPLETED',
+    'FAILED',
+    'BRIDGE_MONITORING',
+    'TIMEOUT',
+    'REFUNDED',
+];
+/** Zod schema for bridge status validation (SSoT pattern). */
+export const BridgeStatusEnum = z.enum(BRIDGE_STATUS_VALUES);
+//# sourceMappingURL=async-status-tracker.js.map

package/dist/common/async-status-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-status-tracker.js","sourceRoot":"","sources":["../../src/common/async-status-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,SAAS;IACT,WAAW;IACX,QAAQ;IACR,mBAAmB;IACnB,SAAS;IACT,UAAU;CACF,CAAC;AAKX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -11,9 +11,24 @@ export type { JupiterSwapConfig } from './providers/jupiter-swap/config.js';
 export { ZeroExSwapActionProvider } from './providers/zerox-swap/index.js';
 export { ALLOWANCE_HOLDER_ADDRESSES, ZEROX_SWAP_DEFAULTS, CHAIN_ID_MAP, getAllowanceHolderAddress } from './providers/zerox-swap/config.js';
 export type { ZeroExSwapConfig } from './providers/zerox-swap/config.js';
+export { LiFiActionProvider } from './providers/lifi/index.js';
+export { LIFI_DEFAULTS, LIFI_CHAIN_MAP, getLiFiChainId } from './providers/lifi/config.js';
+export type { LiFiConfig } from './providers/lifi/config.js';
+export { LiFiApiClient } from './providers/lifi/lifi-api-client.js';
+export { BridgeStatusTracker, BridgeMonitoringTracker } from './providers/lifi/bridge-status-tracker.js';
+export { LidoStakingActionProvider } from './providers/lido-staking/index.js';
+export { LIDO_STAKING_DEFAULTS, LIDO_MAINNET_ADDRESSES, LIDO_TESTNET_ADDRESSES, getLidoAddresses } from './providers/lido-staking/config.js';
+export type { LidoStakingConfig } from './providers/lido-staking/config.js';
+export { LidoWithdrawalTracker } from './providers/lido-staking/withdrawal-tracker.js';
+export { JitoStakingActionProvider } from './providers/jito-staking/index.js';
+export { JITO_STAKING_DEFAULTS, JITO_MAINNET_ADDRESSES, getJitoAddresses } from './providers/jito-staking/config.js';
+export type { JitoStakingConfig } from './providers/jito-staking/config.js';
+export { JitoEpochTracker } from './providers/jito-staking/epoch-tracker.js';
 export { ActionApiClient } from './common/action-api-client.js';
 export { asBps, asPct, clampSlippageBps, bpsToPct, pctToBps } from './common/slippage.js';
 export type { SlippageBps, SlippagePct } from './common/slippage.js';
+export { BRIDGE_STATUS_VALUES, BridgeStatusEnum, } from './common/async-status-tracker.js';
+export type { IAsyncStatusTracker, AsyncTrackingResult, BridgeStatus, } from './common/async-status-tracker.js';
 /** Minimal settings reader interface compatible with SettingsService.get(). */
 export interface SettingsReader {
     get(key: string): string;

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;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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,cAAc,CAAC;AAWjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC/F,YAAY,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC5I,YAAY,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC3F,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAEzG,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC7I,YAAY,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAEvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACrH,YAAY,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAG7E,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC1F,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGrE,OAAO,EACL,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,GACb,MAAM,kCAAkC,CAAC;AAM1C,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;CAC3C;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,gBAAgB,EAC1B,cAAc,EAAE,cAAc,GAC7B;IAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAsHzC"}

package/dist/index.js

@@ -1,13 +1,31 @@
+import { deriveEnvironment } from '@waiaas/core';
 import { JupiterSwapActionProvider } from './providers/jupiter-swap/index.js';
 import { ZeroExSwapActionProvider } from './providers/zerox-swap/index.js';
+import { LiFiActionProvider } from './providers/lifi/index.js';
+import { LidoStakingActionProvider } from './providers/lido-staking/index.js';
+import { getLidoAddresses } from './providers/lido-staking/config.js';
+import { JitoStakingActionProvider } from './providers/jito-staking/index.js';
+import { getJitoAddresses } from './providers/jito-staking/config.js';
 // Re-export provider classes
 export { JupiterSwapActionProvider } from './providers/jupiter-swap/index.js';
 export { JUPITER_PROGRAM_ID, JUPITER_SWAP_DEFAULTS } from './providers/jupiter-swap/config.js';
 export { ZeroExSwapActionProvider } from './providers/zerox-swap/index.js';
 export { ALLOWANCE_HOLDER_ADDRESSES, ZEROX_SWAP_DEFAULTS, CHAIN_ID_MAP, getAllowanceHolderAddress } from './providers/zerox-swap/config.js';
+export { LiFiActionProvider } from './providers/lifi/index.js';
+export { LIFI_DEFAULTS, LIFI_CHAIN_MAP, getLiFiChainId } from './providers/lifi/config.js';
+export { LiFiApiClient } from './providers/lifi/lifi-api-client.js';
+export { BridgeStatusTracker, BridgeMonitoringTracker } from './providers/lifi/bridge-status-tracker.js';
+export { LidoStakingActionProvider } from './providers/lido-staking/index.js';
+export { LIDO_STAKING_DEFAULTS, LIDO_MAINNET_ADDRESSES, LIDO_TESTNET_ADDRESSES, getLidoAddresses } from './providers/lido-staking/config.js';
+export { LidoWithdrawalTracker } from './providers/lido-staking/withdrawal-tracker.js';
+export { JitoStakingActionProvider } from './providers/jito-staking/index.js';
+export { JITO_STAKING_DEFAULTS, JITO_MAINNET_ADDRESSES, getJitoAddresses } from './providers/jito-staking/config.js';
+export { JitoEpochTracker } from './providers/jito-staking/epoch-tracker.js';
 // Re-export common utilities
 export { ActionApiClient } from './common/action-api-client.js';
 export { asBps, asPct, clampSlippageBps, bpsToPct, pctToBps } from './common/slippage.js';
+// Re-export async status tracker interface and types (v28.3 DEFI-04)
+export { BRIDGE_STATUS_VALUES, BridgeStatusEnum, } from './common/async-status-tracker.js';
 /**
  * Register built-in DeFi action providers from Admin Settings.
  *
@@ -49,6 +67,58 @@ export function registerBuiltInProviders(registry, settingsReader) {
                 return new ZeroExSwapActionProvider(config);
             },
         },
+        {
+            key: 'lifi',
+            enabledKey: 'actions.lifi_enabled',
+            factory: () => {
+                const config = {
+                    enabled: true,
+                    apiBaseUrl: settingsReader.get('actions.lifi_api_base_url'),
+                    apiKey: settingsReader.get('actions.lifi_api_key'),
+                    defaultSlippagePct: Number(settingsReader.get('actions.lifi_default_slippage_pct')),
+                    maxSlippagePct: Number(settingsReader.get('actions.lifi_max_slippage_pct')),
+                    requestTimeoutMs: 15_000,
+                };
+                return new LiFiActionProvider(config);
+            },
+        },
+        {
+            key: 'lido_staking',
+            enabledKey: 'actions.lido_staking_enabled',
+            factory: () => {
+                // Resolve environment from registered rpc.evm_default_network setting
+                const evmNetwork = settingsReader.get('rpc.evm_default_network') || 'ethereum-mainnet';
+                const isTestnet = deriveEnvironment(evmNetwork) === 'testnet';
+                const addresses = getLidoAddresses(isTestnet ? 'testnet' : 'mainnet');
+                // Admin Settings overrides individual addresses; empty string falls back to environment default
+                const stethOverride = settingsReader.get('actions.lido_staking_steth_address');
+                const withdrawalOverride = settingsReader.get('actions.lido_staking_withdrawal_queue_address');
+                const config = {
+                    enabled: true,
+                    stethAddress: stethOverride || addresses.stethAddress,
+                    withdrawalQueueAddress: withdrawalOverride || addresses.withdrawalQueueAddress,
+                };
+                return new LidoStakingActionProvider(config);
+            },
+        },
+        {
+            key: 'jito_staking',
+            enabledKey: 'actions.jito_staking_enabled',
+            factory: () => {
+                // Jito is mainnet-only -- no testnet pool exists.
+                // Read admin override addresses; empty string falls back to mainnet defaults.
+                const stakePoolOverride = settingsReader.get('actions.jito_staking_stake_pool_address');
+                const jitosolMintOverride = settingsReader.get('actions.jito_staking_jitosol_mint');
+                const addresses = getJitoAddresses('mainnet');
+                const config = {
+                    enabled: true,
+                    stakePoolAddress: stakePoolOverride || addresses.stakePoolAddress,
+                    jitosolMint: jitosolMintOverride || addresses.jitosolMint,
+                    stakePoolProgram: addresses.stakePoolProgram,
+                };
+                return new JitoStakingActionProvider(config);
+            },
+        },
     ];
     for (const { key, enabledKey, factory } of providers) {
         if (settingsReader.get(enabledKey) === 'true') {

package/dist/index.js.map

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

package/dist/providers/jito-staking/config.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Jito Staking configuration type, defaults, and address maps.
+ *
+ * Supports Solana mainnet only (Jito has no official devnet/testnet deployment).
+ * See: https://www.jito.network/
+ */
+export interface JitoStakingConfig {
+    enabled: boolean;
+    stakePoolAddress: string;
+    jitosolMint: string;
+    stakePoolProgram: string;
+}
+export declare const JITO_MAINNET_ADDRESSES: {
+    readonly stakePoolAddress: "Jito4APyf642JPZPx3hGc6WWJ8zPKtRbRs4P815Awbb";
+    readonly jitosolMint: "J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn";
+    readonly stakePoolProgram: "SPoo1Ku8WFXoNDMHPsrGSTSG1Y47rzgn41SLUNakuHy";
+};
+/** Stake Pool withdraw authority (PDA derived from stake pool address). */
+export declare const JITO_WITHDRAW_AUTHORITY = "6iQKfEyhr3bZMotVkW6beNZz5CPAkiwvgV2CTje9pVSS";
+/** Reserve stake account for the Jito Stake Pool. */
+export declare const JITO_RESERVE_STAKE = "BgKUXdS2jFbByBaPQRf6eSCjMH3mRLDPH1MCVLhEAD3c";
+/** Manager fee account for the Jito Stake Pool. */
+export declare const JITO_MANAGER_FEE = "B1aLzaNMeFVAyQ6f3XbbUyKcH2YPHu2fqiEagmiF23VR";
+/** SPL Token Program. */
+export declare const SPL_TOKEN_PROGRAM = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+/** System Program. */
+export declare const SYSTEM_PROGRAM = "11111111111111111111111111111111";
+export declare const JITO_STAKING_DEFAULTS: JitoStakingConfig;
+/**
+ * Get Jito addresses for a given environment type.
+ *
+ * Jito Stake Pool is mainnet-only. Testnet falls back to mainnet addresses.
+ *
+ * @param environment - 'mainnet' or 'testnet'
+ */
+export declare function getJitoAddresses(environment: 'mainnet' | 'testnet'): {
+    stakePoolAddress: string;
+    jitosolMint: string;
+    stakePoolProgram: string;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/providers/jito-staking/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/providers/jito-staking/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAMD,eAAO,MAAM,sBAAsB;;;;CAIzB,CAAC;AAMX,2EAA2E;AAC3E,eAAO,MAAM,uBAAuB,iDAAiD,CAAC;AAEtF,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,iDAAiD,CAAC;AAEjF,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,iDAAiD,CAAC;AAE/E,yBAAyB;AACzB,eAAO,MAAM,iBAAiB,gDAAgD,CAAC;AAE/E,sBAAsB;AACtB,eAAO,MAAM,cAAc,qCAAqC,CAAC;AAMjE,eAAO,MAAM,qBAAqB,EAAE,iBAGnC,CAAC;AAMF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,SAAS,GAAG,SAAS,GACjC;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAI7E"}

package/dist/providers/jito-staking/config.js

@@ -0,0 +1,50 @@
+/**
+ * Jito Staking configuration type, defaults, and address maps.
+ *
+ * Supports Solana mainnet only (Jito has no official devnet/testnet deployment).
+ * See: https://www.jito.network/
+ */
+// ---------------------------------------------------------------------------
+// Mainnet addresses (Solana)
+// ---------------------------------------------------------------------------
+export const JITO_MAINNET_ADDRESSES = {
+    stakePoolAddress: 'Jito4APyf642JPZPx3hGc6WWJ8zPKtRbRs4P815Awbb',
+    jitosolMint: 'J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn',
+    stakePoolProgram: 'SPoo1Ku8WFXoNDMHPsrGSTSG1Y47rzgn41SLUNakuHy',
+};
+// ---------------------------------------------------------------------------
+// Well-known PDA and program addresses
+// ---------------------------------------------------------------------------
+/** Stake Pool withdraw authority (PDA derived from stake pool address). */
+export const JITO_WITHDRAW_AUTHORITY = '6iQKfEyhr3bZMotVkW6beNZz5CPAkiwvgV2CTje9pVSS';
+/** Reserve stake account for the Jito Stake Pool. */
+export const JITO_RESERVE_STAKE = 'BgKUXdS2jFbByBaPQRf6eSCjMH3mRLDPH1MCVLhEAD3c';
+/** Manager fee account for the Jito Stake Pool. */
+export const JITO_MANAGER_FEE = 'B1aLzaNMeFVAyQ6f3XbbUyKcH2YPHu2fqiEagmiF23VR';
+/** SPL Token Program. */
+export const SPL_TOKEN_PROGRAM = 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA';
+/** System Program. */
+export const SYSTEM_PROGRAM = '11111111111111111111111111111111';
+// ---------------------------------------------------------------------------
+// Defaults (disabled, mainnet addresses)
+// ---------------------------------------------------------------------------
+export const JITO_STAKING_DEFAULTS = {
+    enabled: false,
+    ...JITO_MAINNET_ADDRESSES,
+};
+// ---------------------------------------------------------------------------
+// Helper to select addresses by environment
+// ---------------------------------------------------------------------------
+/**
+ * Get Jito addresses for a given environment type.
+ *
+ * Jito Stake Pool is mainnet-only. Testnet falls back to mainnet addresses.
+ *
+ * @param environment - 'mainnet' or 'testnet'
+ */
+export function getJitoAddresses(environment) {
+    // Jito Stake Pool is mainnet-only. Testnet falls back to mainnet addresses.
+    void environment;
+    return { ...JITO_MAINNET_ADDRESSES };
+}
+//# sourceMappingURL=config.js.map

package/dist/providers/jito-staking/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/providers/jito-staking/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,8EAA8E;AAC9E,6BAA6B;AAC7B,8EAA8E;AAE9E,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,gBAAgB,EAAE,6CAA6C;IAC/D,WAAW,EAAE,8CAA8C;IAC3D,gBAAgB,EAAE,6CAA6C;CACvD,CAAC;AAEX,8EAA8E;AAC9E,uCAAuC;AACvC,8EAA8E;AAE9E,2EAA2E;AAC3E,MAAM,CAAC,MAAM,uBAAuB,GAAG,8CAA8C,CAAC;AAEtF,qDAAqD;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAG,8CAA8C,CAAC;AAEjF,mDAAmD;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,8CAA8C,CAAC;AAE/E,yBAAyB;AACzB,MAAM,CAAC,MAAM,iBAAiB,GAAG,6CAA6C,CAAC;AAE/E,sBAAsB;AACtB,MAAM,CAAC,MAAM,cAAc,GAAG,kCAAkC,CAAC;AAEjE,8EAA8E;AAC9E,yCAAyC;AACzC,8EAA8E;AAE9E,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACtD,OAAO,EAAE,KAAK;IACd,GAAG,sBAAsB;CAC1B,CAAC;AAEF,8EAA8E;AAC9E,4CAA4C;AAC5C,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,WAAkC;IAElC,4EAA4E;IAC5E,KAAK,WAAW,CAAC;IACjB,OAAO,EAAE,GAAG,sBAAsB,EAAE,CAAC;AACvC,CAAC"}

package/dist/providers/jito-staking/epoch-tracker.d.ts

@@ -0,0 +1,22 @@
+/**
+ * JitoEpochTracker - IAsyncStatusTracker for Jito SOL unstake epoch boundary.
+ *
+ * Tracks Jito unstake requests via metadata-based polling (v1 implementation).
+ * Active polling: 30s x 240 = 2 hours, then TIMEOUT (terminal).
+ *
+ * Solana epoch boundaries occur every ~2-3 days. Jito unstake deactivates
+ * the stake account, and cooldown completes at the next epoch boundary.
+ * This tracker monitors metadata state and emits STAKING_UNSTAKE_COMPLETED
+ * or STAKING_UNSTAKE_TIMEOUT notifications.
+ *
+ * @see packages/actions/src/common/async-status-tracker.ts
+ */
+import type { IAsyncStatusTracker, AsyncTrackingResult } from '../../common/async-status-tracker.js';
+export declare class JitoEpochTracker implements IAsyncStatusTracker {
+    readonly name = "jito-epoch";
+    readonly maxAttempts = 240;
+    readonly pollIntervalMs = 30000;
+    readonly timeoutTransition: "TIMEOUT";
+    checkStatus(_txId: string, metadata: Record<string, unknown>): Promise<AsyncTrackingResult>;
+}
+//# sourceMappingURL=epoch-tracker.d.ts.map

package/dist/providers/jito-staking/epoch-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epoch-tracker.d.ts","sourceRoot":"","sources":["../../../src/providers/jito-staking/epoch-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAKrG,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,OAAO;IAC3B,QAAQ,CAAC,cAAc,SAAU;IACjC,QAAQ,CAAC,iBAAiB,EAAG,SAAS,CAAU;IAE1C,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA4BlG"}

package/dist/providers/jito-staking/epoch-tracker.js

@@ -0,0 +1,48 @@
+/**
+ * JitoEpochTracker - IAsyncStatusTracker for Jito SOL unstake epoch boundary.
+ *
+ * Tracks Jito unstake requests via metadata-based polling (v1 implementation).
+ * Active polling: 30s x 240 = 2 hours, then TIMEOUT (terminal).
+ *
+ * Solana epoch boundaries occur every ~2-3 days. Jito unstake deactivates
+ * the stake account, and cooldown completes at the next epoch boundary.
+ * This tracker monitors metadata state and emits STAKING_UNSTAKE_COMPLETED
+ * or STAKING_UNSTAKE_TIMEOUT notifications.
+ *
+ * @see packages/actions/src/common/async-status-tracker.ts
+ */
+/** Expected days for Solana epoch boundary (~2-3 days). */
+const JITO_EXPECTED_DAYS = 3;
+export class JitoEpochTracker {
+    name = 'jito-epoch';
+    maxAttempts = 240; // 240 x 30s = 2 hours active polling
+    pollIntervalMs = 30_000; // 30 seconds
+    timeoutTransition = 'TIMEOUT';
+    async checkStatus(_txId, metadata) {
+        // If metadata.status is 'deactivated', unstake is complete
+        if (metadata.status === 'deactivated') {
+            return {
+                state: 'COMPLETED',
+                details: {
+                    completedAt: Date.now(),
+                    protocol: 'jito',
+                    notificationEvent: 'STAKING_UNSTAKE_COMPLETED',
+                },
+            };
+        }
+        // Calculate estimated days remaining based on unstake request time
+        const requestedAt = metadata.unstakeRequestedAt;
+        const estimatedDaysRemaining = requestedAt
+            ? Math.max(0, JITO_EXPECTED_DAYS - (Date.now() - requestedAt) / (1000 * 60 * 60 * 24))
+            : JITO_EXPECTED_DAYS;
+        return {
+            state: 'PENDING',
+            details: {
+                estimatedDaysRemaining: Math.round(estimatedDaysRemaining * 10) / 10,
+                protocol: 'jito',
+                targetEpoch: metadata.targetEpoch ?? null,
+            },
+        };
+    }
+}
+//# sourceMappingURL=epoch-tracker.js.map

package/dist/providers/jito-staking/epoch-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"epoch-tracker.js","sourceRoot":"","sources":["../../../src/providers/jito-staking/epoch-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,2DAA2D;AAC3D,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B,MAAM,OAAO,gBAAgB;IAClB,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAAG,GAAG,CAAC,CAAU,qCAAqC;IACjE,cAAc,GAAG,MAAM,CAAC,CAAI,aAAa;IACzC,iBAAiB,GAAG,SAAkB,CAAC;IAEhD,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,QAAiC;QAChE,2DAA2D;QAC3D,IAAI,QAAQ,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;YACtC,OAAO;gBACL,KAAK,EAAE,WAAW;gBAClB,OAAO,EAAE;oBACP,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;oBACvB,QAAQ,EAAE,MAAM;oBAChB,iBAAiB,EAAE,2BAA2B;iBAC/C;aACF,CAAC;QACJ,CAAC;QAED,mEAAmE;QACnE,MAAM,WAAW,GAAG,QAAQ,CAAC,kBAAwC,CAAC;QACtE,MAAM,sBAAsB,GAAG,WAAW;YACxC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;YACtF,CAAC,CAAC,kBAAkB,CAAC;QAEvB,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE;gBACP,sBAAsB,EAAE,IAAI,CAAC,KAAK,CAAC,sBAAsB,GAAG,EAAE,CAAC,GAAG,EAAE;gBACpE,QAAQ,EAAE,MAAM;gBAChB,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,IAAI;aAC1C;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/providers/jito-staking/index.d.ts

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

package/dist/providers/jito-staking/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/jito-staking/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACpB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,KAAK,iBAAiB,EAAyB,MAAM,aAAa,CAAC;AAuB5E,qBAAa,yBAA0B,YAAW,eAAe;IAC/D,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAE9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;gBAE/B,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAiCzC,OAAO,CACX,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,mBAAmB,CAAC;YAkBjB,YAAY;YAcZ,cAAc;CAS7B"}

package/dist/providers/jito-staking/index.js

@@ -0,0 +1,89 @@
+/**
+ * Jito Staking Action Provider.
+ *
+ * Implements IActionProvider to resolve Jito liquid staking requests
+ * into ContractCallRequest objects for the sequential pipeline.
+ *
+ * Actions:
+ * - stake: SOL -> JitoSOL via SPL Stake Pool depositSol
+ * - unstake: JitoSOL -> SOL via SPL Stake Pool withdrawSol
+ */
+import { z } from 'zod';
+import { ChainError } from '@waiaas/core';
+import { JITO_STAKING_DEFAULTS } from './config.js';
+import { buildDepositSolRequest, buildWithdrawSolRequest, parseSolAmount, } from './jito-stake-pool.js';
+// ---------------------------------------------------------------------------
+// Input schemas (Zod SSoT)
+// ---------------------------------------------------------------------------
+const JitoStakeInputSchema = z.object({
+    amount: z.string().min(1, 'amount is required (SOL, e.g. "1.0")'),
+});
+const JitoUnstakeInputSchema = z.object({
+    amount: z.string().min(1, 'amount is required (JitoSOL, e.g. "1.0")'),
+});
+// ---------------------------------------------------------------------------
+// Provider implementation
+// ---------------------------------------------------------------------------
+export class JitoStakingActionProvider {
+    metadata;
+    actions;
+    config;
+    constructor(config) {
+        this.config = { ...JITO_STAKING_DEFAULTS, ...config };
+        this.metadata = {
+            name: 'jito_staking',
+            description: 'Jito liquid staking protocol for SOL to JitoSOL conversion via SPL Stake Pool',
+            version: '1.0.0',
+            chains: ['solana'],
+            mcpExpose: true,
+            requiresApiKey: false,
+            requiredApis: [],
+        };
+        this.actions = [
+            {
+                name: 'stake',
+                description: 'Stake SOL to receive JitoSOL via Jito Stake Pool (DepositSol). Immediate, no lock-up.',
+                chain: 'solana',
+                inputSchema: JitoStakeInputSchema,
+                riskLevel: 'medium',
+                defaultTier: 'DELAY',
+            },
+            {
+                name: 'unstake',
+                description: 'Withdraw SOL from Jito Stake Pool by burning JitoSOL (WithdrawSol). Epoch boundary delay.',
+                chain: 'solana',
+                inputSchema: JitoUnstakeInputSchema,
+                riskLevel: 'medium',
+                defaultTier: 'DELAY',
+            },
+        ];
+    }
+    async resolve(actionName, params, context) {
+        if (actionName === 'stake') {
+            return this.resolveStake(params, context);
+        }
+        if (actionName === 'unstake') {
+            return this.resolveUnstake(params, context);
+        }
+        throw new ChainError('INVALID_INSTRUCTION', 'solana', {
+            message: `Unknown action: ${actionName}`,
+        });
+    }
+    // -------------------------------------------------------------------------
+    // Stake: SOL -> JitoSOL via DepositSol
+    // -------------------------------------------------------------------------
+    async resolveStake(params, context) {
+        const input = JitoStakeInputSchema.parse(params);
+        const amountLamports = await parseSolAmount(input.amount);
+        return buildDepositSolRequest(this.config, amountLamports, context.walletAddress);
+    }
+    // -------------------------------------------------------------------------
+    // Unstake: JitoSOL -> SOL via WithdrawSol
+    // -------------------------------------------------------------------------
+    async resolveUnstake(params, context) {
+        const input = JitoUnstakeInputSchema.parse(params);
+        const amountLamports = await parseSolAmount(input.amount);
+        return buildWithdrawSolRequest(this.config, amountLamports, context.walletAddress);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/jito-staking/index.js.map

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