@puga-labs/x402-mantle-sdk 0.4.1 → 0.4.2

package/README.md

@@ -3,7 +3,7 @@
 [![npm version](https://img.shields.io/npm/v/@puga-labs/x402-mantle-sdk.svg)](https://www.npmjs.com/package/@puga-labs/x402-mantle-sdk)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-SDK for x402 payments on Mantle blockchain. Protect your APIs with USDC payments using a simple middleware.
+SDK for gasless x402 payments on Mantle blockchain using USDC (EIP-3009). Protect your APIs with crypto payments — users sign, facilitator pays gas.
 
 ## Installation
 
@@ -30,9 +30,8 @@ npm install @puga-labs/x402-mantle-sdk
 import { useMantleX402 } from '@puga-labs/x402-mantle-sdk/react';
 
 function PaymentButton() {
-  const { postWithPayment } = useMantleX402({
-    facilitatorUrl: 'https://facilitator.x402mantlesdk.xyz'
-  });
+  // facilitatorUrl auto-detected from backend 402 response
+  const { postWithPayment } = useMantleX402();
 
   const handlePay = async () => {
     try {
@@ -87,9 +86,8 @@ function WalletConnect() {
 ```typescript
 import { createMantleClient } from '@puga-labs/x402-mantle-sdk/client';
 
-// Create client
+// Create client (facilitatorUrl auto-detected from backend)
 const client = createMantleClient({
-  facilitatorUrl: 'https://facilitator.x402mantlesdk.xyz',
   resourceUrl: 'https://your-api.com',
   getProvider: () => window.ethereum,
   getAccount: () => userAddress
@@ -108,9 +106,9 @@ For full control over the payment flow:
 ```typescript
 import { createPaymentClient } from '@puga-labs/x402-mantle-sdk/client';
 
+// Low-level client (facilitatorUrl auto-detected from backend)
 const paymentClient = createPaymentClient({
   resourceUrl: 'https://your-api.com',
-  facilitatorUrl: 'https://facilitator.x402mantlesdk.xyz',
   provider: window.ethereum,
   userAddress: '0x...' // Optional
 });
@@ -133,11 +131,11 @@ import { mantlePaywall } from '@puga-labs/x402-mantle-sdk/server/express';
 const app = express();
 app.use(express.json());
 
-// Create paywall middleware
+// Create paywall middleware (hosted mode - facilitatorUrl auto-detected)
 const pay = mantlePaywall({
   priceUsd: 0.01,
   payTo: '0xYourWalletAddress',
-  facilitatorUrl: 'https://facilitator.x402mantlesdk.xyz'
+  projectKey: 'pk_xxx' // Get from https://x402mantlesdk.xyz/dashboard
 });
 
 // Protected route
@@ -165,7 +163,7 @@ import { NextRequest, NextResponse } from 'next/server';
 const pay = mantlePaywall({
   priceUsd: 0.01,
   payTo: '0xYourWalletAddress',
-  facilitatorUrl: 'https://facilitator.x402mantlesdk.xyz'
+  projectKey: 'pk_xxx' // Get from dashboard
 });
 
 export const POST = pay(async (req: NextRequest) => {
@@ -186,7 +184,7 @@ const app = new Hono();
 const pay = mantlePaywall({
   priceUsd: 0.01,
   payTo: '0xYourWalletAddress',
-  facilitatorUrl: 'https://facilitator.x402mantlesdk.xyz'
+  projectKey: 'pk_xxx' // Get from dashboard
 });
 
 app.post('/api/generate', pay(async (c) => {
@@ -205,7 +203,7 @@ import { mantlePaywall } from '@puga-labs/x402-mantle-sdk/server/web';
 const pay = mantlePaywall({
   priceUsd: 0.01,
   payTo: '0xYourWalletAddress',
-  facilitatorUrl: 'https://facilitator.x402mantlesdk.xyz'
+  projectKey: 'pk_xxx' // Get from dashboard
 });
 
 export default {
@@ -231,7 +229,7 @@ import { mantlePaywall } from '@puga-labs/x402-mantle-sdk/server/web';
 const pay = mantlePaywall({
   priceUsd: 0.01,
   payTo: '0xYourWalletAddress',
-  facilitatorUrl: 'https://facilitator.x402mantlesdk.xyz'
+  projectKey: 'pk_xxx' // Get from dashboard
 });
 
 Deno.serve(pay(async (req) => {
@@ -317,7 +315,7 @@ The `facilitatorSecret` is **required** for self-hosted facilitators to prevent
 
 Create a facilitator with:
 ```bash
-npx create-mantle-facilitator my-facilitator
+npx create-mantle-facilitator
 ```
 
 After setup, copy `FACILITATOR_SECRET` from the generated `.env` file to your backend's environment variables.
@@ -332,7 +330,6 @@ Track payments with built-in analytics:
 const pay = mantlePaywall({
   priceUsd: 0.01,
   payTo: '0x...',
-  facilitatorUrl: 'https://facilitator.x402mantlesdk.xyz',
   projectKey: 'pk_xxx',  // Get from dashboard - used for both billing AND analytics
 
   // Optional: Advanced telemetry config
@@ -429,6 +426,23 @@ import { mantlePaywall } from '@puga-labs/x402-mantle-sdk/server/web';
 |---------|----------|--------------|----------|
 | Mantle Mainnet | 5000 | `0x09Bc4E0D864854c6aFB6eB9A9cdF58aC190D0dF9` | 6 |
 
+## Supported Tokens
+
+Currently, the SDK supports **USDC only** for gasless payments.
+
+### Why only USDC?
+
+Gasless payments via facilitator require tokens that implement the **EIP-3009** standard (`transferWithAuthorization`). This standard allows users to sign a payment authorization off-chain, while the facilitator submits the transaction and pays gas fees.
+
+On Mantle mainnet, **USDC is currently the only token** that implements EIP-3009. As other stablecoins and tokens adopt this standard, we will add support for them in the SDK and facilitator.
+
+| Token | EIP-3009 Support | Status |
+|-------|------------------|--------|
+| USDC | Yes | Supported |
+| USDT | No | Not available |
+| DAI | No | Not available |
+| Other tokens | — | Pending EIP-3009 adoption |
+
 ### Price Conversion
 
 - `priceUsd: 0.01` = 1 cent = 10,000 atomic units

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@puga-labs/x402-mantle-sdk",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "x402 payments SDK for Mantle (USDC, gasless, facilitator-based)",
   "license": "MIT",
   "author": "Evgenii Pugachev <cyprus.pugamuga@gmail.com>",