@atxp/client 0.10.6 → 0.10.8

package/dist/x402ProtocolHandler.js

@@ -0,0 +1,166 @@
+import { ATXPPaymentError } from './errors.js';
+import { BigNumber } from 'bignumber.js';
+import { PaymentClient, buildPaymentHeaders } from './paymentClient.js';
+
+function isX402Challenge(obj) {
+    if (typeof obj !== 'object' || obj === null)
+        return false;
+    const candidate = obj;
+    return (typeof candidate.x402Version !== 'undefined' &&
+        Array.isArray(candidate.accepts));
+}
+/**
+ * Protocol handler for X402 payment challenges.
+ *
+ * Detects HTTP 402 responses with x402Version in the JSON body.
+ * Creates payment headers using the x402 library and retries the request.
+ */
+class X402ProtocolHandler {
+    constructor(config) {
+        this.protocol = 'x402';
+        this.accountsServer = config?.accountsServer ?? 'https://accounts.atxp.ai';
+    }
+    async canHandle(response) {
+        if (response.status !== 402)
+            return false;
+        try {
+            const cloned = response.clone();
+            const body = await cloned.text();
+            const parsed = JSON.parse(body);
+            return isX402Challenge(parsed);
+        }
+        catch {
+            return false;
+        }
+    }
+    async handlePaymentChallenge(response, originalRequest, config) {
+        const { account, logger, fetchFn, approvePayment, onPayment, onPaymentFailure } = config;
+        const responseBody = await response.text();
+        let paymentChallenge;
+        try {
+            paymentChallenge = JSON.parse(responseBody);
+        }
+        catch {
+            logger.error('X402: failed to parse challenge body');
+            return null;
+        }
+        if (!isX402Challenge(paymentChallenge)) {
+            return null;
+        }
+        try {
+            const { selectPaymentRequirements } = await import('x402/client');
+            const selectedPaymentRequirements = selectPaymentRequirements(paymentChallenge.accepts, undefined, 'exact');
+            if (!selectedPaymentRequirements) {
+                logger.info('X402: no suitable payment option found');
+                return this.reconstructResponse(responseBody, response);
+            }
+            const amountInUsdc = Number(selectedPaymentRequirements.maxAmountRequired) / (10 ** 6);
+            const network = selectedPaymentRequirements.network;
+            logger.debug(`X402: payment required: ${amountInUsdc} USDC on ${network} to ${selectedPaymentRequirements.payTo}`);
+            const url = typeof originalRequest.url === 'string' ? originalRequest.url : originalRequest.url.toString();
+            const accountId = await account.getAccountId();
+            const prospectivePayment = {
+                accountId,
+                resourceUrl: url,
+                resourceName: selectedPaymentRequirements.description || url,
+                currency: 'USDC',
+                amount: new BigNumber(amountInUsdc),
+                iss: selectedPaymentRequirements.payTo
+            };
+            const approved = await approvePayment(prospectivePayment);
+            if (!approved) {
+                logger.info('X402: payment not approved');
+                const error = new Error('Payment not approved');
+                await onPaymentFailure({
+                    payment: prospectivePayment,
+                    error,
+                    attemptedNetworks: [network],
+                    failureReasons: new Map([[network, error]]),
+                    retryable: true,
+                    timestamp: new Date()
+                });
+                return this.reconstructResponse(responseBody, response);
+            }
+            // Authorize via account.authorize() — ATXPAccount calls the accounts
+            // service, BaseAccount signs locally. No fallback — each account type
+            // handles authorization according to its capabilities.
+            const client = new PaymentClient({
+                accountsServer: this.accountsServer,
+                logger,
+                fetchFn,
+            });
+            const authorizeResult = await client.authorize({
+                account,
+                userId: accountId,
+                destination: url,
+                protocol: 'x402',
+                paymentRequirements: selectedPaymentRequirements,
+            });
+            const paymentHeader = authorizeResult.credential;
+            // Retry with X-PAYMENT header
+            const retryHeaders = buildPaymentHeaders({ protocol: 'x402', credential: paymentHeader }, originalRequest.init?.headers);
+            const retryInit = { ...originalRequest.init, headers: retryHeaders };
+            logger.info('X402: retrying request with X-PAYMENT header');
+            const retryResponse = await fetchFn(originalRequest.url, retryInit);
+            if (retryResponse.ok) {
+                logger.info('X402: payment accepted');
+                await onPayment({
+                    payment: prospectivePayment,
+                    transactionHash: paymentHeader.substring(0, 66),
+                    network
+                });
+            }
+            else {
+                logger.warn(`X402: request failed after payment with status ${retryResponse.status}`);
+                const error = new Error(`Request failed with status ${retryResponse.status}`);
+                await onPaymentFailure({
+                    payment: prospectivePayment,
+                    error,
+                    attemptedNetworks: [network],
+                    failureReasons: new Map([[network, error]]),
+                    retryable: false,
+                    timestamp: new Date()
+                });
+            }
+            return retryResponse;
+        }
+        catch (error) {
+            logger.error(`X402: failed to handle payment challenge: ${error}`);
+            if (isX402Challenge(paymentChallenge) && paymentChallenge.accepts[0]) {
+                const firstOption = paymentChallenge.accepts[0];
+                const amount = firstOption.maxAmountRequired ? Number(firstOption.maxAmountRequired) / (10 ** 6) : 0;
+                const url = typeof originalRequest.url === 'string' ? originalRequest.url : originalRequest.url.toString();
+                const accountId = await account.getAccountId();
+                const errorNetwork = firstOption.network || 'unknown';
+                const typedError = error;
+                const isRetryable = typedError instanceof ATXPPaymentError ? typedError.retryable : true;
+                await onPaymentFailure({
+                    payment: {
+                        accountId,
+                        resourceUrl: url,
+                        resourceName: firstOption.description || url,
+                        currency: 'USDC',
+                        amount: new BigNumber(amount),
+                        iss: firstOption.payTo || ''
+                    },
+                    error: typedError,
+                    attemptedNetworks: [errorNetwork],
+                    failureReasons: new Map([[errorNetwork, typedError]]),
+                    retryable: isRetryable,
+                    timestamp: new Date()
+                });
+            }
+            return this.reconstructResponse(responseBody, response);
+        }
+    }
+    reconstructResponse(body, original) {
+        return new Response(body, {
+            status: original.status,
+            statusText: original.statusText,
+            headers: original.headers
+        });
+    }
+}
+
+export { X402ProtocolHandler };
+//# sourceMappingURL=x402ProtocolHandler.js.map

package/dist/x402ProtocolHandler.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atxp/client",
-  "version": "0.10.6",
+  "version": "0.10.8",
   "description": "ATXP Client - MCP client with OAuth authentication and payment processing",
   "license": "MIT",
   "repository": {
@@ -33,10 +33,12 @@
     "pack:dry": "npm pack --dry-run"
   },
   "dependencies": {
-    "@atxp/common": "0.10.6",
+    "@atxp/common": "0.10.8",
+    "@atxp/mpp": "0.10.7",
     "@modelcontextprotocol/sdk": "^1.15.0",
     "bignumber.js": "^9.3.0",
-    "oauth4webapi": "^3.8.3"
+    "oauth4webapi": "^3.8.3",
+    "x402": "^1.1.0"
   },
   "peerDependencies": {
     "expo-crypto": ">=14.0.0",