@infiniteezverse/monskills-ezpath 0.1.0

package/dist/payments/quote-execution.js

@@ -0,0 +1,285 @@
+"use strict";
+/**
+ * Quote Execution with X402 Payment
+ * Handles the complete flow: probe → payment signing → retry → settlement
+ *
+ * Flow:
+ * 1. GET /api/v1/quote → HTTP 402 Payment Required
+ * 2. Extract toll address and payment amount from 402 response
+ * 3. Create EIP-3009 TransferWithAuthorization message
+ * 4. Sign message with agent's private key
+ * 5. Retry GET /api/v1/quote with X-Payment header
+ * 6. Return settlement transaction and quote data
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuoteExecutor = void 0;
+const axios_1 = __importDefault(require("axios"));
+const eip3009_1 = require("./eip3009");
+/**
+ * Quote Executor
+ * Handles quotes with optional X402 payment
+ */
+class QuoteExecutor {
+    constructor(ezPathUrl = 'https://ezpath.myezverse.xyz', options) {
+        this.maxRetries = 3;
+        this.retryDelayMs = 1000;
+        this.ezPathUrl = ezPathUrl;
+        if (options?.maxRetries)
+            this.maxRetries = options.maxRetries;
+        if (options?.retryDelayMs)
+            this.retryDelayMs = options.retryDelayMs;
+        if (options?.signingFunction)
+            this.signingFunction = options.signingFunction;
+        if (options?.agentAddress)
+            this.agentAddress = options.agentAddress;
+    }
+    /**
+     * Execute quote with optional X402 payment
+     */
+    async executeQuote(request, paymentSigningFunction) {
+        let retries = 0;
+        const maxRetries = this.maxRetries;
+        const agentAddress = this.agentAddress || '0x0000000000000000000000000000000000000000';
+        try {
+            // Step 1: Initial probe (no payment)
+            console.log('[EZ-Path] Probing endpoint...');
+            const probeResponse = await this.makeQuoteRequest(request);
+            // Check for 402 Payment Required
+            if (probeResponse.status === 402) {
+                const paymentRequired = probeResponse.data;
+                console.log('[EZ-Path] Payment required (HTTP 402)');
+                // Extract payment information
+                const feeUSD = paymentRequired.unlock_fee_usd || 0.03;
+                const feeAtomic = getTierBasedAmount(feeUSD);
+                const tier = (0, eip3009_1.getTierByAmount)(feeAtomic);
+                console.log(`[X402] Tier: ${tier}, Fee: $${feeUSD} USDC (${feeAtomic.toString()} atomic)`);
+                // Step 2: Create authorization message
+                const authMessage = (0, eip3009_1.createAuthorizationMessage)(agentAddress, eip3009_1.TOLL_ADDRESS, feeAtomic, 300 // 5 minute validity
+                );
+                console.log(`[X402] Authorization created`);
+                console.log(`   Valid: ${new Date(authMessage.validAfter * 1000).toISOString()}`);
+                console.log(`   Expires: ${new Date(authMessage.validBefore * 1000).toISOString()}`);
+                console.log(`   Nonce: ${authMessage.nonce}`);
+                // Validate message before signing
+                const validation = validateAuthorizationMessage(authMessage);
+                if (!validation.valid) {
+                    return {
+                        success: false,
+                        error: `Invalid authorization message: ${validation.error}`,
+                        paymentRequired: true,
+                        estimatedFee: {
+                            usd: feeUSD,
+                            atomic: feeAtomic.toString(),
+                            token: 'USDC',
+                        },
+                        retries,
+                    };
+                }
+                // Step 3: Sign the message
+                let signature;
+                const signingFn = paymentSigningFunction || this.signingFunction;
+                if (!signingFn) {
+                    return {
+                        success: false,
+                        error: 'No signing function provided. Cannot sign X402 payment.',
+                        paymentRequired: true,
+                        estimatedFee: {
+                            usd: feeUSD,
+                            atomic: feeAtomic.toString(),
+                            token: 'USDC',
+                        },
+                        retries,
+                    };
+                }
+                try {
+                    console.log('[X402] Signing authorization...');
+                    signature = await signingFn(authMessage);
+                    console.log(`[X402] Signature: ${signature.substring(0, 20)}...`);
+                }
+                catch (signError) {
+                    return {
+                        success: false,
+                        error: `Failed to sign X402 payment: ${String(signError)}`,
+                        paymentRequired: true,
+                        estimatedFee: {
+                            usd: feeUSD,
+                            atomic: feeAtomic.toString(),
+                            token: 'USDC',
+                        },
+                        retries,
+                    };
+                }
+                // Step 4: Create X402 payment header
+                const paymentSignature = {
+                    signature,
+                    authorization: authMessage,
+                    quote_issued_at: Math.floor(Date.now() / 1000),
+                };
+                const xPaymentHeader = (0, eip3009_1.createX402PaymentHeader)(paymentSignature);
+                // Step 5: Retry with payment header
+                console.log('[X402] Retrying quote with payment...');
+                let paidResponse = await this.makeQuoteRequest(request, xPaymentHeader);
+                retries++;
+                // Retry logic for transient failures
+                while (paidResponse.status !== 200 && retries < maxRetries) {
+                    console.log(`[X402] Attempt ${retries}: Got ${paidResponse.status}, retrying in ${this.retryDelayMs}ms...`);
+                    await this.delay(this.retryDelayMs);
+                    paidResponse = await this.makeQuoteRequest(request, xPaymentHeader);
+                    retries++;
+                }
+                // Check final response
+                if (paidResponse.status === 200) {
+                    const data = paidResponse.data;
+                    console.log(`[EZ-Path] ✅ Quote successful`);
+                    console.log(`   Buy amount: ${data.buyAmount}`);
+                    console.log(`   Best engine: ${data.routingEngine}`);
+                    console.log(`   Settlement TX: ${data.settlement_tx || 'pending'}`);
+                    return {
+                        success: true,
+                        data: {
+                            status: data.status,
+                            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: tier,
+                            settlement_tx: data.settlement_tx,
+                        },
+                        paymentSignature,
+                        retries,
+                    };
+                }
+                else {
+                    return {
+                        success: false,
+                        error: `Quote failed after ${retries} attempts: ${paidResponse.status}`,
+                        retries,
+                    };
+                }
+            }
+            else if (probeResponse.status === 200) {
+                // No payment required, return quote directly
+                const data = probeResponse.data;
+                console.log('[EZ-Path] ✅ Quote successful (no payment required)');
+                return {
+                    success: true,
+                    data: {
+                        status: data.status,
+                        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: 'basic',
+                    },
+                    retries,
+                };
+            }
+            else {
+                return {
+                    success: false,
+                    error: `Unexpected status: ${probeResponse.status}`,
+                    retries,
+                };
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`[EZ-Path] Error: ${message}`);
+            return {
+                success: false,
+                error: `Request failed: ${message}`,
+                retries,
+            };
+        }
+    }
+    /**
+     * Make quote request (internal)
+     */
+    async makeQuoteRequest(request, xPaymentHeader) {
+        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());
+        }
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (xPaymentHeader) {
+            headers['X-Payment'] = xPaymentHeader;
+        }
+        try {
+            const response = await axios_1.default.get(`${this.ezPathUrl}/api/v1/quote?${params}`, {
+                headers,
+                timeout: 10000,
+                validateStatus: () => true, // Accept all statuses
+            });
+            return response;
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    /**
+     * Delay utility
+     */
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+exports.QuoteExecutor = QuoteExecutor;
+/**
+ * Get tier-based payment amount
+ */
+function getTierBasedAmount(feeUSD) {
+    // Map USD fee to atomic USDC (6 decimals)
+    const atomic = Math.round(feeUSD * 1e6);
+    return BigInt(atomic);
+}
+/**
+ * Validate authorization message
+ */
+function validateAuthorizationMessage(message) {
+    const now = Math.floor(Date.now() / 1000);
+    if (message.validBefore < now) {
+        return {
+            valid: false,
+            error: 'Authorization expired',
+        };
+    }
+    if (!message.from.startsWith('0x') || message.from.length !== 42) {
+        return {
+            valid: false,
+            error: 'Invalid from address',
+        };
+    }
+    if (!message.to.startsWith('0x') || message.to.length !== 42) {
+        return {
+            valid: false,
+            error: 'Invalid to address',
+        };
+    }
+    if (!message.nonce.startsWith('0x') || message.nonce.length !== 66) {
+        return {
+            valid: false,
+            error: 'Invalid nonce',
+        };
+    }
+    return { valid: true };
+}
+exports.default = QuoteExecutor;
+//# sourceMappingURL=quote-execution.js.map

package/dist/payments/quote-execution.js.map

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

package/dist/types/ezpath.d.ts

@@ -0,0 +1,65 @@
+/**
+ * EZ-Path Quote Types
+ * Matches the EZ-Path API response schema
+ */
+export interface EZPathQuoteRequest {
+    chain: 'base' | 'monad' | 'arbitrum' | 'optimism' | 'polygon';
+    sellToken: string;
+    buyToken: string;
+    sellAmount: string;
+    slippagePercentage?: number;
+}
+export interface EZPathSource {
+    name: string;
+    buyAmount: string;
+    gasEstimate?: string;
+}
+export interface EZPathQuoteResponse {
+    status: 'ok' | 'payment_required' | 'bad_request' | 'internal_error';
+    request_id: string;
+    sellToken: string;
+    buyToken: string;
+    sellAmount: string;
+    buyAmount: string;
+    price: string;
+    sources: EZPathSource[];
+    routingEngine: string;
+    tier: 'basic' | 'resilient' | 'institutional';
+    settlement_tx?: string;
+}
+export interface EZPathPaymentRequired {
+    status: 'payment_required';
+    x402Version: number;
+    accepts: Array<{
+        scheme: string;
+        network: string;
+        maxAmountRequired: string;
+        resource: string;
+        description: string;
+        mimeType: string;
+        payTo: string;
+        maxTimeoutSeconds: number;
+        asset: string;
+        extra: Record<string, any>;
+    }>;
+    unlock_fee_usd: number;
+    request_id: string;
+    tiers: Record<string, {
+        min_atomic: string;
+        min_usdc: number;
+        description: string;
+    }>;
+}
+export type EZPathResponse = EZPathQuoteResponse | EZPathPaymentRequired;
+export interface QuoteResult {
+    success: boolean;
+    data?: EZPathQuoteResponse;
+    error?: string;
+    paymentRequired?: boolean;
+    estimatedFee?: {
+        usd: number;
+        atomic: string;
+        token: 'USDC';
+    };
+}
+//# sourceMappingURL=ezpath.d.ts.map

package/dist/types/ezpath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ezpath.d.ts","sourceRoot":"","sources":["../../src/types/ezpath.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,IAAI,GAAG,kBAAkB,GAAG,aAAa,GAAG,gBAAgB,CAAC;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,eAAe,CAAC;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,iBAAiB,EAAE,MAAM,CAAC;QAC1B,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC5B,CAAC,CAAC;IACH,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG,qBAAqB,CAAC;AAEzE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH"}

package/dist/types/ezpath.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * EZ-Path Quote Types
+ * Matches the EZ-Path API response schema
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ezpath.js.map

package/dist/types/ezpath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ezpath.js","sourceRoot":"","sources":["../../src/types/ezpath.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@infiniteezverse/monskills-ezpath",
+  "version": "0.1.0",
+  "description": "MONSKILLS skill for EZ-Path DEX price quotes on Monad, Base, and other EVM chains",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "dev": "tsc --watch",
+    "lint": "eslint src/**/*.ts",
+    "publish:npm": "npm run build && npm publish --access=public"
+  },
+  "keywords": [
+    "monskills",
+    "monad",
+    "dex",
+    "ezpath",
+    "agent",
+    "skill",
+    "defi"
+  ],
+  "author": "infiniteezverse",
+  "license": "MIT",
+  "dependencies": {
+    "axios": "^1.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "jest": "^29.0.0",
+    "@types/jest": "^29.0.0",
+    "ts-jest": "^29.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/infiniteezverse/monskills-ezpath.git"
+  },
+  "homepage": "https://skills.devnads.com"
+}