@goplausible/algorand-mcp 4.3.1 → 4.3.2

package/dist/tools/utilityManager.js

@@ -86,7 +86,7 @@ export class UtilityManager {
                                 type: 'text',
                                 text: JSON.stringify({
                                     name: 'Algorand MCP Server',
-                                    version: '4.3.1',
+                                    version: '4.3.2',
                                     builder: 'GoPlausible',
                                     description: 'A Model Context Protocol (MCP) server providing comprehensive access to the Algorand blockchain. Supports account management, transaction building and signing, smart contract interaction, asset operations, ARC-26 URI generation, and deep integration with Algorand ecosystem services including NFDomains, Tinyman, Vestige, and Ultrade.',
                                     blockchain: 'Algorand — a carbon-negative, pure proof-of-stake Layer 1 blockchain delivering instant finality, low fees, and advanced smart contract capabilities via AVM (Algorand Virtual Machine).',

package/dist/tools/x402Manager.d.ts

@@ -12,6 +12,15 @@ export declare class X402Manager {
     }>;
     private static handleDiscover;
     private static handlePaidRequest;
+    /**
+     * Returns the amount field from a PaymentRequirement, supporting both x402
+     * spec versions:
+     *   - V2 (current): `amount`
+     *   - V1 (legacy):  `maxAmountRequired`
+     * Prefers V2 if both are set (V2 deployments may include both for compat).
+     */
+    private static getRequirementAmount;
+    private static isValidPaymentRequiredResponse;
     private static discover;
     private static selectRequirement;
     private static buildPaymentHeader;

package/dist/tools/x402Manager.js

@@ -108,7 +108,10 @@ export class X402Manager {
             throw new McpError(ErrorCode.InvalidRequest, `Payment rejected by server: ${X402Manager.snippet(response.bodyText)}`);
         }
         const result = X402Manager.tryParseJson(response.bodyText) ?? response.bodyText;
-        const paymentResponseHeader = response.headers['x-payment-response'] ?? response.headers['X-PAYMENT-RESPONSE'];
+        // Algorand x402 V2 uses lowercase `payment-response`; older deployments
+        // may use Coinbase's `x-payment-response`. Accept either.
+        const paymentResponseHeader = response.headers['payment-response']
+            ?? response.headers['x-payment-response'];
         return X402Manager.textResponse({
             result,
             status: response.status,
@@ -116,27 +119,51 @@ export class X402Manager {
             paid: {
                 network: mcpNetwork,
                 asset: requirement.asset,
-                amount: requirement.maxAmountRequired,
+                amount: X402Manager.getRequirementAmount(requirement),
                 payTo: requirement.payTo,
             },
             extensions,
         });
     }
     // ── x402 protocol helpers ──────────────────────────────────────────────────
+    /**
+     * Returns the amount field from a PaymentRequirement, supporting both x402
+     * spec versions:
+     *   - V2 (current): `amount`
+     *   - V1 (legacy):  `maxAmountRequired`
+     * Prefers V2 if both are set (V2 deployments may include both for compat).
+     */
+    static getRequirementAmount(req) {
+        return req.amount ?? req.maxAmountRequired;
+    }
+    static isValidPaymentRequiredResponse(v) {
+        return !!v
+            && typeof v === 'object'
+            && typeof v.x402Version === 'number'
+            && Array.isArray(v.accepts);
+    }
     static async discover(opts) {
         const response = await X402Manager.httpRequest(opts);
-        if (response.status !== 402) {
-            return { status: response.status, x402: false, rawBody: X402Manager.tryParseJson(response.bodyText) ?? response.bodyText };
+        // 1. Canonical Algorand x402 V2 transport: requirements arrive in the
+        //    `payment-required` HTTP header as base64-encoded JSON. The body is
+        //    usually empty (`{}`). Check this first.
+        const headerPayload = response.headers['payment-required'];
+        if (headerPayload) {
+            const decoded = X402Manager.decodeBase64Json(headerPayload);
+            if (X402Manager.isValidPaymentRequiredResponse(decoded)) {
+                return { status: response.status, x402: true, accepts: decoded.accepts, x402Version: decoded.x402Version };
+            }
         }
-        const parsed = X402Manager.tryParseJson(response.bodyText);
-        if (!parsed ||
-            typeof parsed !== 'object' ||
-            typeof parsed.x402Version !== 'number' ||
-            !Array.isArray(parsed.accepts)) {
+        // 2. Fallback transport (some x402 servers put requirements in the 402 body).
+        if (response.status === 402) {
+            const parsed = X402Manager.tryParseJson(response.bodyText);
+            if (X402Manager.isValidPaymentRequiredResponse(parsed)) {
+                return { status: 402, x402: true, accepts: parsed.accepts, x402Version: parsed.x402Version };
+            }
             return { status: 402, x402: false, rawBody: parsed ?? response.bodyText };
         }
-        const body = parsed;
-        return { status: 402, x402: true, accepts: body.accepts, x402Version: body.x402Version };
+        // 3. Not an x402-protected response at all.
+        return { status: response.status, x402: false, rawBody: X402Manager.tryParseJson(response.bodyText) ?? response.bodyText };
     }
     static selectRequirement(accepts, preferredNetwork, maxAmountPerRequest) {
         // Map each accepts entry to its MCP network (or null if non-Algorand).
@@ -146,10 +173,11 @@ export class X402Manager {
         if (ranked.length === 0) {
             throw new McpError(ErrorCode.InvalidRequest, `No payment requirement is satisfiable on Algorand. Endpoint accepts networks: [${accepts.map(r => r.network).join(', ')}]`);
         }
-        const inBudget = (req) => maxAmountPerRequest === undefined || Number(req.maxAmountRequired) <= maxAmountPerRequest;
+        const amountOf = (req) => Number(X402Manager.getRequirementAmount(req));
+        const inBudget = (req) => maxAmountPerRequest === undefined || amountOf(req) <= maxAmountPerRequest;
         const affordable = ranked.filter(e => inBudget(e.req));
         if (affordable.length === 0) {
-            throw new McpError(ErrorCode.InvalidRequest, `All Algorand payment requirements exceed maxAmountPerRequest=${maxAmountPerRequest}. Cheapest: ${Math.min(...ranked.map(e => Number(e.req.maxAmountRequired)))}.`);
+            throw new McpError(ErrorCode.InvalidRequest, `All Algorand payment requirements exceed maxAmountPerRequest=${maxAmountPerRequest}. Cheapest: ${Math.min(...ranked.map(e => amountOf(e.req)))}.`);
         }
         if (preferredNetwork) {
             const preferred = affordable.find(e => e.mcpNetwork === preferredNetwork);
@@ -157,7 +185,7 @@ export class X402Manager {
                 return { requirement: preferred.req, mcpNetwork: preferred.mcpNetwork };
         }
         // No preference (or preference not matched): pick the cheapest affordable.
-        const chosen = affordable.reduce((a, b) => Number(a.req.maxAmountRequired) <= Number(b.req.maxAmountRequired) ? a : b);
+        const chosen = affordable.reduce((a, b) => amountOf(a.req) <= amountOf(b.req) ? a : b);
         return { requirement: chosen.req, mcpNetwork: chosen.mcpNetwork };
     }
     static async buildPaymentHeader(requirement, mcpNetwork) {
@@ -165,9 +193,10 @@ export class X402Manager {
         if (!feePayer || typeof feePayer !== 'string') {
             throw new McpError(ErrorCode.InvalidRequest, 'Payment requirement is missing `extra.feePayer` (facilitator address).');
         }
-        const amount = Number(requirement.maxAmountRequired);
+        const amountStr = X402Manager.getRequirementAmount(requirement);
+        const amount = Number(amountStr);
         if (!Number.isFinite(amount) || amount < 0) {
-            throw new McpError(ErrorCode.InvalidRequest, `Invalid maxAmountRequired: ${requirement.maxAmountRequired}`);
+            throw new McpError(ErrorCode.InvalidRequest, `Invalid payment amount: ${amountStr ?? '(missing `amount` / `maxAmountRequired` field)'}`);
         }
         const account = await WalletManager.getActiveWalletAccount();
         const sk = await WalletManager.getActiveWalletSecretKey();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goplausible/algorand-mcp",
-  "version": "4.3.1",
+  "version": "4.3.2",
   "publishConfig": {
     "access": "public"
   },