@dexterai/x402 6.0.0-rc.5 → 6.0.1

package/examples/mcp-paid-tool.ts

@@ -0,0 +1,39 @@
+import {
+  createMcpFacilitatorProcessor, createPaidMcpTool,
+  type McpPaymentStore,
+} from '@dexterai/x402/mcp';
+
+interface CustomerContext { accountId?: string }
+
+/** Supply the application's existing durable store and report execution. */
+export function createReportTool(dependencies: {
+  sellerAddress: string;
+  store: McpPaymentStore;
+  requireAccount(context: CustomerContext): Promise<string>;
+  buildReport(arguments_: Record<string, unknown>, paymentId: string): Promise<{
+    summary: string;
+    sources: string[];
+  }>;
+}) {
+  return createPaidMcpTool<CustomerContext>({
+    name: 'report',
+    serviceScope: 'reports.example/customer-reports',
+    requirements: {
+      x402Version: 2,
+      resource: { url: 'mcp://reports.example/tools/report', mimeType: 'application/json' },
+      accepts: [{
+        scheme: 'exact', network: 'eip155:8453', amount: '10000',
+        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+        payTo: dependencies.sellerAddress, maxTimeoutSeconds: 60,
+        extra: { name: 'USD Coin', version: '2' },
+      }],
+    },
+    payments: createMcpFacilitatorProcessor({ networks: ['eip155:8453'] }),
+    store: dependencies.store,
+    authorize: (_request, context) => dependencies.requireAccount(context),
+    execute: async (request, { paymentId }) => {
+      const report = await dependencies.buildReport(request.arguments ?? {}, paymentId);
+      return { content: [{ type: 'text', text: report.summary }], structuredContent: report };
+    },
+  });
+}

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "@dexterai/x402",
-  "version": "6.0.0-rc.5",
+  "version": "6.0.1",
   "description": "Full-stack x402 SDK - add paid API monetization to any endpoint. Express middleware, React hooks, Access Pass, dynamic pricing. Solana, Base, Polygon, Arbitrum, Optimism, Avalanche, World Chain, Monad, Robinhood Chain, SKALE.",
   "author": "Dexter",
   "license": "MIT",
   "type": "module",
   "exports": {
+    "./mcp": {
+      "types": "./dist/mcp/index.d.ts",
+      "import": "./dist/mcp/index.js",
+      "require": "./dist/mcp/index.cjs"
+    },
     "./client": {
       "types": "./dist/client/index.d.ts",
       "import": "./dist/client/index.js",
@@ -62,6 +67,8 @@
     "README.md",
     "REFERENCE.md",
     "CHANGELOG.md",
+    "docs/mcp.md",
+    "examples/mcp-paid-tool.ts",
     "LICENSE",
     "assets/*.svg"
   ],
@@ -73,10 +80,7 @@
     "test:watch": "vitest",
     "test:real": "echo 'Real payment tests require funded wallets. Run: npx tsx test/real-payment-solana.ts'",
     "prepublishOnly": "npm run build",
-    "release": "npm version patch && npm publish --access public",
-    "release:minor": "npm version minor && npm publish --access public",
-    "release:major": "npm version major && npm publish --access public",
-    "release:next": "npm publish --access public --tag next"
+    "verify:tab:package": "node scripts/verify-packed-tab.mjs"
   },
   "dependencies": {
     "@dexterai/x402-ads-types": "^0.2.0",
@@ -85,18 +89,20 @@
     "@noble/hashes": "^1.8.0",
     "@solana/spl-token": "^0.4.9",
     "@solana/web3.js": "^1.98.0",
-    "@x402/core": "2.12.0",
-    "@x402/evm": "2.12.0",
-    "@x402/extensions": "2.12.0",
+    "@x402/core": "2.26.0",
+    "@x402/evm": "2.26.0",
+    "@x402/extensions": "2.26.0",
     "bs58": "^6.0.0",
     "tweetnacl": "^1.0.3"
   },
   "devDependencies": {
-    "@dexterai/vault": "0.43.3-rc.1",
+    "@dexterai/vault": "0.43.4",
+    "@modelcontextprotocol/sdk": "1.30.0",
     "@types/aws-lambda": "^8.10.161",
     "@types/express": "^5.0.6",
     "@types/node": "^22.10.0",
     "@types/react": "^18.0.0",
+    "@x402/mcp": "2.26.0",
     "ethers": "^6.13.0",
     "express": "^5.2.1",
     "react": "^18.0.0",
@@ -106,7 +112,7 @@
     "vitest": "^2.1.8"
   },
   "peerDependencies": {
-    "@dexterai/vault": "0.43.3-rc.1",
+    "@dexterai/vault": "0.43.4",
     "@solana/wallet-adapter-base": "^0.9.0",
     "react": "^18.0.0 || ^19.0.0",
     "stripe": "^20.0.0",

package/dist/x402-client-B8zdDeat.d.cts

@@ -1,146 +0,0 @@
-import { SponsoredAccessSettlementInfo, SponsoredRecommendation } from '@dexterai/x402-ads-types';
-
-/**
- * Sponsored Access (Ads for Agents) — Client Helpers
- *
- * Extract sponsored recommendations from x402 payment receipts and
- * fire impression beacons to confirm delivery to the ad network.
- *
- * Recommendations are injected by the facilitator after settlement
- * via the `extensions["sponsored-access"]` field. Publishers who enable
- * `sponsoredAccess: true` in their middleware also inject them into
- * the JSON response body as `_x402_sponsored`.
- *
- * @example
- * ```typescript
- * import { wrapFetch, getSponsoredRecommendations, fireImpressionBeacon } from '@dexterai/x402/client';
- *
- * const x402Fetch = wrapFetch(fetch, { walletPrivateKey: key });
- * const response = await x402Fetch('https://api.example.com/data');
- *
- * const recs = getSponsoredRecommendations(response);
- * if (recs) {
- *   console.log('Sponsored:', recs.map(r => `${r.sponsor}: ${r.description}`));
- *   await fireImpressionBeacon(response); // Confirm delivery to ad network
- * }
- * ```
- */
-
-/**
- * Extract the full sponsored-access extension data from a payment receipt.
- * Returns undefined if no sponsored-access extension is present.
- */
-declare function getSponsoredAccessInfo(response: Response): SponsoredAccessSettlementInfo | undefined;
-/**
- * Extract sponsored recommendations from an x402 payment response.
- * Returns the recommendations array, or undefined if none present.
- *
- * @example
- * ```typescript
- * const recs = getSponsoredRecommendations(response);
- * if (recs) {
- *   for (const rec of recs) {
- *     console.log(`${rec.sponsor}: ${rec.description} — ${rec.resourceUrl}`);
- *   }
- * }
- * ```
- */
-declare function getSponsoredRecommendations(response: Response): SponsoredRecommendation[] | undefined;
-/**
- * Fire the impression beacon to confirm recommendation delivery to the ad network.
- * This is a fire-and-forget GET request — failures are silently ignored.
- *
- * Call this after you've read the recommendations to help the ad network
- * track delivery rates and verify impressions.
- *
- * @returns true if the beacon was fired (regardless of response), false if no beacon URL
- *
- * @example
- * ```typescript
- * const recs = getSponsoredRecommendations(response);
- * if (recs) {
- *   // Process recommendations...
- *   await fireImpressionBeacon(response);
- * }
- * ```
- */
-declare function fireImpressionBeacon(response: Response): Promise<boolean>;
-
-/**
- * x402 v2 Client
- *
- * `createX402Client`, `X402Client`, and `X402ClientConfig` are
- * @deprecated — slated for removal in `@dexterai/x402` 5.0 (~6 months out;
- * longer cycle than the 4.0 batch because there are real consumers). Use
- * `payAndFetch` from `@dexterai/x402/client` instead — it's the version-
- * agnostic 2026+ client with a discriminated-union return type. The
- * `getPaymentReceipt` helper and `PaymentReceipt` type in this file are NOT
- * deprecated; they continue to support receipt-reading on any paid response.
- *
- * Chain-agnostic client for x402 v2 payments.
- * Automatically detects 402 responses, finds a matching payment option,
- * builds the transaction with the appropriate chain adapter, and retries.
- *
- * @example
- * ```typescript
- * import { createX402Client } from '@dexterai/x402/client';
- * import { createSolanaAdapter, createEvmAdapter } from '@dexterai/x402/adapters';
- *
- * const client = createX402Client({
- *   adapters: [createSolanaAdapter(), createEvmAdapter()],
- *   wallets: {
- *     solana: solanaWallet,
- *     evm: evmWallet,
- *   },
- * });
- *
- * const response = await client.fetch(url);
- * ```
- */
-
-/**
- * Payment receipt attached to a successful x402 response.
- * Access via `getPaymentReceipt(response)`.
- */
-interface PaymentReceipt {
-    /** Whether settlement succeeded */
-    success?: boolean;
-    /** Transaction signature/hash */
-    transaction?: string;
-    /** CAIP-2 network */
-    network?: string;
-    /** Payer address */
-    payer?: string;
-    /** Protocol extensions (e.g., sponsored-access recommendations) */
-    extensions?: Record<string, unknown>;
-    /**
-     * Amount actually paid, in atomic units (e.g. '10000' for 0.01 USDC).
-     * Sourced from the payment requirement the client settled — the facilitator's
-     * PAYMENT-RESPONSE receipt does not echo the amount, so the client records it.
-     */
-    amountAtomic?: string;
-    /**
-     * Decimals of the paid asset, so `amountAtomic` can be converted to a human
-     * amount: `Number(amountAtomic) / 10 ** assetDecimals`.
-     */
-    assetDecimals?: number;
-}
-/**
- * Get the x402 payment receipt from a response, or undefined if none.
- */
-declare function getPaymentReceipt(response: Response): PaymentReceipt | undefined;
-/**
- * x402 Client interface
- *
- * @deprecated Slated for removal in `@dexterai/x402` 5.0. Use `payAndFetch`
- * directly instead of constructing a client object.
- */
-interface X402Client {
-    /**
-     * Fetch with automatic x402 payment handling.
-     * If the server returns 402, handles payment automatically and retries.
-     */
-    fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
-}
-
-export { type PaymentReceipt as P, type X402Client as X, getSponsoredAccessInfo as a, getSponsoredRecommendations as b, fireImpressionBeacon as f, getPaymentReceipt as g };

package/dist/x402-client-B8zdDeat.d.ts

@@ -1,146 +0,0 @@
-import { SponsoredAccessSettlementInfo, SponsoredRecommendation } from '@dexterai/x402-ads-types';
-
-/**
- * Sponsored Access (Ads for Agents) — Client Helpers
- *
- * Extract sponsored recommendations from x402 payment receipts and
- * fire impression beacons to confirm delivery to the ad network.
- *
- * Recommendations are injected by the facilitator after settlement
- * via the `extensions["sponsored-access"]` field. Publishers who enable
- * `sponsoredAccess: true` in their middleware also inject them into
- * the JSON response body as `_x402_sponsored`.
- *
- * @example
- * ```typescript
- * import { wrapFetch, getSponsoredRecommendations, fireImpressionBeacon } from '@dexterai/x402/client';
- *
- * const x402Fetch = wrapFetch(fetch, { walletPrivateKey: key });
- * const response = await x402Fetch('https://api.example.com/data');
- *
- * const recs = getSponsoredRecommendations(response);
- * if (recs) {
- *   console.log('Sponsored:', recs.map(r => `${r.sponsor}: ${r.description}`));
- *   await fireImpressionBeacon(response); // Confirm delivery to ad network
- * }
- * ```
- */
-
-/**
- * Extract the full sponsored-access extension data from a payment receipt.
- * Returns undefined if no sponsored-access extension is present.
- */
-declare function getSponsoredAccessInfo(response: Response): SponsoredAccessSettlementInfo | undefined;
-/**
- * Extract sponsored recommendations from an x402 payment response.
- * Returns the recommendations array, or undefined if none present.
- *
- * @example
- * ```typescript
- * const recs = getSponsoredRecommendations(response);
- * if (recs) {
- *   for (const rec of recs) {
- *     console.log(`${rec.sponsor}: ${rec.description} — ${rec.resourceUrl}`);
- *   }
- * }
- * ```
- */
-declare function getSponsoredRecommendations(response: Response): SponsoredRecommendation[] | undefined;
-/**
- * Fire the impression beacon to confirm recommendation delivery to the ad network.
- * This is a fire-and-forget GET request — failures are silently ignored.
- *
- * Call this after you've read the recommendations to help the ad network
- * track delivery rates and verify impressions.
- *
- * @returns true if the beacon was fired (regardless of response), false if no beacon URL
- *
- * @example
- * ```typescript
- * const recs = getSponsoredRecommendations(response);
- * if (recs) {
- *   // Process recommendations...
- *   await fireImpressionBeacon(response);
- * }
- * ```
- */
-declare function fireImpressionBeacon(response: Response): Promise<boolean>;
-
-/**
- * x402 v2 Client
- *
- * `createX402Client`, `X402Client`, and `X402ClientConfig` are
- * @deprecated — slated for removal in `@dexterai/x402` 5.0 (~6 months out;
- * longer cycle than the 4.0 batch because there are real consumers). Use
- * `payAndFetch` from `@dexterai/x402/client` instead — it's the version-
- * agnostic 2026+ client with a discriminated-union return type. The
- * `getPaymentReceipt` helper and `PaymentReceipt` type in this file are NOT
- * deprecated; they continue to support receipt-reading on any paid response.
- *
- * Chain-agnostic client for x402 v2 payments.
- * Automatically detects 402 responses, finds a matching payment option,
- * builds the transaction with the appropriate chain adapter, and retries.
- *
- * @example
- * ```typescript
- * import { createX402Client } from '@dexterai/x402/client';
- * import { createSolanaAdapter, createEvmAdapter } from '@dexterai/x402/adapters';
- *
- * const client = createX402Client({
- *   adapters: [createSolanaAdapter(), createEvmAdapter()],
- *   wallets: {
- *     solana: solanaWallet,
- *     evm: evmWallet,
- *   },
- * });
- *
- * const response = await client.fetch(url);
- * ```
- */
-
-/**
- * Payment receipt attached to a successful x402 response.
- * Access via `getPaymentReceipt(response)`.
- */
-interface PaymentReceipt {
-    /** Whether settlement succeeded */
-    success?: boolean;
-    /** Transaction signature/hash */
-    transaction?: string;
-    /** CAIP-2 network */
-    network?: string;
-    /** Payer address */
-    payer?: string;
-    /** Protocol extensions (e.g., sponsored-access recommendations) */
-    extensions?: Record<string, unknown>;
-    /**
-     * Amount actually paid, in atomic units (e.g. '10000' for 0.01 USDC).
-     * Sourced from the payment requirement the client settled — the facilitator's
-     * PAYMENT-RESPONSE receipt does not echo the amount, so the client records it.
-     */
-    amountAtomic?: string;
-    /**
-     * Decimals of the paid asset, so `amountAtomic` can be converted to a human
-     * amount: `Number(amountAtomic) / 10 ** assetDecimals`.
-     */
-    assetDecimals?: number;
-}
-/**
- * Get the x402 payment receipt from a response, or undefined if none.
- */
-declare function getPaymentReceipt(response: Response): PaymentReceipt | undefined;
-/**
- * x402 Client interface
- *
- * @deprecated Slated for removal in `@dexterai/x402` 5.0. Use `payAndFetch`
- * directly instead of constructing a client object.
- */
-interface X402Client {
-    /**
-     * Fetch with automatic x402 payment handling.
-     * If the server returns 402, handles payment automatically and retries.
-     */
-    fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
-}
-
-export { type PaymentReceipt as P, type X402Client as X, getSponsoredAccessInfo as a, getSponsoredRecommendations as b, fireImpressionBeacon as f, getPaymentReceipt as g };