@x402-api/elizaos-plugin 1.0.0

package/dist/actions/priceFeed.js

@@ -0,0 +1,75 @@
+import { x402ApiRequest } from '../client.js';
+export function createPriceFeedAction(config) {
+    return {
+        name: 'GET_CRYPTO_PRICES',
+        similes: [
+            'PRICE_FEED',
+            'GET_PRICES',
+            'CRYPTO_PRICES',
+            'TOKEN_PRICES',
+            'MARKET_PRICES',
+            'CHECK_PRICE',
+            'PRICE_CHECK',
+            'CURRENT_PRICES',
+            'MARKET_DATA',
+        ],
+        description: 'Fetch live crypto prices for BTC, ETH, SOL and top movers by 24h change. ' +
+            'Data sourced from CoinGecko. Costs $0.001 USDC via x402.',
+        validate: async (_runtime, _message, _state) => {
+            // Always valid — no required parameters
+            return true;
+        },
+        handler: async (_runtime, message, _state, _options, callback) => {
+            try {
+                const data = await x402ApiRequest('/api/price-feed', {}, config);
+                const { core, top_movers } = data.data;
+                // Format a readable summary
+                const coreLines = core
+                    .map(c => {
+                    const sign = (c.change_24h_pct ?? 0) >= 0 ? '📈' : '📉';
+                    const change = c.change_24h_pct != null ? `${sign} ${c.change_24h_pct > 0 ? '+' : ''}${c.change_24h_pct}%` : '';
+                    const price = c.price_usd != null ? `$${c.price_usd.toLocaleString()}` : 'N/A';
+                    return `• **${c.id.toUpperCase()}**: ${price} ${change}`;
+                })
+                    .join('\n');
+                const gainersLine = top_movers.gainers
+                    .slice(0, 3)
+                    .map(c => `${c.id.toUpperCase()} +${c.change_24h_pct}%`)
+                    .join(', ');
+                const losersLine = top_movers.losers
+                    .slice(0, 3)
+                    .map(c => `${c.id.toUpperCase()} ${c.change_24h_pct}%`)
+                    .join(', ');
+                const text = `## 💰 Crypto Prices\n\n${coreLines}\n\n` +
+                    `**Top Gainers (24h):** ${gainersLine}\n` +
+                    `**Top Losers (24h):** ${losersLine}\n\n` +
+                    `*Source: ${data.source} • Updated: ${data.timestamp}${data.cached ? ' (cached)' : ''}*`;
+                if (callback) {
+                    await callback({ text, source: message.content.source });
+                }
+                return { success: true, text, data: data.data };
+            }
+            catch (error) {
+                const errMsg = `Failed to fetch crypto prices: ${error.message}`;
+                if (callback)
+                    await callback({ text: errMsg });
+                return { success: false, text: errMsg };
+            }
+        },
+        examples: [
+            [
+                { name: '{{user}}', content: { text: 'What are the current crypto prices?' } },
+                { name: '{{agent}}', content: { text: '## 💰 Crypto Prices\n\n• **BITCOIN**: $98,000 📈 +2.1%\n• **ETHEREUM**: $2,750 📉 -0.8%\n• **SOLANA**: $185 📈 +4.2%\n\n**Top Gainers:** SUI +8.2%, SOL +4.2%, BTC +2.1%', actions: ['GET_CRYPTO_PRICES'] } },
+            ],
+            [
+                { name: '{{user}}', content: { text: 'Check the price feed' } },
+                { name: '{{agent}}', content: { text: 'Fetching live crypto prices...', actions: ['GET_CRYPTO_PRICES'] } },
+            ],
+            [
+                { name: '{{user}}', content: { text: 'How is the market doing?' } },
+                { name: '{{agent}}', content: { text: '## 💰 Crypto Prices\n\nFetching latest market data via x402...', actions: ['GET_CRYPTO_PRICES'] } },
+            ],
+        ],
+    };
+}
+//# sourceMappingURL=priceFeed.js.map

package/dist/actions/priceFeed.js.map

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

package/dist/actions/tokenScanner.d.ts

@@ -0,0 +1,4 @@
+import type { Action } from '@elizaos/core';
+import { type X402ClientConfig } from '../client.js';
+export declare function createTokenScannerAction(config: X402ClientConfig): Action;
+//# sourceMappingURL=tokenScanner.d.ts.map

package/dist/actions/tokenScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenScanner.d.ts","sourceRoot":"","sources":["../../src/actions/tokenScanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAA+E,MAAM,eAAe,CAAC;AACzH,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAKrE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAqGzE"}

package/dist/actions/tokenScanner.js

@@ -0,0 +1,83 @@
+import { x402ApiRequest } from '../client.js';
+const RISK_EMOJIS = { LOW: '🟢', MEDIUM: '🟡', HIGH: '🔴', CRITICAL: '💀' };
+export function createTokenScannerAction(config) {
+    return {
+        name: 'SCAN_TOKEN',
+        similes: [
+            'TOKEN_SCANNER',
+            'CHECK_TOKEN',
+            'TOKEN_SECURITY',
+            'TOKEN_AUDIT',
+            'RUG_CHECK',
+            'HONEYPOT_CHECK',
+            'TOKEN_SAFETY',
+            'ANALYZE_TOKEN',
+            'TOKEN_RISK',
+        ],
+        description: 'Scan a token for security risks: contract verification, mint function, proxy, liquidity lock, ' +
+            'honeypot detection, buy/sell tax, holder count, market cap. ' +
+            'Detects potential rug-pulls. Query with token symbol or address. Costs $0.003 USDC via x402.',
+        validate: async (_runtime, _message, _state) => {
+            return true;
+        },
+        handler: async (_runtime, message, _state, options, callback) => {
+            try {
+                const text = message.content.text || '';
+                // Extract token from message
+                const addressMatch = text.match(/0x[0-9a-fA-F]{40}/);
+                const symbolMatch = text.match(/\b([A-Z]{2,8})\b/);
+                const token = options?.token ||
+                    addressMatch?.[0] ||
+                    symbolMatch?.[1] ||
+                    'PEPE';
+                const chainMatch = text.match(/\b(ethereum|base|arbitrum|polygon)\b/i);
+                const chain = options?.chain || chainMatch?.[1]?.toLowerCase() || 'ethereum';
+                const data = await x402ApiRequest('/api/token-scanner', { token, chain }, config);
+                const t = data.data;
+                const riskEmoji = RISK_EMOJIS[t.risk_level];
+                const flags = t.risk_flags;
+                const flagLines = [
+                    `${flags.is_verified ? '✅' : '❌'} Contract verified`,
+                    `${!flags.has_proxy ? '✅' : '⚠️'} ${flags.has_proxy ? 'Has proxy (upgradeable)' : 'No proxy'}`,
+                    `${!flags.has_mint_function ? '✅' : '⚠️'} ${flags.has_mint_function ? 'Has mint function' : 'No mint function'}`,
+                    `${flags.liquidity_locked ? '✅' : '❌'} Liquidity ${flags.liquidity_locked ? 'locked' : 'NOT locked'}`,
+                    `${!flags.honeypot_risk ? '✅' : '💀'} ${flags.honeypot_risk ? 'HONEYPOT DETECTED' : 'No honeypot'}`,
+                    `${!flags.high_buy_tax ? '✅' : '⚠️'} Buy tax: ${t.buy_tax}%`,
+                    `${!flags.high_sell_tax ? '✅' : '⚠️'} Sell tax: ${t.sell_tax}%`,
+                ].join('\n');
+                const response = `## 🔍 Token Scanner: ${t.symbol} (${t.name})\n\n` +
+                    `${riskEmoji} **Risk: ${t.risk_level}** (score: ${t.risk_score}/100)\n\n` +
+                    `**Contract:** \`${t.address}\` on ${t.chain}\n` +
+                    `**Price:** $${t.price_usd} | **Market Cap:** $${t.market_cap_usd?.toLocaleString()}\n` +
+                    `**Liquidity:** $${t.liquidity_usd?.toLocaleString()} | **Holders:** ${t.holder_count?.toLocaleString()}\n` +
+                    `**Age:** ${t.age_days} days\n\n` +
+                    `### Security Checks\n${flagLines}`;
+                if (callback) {
+                    await callback({ text: response, source: message.content.source });
+                }
+                return { success: true, text: response, data: data.data };
+            }
+            catch (error) {
+                const errMsg = `Failed to scan token: ${error.message}`;
+                if (callback)
+                    await callback({ text: errMsg });
+                return { success: false, text: errMsg };
+            }
+        },
+        examples: [
+            [
+                { name: '{{user}}', content: { text: 'Is PEPE safe to buy? Check for rug' } },
+                { name: '{{agent}}', content: { text: '## 🔍 Token Scanner: PEPE\n\n🟢 **Risk: LOW** (score: 15/100)\n\n✅ Contract verified\n✅ No proxy\n✅ Liquidity locked\n✅ No honeypot', actions: ['SCAN_TOKEN'] } },
+            ],
+            [
+                { name: '{{user}}', content: { text: 'Scan this token: 0x6982508145454Ce325dDbE47a25d4ec3d2311933' } },
+                { name: '{{agent}}', content: { text: 'Scanning token security for 0x698...', actions: ['SCAN_TOKEN'] } },
+            ],
+            [
+                { name: '{{user}}', content: { text: 'Check if this is a honeypot' } },
+                { name: '{{agent}}', content: { text: 'Running security scan...', actions: ['SCAN_TOKEN'] } },
+            ],
+        ],
+    };
+}
+//# sourceMappingURL=tokenScanner.js.map

package/dist/actions/tokenScanner.js.map

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

package/dist/actions/walletProfiler.d.ts

@@ -0,0 +1,4 @@
+import type { Action } from '@elizaos/core';
+import { type X402ClientConfig } from '../client.js';
+export declare function createWalletProfilerAction(config: X402ClientConfig): Action;
+//# sourceMappingURL=walletProfiler.d.ts.map

package/dist/actions/walletProfiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walletProfiler.d.ts","sourceRoot":"","sources":["../../src/actions/walletProfiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAA+E,MAAM,eAAe,CAAC;AACzH,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAKrE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAgH3E"}

package/dist/actions/walletProfiler.js

@@ -0,0 +1,92 @@
+import { x402ApiRequest } from '../client.js';
+const RISK_EMOJIS = { conservative: '🟢', moderate: '🟡', aggressive: '🔴' };
+export function createWalletProfilerAction(config) {
+    return {
+        name: 'PROFILE_WALLET',
+        similes: [
+            'WALLET_PROFILER',
+            'WALLET_ANALYSIS',
+            'ANALYZE_WALLET',
+            'CHECK_WALLET',
+            'WALLET_PORTFOLIO',
+            'WALLET_HOLDINGS',
+            'ADDRESS_ANALYSIS',
+            'WALLET_INTEL',
+            'WALLET_INFO',
+        ],
+        description: 'Profile an Ethereum wallet: portfolio holdings, DeFi positions, activity metrics, ' +
+            'risk classification, and chain distribution. ' +
+            'Query with ?address=0x... Costs $0.008 USDC via x402.',
+        validate: async (_runtime, message, _state) => {
+            const text = message.content.text || '';
+            // Valid if there's a wallet address in the message, or we'll use a default
+            const hasAddress = /0x[0-9a-fA-F]{40}/.test(text);
+            const hasWalletKeywords = /wallet|address|portfolio|holdings|profile/i.test(text);
+            return hasAddress || hasWalletKeywords;
+        },
+        handler: async (_runtime, message, _state, options, callback) => {
+            try {
+                const text = message.content.text || '';
+                // Extract wallet address
+                const addressMatch = text.match(/0x[0-9a-fA-F]{40}/);
+                const address = options?.address ||
+                    addressMatch?.[0] ||
+                    '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'; // Vitalik default
+                const chainMatch = text.match(/\b(ethereum|base|arbitrum|polygon|all)\b/i);
+                const chain = options?.chain || chainMatch?.[1]?.toLowerCase() || 'all';
+                const data = await x402ApiRequest('/api/wallet-profiler', { address, chain }, config);
+                const w = data.data;
+                const riskEmoji = RISK_EMOJIS[w.risk_profile.classification];
+                // Format total value
+                const totalFormatted = w.total_value_usd >= 1e6
+                    ? `$${(w.total_value_usd / 1e6).toFixed(2)}M`
+                    : `$${w.total_value_usd.toLocaleString()}`;
+                // Top holdings
+                const holdingsLines = w.portfolio.top_holdings.slice(0, 5)
+                    .map(h => `  • ${h.token} (${h.chain}): $${h.value_usd.toLocaleString()} (${h.portfolio_pct}%)`)
+                    .join('\n');
+                // DeFi positions
+                const defiLines = w.defi_positions.length > 0
+                    ? w.defi_positions
+                        .map(p => `  • ${p.protocol} ${p.type}: ${p.asset} — $${p.value_usd.toLocaleString()} @ ${p.apy}% APY`)
+                        .join('\n')
+                    : '  No active DeFi positions';
+                const alloc = w.portfolio.allocation;
+                const activity = w.activity;
+                const response = `## 👛 Wallet Profile\n\n` +
+                    `**Address:** \`${w.address}\`${w.label ? ` (${w.label})` : ''}\n` +
+                    `**Type:** ${w.wallet_type} | **Chains:** ${w.chains_active.join(', ')}\n` +
+                    `**Total Value:** ${totalFormatted} | **DeFi:** $${w.defi_value_usd.toLocaleString()}\n\n` +
+                    `### Portfolio Allocation\n` +
+                    `  Native: ${alloc.native_tokens_pct}% | Stablecoins: ${alloc.stablecoins_pct}% | DeFi tokens: ${alloc.defi_tokens_pct}%\n\n` +
+                    `### Top Holdings\n${holdingsLines}\n\n` +
+                    `### DeFi Positions\n${defiLines}\n\n` +
+                    `### Activity\n` +
+                    `  ${activity.total_transactions.toLocaleString()} txns | ${activity.age_days} days old | Last active: ${new Date(activity.last_active).toLocaleDateString()}\n\n` +
+                    `### Risk Profile\n` +
+                    `  ${riskEmoji} **${w.risk_profile.classification.toUpperCase()}** | Diversification: ${w.risk_profile.diversification_score}/10 | DeFi exposure: ${w.risk_profile.defi_exposure_pct}%`;
+                if (callback) {
+                    await callback({ text: response, source: message.content.source });
+                }
+                return { success: true, text: response, data: data.data };
+            }
+            catch (error) {
+                const errMsg = `Failed to profile wallet: ${error.message}`;
+                if (callback)
+                    await callback({ text: errMsg });
+                return { success: false, text: errMsg };
+            }
+        },
+        examples: [
+            [
+                { name: '{{user}}', content: { text: 'Analyze wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045' } },
+                { name: '{{agent}}', content: { text: '## 👛 Wallet Profile\n\n**Address:** `0xd8dA...` (vitalik.eth)\n**Total Value:** $4.82M | **DeFi:** $820K', actions: ['PROFILE_WALLET'] } },
+            ],
+            [
+                { name: '{{user}}', content: { text: 'What\'s in this wallet? 0xBE0eB53F46cd790Cd13851d5EFf43D12404d33E8' } },
+                { name: '{{agent}}', content: { text: 'Profiling wallet 0xBE0e...', actions: ['PROFILE_WALLET'] } },
+            ],
+        ],
+    };
+}
+//# sourceMappingURL=walletProfiler.js.map

package/dist/actions/walletProfiler.js.map

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

package/dist/actions/whaleTracker.d.ts

@@ -0,0 +1,4 @@
+import type { Action } from '@elizaos/core';
+import { type X402ClientConfig } from '../client.js';
+export declare function createWhaleTrackerAction(config: X402ClientConfig): Action;
+//# sourceMappingURL=whaleTracker.d.ts.map

package/dist/actions/whaleTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whaleTracker.d.ts","sourceRoot":"","sources":["../../src/actions/whaleTracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAA+E,MAAM,eAAe,CAAC;AACzH,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA2FzE"}

package/dist/actions/whaleTracker.js

@@ -0,0 +1,71 @@
+import { x402ApiRequest } from '../client.js';
+export function createWhaleTrackerAction(config) {
+    return {
+        name: 'TRACK_WHALES',
+        similes: [
+            'WHALE_TRACKER',
+            'WHALE_ACTIVITY',
+            'CHECK_WHALES',
+            'TOP_HOLDERS',
+            'HOLDER_ANALYSIS',
+            'CONCENTRATION_ANALYSIS',
+            'WHALE_MOVEMENTS',
+            'LARGE_HOLDERS',
+        ],
+        description: 'Analyze whale concentration and top holder distribution for any token. ' +
+            'Returns top holders, Gini coefficient, distribution buckets, and recent large transfers. ' +
+            'Costs $0.005 USDC via x402.',
+        validate: async (_runtime, _message, _state) => {
+            return true;
+        },
+        handler: async (_runtime, message, _state, options, callback) => {
+            try {
+                const text = message.content.text || '';
+                const symbolMatch = text.match(/\b(BTC|ETH|SOL|PEPE|SHIB|DOGE|LINK|UNI|AAVE|ARB|OP|SUI|AVAX)\b/i);
+                const chainMatch = text.match(/\b(ethereum|base|solana|arbitrum|optimism)\b/i);
+                const token = options?.token || symbolMatch?.[1]?.toUpperCase() || 'ETH';
+                const chain = options?.chain || chainMatch?.[1]?.toLowerCase() || 'ethereum';
+                const data = await x402ApiRequest('/api/whale-tracker', { token, chain }, config);
+                const w = data.data;
+                const cm = w.concentration_metrics;
+                // Concentration health indicator
+                const giniRisk = cm.gini_coefficient > 0.8 ? '🔴 Very concentrated'
+                    : cm.gini_coefficient > 0.65 ? '🟡 Moderately concentrated'
+                        : '🟢 Well distributed';
+                const topHolderLines = w.top_holders.slice(0, 5)
+                    .map(h => `  ${h.rank}. ${h.label} (${h.wallet_type}): **${h.percentage}%**`)
+                    .join('\n');
+                const recentTx = w.recent_large_transfers
+                    .map(tx => `  • $${tx.usd_value.toLocaleString()} ${tx.transfer_type} — ${new Date(tx.timestamp).toLocaleDateString()}`)
+                    .join('\n');
+                const response = `## 🐋 Whale Tracker: ${w.token} on ${w.chain}\n\n` +
+                    `**Distribution:** ${giniRisk}\n` +
+                    `**Gini coefficient:** ${cm.gini_coefficient} | **Top 10 hold:** ${cm.top_10_pct}%\n` +
+                    `**Total holders:** ${w.holder_count?.toLocaleString()}\n\n` +
+                    `### Top 5 Holders\n${topHolderLines}\n\n` +
+                    `### Recent Large Transfers\n${recentTx || '  No recent large transfers'}`;
+                if (callback) {
+                    await callback({ text: response, source: message.content.source });
+                }
+                return { success: true, text: response, data: data.data };
+            }
+            catch (error) {
+                const errMsg = `Failed to track whales: ${error.message}`;
+                if (callback)
+                    await callback({ text: errMsg });
+                return { success: false, text: errMsg };
+            }
+        },
+        examples: [
+            [
+                { name: '{{user}}', content: { text: 'Are whales accumulating ETH?' } },
+                { name: '{{agent}}', content: { text: '## 🐋 Whale Tracker: ETH\n\nTop 10 holders own 42% of supply. Gini: 0.72\n\nRecent large transfers detected...', actions: ['TRACK_WHALES'] } },
+            ],
+            [
+                { name: '{{user}}', content: { text: 'Show me whale activity for PEPE' } },
+                { name: '{{agent}}', content: { text: 'Fetching PEPE whale distribution and recent transfers...', actions: ['TRACK_WHALES'] } },
+            ],
+        ],
+    };
+}
+//# sourceMappingURL=whaleTracker.js.map

package/dist/actions/whaleTracker.js.map

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

package/dist/actions/yieldScanner.d.ts

@@ -0,0 +1,4 @@
+import type { Action } from '@elizaos/core';
+import { type X402ClientConfig } from '../client.js';
+export declare function createYieldScannerAction(config: X402ClientConfig): Action;
+//# sourceMappingURL=yieldScanner.d.ts.map

package/dist/actions/yieldScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yieldScanner.d.ts","sourceRoot":"","sources":["../../src/actions/yieldScanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAA+E,MAAM,eAAe,CAAC;AACzH,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAcrE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAsGzE"}

package/dist/actions/yieldScanner.js

@@ -0,0 +1,93 @@
+import { x402ApiRequest } from '../client.js';
+const RISK_EMOJIS = { low: '🟢', medium: '🟡', high: '🔴' };
+export function createYieldScannerAction(config) {
+    return {
+        name: 'SCAN_YIELDS',
+        similes: [
+            'YIELD_SCANNER',
+            'FIND_YIELDS',
+            'BEST_APY',
+            'DEFI_YIELDS',
+            'YIELD_OPPORTUNITIES',
+            'HIGH_YIELD',
+            'STAKING_RATES',
+            'LENDING_RATES',
+            'PASSIVE_INCOME',
+            'DEFI_APY',
+        ],
+        description: 'Find the best DeFi yield opportunities across Aave, Compound, Morpho, Lido, Pendle, Ethena, ' +
+            'Yearn, Convex, and more. Filter by chain, asset, TVL, and risk tier. ' +
+            'Costs $0.005 USDC via x402.',
+        validate: async (_runtime, _message, _state) => {
+            return true;
+        },
+        handler: async (_runtime, message, _state, options, callback) => {
+            try {
+                const text = message.content.text || '';
+                const chainMatch = text.match(/\b(ethereum|base|arbitrum|polygon|all)\b/i);
+                const assetMatch = text.match(/\b(ETH|USDC|USDT|DAI|stETH|rETH|sUSDe|sDAI|WBTC)\b/i);
+                const minTvlMatch = text.match(/(?:min\s+tvl|tvl\s+above|minimum\s+tvl)[:\s]+\$?([\d,kmb]+)/i);
+                const chain = options?.chain || chainMatch?.[1]?.toLowerCase() || 'all';
+                const asset = options?.asset || assetMatch?.[1]?.toUpperCase();
+                const limit = options?.limit || 10;
+                // Parse min_tvl (supports "1m", "500k", etc.)
+                let minTvl = options?.min_tvl || 0;
+                if (minTvlMatch) {
+                    const tvlStr = minTvlMatch[1].toLowerCase().replace(',', '');
+                    if (tvlStr.endsWith('b'))
+                        minTvl = parseFloat(tvlStr) * 1e9;
+                    else if (tvlStr.endsWith('m'))
+                        minTvl = parseFloat(tvlStr) * 1e6;
+                    else if (tvlStr.endsWith('k'))
+                        minTvl = parseFloat(tvlStr) * 1e3;
+                    else
+                        minTvl = parseFloat(tvlStr);
+                }
+                const params = { chain, limit };
+                if (asset)
+                    params.asset = asset;
+                if (minTvl > 0)
+                    params.min_tvl = minTvl;
+                const data = await x402ApiRequest('/api/yield-scanner', params, config);
+                const pools = data.data.slice(0, limit);
+                const poolLines = pools
+                    .map((p, i) => {
+                    const riskEmoji = RISK_EMOJIS[p.risk_tier];
+                    const tvlFormatted = p.tvl >= 1e9 ? `$${(p.tvl / 1e9).toFixed(1)}B`
+                        : p.tvl >= 1e6 ? `$${(p.tvl / 1e6).toFixed(0)}M`
+                            : `$${(p.tvl / 1e3).toFixed(0)}K`;
+                    return `${i + 1}. ${riskEmoji} **${p.protocol}** — ${p.asset} on ${p.chain}: **${p.apy}% APY** (TVL: ${tvlFormatted}, ${p.type})`;
+                })
+                    .join('\n');
+                const response = `## 🌾 Yield Scanner${asset ? ` — ${asset}` : ''}${chain !== 'all' ? ` on ${chain}` : ''}\n\n` +
+                    `${poolLines}\n\n` +
+                    `*🟢 low risk  🟡 medium  🔴 high | ${data.total_results} results • ${data.timestamp}*`;
+                if (callback) {
+                    await callback({ text: response, source: message.content.source });
+                }
+                return { success: true, text: response, data: data.data };
+            }
+            catch (error) {
+                const errMsg = `Failed to scan yields: ${error.message}`;
+                if (callback)
+                    await callback({ text: errMsg });
+                return { success: false, text: errMsg };
+            }
+        },
+        examples: [
+            [
+                { name: '{{user}}', content: { text: 'What are the best DeFi yields right now?' } },
+                { name: '{{agent}}', content: { text: '## 🌾 Yield Scanner\n\n1. 🔴 Camelot — GRAIL/ETH on arbitrum: 28.3% APY\n2. 🔴 Aerodrome — USDC/ETH on base: 22.1% APY\n3. 🔴 Ethena — sUSDe on ethereum: 18.5% APY', actions: ['SCAN_YIELDS'] } },
+            ],
+            [
+                { name: '{{user}}', content: { text: 'Find safe USDC yields on Base' } },
+                { name: '{{agent}}', content: { text: 'Scanning USDC yield opportunities on Base...', actions: ['SCAN_YIELDS'] } },
+            ],
+            [
+                { name: '{{user}}', content: { text: 'Best staking rates for ETH?' } },
+                { name: '{{agent}}', content: { text: 'Finding ETH yield opportunities across all chains...', actions: ['SCAN_YIELDS'] } },
+            ],
+        ],
+    };
+}
+//# sourceMappingURL=yieldScanner.js.map

package/dist/actions/yieldScanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yieldScanner.js","sourceRoot":"","sources":["../../src/actions/yieldScanner.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAyB,MAAM,cAAc,CAAC;AAYrE,MAAM,WAAW,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAW,CAAC;AAErE,MAAM,UAAU,wBAAwB,CAAC,MAAwB;IAC/D,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE;YACP,eAAe;YACf,aAAa;YACb,UAAU;YACV,aAAa;YACb,qBAAqB;YACrB,YAAY;YACZ,eAAe;YACf,eAAe;YACf,gBAAgB;YAChB,UAAU;SACX;QACD,WAAW,EACT,8FAA8F;YAC9F,uEAAuE;YACvE,6BAA6B;QAE/B,QAAQ,EAAE,KAAK,EAAE,QAAuB,EAAE,QAAgB,EAAE,MAAc,EAAE,EAAE;YAC5E,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,EAAE,KAAK,EACZ,QAAuB,EACvB,OAAe,EACf,MAAc,EACd,OAAwB,EACxB,QAA0B,EAC1B,EAAE;YACF,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;gBAExC,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;gBAC3E,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAC;gBACrF,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;gBAE/F,MAAM,KAAK,GAAK,OAA8C,EAAE,KAAgB,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,KAAK,CAAC;gBAC5H,MAAM,KAAK,GAAK,OAA8C,EAAE,KAAgB,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;gBACnH,MAAM,KAAK,GAAK,OAA8C,EAAE,KAAgB,IAAI,EAAE,CAAC;gBAEvF,8CAA8C;gBAC9C,IAAI,MAAM,GAAK,OAA8C,EAAE,OAAkB,IAAI,CAAC,CAAC;gBACvF,IAAI,WAAW,EAAE,CAAC;oBAChB,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;oBAC7D,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;wBAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC;yBACvD,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;wBAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC;yBAC5D,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;wBAAE,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC;;wBAC5D,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;gBACnC,CAAC;gBAED,MAAM,MAAM,GAAgD,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;gBAC7E,IAAI,KAAK;oBAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;gBAChC,IAAI,MAAM,GAAG,CAAC;oBAAE,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC;gBAExC,MAAM,IAAI,GAAG,MAAM,cAAc,CAAuB,oBAAoB,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;gBAE9F,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;gBAExC,MAAM,SAAS,GAAG,KAAK;qBACpB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;oBACZ,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;oBAC3C,MAAM,YAAY,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;wBACjE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;4BAChD,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;oBACpC,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,MAAM,CAAC,CAAC,QAAQ,QAAQ,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,GAAG,iBAAiB,YAAY,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC;gBACpI,CAAC,CAAC;qBACD,IAAI,CAAC,IAAI,CAAC,CAAC;gBAEd,MAAM,QAAQ,GACZ,sBAAsB,KAAK,CAAC,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM;oBAC9F,GAAG,SAAS,MAAM;oBAClB,sCAAsC,IAAI,CAAC,aAAa,cAAc,IAAI,CAAC,SAAS,GAAG,CAAC;gBAE1F,IAAI,QAAQ,EAAE,CAAC;oBACb,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;gBACrE,CAAC;gBAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,IAA0C,EAAE,CAAC;YAClG,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,MAAM,GAAG,0BAA2B,KAAe,CAAC,OAAO,EAAE,CAAC;gBACpE,IAAI,QAAQ;oBAAE,MAAM,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC/C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,QAAQ,EAAE;YACR;gBACE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,0CAA0C,EAAE,EAAE;gBACnF,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,qKAAqK,EAAE,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE;aAC1O;YACD;gBACE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,+BAA+B,EAAE,EAAE;gBACxE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,8CAA8C,EAAE,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE;aACnH;YACD;gBACE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,6BAA6B,EAAE,EAAE;gBACtE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,sDAAsD,EAAE,OAAO,EAAE,CAAC,aAAa,CAAC,EAAE,EAAE;aAC3H;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,66 @@
+/**
+ * x402 API Client
+ *
+ * Handles HTTP requests to the x402 DeFi API with x402 payment support.
+ *
+ * ## Payment Flow
+ *
+ * The x402 API uses the HTTP 402 Payment Required protocol:
+ * 1. Agent makes a request
+ * 2. Server returns 402 with payment details (amount, token, payTo address)
+ * 3. Agent pays via USDC on Base
+ * 4. Agent retries with payment proof header (X-PAYMENT)
+ * 5. Server validates payment and returns data
+ *
+ * ## Setup Options
+ *
+ * ### Option A: x402-fetch (Recommended for autonomous agents)
+ * Install x402-fetch and configure your wallet private key.
+ * The client will auto-handle the 402 flow transparently.
+ *
+ * ### Option B: Pre-authorized fetch
+ * If you have a pre-authorized session token from the x402 facilitator.
+ *
+ * ### Option C: Manual (for testing)
+ * Just make the request — you'll get the 402 details to handle manually.
+ */
+export declare const X402_API_BASE_URL = "https://x402-api.fly.dev";
+export interface X402ClientConfig {
+    /**
+     * Base URL for the x402 API.
+     * @default 'https://x402-api.fly.dev'
+     */
+    baseUrl?: string;
+    /**
+     * Wallet private key for automatic x402 payment handling.
+     * Required for autonomous payment. Keep this in your .env file!
+     * Used with x402-fetch to auto-pay 402 responses.
+     */
+    walletPrivateKey?: string;
+    /**
+     * Your wallet address (for display/logging purposes).
+     */
+    walletAddress?: string;
+    /**
+     * Request timeout in milliseconds.
+     * @default 30000
+     */
+    timeoutMs?: number;
+}
+export type FetchWithX402 = (url: string | URL, init?: RequestInit) => Promise<Response>;
+/**
+ * Make a request to the x402 API.
+ *
+ * @param endpoint - API endpoint path (e.g. '/api/price-feed')
+ * @param params - Query parameters
+ * @param config - Client configuration
+ * @returns Parsed JSON response
+ * @throws Error with helpful message on 402 (payment required) or other errors
+ */
+export declare function x402ApiRequest<T>(endpoint: string, params: Record<string, string | number | undefined>, config?: X402ClientConfig): Promise<T>;
+/**
+ * Extract key information from a message for API parameters.
+ * Parses natural language to extract token symbols, addresses, chains, etc.
+ */
+export declare function extractParams(text: string): Record<string, string>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,eAAO,MAAM,iBAAiB,6BAA6B,CAAC;AAE5D,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAqDzF;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,EACnD,MAAM,GAAE,gBAAqB,GAC5B,OAAO,CAAC,CAAC,CAAC,CAuDZ;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwBlE"}