@infiniteezverse/monskills-ezpath 0.1.0

package/dist/config/monad.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Monad-Specific Configuration
+ * RPC endpoints, contract addresses, and optimization settings for Monad chain
+ */
+export declare const MONAD_CONFIG: {
+    chainId: number;
+    name: string;
+    nativeToken: string;
+    rpc: {
+        primary: string;
+        fallbacks: string[];
+    };
+    blockExplorer: string;
+    tokens: {
+        MON: string;
+        USDC: string;
+        WMON: string;
+        WETH: string;
+        USDbC: string;
+        DAI: string;
+        USDT: string;
+    };
+    venues: {
+        aerodrome: {
+            router: string;
+            factory: string;
+            stable: boolean;
+            name: string;
+            priority: number;
+            features: string[];
+        };
+        uniswapV3: {
+            router: string;
+            factory: string;
+            name: string;
+            priority: number;
+            features: string[];
+        };
+        curve: {
+            router: string;
+            name: string;
+            priority: number;
+            features: string[];
+        };
+        balancer: {
+            vault: string;
+            name: string;
+            priority: number;
+            features: string[];
+        };
+        zerox: {
+            name: string;
+            priority: number;
+            features: string[];
+        };
+        paraswap: {
+            name: string;
+            priority: number;
+            features: string[];
+        };
+        oneInch: {
+            name: string;
+            priority: number;
+            features: string[];
+        };
+        cow: {
+            name: string;
+            priority: number;
+            features: string[];
+        };
+    };
+    gas: {
+        maxPriorityFee: bigint;
+        maxFeePerGas: bigint;
+        swapGasEstimate: {
+            simple: number;
+            multiHop: number;
+            complex: number;
+        };
+    };
+    performance: {
+        maxConcurrentQuotes: number;
+        quoteTimeoutMs: number;
+        targetLatency: number;
+        priceCache: {
+            ttl: number;
+            maxSize: number;
+        };
+    };
+    ecosystem: {
+        monadDAO: string;
+        staking: string;
+        governance: string;
+    };
+    settlement: {
+        confirmations: number;
+        confirmationTimeMs: number;
+        permit2: string;
+    };
+    rateLimit: {
+        requestsPerSecond: number;
+        burstSize: number;
+        retryDelayMs: number;
+    };
+    monitoring: {
+        priceDeviationAlert: number;
+        slippageWarn: number;
+        latencyWarn: number;
+    };
+};
+/**
+ * Get RPC endpoint with fallback support
+ */
+export declare function getMonadRPC(): Promise<string>;
+/**
+ * Check if a venue is available on Monad
+ */
+export declare function isVenueAvailableOnMonad(venueName: string): boolean;
+/**
+ * Get venue by priority for Monad
+ */
+export declare function getVenuesByPriority(): ({
+    id: string;
+    router: string;
+    factory: string;
+    stable: boolean;
+    name: string;
+    priority: number;
+    features: string[];
+} | {
+    id: string;
+    router: string;
+    factory: string;
+    name: string;
+    priority: number;
+    features: string[];
+} | {
+    id: string;
+    router: string;
+    name: string;
+    priority: number;
+    features: string[];
+} | {
+    id: string;
+    vault: string;
+    name: string;
+    priority: number;
+    features: string[];
+} | {
+    id: string;
+    name: string;
+    priority: number;
+    features: string[];
+} | {
+    id: string;
+    name: string;
+    priority: number;
+    features: string[];
+} | {
+    id: string;
+    name: string;
+    priority: number;
+    features: string[];
+} | {
+    id: string;
+    name: string;
+    priority: number;
+    features: string[];
+})[];
+/**
+ * Get recommended venue for specific token pair on Monad
+ */
+export declare function recommendMonadVenue(tokenIn: string, tokenOut: string): string;
+export default MONAD_CONFIG;
+//# sourceMappingURL=monad.d.ts.map

package/dist/config/monad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monad.d.ts","sourceRoot":"","sources":["../../src/config/monad.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6IxB,CAAC;AAEF;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CA0CnD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAIlE;AAED;;GAEG;AACH,wBAAgB,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAOlC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAe7E;AAED,eAAe,YAAY,CAAC"}

package/dist/config/monad.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * Monad-Specific Configuration
+ * RPC endpoints, contract addresses, and optimization settings for Monad chain
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MONAD_CONFIG = void 0;
+exports.getMonadRPC = getMonadRPC;
+exports.isVenueAvailableOnMonad = isVenueAvailableOnMonad;
+exports.getVenuesByPriority = getVenuesByPriority;
+exports.recommendMonadVenue = recommendMonadVenue;
+exports.MONAD_CONFIG = {
+    // Chain identification
+    chainId: 10143,
+    name: 'Monad',
+    nativeToken: 'MON',
+    // RPC Endpoints (primary + fallbacks)
+    rpc: {
+        primary: 'https://mainnet.monad.xyz/rpc',
+        fallbacks: [
+            'https://rpc-monad.monadscan.io',
+            'https://monad-rpc.publicnode.com',
+            'https://monad.drpc.org',
+        ],
+    },
+    // Block explorer
+    blockExplorer: 'https://monadiscan.io',
+    // Token addresses on Monad
+    tokens: {
+        MON: '0x0000000000000000000000000000000000000001', // Native
+        USDC: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', // Bridged from Base
+        WMON: '0x0000000000000000000000000000000000000002', // Wrapped MON
+        WETH: '0x4200000000000000000000000000000000000006', // Bridged from Base
+        USDbC: '0x50c5725949A6F0c72EC20E08a6DE0146F30F1F75', // Bridged
+        DAI: '0x6B175474E89094C44Da98b954EedeAC495271d0F', // Bridged
+        USDT: '0xdAC17F958D2ee523a2206206994597C13D831ec7', // Bridged
+    },
+    // Primary routing venues on Monad
+    venues: {
+        // DEX routers with Monad support
+        aerodrome: {
+            router: '0x16AAB61dedBad9405299340D63Ee98D1bFd052d3',
+            factory: '0x420DD381b31aEf6683db6B902084cB0FFECe40Da',
+            stable: false, // Volatile pair routing
+            name: 'Aerodrome',
+            priority: 1, // Highest priority on Monad
+            features: ['volatile', 'stable', 'concentrated'],
+        },
+        uniswapV3: {
+            router: '0xE592427A0AEce92De3Edee1F18E0157C05861564',
+            factory: '0x1F98431c8aD98523631AE4a59f267346ea3113cD',
+            name: 'Uniswap V3',
+            priority: 2,
+            features: ['concentrated-liquidity', 'fee-tiers'],
+        },
+        curve: {
+            router: '0x99a58482BD75cbab83b27EC03ca68fF489ee5f38',
+            name: 'Curve',
+            priority: 3,
+            features: ['stable-swap', 'meta-pools'],
+        },
+        balancer: {
+            vault: '0xBA12222222228d8Ba445958a75a0704d566BF2C8',
+            name: 'Balancer',
+            priority: 4,
+            features: ['weighted-pools', 'stable-pools', 'liquidity-bootstrapping'],
+        },
+        // Aggregators
+        zerox: {
+            name: '0x',
+            priority: 5,
+            features: ['meta-aggregator'],
+        },
+        paraswap: {
+            name: 'ParaSwap',
+            priority: 6,
+            features: ['meta-aggregator'],
+        },
+        oneInch: {
+            name: '1Inch',
+            priority: 7,
+            features: ['meta-aggregator'],
+        },
+        cow: {
+            name: 'CoW',
+            priority: 8,
+            features: ['intents', 'batch-auctions'],
+        },
+    },
+    // Gas optimization settings
+    gas: {
+        // Monad has high throughput, lower gas costs
+        maxPriorityFee: BigInt('1000000000'), // 1 gwei (very low)
+        maxFeePerGas: BigInt('2000000000'), // 2 gwei
+        // Typical tx costs
+        swapGasEstimate: {
+            simple: 80000, // Single hop
+            multiHop: 150000, // Multi-hop
+            complex: 250000, // Complex route
+        },
+    },
+    // Performance settings
+    performance: {
+        // Monad's high TPS allows aggressive settings
+        maxConcurrentQuotes: 50, // 50 parallel venue queries
+        quoteTimeoutMs: 1500, // Tight timeout for high throughput
+        targetLatency: 800, // Target sub-1 second
+        // Caching strategy
+        priceCache: {
+            ttl: 3000, // 3-second cache (frequent updates)
+            maxSize: 1000, // Max cached pairs
+        },
+    },
+    // Monad ecosystem integration
+    ecosystem: {
+        monadDAO: '0x0000000000000000000000000000000000000000',
+        staking: '0x0000000000000000000000000000000000000000',
+        governance: '0x0000000000000000000000000000000000000000',
+    },
+    // Settlement settings
+    settlement: {
+        // Standard ERC20 transfers
+        confirmations: 1, // Monad finality is fast
+        confirmationTimeMs: 2000, // ~2 seconds per block
+        // Permit2 support (gas optimization)
+        permit2: '0x000000000022D473030F116dDEE9F6B43aC78BA3',
+    },
+    // Rate limiting (Monad nodes are fast)
+    rateLimit: {
+        requestsPerSecond: 100,
+        burstSize: 500,
+        retryDelayMs: 100,
+    },
+    // Monitoring & alerts
+    monitoring: {
+        priceDeviationAlert: 0.5, // Alert if price deviates >0.5% from average
+        slippageWarn: 0.1, // Warn if slippage >0.1%
+        latencyWarn: 2000, // Warn if quote takes >2s
+    },
+};
+/**
+ * Get RPC endpoint with fallback support
+ */
+async function getMonadRPC() {
+    // Try primary first
+    try {
+        const response = await fetch(exports.MONAD_CONFIG.rpc.primary, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                jsonrpc: '2.0',
+                method: 'eth_chainId',
+                params: [],
+                id: 1,
+            }),
+        });
+        if (response.ok)
+            return exports.MONAD_CONFIG.rpc.primary;
+    }
+    catch (err) {
+        console.warn('Primary Monad RPC failed, trying fallback');
+    }
+    // Try fallbacks
+    for (const fallback of exports.MONAD_CONFIG.rpc.fallbacks) {
+        try {
+            const response = await fetch(fallback, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    jsonrpc: '2.0',
+                    method: 'eth_chainId',
+                    params: [],
+                    id: 1,
+                }),
+            });
+            if (response.ok)
+                return fallback;
+        }
+        catch (err) {
+            continue;
+        }
+    }
+    // All failed, return primary anyway
+    console.error('All Monad RPC endpoints failed, using primary as fallback');
+    return exports.MONAD_CONFIG.rpc.primary;
+}
+/**
+ * Check if a venue is available on Monad
+ */
+function isVenueAvailableOnMonad(venueName) {
+    return Object.values(exports.MONAD_CONFIG.venues).some(v => v.name.toLowerCase() === venueName.toLowerCase());
+}
+/**
+ * Get venue by priority for Monad
+ */
+function getVenuesByPriority() {
+    return Object.entries(exports.MONAD_CONFIG.venues)
+        .map(([key, config]) => ({
+        ...config,
+        id: key,
+    }))
+        .sort((a, b) => a.priority - b.priority);
+}
+/**
+ * Get recommended venue for specific token pair on Monad
+ */
+function recommendMonadVenue(tokenIn, tokenOut) {
+    // Aerodrome is default for MON pairs (highest priority)
+    if (tokenIn === exports.MONAD_CONFIG.tokens.MON ||
+        tokenOut === exports.MONAD_CONFIG.tokens.MON) {
+        return 'aerodrome';
+    }
+    // Uniswap V3 for stables
+    if ((tokenIn === exports.MONAD_CONFIG.tokens.USDC && tokenOut === exports.MONAD_CONFIG.tokens.USDT) ||
+        (tokenIn === exports.MONAD_CONFIG.tokens.USDT && tokenOut === exports.MONAD_CONFIG.tokens.USDC)) {
+        return 'curve'; // Curve is optimal for stables
+    }
+    // Default: use top-priority venue (Aerodrome)
+    return 'aerodrome';
+}
+exports.default = exports.MONAD_CONFIG;
+//# sourceMappingURL=monad.js.map

package/dist/config/monad.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * EZ-Path MONSKILLS Plugin
+ * Exposes EZ-Path DEX routing as a MONSKILLS skill for agent use
+ */
+import { EZPathQuoteRequest, QuoteResult } from './types/ezpath';
+/**
+ * Get a DEX price quote from EZ-Path
+ * Races 10 venues and returns the best price
+ *
+ * @param request - Quote parameters (chain, tokens, amount)
+ * @returns Quote result with price and sources
+ */
+export declare function getQuote(request: EZPathQuoteRequest): Promise<QuoteResult>;
+/**
+ * Get price for a token pair in human-readable format
+ * Convenience wrapper around getQuote
+ *
+ * @param chain - Blockchain (base, monad, etc.)
+ * @param sellToken - Token to sell (address)
+ * @param buyToken - Token to buy (address)
+ * @param amount - Amount in atomic units
+ * @returns Price as decimal string
+ */
+export declare function getPrice(chain: string, sellToken: string, buyToken: string, amount: string): Promise<{
+    price: string;
+    sources: string[];
+} | {
+    error: string;
+}>;
+/**
+ * Batch quote multiple pairs
+ * Useful for portfolio valuation
+ */
+export declare function batchQuotes(requests: EZPathQuoteRequest[]): Promise<QuoteResult[]>;
+export * from './types/ezpath';
+export declare const skill: {
+    name: string;
+    version: string;
+    description: string;
+    handlers: {
+        getQuote: typeof getQuote;
+        getPrice: typeof getPrice;
+        batchQuotes: typeof batchQuotes;
+    };
+};
+export default skill;
+//# 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;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAkB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAKjF;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CA4EhF;AAED;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAC5B,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAanE;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,kBAAkB,EAAE,GAC7B,OAAO,CAAC,WAAW,EAAE,CAAC,CAExB;AAGD,cAAc,gBAAgB,CAAC;AAG/B,eAAO,MAAM,KAAK;;;;;;;;;CASjB,CAAC;AAEF,eAAe,KAAK,CAAC"}

package/dist/index.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * EZ-Path MONSKILLS Plugin
+ * Exposes EZ-Path DEX routing as a MONSKILLS skill for agent use
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skill = void 0;
+exports.getQuote = getQuote;
+exports.getPrice = getPrice;
+exports.batchQuotes = batchQuotes;
+const axios_1 = __importDefault(require("axios"));
+const EZPATH_URL = process.env.EZPATH_URL || 'https://ezpath.myezverse.xyz';
+const API_ENDPOINT = `${EZPATH_URL}/api/v1/quote`;
+/**
+ * Get a DEX price quote from EZ-Path
+ * Races 10 venues and returns the best price
+ *
+ * @param request - Quote parameters (chain, tokens, amount)
+ * @returns Quote result with price and sources
+ */
+async function getQuote(request) {
+    try {
+        // Validate inputs
+        if (!request.sellToken || !request.buyToken || !request.sellAmount) {
+            return {
+                success: false,
+                error: 'Missing required parameters: sellToken, buyToken, sellAmount',
+            };
+        }
+        // Build query parameters
+        const params = new URLSearchParams({
+            chain: request.chain || 'base',
+            sellToken: request.sellToken,
+            buyToken: request.buyToken,
+            sellAmount: request.sellAmount,
+        });
+        if (request.slippagePercentage !== undefined) {
+            params.append('slippagePercentage', request.slippagePercentage.toString());
+        }
+        // Call EZ-Path endpoint
+        const response = await axios_1.default.get(`${API_ENDPOINT}?${params}`, {
+            timeout: 10000,
+            validateStatus: () => true, // Accept all statuses
+        });
+        // Handle 402 Payment Required
+        if (response.status === 402) {
+            const data = response.data;
+            return {
+                success: false,
+                paymentRequired: true,
+                estimatedFee: {
+                    usd: data.unlock_fee_usd,
+                    atomic: data.tiers?.basic?.min_atomic || '30000',
+                    token: 'USDC',
+                },
+                error: `Payment required: ${data.unlock_fee_usd} USDC via X402 EIP-3009`,
+            };
+        }
+        // Handle successful quote
+        if (response.status === 200) {
+            const data = response.data;
+            return {
+                success: true,
+                data: {
+                    status: 'ok',
+                    request_id: data.request_id,
+                    sellToken: data.sellToken,
+                    buyToken: data.buyToken,
+                    sellAmount: data.sellAmount,
+                    buyAmount: data.buyAmount,
+                    price: data.price,
+                    sources: data.sources || [],
+                    routingEngine: data.routingEngine || 'unknown',
+                    tier: data.tier || 'basic',
+                    settlement_tx: data.settlement_tx,
+                },
+            };
+        }
+        // Handle errors
+        return {
+            success: false,
+            error: `EZ-Path error (${response.status}): ${JSON.stringify(response.data)}`,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+            success: false,
+            error: `Request failed: ${message}`,
+        };
+    }
+}
+/**
+ * Get price for a token pair in human-readable format
+ * Convenience wrapper around getQuote
+ *
+ * @param chain - Blockchain (base, monad, etc.)
+ * @param sellToken - Token to sell (address)
+ * @param buyToken - Token to buy (address)
+ * @param amount - Amount in atomic units
+ * @returns Price as decimal string
+ */
+async function getPrice(chain, sellToken, buyToken, amount) {
+    const result = await getQuote({ chain: chain, sellToken, buyToken, sellAmount: amount });
+    if (result.success && result.data) {
+        return {
+            price: result.data.price,
+            sources: result.data.sources.map((s) => s.name),
+        };
+    }
+    return {
+        error: result.error || 'Failed to get price',
+    };
+}
+/**
+ * Batch quote multiple pairs
+ * Useful for portfolio valuation
+ */
+async function batchQuotes(requests) {
+    return Promise.all(requests.map((req) => getQuote(req)));
+}
+// Export types
+__exportStar(require("./types/ezpath"), exports);
+// MONSKILLS-compatible exports
+exports.skill = {
+    name: 'ez-path',
+    version: '0.1.0',
+    description: 'DEX price quotes via EZ-Path (races 10 venues)',
+    handlers: {
+        getQuote,
+        getPrice,
+        batchQuotes,
+    },
+};
+exports.default = exports.skill;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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