@x402-api/elizaos-plugin 1.0.0

package/dist/client.js

@@ -0,0 +1,154 @@
+/**
+ * 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 const X402_API_BASE_URL = 'https://x402-api.fly.dev';
+let cachedFetch = null;
+/**
+ * Get a fetch function that handles x402 payments.
+ *
+ * If x402-fetch is installed and a wallet private key is provided,
+ * returns an auto-paying fetch. Otherwise returns standard fetch.
+ */
+async function getX402Fetch(config) {
+    if (cachedFetch)
+        return cachedFetch;
+    if (config.walletPrivateKey) {
+        try {
+            // Try to load x402-fetch for automatic payment handling.
+            // Using dynamic require via Function to avoid TypeScript's static analysis
+            // of optional peer dependencies (x402-fetch, viem) which may not be installed.
+            const requireDynamic = new Function('m', 'return import(m)');
+            const x402Module = await requireDynamic('x402-fetch').catch(() => null);
+            if (x402Module?.wrapFetchWithPayment) {
+                const viemModule = await requireDynamic('viem');
+                const viemAccounts = await requireDynamic('viem/accounts');
+                const viemChains = await requireDynamic('viem/chains');
+                const privateKeyToAccount = viemAccounts['privateKeyToAccount'];
+                const createWalletClient = viemModule['createWalletClient'];
+                const http = viemModule['http'];
+                const base = viemChains['base'];
+                const account = privateKeyToAccount(config.walletPrivateKey);
+                const walletClient = createWalletClient({ account, chain: base, transport: http() });
+                const wrapFetch = x402Module['wrapFetchWithPayment'];
+                cachedFetch = wrapFetch(fetch, walletClient);
+                console.log('[x402-plugin] Using x402-fetch with wallet:', account.address);
+                return cachedFetch;
+            }
+        }
+        catch {
+            // x402-fetch or viem not installed, fall through to standard fetch
+        }
+    }
+    // Standard fetch — will return 402 if payment not configured
+    cachedFetch = fetch;
+    return cachedFetch;
+}
+/**
+ * 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 async function x402ApiRequest(endpoint, params, config = {}) {
+    const baseUrl = config.baseUrl || X402_API_BASE_URL;
+    // Build URL with query params
+    const url = new URL(`${baseUrl}${endpoint}`);
+    for (const [key, value] of Object.entries(params)) {
+        if (value !== undefined) {
+            url.searchParams.set(key, String(value));
+        }
+    }
+    const fetchFn = await getX402Fetch(config);
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), config.timeoutMs || 30_000);
+    try {
+        const response = await fetchFn(url.toString(), {
+            signal: controller.signal,
+            headers: {
+                'Accept': 'application/json',
+                'User-Agent': 'ElizaOS-x402-plugin/1.0',
+            },
+        });
+        if (response.status === 402) {
+            // Payment required — x402-fetch should have handled this automatically
+            // If we reach here, it means x402-fetch is not configured
+            let paymentDetails = '';
+            try {
+                const body = await response.json();
+                paymentDetails = JSON.stringify(body, null, 2);
+            }
+            catch {
+                paymentDetails = await response.text();
+            }
+            throw new Error(`x402 Payment Required for ${endpoint}\n\n` +
+                `To enable automatic payments:\n` +
+                `1. Install x402-fetch: npm install x402-fetch viem\n` +
+                `2. Set X402_WALLET_PRIVATE_KEY in your .env file\n` +
+                `3. Add walletPrivateKey to plugin config\n\n` +
+                `Payment details:\n${paymentDetails}`);
+        }
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`API error ${response.status}: ${errorText}`);
+        }
+        return response.json();
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Extract key information from a message for API parameters.
+ * Parses natural language to extract token symbols, addresses, chains, etc.
+ */
+export function extractParams(text) {
+    const params = {};
+    // Extract Ethereum address
+    const addressMatch = text.match(/0x[0-9a-fA-F]{40}/);
+    if (addressMatch)
+        params.address = addressMatch[0];
+    // Extract chain name
+    const chainMatch = text.match(/\b(ethereum|base|arbitrum|polygon|solana|optimism)\b/i);
+    if (chainMatch)
+        params.chain = chainMatch[1].toLowerCase();
+    // Extract token symbols (2-6 uppercase letters, common patterns)
+    const tokenMatch = text.match(/\b([A-Z]{2,6})\b/);
+    if (tokenMatch && !['GET', 'THE', 'FOR', 'AND', 'ETH', 'BTC', 'SOL'].includes(tokenMatch[1])) {
+        // Prefer specific DeFi tokens
+        const defiTokenMatch = text.match(/\b(BTC|ETH|SOL|USDC|USDT|DAI|LINK|UNI|AAVE|ARB|OP|PEPE|SHIB|DOGE|stETH|rETH|sUSDe|sDAI)\b/i);
+        if (defiTokenMatch)
+            params.token = defiTokenMatch[1].toUpperCase();
+    }
+    // Extract amounts
+    const amountMatch = text.match(/\b(\d+(?:\.\d+)?)\s*(?:eth|btc|sol|usdc|token)?/i);
+    if (amountMatch)
+        params.amount = amountMatch[1];
+    return params;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @x402-api/elizaos-plugin
+ *
+ * ElizaOS plugin wrapping the x402 DeFi API — 8 pay-per-call endpoints
+ * for crypto prices, gas, DEX quotes, token security, whale tracking,
+ * yields, funding rates, and wallet analysis.
+ *
+ * @see https://x402-api.fly.dev
+ * @see https://github.com/sugi/x402-api-server
+ */
+export { x402DeFiPlugin, createX402Plugin } from './plugin.js';
+export type { X402PluginConfig } from './plugin.js';
+export { x402ApiRequest, extractParams, X402_API_BASE_URL } from './client.js';
+export type { X402ClientConfig } from './client.js';
+export { createPriceFeedAction } from './actions/priceFeed.js';
+export { createGasTrackerAction } from './actions/gasTracker.js';
+export { createDexQuotesAction } from './actions/dexQuotes.js';
+export { createTokenScannerAction } from './actions/tokenScanner.js';
+export { createWhaleTrackerAction } from './actions/whaleTracker.js';
+export { createYieldScannerAction } from './actions/yieldScanner.js';
+export { createFundingRatesAction } from './actions/fundingRates.js';
+export { createWalletProfilerAction } from './actions/walletProfiler.js';
+export type { X402PaymentInfo, ApiResponse, CoinPrice, PriceFeedData, PriceFeedResponse, GasTier, ChainGasData, GasTrackerData, GasTrackerResponse, DexQuote, DexQuotesData, DexQuotesQuery, TokenScanData, TokenScanQuery, WhaleHolder, WhaleTransfer, WhaleTrackerData, WhaleTrackerQuery, YieldPool, YieldScannerQuery, FundingRateEntry, ArbOpportunity, FundingRatesData, FundingRatesQuery, WalletHolding, DefiPosition, WalletProfileData, WalletProfilerQuery, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC/E,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAGzE,YAAY,EAEV,eAAe,EACf,WAAW,EAGX,SAAS,EACT,aAAa,EACb,iBAAiB,EAGjB,OAAO,EACP,YAAY,EACZ,cAAc,EACd,kBAAkB,EAGlB,QAAQ,EACR,aAAa,EACb,cAAc,EAGd,aAAa,EACb,cAAc,EAGd,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EAGjB,SAAS,EACT,iBAAiB,EAGjB,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EAGjB,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+/**
+ * @x402-api/elizaos-plugin
+ *
+ * ElizaOS plugin wrapping the x402 DeFi API — 8 pay-per-call endpoints
+ * for crypto prices, gas, DEX quotes, token security, whale tracking,
+ * yields, funding rates, and wallet analysis.
+ *
+ * @see https://x402-api.fly.dev
+ * @see https://github.com/sugi/x402-api-server
+ */
+// Main plugin
+export { x402DeFiPlugin, createX402Plugin } from './plugin.js';
+// Client utilities
+export { x402ApiRequest, extractParams, X402_API_BASE_URL } from './client.js';
+// Individual action factories (for custom composition)
+export { createPriceFeedAction } from './actions/priceFeed.js';
+export { createGasTrackerAction } from './actions/gasTracker.js';
+export { createDexQuotesAction } from './actions/dexQuotes.js';
+export { createTokenScannerAction } from './actions/tokenScanner.js';
+export { createWhaleTrackerAction } from './actions/whaleTracker.js';
+export { createYieldScannerAction } from './actions/yieldScanner.js';
+export { createFundingRatesAction } from './actions/fundingRates.js';
+export { createWalletProfilerAction } from './actions/walletProfiler.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc;AACd,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/D,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG/E,uDAAuD;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,63 @@
+/**
+ * x402 DeFi API — ElizaOS Plugin
+ *
+ * Wraps all 8 pay-per-call DeFi endpoints as ElizaOS actions.
+ * Payments handled automatically via x402-fetch (USDC on Base).
+ *
+ * @example
+ * ```typescript
+ * // In your character file:
+ * import { x402DeFiPlugin } from '@x402-api/elizaos-plugin';
+ *
+ * export const character: Character = {
+ *   name: 'DeFi Agent',
+ *   plugins: [
+ *     '@elizaos/plugin-bootstrap',
+ *     x402DeFiPlugin,
+ *   ],
+ * };
+ * ```
+ */
+import type { Plugin } from '@elizaos/core';
+export interface X402PluginConfig {
+    /**
+     * Base URL for the API.
+     * @default 'https://x402-api.fly.dev'
+     */
+    baseUrl?: string;
+    /**
+     * Wallet private key for automatic x402 payment.
+     * Can also be set via X402_WALLET_PRIVATE_KEY env variable.
+     * WARNING: Keep this secret! Use env vars, never hardcode.
+     */
+    walletPrivateKey?: string;
+    /**
+     * Your wallet address (used for logging).
+     * Can also be set via X402_WALLET_ADDRESS env variable.
+     */
+    walletAddress?: string;
+    /**
+     * Request timeout in milliseconds.
+     * @default 30000
+     */
+    timeoutMs?: number;
+}
+/**
+ * Create the x402 DeFi plugin with configuration.
+ *
+ * @example
+ * ```typescript
+ * import { createX402Plugin } from '@x402-api/elizaos-plugin';
+ *
+ * const plugin = createX402Plugin({
+ *   walletPrivateKey: process.env.X402_WALLET_PRIVATE_KEY,
+ * });
+ * ```
+ */
+export declare function createX402Plugin(pluginConfig?: X402PluginConfig): Plugin;
+/**
+ * Default export: pre-configured plugin with env-based settings.
+ * Wallet key is read from X402_WALLET_PRIVATE_KEY at runtime.
+ */
+export declare const x402DeFiPlugin: Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,eAAe,CAAC;AAW3D,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,YAAY,GAAE,gBAAqB,GAAG,MAAM,CAwE5E;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAqB,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,108 @@
+/**
+ * x402 DeFi API — ElizaOS Plugin
+ *
+ * Wraps all 8 pay-per-call DeFi endpoints as ElizaOS actions.
+ * Payments handled automatically via x402-fetch (USDC on Base).
+ *
+ * @example
+ * ```typescript
+ * // In your character file:
+ * import { x402DeFiPlugin } from '@x402-api/elizaos-plugin';
+ *
+ * export const character: Character = {
+ *   name: 'DeFi Agent',
+ *   plugins: [
+ *     '@elizaos/plugin-bootstrap',
+ *     x402DeFiPlugin,
+ *   ],
+ * };
+ * ```
+ */
+import { X402_API_BASE_URL } from './client.js';
+import { createPriceFeedAction } from './actions/priceFeed.js';
+import { createGasTrackerAction } from './actions/gasTracker.js';
+import { createDexQuotesAction } from './actions/dexQuotes.js';
+import { createTokenScannerAction } from './actions/tokenScanner.js';
+import { createWhaleTrackerAction } from './actions/whaleTracker.js';
+import { createYieldScannerAction } from './actions/yieldScanner.js';
+import { createFundingRatesAction } from './actions/fundingRates.js';
+import { createWalletProfilerAction } from './actions/walletProfiler.js';
+/**
+ * Create the x402 DeFi plugin with configuration.
+ *
+ * @example
+ * ```typescript
+ * import { createX402Plugin } from '@x402-api/elizaos-plugin';
+ *
+ * const plugin = createX402Plugin({
+ *   walletPrivateKey: process.env.X402_WALLET_PRIVATE_KEY,
+ * });
+ * ```
+ */
+export function createX402Plugin(pluginConfig = {}) {
+    let clientConfig = {
+        baseUrl: pluginConfig.baseUrl || X402_API_BASE_URL,
+        timeoutMs: pluginConfig.timeoutMs || 30_000,
+    };
+    return {
+        name: 'x402-defi-api',
+        description: 'Pay-per-call DeFi intelligence: prices, gas, DEX quotes, token security, ' +
+            'whale tracking, yields, funding rates, and wallet analysis. ' +
+            'Powered by x402 micropayments (USDC on Base). Base cost: $0.001–$0.008 per query.',
+        /**
+         * Called once when ElizaOS loads the plugin.
+         * Reads wallet configuration from runtime settings or env vars.
+         */
+        init: async (runtimeConfig, runtime) => {
+            // Resolve wallet private key from multiple sources (priority order):
+            // 1. Plugin config (passed directly)
+            // 2. Runtime settings (from character file or .env via elizaos)
+            // 3. Process environment
+            // getSetting returns string | boolean | number | null — we cast to string for URL/key values
+            const privateKey = pluginConfig.walletPrivateKey ||
+                runtime.getSetting('X402_WALLET_PRIVATE_KEY') ||
+                process.env.X402_WALLET_PRIVATE_KEY;
+            const walletAddress = pluginConfig.walletAddress ||
+                runtime.getSetting('X402_WALLET_ADDRESS') ||
+                process.env.X402_WALLET_ADDRESS;
+            const baseUrl = pluginConfig.baseUrl ||
+                runtime.getSetting('X402_API_BASE_URL') ||
+                process.env.X402_API_BASE_URL ||
+                X402_API_BASE_URL;
+            clientConfig = {
+                baseUrl,
+                walletPrivateKey: privateKey,
+                walletAddress,
+                timeoutMs: pluginConfig.timeoutMs || 30_000,
+            };
+            if (privateKey) {
+                console.log('[x402-plugin] Wallet configured — automatic payment enabled');
+                console.log(`[x402-plugin] API: ${baseUrl}`);
+            }
+            else {
+                console.warn('[x402-plugin] WARNING: No wallet private key configured.\n' +
+                    '  Set X402_WALLET_PRIVATE_KEY in your .env file to enable automatic x402 payments.\n' +
+                    '  Without it, API calls will return a 402 Payment Required error.\n' +
+                    '  See: https://github.com/sugi/x402-api-server#configuration');
+            }
+        },
+        actions: [
+            // All 8 actions are created lazily with the clientConfig reference
+            // (clientConfig is mutated in init, so actions see the updated config)
+            createPriceFeedAction(clientConfig),
+            createGasTrackerAction(clientConfig),
+            createDexQuotesAction(clientConfig),
+            createTokenScannerAction(clientConfig),
+            createWhaleTrackerAction(clientConfig),
+            createYieldScannerAction(clientConfig),
+            createFundingRatesAction(clientConfig),
+            createWalletProfilerAction(clientConfig),
+        ],
+    };
+}
+/**
+ * Default export: pre-configured plugin with env-based settings.
+ * Wallet key is read from X402_WALLET_PRIVATE_KEY at runtime.
+ */
+export const x402DeFiPlugin = createX402Plugin();
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAyB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AA6BzE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,eAAiC,EAAE;IAClE,IAAI,YAAY,GAAqB;QACnC,OAAO,EAAE,YAAY,CAAC,OAAO,IAAI,iBAAiB;QAClD,SAAS,EAAE,YAAY,CAAC,SAAS,IAAI,MAAM;KAC5C,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,2EAA2E;YAC3E,8DAA8D;YAC9D,mFAAmF;QAErF;;;WAGG;QACH,IAAI,EAAE,KAAK,EAAE,aAAqC,EAAE,OAAsB,EAAE,EAAE;YAC5E,qEAAqE;YACrE,qCAAqC;YACrC,gEAAgE;YAChE,yBAAyB;YACzB,6FAA6F;YAC7F,MAAM,UAAU,GACd,YAAY,CAAC,gBAAgB;gBAC5B,OAAO,CAAC,UAAU,CAAC,yBAAyB,CAAmB;gBAChE,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;YAEtC,MAAM,aAAa,GACjB,YAAY,CAAC,aAAa;gBACzB,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAmB;gBAC5D,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;YAElC,MAAM,OAAO,GACX,YAAY,CAAC,OAAO;gBACnB,OAAO,CAAC,UAAU,CAAC,mBAAmB,CAAmB;gBAC1D,OAAO,CAAC,GAAG,CAAC,iBAAiB;gBAC7B,iBAAiB,CAAC;YAEpB,YAAY,GAAG;gBACb,OAAO;gBACP,gBAAgB,EAAE,UAAU;gBAC5B,aAAa;gBACb,SAAS,EAAE,YAAY,CAAC,SAAS,IAAI,MAAM;aAC5C,CAAC;YAEF,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC;gBAC3E,OAAO,CAAC,GAAG,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CACV,4DAA4D;oBAC5D,sFAAsF;oBACtF,qEAAqE;oBACrE,8DAA8D,CAC/D,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,EAAE;YACP,mEAAmE;YACnE,uEAAuE;YACvE,qBAAqB,CAAC,YAAY,CAAC;YACnC,sBAAsB,CAAC,YAAY,CAAC;YACpC,qBAAqB,CAAC,YAAY,CAAC;YACnC,wBAAwB,CAAC,YAAY,CAAC;YACtC,wBAAwB,CAAC,YAAY,CAAC;YACtC,wBAAwB,CAAC,YAAY,CAAC;YACtC,wBAAwB,CAAC,YAAY,CAAC;YACtC,0BAA0B,CAAC,YAAY,CAAC;SACzC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,280 @@
+/**
+ * TypeScript types for the x402 DeFi API responses.
+ * Base URL: https://x402-api.fly.dev
+ *
+ * All endpoints require x402 micropayment (USDC on Base).
+ */
+export interface X402PaymentInfo {
+    payer?: string;
+    amount?: string;
+    token?: string;
+}
+export interface ApiResponse<T> {
+    timestamp: string;
+    source: string;
+    cached?: boolean;
+    payment?: X402PaymentInfo;
+    data: T;
+}
+export interface CoinPrice {
+    id: string;
+    price_usd: number | null;
+    change_24h_pct: number | null;
+    volume_24h_usd: number | null;
+    market_cap_usd: number | null;
+    last_updated: string | null;
+}
+export interface PriceFeedData {
+    core: CoinPrice[];
+    top_movers: {
+        gainers: CoinPrice[];
+        losers: CoinPrice[];
+    };
+}
+export interface PriceFeedResponse extends ApiResponse<PriceFeedData> {
+    cache_ttl_seconds: number;
+}
+export interface GasTier {
+    slow: number;
+    normal: number;
+    fast: number;
+}
+export interface ChainGasData {
+    chain: string;
+    chain_id: number;
+    native_token: string;
+    is_mock: boolean;
+    gas_price_gwei: GasTier;
+    estimated_cost_usd: {
+        transfer: GasTier;
+        swap: GasTier;
+        nft_mint: GasTier;
+    };
+}
+export interface GasTrackerData {
+    ethereum: ChainGasData;
+    base: ChainGasData;
+    polygon: ChainGasData;
+    arbitrum: ChainGasData;
+}
+export interface GasTrackerResponse extends ApiResponse<GasTrackerData> {
+    cache_ttl_seconds: number;
+}
+export interface DexQuote {
+    dex: string;
+    dex_name: string;
+    input_token: string;
+    output_token: string;
+    input_amount: number;
+    output_amount: number;
+    effective_rate: number;
+    price_impact_pct: number;
+    fee_bps: number;
+    fee_usd: number;
+    estimated_gas_usd: number;
+    route: string[];
+    min_output: number;
+    expires_in_seconds: number;
+}
+export interface DexQuotesData {
+    pair: string;
+    chain: string;
+    input_amount: number;
+    input_value_usd: number;
+    base_rate: number;
+    best_dex: string;
+    best_output: number;
+    savings_vs_worst: number;
+    quotes: DexQuote[];
+    recommendation: {
+        dex: string;
+        reason: string;
+        output: number;
+        total_cost_usd: number;
+    };
+}
+export interface DexQuotesQuery {
+    from?: string;
+    to?: string;
+    amount?: number;
+    chain?: string;
+}
+export interface TokenScanData {
+    address: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+    chain: string;
+    deployer: string;
+    deploy_date: string;
+    total_supply: number;
+    holder_count: number;
+    is_verified: boolean;
+    has_proxy: boolean;
+    has_mint_function: boolean;
+    liquidity_locked: boolean;
+    honeypot_risk: boolean;
+    buy_tax: number;
+    sell_tax: number;
+    liquidity_usd: number;
+    market_cap_usd: number;
+    price_usd: number;
+    risk_score: number;
+    risk_level: 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+    risk_flags: {
+        is_verified: boolean;
+        has_proxy: boolean;
+        has_mint_function: boolean;
+        liquidity_locked: boolean;
+        honeypot_risk: boolean;
+        high_buy_tax: boolean;
+        high_sell_tax: boolean;
+    };
+    age_days: number;
+}
+export interface TokenScanQuery {
+    token?: string;
+    chain?: string;
+}
+export interface WhaleHolder {
+    rank: number;
+    address: string;
+    label: string;
+    wallet_type: string;
+    balance: number;
+    percentage: number;
+    last_active: string;
+    is_contract: boolean;
+}
+export interface WhaleTransfer {
+    tx_hash: string;
+    from: string;
+    to: string;
+    amount: number;
+    usd_value: number;
+    timestamp: string;
+    transfer_type: string;
+}
+export interface WhaleTrackerData {
+    token: string;
+    chain: string;
+    total_supply: number;
+    circulating_supply: number;
+    holder_count: number;
+    concentration_metrics: {
+        top_1_pct: number;
+        top_10_pct: number;
+        top_20_pct: number;
+        gini_coefficient: number;
+        herfindahl_index: number;
+    };
+    distribution_buckets: Array<{
+        label: string;
+        holder_pct: number;
+        supply_pct: number;
+    }>;
+    top_holders: WhaleHolder[];
+    recent_large_transfers: WhaleTransfer[];
+}
+export interface WhaleTrackerQuery {
+    token?: string;
+    chain?: string;
+}
+export interface YieldPool {
+    protocol: string;
+    asset: string;
+    chain: string;
+    apy: number;
+    tvl: number;
+    risk_tier: 'low' | 'medium' | 'high';
+    type: string;
+    updated_at: string;
+}
+export interface YieldScannerQuery {
+    chain?: string;
+    min_tvl?: number;
+    asset?: string;
+    limit?: number;
+}
+export interface FundingRateEntry {
+    funding_rate: number;
+    annualized_pct: number;
+    predicted_rate: number;
+    open_interest_usd: number;
+    next_funding_in_ms: number;
+    last_updated: string;
+}
+export interface ArbOpportunity {
+    asset: string;
+    long_venue: string;
+    long_rate: number;
+    short_venue: string;
+    short_rate: number;
+    spread_bps: number;
+    annualized_arb_pct: number;
+    signal: 'STRONG' | 'MODERATE' | 'WEAK';
+    note: string;
+}
+export interface FundingRatesData {
+    [asset: string]: {
+        [protocol: string]: FundingRateEntry;
+    };
+}
+export interface FundingRatesQuery {
+    asset?: string;
+    min_spread?: number;
+}
+export interface WalletHolding {
+    token: string;
+    chain: string;
+    balance: number;
+    price_usd: number;
+    value_usd: number;
+    portfolio_pct: number;
+}
+export interface DefiPosition {
+    protocol: string;
+    type: string;
+    asset: string;
+    chain: string;
+    value_usd: number;
+    apy: number;
+}
+export interface WalletProfileData {
+    address: string;
+    label: string | null;
+    wallet_type: string;
+    chains_active: string[];
+    total_value_usd: number;
+    defi_value_usd: number;
+    portfolio: {
+        top_holdings: WalletHolding[];
+        allocation: {
+            native_tokens_pct: number;
+            stablecoins_pct: number;
+            defi_tokens_pct: number;
+        };
+    };
+    defi_positions: DefiPosition[];
+    activity: {
+        total_transactions: number;
+        first_seen: string;
+        last_active: string;
+        age_days: number;
+        avg_tx_per_day: number;
+        nft_count: number;
+    };
+    risk_profile: {
+        classification: 'conservative' | 'moderate' | 'aggressive';
+        stablecoin_ratio: number;
+        diversification_score: number;
+        defi_exposure_pct: number;
+        is_contract: boolean;
+        is_multisig: boolean;
+    };
+}
+export interface WalletProfilerQuery {
+    address?: string;
+    chain?: string;
+}
+//# sourceMappingURL=types.d.ts.map