updates code after hackathon

Author: cooganb

docs/pos/payments/x402/quickstart-buyers.md

@@ -34,45 +34,88 @@ Create a wallet client using a tool like [viem](https://viem.sh/):
 npm install viem
 ```
 
-Then, instantiate the wallet account:
+Then, instantiate the wallet account and client:
 
 ```typescript
-import { createWalletClient, http } from "viem";
-import { privateKeyToAccount } from "viem/accounts";
-import { polygonAmoy } from "viem/chains";
-
-// Create a wallet client (using your private key)
-const account = privateKeyToAccount("0xYourPrivateKey"); // we recommend using an environment variable for this
+import { wrapFetchWithPayment, decodeXPaymentResponse } from "x402-fetch";
+import { createWalletClient, http } from 'viem';
+import { privateKeyToAccount } from 'viem/accounts';
+import { polygonAmoy } from 'viem/chains';
+import 'dotenv/config';
+
+const privateKey = process.env.PRIVATE_KEY;
+if (!privateKey) {
+  throw new Error("PRIVATE_KEY not set in .env file");
+}
+
+const account = privateKeyToAccount(`0x${privateKey}`);
+const client = createWalletClient({
+  account,
+  chain: polygonAmoy,
+  transport: http()
+});
+
+console.log("Using wallet address:", account.address);
 ```
 
 ## 3. Make Paid Requests Automatically
 
 You can use either `x402-fetch` or `x402-axios` to automatically handle 402 Payment Required responses and complete payment flows.
 
 !!! info x402-fetch
-    **x402-fetch** extends the native `fetch` API to handle 402 responses and payment headers for you. [Full example from Coinbase here](https://github.com/coinbase/x402/tree/main/examples/typescript/clients/fetch)
+    **x402-fetch** extends the native `fetch` API to handle 402 responses and payment headers for you. [Full example here](https://github.com/AkshatGada/x402_Polygon/blob/feature/facilitator-amoy/demo/quickstart-local/buyer_x402.js)
 
 ```typescript
 import { wrapFetchWithPayment, decodeXPaymentResponse } from "x402-fetch";
 // other imports...
 
 // wallet creation logic...
 
-const fetchWithPayment = wrapFetchWithPayment(fetch, account);
+const FACILITATOR_URL = process.env.FACILITATOR_URL || "https://facilitator.x402.rs";
+
+const fetchWithPayment = wrapFetchWithPayment(fetch, client);
+
+const url = process.env.QUICKSTART_RESOURCE_URL || 'http://127.0.0.1:4021/weather';
 
 fetchWithPayment(url, { //url should be something like https://api.example.com/paid-endpoint
   method: "GET",
 })
   .then(async response => {
     const body = await response.json();
-    console.log(body);
-
-    const paymentResponse = decodeXPaymentResponse(response.headers.get("x-payment-response")!);
-    console.log(paymentResponse);
+    console.log('Response body:', body);
+
+    // Only try to decode payment response if we got the weather data (not the 402 response)
+    if (body.report) {
+      console.log('All response headers:', Object.fromEntries(response.headers.entries()));
+      const rawPaymentResponse = response.headers.get("x-payment-response");
+      console.log('Raw x-payment-response:', rawPaymentResponse);
+
+      try {
+        const paymentResponse = decodeXPaymentResponse(rawPaymentResponse);
+        console.log('Decoded payment response:', paymentResponse);
+      } catch (e) {
+        console.error('Error decoding payment response:', e);
+        console.error('Failed to decode response:', rawPaymentResponse);
+        throw e;
+      }
+    }
   })
-  .catch(error => {
-    console.error(error.response?.data?.error);
-  });
+  .catch(async error => {
+    console.error('Error:', error.message);
+    if (error.response) {
+      try {
+        const text = await error.response.text();
+        console.error('Response text:', text);
+        console.error('Response status:', error.response.status);
+        console.error('Response headers:', error.response.headers);
+      } catch (e) {
+        console.error('Error reading response:', e);
+        console.error('Raw error:', error);
+      }
+    } else {
+      console.error('Raw error:', error);
+    }
+  }); 
 ```
 
 ## 4. Error Handling

docs/pos/payments/x402/quickstart-sellers.md

@@ -12,10 +12,12 @@ Before you begin, ensure you have:
 * [Node.js](https://nodejs.org/en) and npm (or Python and pip) installed
 * An existing API or server
 
-**Note**\
-There are pre-configured examples available in the Coinbase repo for both
- [Node.js](https://github.com/coinbase/x402/tree/main/examples/typescript/servers). We also have an [advanced example](https://github.com/coinbase/x402/tree/main/examples/typescript/servers/advanced) 
- that shows how to use the x402 SDKs to build a more complex payment flow.
+**Note**
+
+There are pre-configured examples available in the Coinbase repo for
+ [Node.js](https://github.com/coinbase/x402/tree/main/examples/typescript/servers). 
+There is also an [advanced example](https://github.com/coinbase/x402/tree/main/examples/typescript/servers/advanced)
+that shows how to use the x402 SDKs to build a more complex payment flow.
 The following example shows how to adapt these for Polygon.
 
 ## 1. Install Dependencies
@@ -33,8 +35,6 @@ Install the [x402 Next.js middleware package](https://www.npmjs.com/package/x402
 npm install x402-next
 ```
 
-Install the [x402 Hono middleware package](https://www.npmjs.com/package/x402-hono).
-
 ```bash
 npm install x402-hono
 ```
@@ -54,10 +54,10 @@ Integrate the payment middleware into your application. You will need
 to provide:
 
 * The Facilitator URL or facilitator object. For testing, 
-use `https://x402.org/facilitator` which works on Base Sepolia.
+use `https://facilitator.x402.rs/` which works on Polygon Mainnet and Amoy.
 * For more information on running in production on mainnet, check 
 out [CDP's Quickstart for Sellers](https://docs.cdp.coinbase.com/x402/docs/
-quickstart-sellers)
+quickstart-sellers). For a facilitator access on Polygon, please contact us [here.](https://t.me/PolygonHQ/32)
 * The routes you want to protect.
 * Your receiving wallet address.
 
@@ -68,21 +68,39 @@ Please adapt for Polygon.
 
 ```javascript
 import express from "express";
-import { paymentMiddleware, Network } from "x402-express";
+import { paymentMiddleware } from "x402-express";
+// import { facilitator } from "@coinbase/x402"; // For mainnet
 
 const app = express();
 
 app.use(paymentMiddleware(
-  "0xYourAddress", // your receiving wallet address 
+  "0xCA3953e536bDA86D1F152eEfA8aC7b0C82b6eC00", // receiving wallet address
   {  // Route configurations for protected endpoints
-      "GET /weather": {
-        // USDC amount in dollars
-        price: "$0.001",
-        network: "polygon-amoy",
-      },
+    "GET /weather": {
+      // USDC amount in dollars
+      price: "$0.001",
+      network: "polygon-amoy",
+      // Optional: Add metadata for better discovery in x402 Bazaar
+      config: {
+        description: "Get current weather data for any location",
+        inputSchema: {
+          type: "object",
+          properties: {
+            location: { type: "string", description: "City name" }
+          }
+        },
+        outputSchema: {
+          type: "object",
+          properties: {
+            weather: { type: "string" },
+            temperature: { type: "number" }
+          }
+        }
+      }
     },
+  },
   {
-    url: "https://facilitator.x402.rs/", // Facilitator URL for Polygon Amoy testnet. 
+    url: process.env.FACILITATOR_URL || "https://facilitator.x402.rs", // Polygon Amoy facilitator
   }
 ));
 
@@ -98,10 +116,10 @@ app.get("/weather", (req, res) => {
 
 app.listen(4021, () => {
   console.log(`Server listening at http://localhost:4021`);
-});
+}); 
 ```
 
-Full example in the repo [here](https://github.com/coinbase/x402/tree/main/examples/typescript/fullstack/next). 
+Full example in the repo [here](https://github.com/AkshatGada/x402_Polygon/blob/feature/facilitator-amoy/demo/quickstart-local/seller_x402.js). 
 Since this is a fullstack example, we recommend using the example to build
 this yourself, and treat the code snippet below as a reference to adapt for
 Polygon.
@@ -115,7 +133,7 @@ export const middleware = paymentMiddleware(
   {  // Route configurations for protected endpoints
     '/protected': {
       price: '$0.01',
-      network: "base-sepolia",
+      network: "polygon-amoy",
       config: {
         description: 'Access to protected content'
       }

mkdocs.yml

@@ -69,8 +69,8 @@ nav:
           - USDC: pos/transfers/transfer-usdc.md
         - x402:
           - Overview: pos/payments/x402/overview.md
-          - Quickstart for Buyers: pos/payments/x402/buyers.md
-          - Quickstart for Sellers: pos/payments/x402/sellers.md
+          - Quickstart for Buyers: pos/payments/x402/quickstart-buyers.md
+          - Quickstart for Sellers: pos/payments/x402/quickstart-sellers.md
       - Node how-tos:
         - Prerequisites: pos/how-to/prerequisites.md
         - Sync node using snapshots: pos/how-to/snapshots.md