@x402-api/elizaos-plugin 1.0.0

package/README.md

@@ -0,0 +1,346 @@
+# @x402-api/elizaos-plugin
+
+> ElizaOS plugin for **pay-per-call DeFi intelligence** — powered by [x402](https://x402.org) micropayments (USDC on Base)
+
+Give your ElizaOS agent real-time access to 8 DeFi data endpoints for as little as **$0.001 per query**. No API keys, no subscriptions — just pay per call in USDC.
+
+## Endpoints
+
+| Action | Endpoint | Cost |
+|--------|----------|------|
+| `GET_CRYPTO_PRICES` | `/api/price-feed` | $0.001 |
+| `GET_GAS_PRICES` | `/api/gas-tracker` | $0.001 |
+| `GET_DEX_QUOTES` | `/api/dex-quotes` | $0.002 |
+| `SCAN_TOKEN` | `/api/token-scanner` | $0.003 |
+| `TRACK_WHALES` | `/api/whale-tracker` | $0.005 |
+| `SCAN_YIELDS` | `/api/yield-scanner` | $0.005 |
+| `GET_FUNDING_RATES` | `/api/funding-rates` | $0.008 |
+| `PROFILE_WALLET` | `/api/wallet-profiler` | $0.008 |
+
+**API Base URL:** `https://x402-api.fly.dev`
+
+---
+
+## Installation
+
+```bash
+npm install @x402-api/elizaos-plugin
+# or
+bun add @x402-api/elizaos-plugin
+```
+
+### For automatic payments (required for production)
+
+```bash
+npm install x402-fetch viem
+```
+
+---
+
+## Quick Start
+
+### 1. Add to your character file
+
+```typescript
+// src/character.ts
+import { x402DeFiPlugin } from '@x402-api/elizaos-plugin';
+
+export const character: Character = {
+  name: 'DeFi Agent',
+  plugins: [
+    '@elizaos/plugin-bootstrap',
+    '@elizaos/plugin-sql',
+    x402DeFiPlugin,  // ← add this
+  ],
+};
+```
+
+### 2. Configure your wallet
+
+The plugin needs a wallet with USDC on Base to pay for API calls.
+
+```bash
+# .env
+X402_WALLET_PRIVATE_KEY=0xYOUR_PRIVATE_KEY_HERE
+```
+
+> **⚠️ Security:** Never commit your private key. Use `.env` files and add them to `.gitignore`.
+
+### 3. Fund your wallet
+
+Your wallet needs USDC on Base. Get some from:
+- [Coinbase](https://coinbase.com) → withdraw USDC to Base
+- [Uniswap on Base](https://app.uniswap.org) → swap ETH for USDC
+- [bridge.base.org](https://bridge.base.org) → bridge from Ethereum
+
+Costs are tiny — $1 of USDC covers **125–1000 queries** depending on the endpoint.
+
+---
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `X402_WALLET_PRIVATE_KEY` | Your wallet's private key (hex) | — |
+| `X402_WALLET_ADDRESS` | Your wallet address (for logging) | — |
+| `X402_API_BASE_URL` | API base URL override | `https://x402-api.fly.dev` |
+
+### Programmatic Config
+
+```typescript
+import { createX402Plugin } from '@x402-api/elizaos-plugin';
+
+const plugin = createX402Plugin({
+  walletPrivateKey: process.env.MY_KEY,
+  baseUrl: 'https://x402-api.fly.dev',  // or your own instance
+  timeoutMs: 15000,
+});
+
+export const character: Character = {
+  plugins: [plugin],
+};
+```
+
+---
+
+## What Each Action Does
+
+### 💰 GET_CRYPTO_PRICES
+Fetches live prices for BTC, ETH, SOL + top 5 gainers/losers by 24h change. Data from CoinGecko.
+
+**Triggers when you say:**
+- "What are the current crypto prices?"
+- "How is the market doing?"
+- "Price feed"
+
+---
+
+### ⛽ GET_GAS_PRICES
+Current gas prices across Ethereum, Base, Polygon, and Arbitrum. Returns slow/normal/fast tiers with USD cost estimates for transfers, swaps, and NFT mints.
+
+**Triggers when you say:**
+- "What are the gas fees right now?"
+- "How much does an ETH swap cost?"
+- "Check gas prices on Arbitrum"
+
+---
+
+### 🔄 GET_DEX_QUOTES
+Compare swap quotes across Uniswap V3, SushiSwap, and 1inch for any token pair. Shows price impact, fees, gas costs, and best route.
+
+**Triggers when you say:**
+- "What's the best rate to swap 1 ETH for USDC?"
+- "Compare DEX quotes for BTC/USDC on Base"
+- "How much USDT do I get for 500 USDC?"
+
+**Params extracted from message:** from/to tokens, amount, chain
+
+---
+
+### 🔍 SCAN_TOKEN
+Security scan for any ERC-20 token. Checks: contract verification, proxy/upgradeable, mint function, liquidity lock, honeypot detection, buy/sell tax, holder count, risk score.
+
+**Triggers when you say:**
+- "Is PEPE safe? Check for rug"
+- "Scan this token: 0x6982..."
+- "Is this a honeypot?"
+
+**Params:** token symbol or address, chain
+
+---
+
+### 🐋 TRACK_WHALES
+Top holder distribution analysis. Returns concentration metrics (Gini coefficient, Herfindahl index), distribution buckets, top 20 holders with labels, and recent large transfers.
+
+**Triggers when you say:**
+- "Are whales accumulating ETH?"
+- "Show whale activity for PEPE"
+- "Who are the top holders of SOL?"
+
+---
+
+### 🌾 SCAN_YIELDS
+Find the best DeFi yield opportunities across 10+ protocols: Aave, Compound, Morpho, Lido, Rocket Pool, Pendle, Ethena, Maker DSR, Convex, Yearn, Aerodrome, and more. Filter by chain, asset, TVL, and risk tier.
+
+**Triggers when you say:**
+- "What are the best DeFi yields right now?"
+- "Find safe USDC yields on Base"
+- "Best ETH staking rates?"
+
+---
+
+### 📊 GET_FUNDING_RATES
+Perpetual futures funding rates across Hyperliquid, dYdX v4, Aevo, GMX, Drift, and Vertex. Automatically identifies arbitrage opportunities (long on lowest-rate venue, short on highest).
+
+**Triggers when you say:**
+- "What are the current perp funding rates?"
+- "Is there a funding rate arb for ETH?"
+- "Compare funding rates across venues"
+
+---
+
+### 👛 PROFILE_WALLET
+Full wallet analysis: portfolio breakdown, DeFi positions, activity metrics, risk classification. Supports ENS and known wallet labels.
+
+**Triggers when you say:**
+- "Analyze wallet 0xd8dA..."
+- "What's in vitalik's wallet?"
+- "Profile this address: 0x..."
+
+---
+
+## How x402 Payments Work
+
+The [x402 protocol](https://x402.org) is a standard for HTTP micropayments:
+
+```
+1. Agent → GET /api/price-feed
+2. Server → 402 Payment Required + payment details
+3. x402-fetch → sign & broadcast USDC transfer on Base
+4. Agent → GET /api/price-feed + X-PAYMENT header
+5. Server → validate payment → 200 OK + data
+```
+
+This happens **automatically** when you install `x402-fetch` and provide a wallet key. From your agent's perspective, it's just a normal API call.
+
+### Without x402-fetch
+
+If `x402-fetch` is not installed, the plugin will:
+1. Make the request
+2. Receive a 402 response
+3. Throw a helpful error explaining how to configure payment
+
+This is useful for **testing** the plugin structure without spending USDC.
+
+---
+
+## TypeScript Types
+
+All API response types are exported:
+
+```typescript
+import type {
+  PriceFeedResponse,
+  GasTrackerResponse,
+  DexQuotesData,
+  TokenScanData,
+  WhaleTrackerData,
+  YieldPool,
+  ArbOpportunity,
+  WalletProfileData,
+} from '@x402-api/elizaos-plugin';
+```
+
+---
+
+## Advanced: Custom Action Composition
+
+Use only the actions you need:
+
+```typescript
+import {
+  createPriceFeedAction,
+  createTokenScannerAction,
+  type X402ClientConfig,
+} from '@x402-api/elizaos-plugin';
+import type { Plugin } from '@elizaos/core';
+
+const config: X402ClientConfig = {
+  baseUrl: 'https://x402-api.fly.dev',
+  walletPrivateKey: process.env.X402_WALLET_PRIVATE_KEY,
+};
+
+const myPlugin: Plugin = {
+  name: 'my-defi-plugin',
+  description: 'Selected DeFi actions',
+  actions: [
+    createPriceFeedAction(config),
+    createTokenScannerAction(config),
+  ],
+};
+```
+
+---
+
+## Running Your Own API Instance
+
+The API server is open source. Deploy your own:
+
+```bash
+git clone https://github.com/sugi/x402-api-server
+cd x402-api-server
+fly deploy
+```
+
+Then point the plugin at your instance:
+
+```bash
+X402_API_BASE_URL=https://your-api.fly.dev
+```
+
+---
+
+## Development & Testing
+
+```bash
+# Install deps
+npm install
+
+# Build TypeScript
+npm run build
+
+# Watch mode
+npm run dev
+```
+
+### Testing without real payments
+
+Set a dummy private key to test plugin loading (calls will fail at payment step):
+
+```bash
+X402_WALLET_PRIVATE_KEY=0x0000000000000000000000000000000000000000000000000000000000000001
+```
+
+Or mock `x402-fetch` in your tests.
+
+---
+
+## Publishing to npm
+
+```bash
+npm run build
+npm publish --access public
+```
+
+Or with Bun:
+
+```bash
+bun run build
+bun publish
+```
+
+---
+
+## Compatibility
+
+| ElizaOS Version | Plugin Version | Notes |
+|----------------|----------------|-------|
+| `>=1.0.0` | `1.x` | Full support |
+| `0.x` | Not supported | Use the raw API client instead |
+
+---
+
+## License
+
+MIT © Sugi
+
+---
+
+## Links
+
+- **API Server:** https://x402-api.fly.dev
+- **x402 Protocol:** https://x402.org
+- **ElizaOS Docs:** https://docs.elizaos.ai
+- **Source Code:** https://github.com/sugi/x402-api-server

package/dist/actions/dexQuotes.d.ts

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

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

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

package/dist/actions/dexQuotes.js

@@ -0,0 +1,80 @@
+import { x402ApiRequest } from '../client.js';
+export function createDexQuotesAction(config) {
+    return {
+        name: 'GET_DEX_QUOTES',
+        similes: [
+            'DEX_QUOTES',
+            'SWAP_QUOTES',
+            'GET_SWAP_RATE',
+            'COMPARE_DEXS',
+            'UNISWAP_QUOTE',
+            'SWAP_PRICE',
+            'BEST_SWAP',
+            'TOKEN_SWAP_QUOTE',
+            'DEX_COMPARISON',
+        ],
+        description: 'Get DEX swap quotes for any token pair across Uniswap V3, SushiSwap, and 1inch. ' +
+            'Compares rates, price impact, fees, and gas costs. ' +
+            'Query with from/to tokens, amount, and chain. Costs $0.002 USDC via x402.',
+        validate: async (_runtime, _message, _state) => {
+            return true;
+        },
+        handler: async (_runtime, message, _state, options, callback) => {
+            try {
+                const text = message.content.text || '';
+                // Extract swap parameters from message
+                // Patterns: "swap 1 ETH to USDC", "ETH/USDC quote", "0.5 BTC for USDT on base"
+                const fromMatch = text.match(/\b(from|swap|sell|exchange)\s+[\d.]+\s+([A-Z]{2,6})/i) ||
+                    text.match(/\b([\d.]+)\s+([A-Z]{2,6})\s+(?:to|for|→)/i);
+                const toMatch = text.match(/\b(?:to|for|into)\s+([A-Z]{2,6})\b/i);
+                const amountMatch = text.match(/\b([\d.]+(?:\.\d+)?)\b/);
+                const chainMatch = text.match(/\b(ethereum|base|arbitrum|polygon)\b/i);
+                const from = options?.from || fromMatch?.[2]?.toUpperCase() || 'ETH';
+                const to = options?.to || toMatch?.[1]?.toUpperCase() || 'USDC';
+                const amount = options?.amount || parseFloat(amountMatch?.[1] || '1') || 1;
+                const chain = options?.chain || chainMatch?.[1]?.toLowerCase() || 'ethereum';
+                const data = await x402ApiRequest('/api/dex-quotes', { from, to, amount: amount.toString(), chain }, config);
+                const q = data.data;
+                const best = q.quotes[0];
+                const quoteLines = q.quotes
+                    .map((quote, i) => {
+                    const medal = i === 0 ? '🥇' : i === 1 ? '🥈' : '🥉';
+                    return (`${medal} **${quote.dex_name}**: ${quote.output_amount} ${to} ` +
+                        `(impact: ${quote.price_impact_pct}%, gas: $${quote.estimated_gas_usd})`);
+                })
+                    .join('\n');
+                const response = `## 🔄 DEX Quotes: ${amount} ${from} → ${to} on ${chain}\n\n` +
+                    `${quoteLines}\n\n` +
+                    `**Best:** ${q.recommendation.dex} — ${q.recommendation.reason}\n` +
+                    `**Output:** ${best.output_amount} ${to} ($${(best.output_amount * (q.input_value_usd / amount)).toFixed(2)})\n` +
+                    `**Total cost:** $${q.recommendation.total_cost_usd} (fees + gas)\n\n` +
+                    `*Quotes valid for ${best.expires_in_seconds}s • ${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 get DEX quotes: ${error.message}`;
+                if (callback)
+                    await callback({ text: errMsg });
+                return { success: false, text: errMsg };
+            }
+        },
+        examples: [
+            [
+                { name: '{{user}}', content: { text: 'What\'s the best rate to swap 1 ETH to USDC?' } },
+                { name: '{{agent}}', content: { text: '## 🔄 DEX Quotes: 1 ETH → USDC on ethereum\n\n🥇 1inch Aggregator: 2749.5 USDC\n🥈 Uniswap V3: 2747.2 USDC\n🥉 SushiSwap: 2744.8 USDC', actions: ['GET_DEX_QUOTES'] } },
+            ],
+            [
+                { name: '{{user}}', content: { text: 'Compare DEX rates for ETH/USDC on Base' } },
+                { name: '{{agent}}', content: { text: 'Getting swap quotes across Uniswap, SushiSwap, and 1inch on Base...', actions: ['GET_DEX_QUOTES'] } },
+            ],
+            [
+                { name: '{{user}}', content: { text: 'How much USDC do I get for 0.5 BTC?' } },
+                { name: '{{agent}}', content: { text: 'Fetching DEX quotes for 0.5 BTC → USDC...', actions: ['GET_DEX_QUOTES'] } },
+            ],
+        ],
+    };
+}
+//# sourceMappingURL=dexQuotes.js.map

package/dist/actions/dexQuotes.js.map

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

package/dist/actions/fundingRates.d.ts

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

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

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

package/dist/actions/fundingRates.js

@@ -0,0 +1,85 @@
+import { x402ApiRequest } from '../client.js';
+const SIGNAL_EMOJIS = { STRONG: '🚀', MODERATE: '📈', WEAK: '💤' };
+export function createFundingRatesAction(config) {
+    return {
+        name: 'GET_FUNDING_RATES',
+        similes: [
+            'FUNDING_RATES',
+            'PERP_FUNDING',
+            'PERPETUAL_RATES',
+            'FUNDING_ARBITRAGE',
+            'PERP_RATES',
+            'FUNDING_ANALYSIS',
+            'HYPERLIQUID_FUNDING',
+            'DYDX_FUNDING',
+        ],
+        description: 'Get perpetual futures funding rates across Hyperliquid, dYdX v4, Aevo, GMX, Drift, and Vertex. ' +
+            'Identifies funding rate arbitrage opportunities (long/short spread capture). ' +
+            'Costs $0.008 USDC via x402.',
+        validate: async (_runtime, _message, _state) => {
+            return true;
+        },
+        handler: async (_runtime, message, _state, options, callback) => {
+            try {
+                const text = message.content.text || '';
+                // Extract asset and min spread from message
+                const assetMatch = text.match(/\b(BTC|ETH|SOL|SUI|AVAX|ARB|OP|DOGE|LINK|UNI)\b/i);
+                const spreadMatch = text.match(/(?:spread|bps|basis points)[:\s]+(\d+)/i);
+                const asset = options?.asset || assetMatch?.[1]?.toUpperCase();
+                const minSpread = options?.min_spread || (spreadMatch ? parseInt(spreadMatch[1]) : 0);
+                const params = {};
+                if (asset)
+                    params.asset = asset;
+                if (minSpread > 0)
+                    params.min_spread = minSpread;
+                const data = await x402ApiRequest('/api/funding-rates', params, config);
+                // Show top arb opportunities
+                const arbs = data.arb_opportunities.slice(0, 5);
+                const arbLines = arbs.length > 0
+                    ? arbs.map(arb => {
+                        const signal = SIGNAL_EMOJIS[arb.signal];
+                        return (`${signal} **${arb.asset}**: ${arb.spread_bps} bps spread — ` +
+                            `Long ${arb.long_venue}, Short ${arb.short_venue} → **${arb.annualized_arb_pct}% APR**`);
+                    }).join('\n')
+                    : '  No significant arb opportunities found';
+                // Show rates for specific asset if requested
+                let assetSection = '';
+                if (asset && data.data[asset]) {
+                    const rates = Object.entries(data.data[asset])
+                        .sort((a, b) => a[1].funding_rate - b[1].funding_rate)
+                        .map(([protocol, r]) => {
+                        const sign = r.funding_rate >= 0 ? '+' : '';
+                        return `  • ${protocol}: ${sign}${(r.funding_rate * 100).toFixed(4)}% (${sign}${r.annualized_pct}% APR)`;
+                    })
+                        .join('\n');
+                    assetSection = `\n\n### ${asset} Funding Rates\n${rates}`;
+                }
+                const response = `## 📊 Funding Rates — ${asset || 'All Assets'}\n\n` +
+                    `### Top Arbitrage Opportunities\n${arbLines}` +
+                    assetSection +
+                    `\n\n*Funding interval: ${data.funding_interval_hours}h | Protocols: ${data.protocols.join(', ')} | ${data.timestamp}*`;
+                if (callback) {
+                    await callback({ text: response, source: message.content.source });
+                }
+                return { success: true, text: response, data: { rates: data.data, arb: data.arb_opportunities } };
+            }
+            catch (error) {
+                const errMsg = `Failed to get funding rates: ${error.message}`;
+                if (callback)
+                    await callback({ text: errMsg });
+                return { success: false, text: errMsg };
+            }
+        },
+        examples: [
+            [
+                { name: '{{user}}', content: { text: 'What are the current perp funding rates?' } },
+                { name: '{{agent}}', content: { text: '## 📊 Funding Rates\n\n### Top Arb Opportunities\n🚀 BTC: 12 bps spread — Long dYdX, Short Drift → 24.5% APR\n📈 ETH: 8 bps — Long GMX, Short Aevo → 14.2% APR', actions: ['GET_FUNDING_RATES'] } },
+            ],
+            [
+                { name: '{{user}}', content: { text: 'Is there a funding rate arb for ETH?' } },
+                { name: '{{agent}}', content: { text: 'Checking ETH funding rates across all perp venues...', actions: ['GET_FUNDING_RATES'] } },
+            ],
+        ],
+    };
+}
+//# sourceMappingURL=fundingRates.js.map

package/dist/actions/fundingRates.js.map

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

package/dist/actions/gasTracker.d.ts

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

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

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

package/dist/actions/gasTracker.js

@@ -0,0 +1,60 @@
+import { x402ApiRequest } from '../client.js';
+export function createGasTrackerAction(config) {
+    return {
+        name: 'GET_GAS_PRICES',
+        similes: [
+            'GAS_TRACKER',
+            'GAS_PRICES',
+            'CHECK_GAS',
+            'CURRENT_GAS',
+            'TRANSACTION_FEES',
+            'GAS_FEES',
+            'NETWORK_FEES',
+            'ETH_GAS',
+        ],
+        description: 'Fetch current gas prices across Ethereum, Base, Polygon, and Arbitrum. ' +
+            'Returns slow/normal/fast tiers with USD cost estimates for transfers, swaps, and NFT mints. ' +
+            'Costs $0.001 USDC via x402.',
+        validate: async (_runtime, _message, _state) => {
+            return true;
+        },
+        handler: async (_runtime, message, _state, _options, callback) => {
+            try {
+                const data = await x402ApiRequest('/api/gas-tracker', {}, config);
+                const chains = data.data;
+                const chainLines = Object.entries(chains)
+                    .map(([key, chain]) => {
+                    const gwei = chain.gas_price_gwei;
+                    const cost = chain.estimated_cost_usd;
+                    return (`### ${chain.chain} (Chain ID: ${chain.chain_id})\n` +
+                        `Gas: slow ${gwei.slow} / normal ${gwei.normal} / fast ${gwei.fast} gwei\n` +
+                        `Transfer: $${cost.transfer.normal} | Swap: $${cost.swap.normal} | NFT mint: $${cost.nft_mint.normal}`);
+                })
+                    .join('\n\n');
+                const text = `## ⛽ Gas Tracker\n\n${chainLines}\n\n` +
+                    `*Source: ${data.source} • Updated: ${data.timestamp}*`;
+                if (callback) {
+                    await callback({ text, source: message.content.source });
+                }
+                return { success: true, text, data: data.data };
+            }
+            catch (error) {
+                const errMsg = `Failed to fetch gas prices: ${error.message}`;
+                if (callback)
+                    await callback({ text: errMsg });
+                return { success: false, text: errMsg };
+            }
+        },
+        examples: [
+            [
+                { name: '{{user}}', content: { text: 'What are the current gas prices?' } },
+                { name: '{{agent}}', content: { text: '## ⛽ Gas Tracker\n\n### Ethereum\nGas: slow 20 / normal 28 / fast 39 gwei\nTransfer: $1.62 | Swap: $11.55 | NFT mint: $6.54', actions: ['GET_GAS_PRICES'] } },
+            ],
+            [
+                { name: '{{user}}', content: { text: 'How much does an ETH transfer cost right now?' } },
+                { name: '{{agent}}', content: { text: 'Checking gas prices across all chains...', actions: ['GET_GAS_PRICES'] } },
+            ],
+        ],
+    };
+}
+//# sourceMappingURL=gasTracker.js.map

package/dist/actions/gasTracker.js.map

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

package/dist/actions/priceFeed.d.ts

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

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

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