@varun-ai07/covenant-mcp 1.2.0 → 1.2.1

package/dist/utils.js

@@ -0,0 +1,217 @@
+/**
+ * COVENANT MCP Utilities
+ * Helper functions for encoding and data conversion
+ */
+import { pad, toHex } from "viem";
+/**
+ * Convert a string to bytes32 format.
+ * Handles IPFS CIDs and other task description hashes.
+ *
+ * For strings <= 31 chars: Encodes as UTF-8 bytes, padded right
+ * For strings > 31 chars: Truncates to fit
+ * For hex strings starting with 0x: Validates length and pads if needed
+ */
+export function stringToBytes32(str) {
+    // If it's already a 0x-prefixed hex string
+    if (str.startsWith("0x")) {
+        // If it's exactly 66 chars (0x + 64 hex digits), it's already bytes32
+        if (str.length === 66) {
+            return str;
+        }
+        // If shorter, pad to 32 bytes (left-pad for numbers)
+        if (str.length < 66) {
+            return pad(str, { size: 32 });
+        }
+        // If longer, truncate
+        return str.slice(0, 66);
+    }
+    // For plaintext strings, encode to hex and pad
+    // Convert string to UTF-8 bytes, then to hex
+    const encoder = new TextEncoder();
+    const bytes = encoder.encode(str);
+    // bytes32 is 32 bytes, strings can use up to 31 bytes (last byte is length)
+    // For simplicity, we truncate to 31 bytes and pad
+    const truncatedBytes = bytes.slice(0, 31);
+    const hexString = toHex(truncatedBytes);
+    // Pad to 32 bytes (right-pad for string data)
+    return pad(hexString, { size: 32, dir: "right" });
+}
+/**
+ * Convert an array of strings to bytes32 format.
+ */
+export function stringsToBytes32(strings) {
+    return strings.map(stringToBytes32);
+}
+/**
+ * Decode bytes32 back to string (for display purposes).
+ * Falls back to hex string if not UTF-8 decodable.
+ */
+export function bytes32ToString(bytes32) {
+    try {
+        // Remove 0x prefix and decode hex as UTF-8
+        const hex = bytes32.slice(2);
+        const bytes = new Uint8Array(hex.length / 2);
+        for (let i = 0; i < hex.length; i += 2) {
+            bytes[i / 2] = parseInt(hex.slice(i, i + 2), 16);
+        }
+        // Find null terminator or trailing zeros
+        let end = bytes.findIndex(b => b === 0);
+        if (end === -1)
+            end = bytes.length;
+        const decoder = new TextDecoder();
+        return decoder.decode(bytes.slice(0, end));
+    }
+    catch {
+        // If decoding fails, return hex representation
+        return bytes32;
+    }
+}
+/**
+ * Convert a numeric ID to bytes32 format.
+ * Left-pads the number to 32 bytes.
+ */
+export function numberToBytes32(num) {
+    // Convert to hex and left-pad to 32 bytes
+    const hex = typeof num === 'bigint'
+        ? `0x${num.toString(16)}`
+        : `0x${num.toString(16)}`;
+    return pad(hex, { size: 32 });
+}
+/**
+ * Validate that a string is a valid bytes32.
+ */
+export function isBytes32(str) {
+    return /^0x[0-9a-fA-F]{64}$/.test(str);
+}
+// ============================================================
+// IPFS Gateway Configuration with Fallbacks
+// ============================================================
+// Gateway priority list (dedicated Pinata first, then public gateways)
+const IPFS_GATEWAYS = [
+    // Dedicated Pinata gateway (requires PINATA_GATEWAY in env)
+    process.env.PINATA_GATEWAY,
+    // Public Pinata gateway
+    "https://gateway.pinata.cloud",
+    // IPFS.io public gateway
+    "https://ipfs.io",
+    // Cloudflare IPFS gateway
+    "https://cloudflare-ipfs.com",
+    // dWeb gateway
+    "https://dweb.link",
+].filter(Boolean);
+// Cache for gateway health status
+const gatewayHealth = new Map();
+/**
+ * Get the best available IPFS gateway
+ */
+export function getBestGateway() {
+    // Check for dedicated gateway first
+    if (process.env.PINATA_GATEWAY) {
+        return process.env.PINATA_GATEWAY;
+    }
+    // Fall back to first available gateway
+    return IPFS_GATEWAYS[0] || "https://ipfs.io";
+}
+/**
+ * Build an IPFS URL for a CID
+ */
+export function buildIpfsUrl(cid, gateway) {
+    const gw = gateway || getBestGateway();
+    // Handle different CID formats
+    if (cid.startsWith("Qm") || cid.startsWith("baf")) {
+        return `${gw}/ipfs/${cid}`;
+    }
+    // Already a URL
+    if (cid.startsWith("http")) {
+        return cid;
+    }
+    return `${gw}/ipfs/${cid}`;
+}
+/**
+ * Fetch from IPFS with gateway fallback
+ */
+export async function fetchFromIpfs(cid, timeoutMs = 30000) {
+    const errors = [];
+    // Sort gateways by health
+    const sortedGateways = [...IPFS_GATEWAYS].sort((a, b) => {
+        const healthA = gatewayHealth.get(a);
+        const healthB = gatewayHealth.get(b);
+        if (!healthA && !healthB)
+            return 0;
+        if (!healthA)
+            return 1;
+        if (!healthB)
+            return -1;
+        // Prefer lower latency and fewer failures
+        const scoreA = healthA.latency + (healthA.failures * 1000);
+        const scoreB = healthB.latency + (healthB.failures * 1000);
+        return scoreA - scoreB;
+    });
+    // Try each gateway in order
+    for (const gateway of sortedGateways) {
+        try {
+            const url = buildIpfsUrl(cid, gateway);
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+            const start = Date.now();
+            const response = await fetch(url, {
+                signal: controller.signal,
+                headers: {
+                    "Accept": "application/json, text/plain, */*",
+                    "User-Agent": "COVENANT-MCP/1.0",
+                },
+            });
+            clearTimeout(timeoutId);
+            if (response.ok) {
+                // Update health metrics
+                gatewayHealth.set(gateway, {
+                    latency: Date.now() - start,
+                    lastCheck: Date.now(),
+                    failures: gatewayHealth.get(gateway)?.failures || 0,
+                });
+                return response;
+            }
+        }
+        catch (error) {
+            errors.push(error instanceof Error ? error : new Error(String(error)));
+            // Mark gateway as failed
+            const current = gatewayHealth.get(gateway) || { latency: 0, lastCheck: 0, failures: 0 };
+            gatewayHealth.set(gateway, {
+                ...current,
+                failures: current.failures + 1,
+                lastCheck: Date.now(),
+            });
+        }
+    }
+    throw new Error(`Failed to fetch ${cid} from all gateways: ${errors.map(e => e.message).join(", ")}`);
+}
+/**
+ * Check gateway health
+ */
+export async function checkGatewayHealth() {
+    const results = {};
+    await Promise.all(IPFS_GATEWAYS.map(async (gateway) => {
+        try {
+            const start = Date.now();
+            const response = await fetch(`${gateway}/ipfs/QmUNLLsPACCz1vLxQVkXqqLX5R1X345qqfHbsf67hvA3Nn`, {
+                method: "HEAD",
+                signal: AbortSignal.timeout(5000),
+            });
+            const latency = Date.now() - start;
+            results[gateway] = {
+                healthy: response.ok,
+                latency,
+            };
+            gatewayHealth.set(gateway, {
+                latency,
+                lastCheck: Date.now(),
+                failures: response.ok ? 0 : (gatewayHealth.get(gateway)?.failures || 0) + 1,
+            });
+        }
+        catch {
+            results[gateway] = { healthy: false, latency: -1 };
+        }
+    }));
+    return results;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@varun-ai07/covenant-mcp",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "COVENANT Protocol MCP Server — AI agent access to on-chain task marketplace",
   "type": "module",
   "main": "dist/index.js",