Merge branch 'main' into starknet

Author: kamalbuilds

README.md

@@ -1,13 +1,13 @@
 # x402 payments protocol
 
-> "1 line of code to accept digital dollars. No fee, 2 second settlement, $0.001 minimum payment."
+> "1 line of code to accept digital dollars. No fees, 2-second settlement, $0.001 minimum payment."
 
 ```typescript
 app.use(
   // How much you want to charge, and where you want the funds to land
   paymentMiddleware("0xYourAddress", { "/your-endpoint": "$0.01" })
 );
-// That's it! See examples/typescript/servers/express.ts for a complete example. Instruction below for running on base-sepolia.
+// That's it! See examples/typescript/servers/express/index.ts for a complete example. Instruction below for running on base-sepolia.
 ```
 
 ## Philosophy

examples/typescript/clients/axios/index.ts

@@ -36,8 +36,11 @@ async function main(): Promise<void> {
   const response = await api.get(endpointPath);
   console.log(response.data);
 
-  const paymentResponse = decodeXPaymentResponse(response.headers["x-payment-response"]);
-  console.log(paymentResponse);
+  const paymentResponseHeader = response.headers["x-payment-response"];
+  if (paymentResponseHeader) {
+    const paymentResponse = decodeXPaymentResponse(paymentResponseHeader);
+    console.log(paymentResponse);
+  }
 }
 
 main();

examples/typescript/clients/fetch/index.ts

@@ -30,8 +30,11 @@ async function main(): Promise<void> {
   const body = await response.json();
   console.log(body);
 
-  const paymentResponse = decodeXPaymentResponse(response.headers.get("x-payment-response")!);
-  console.log(paymentResponse);
+  const paymentResponseHeader = response.headers.get("x-payment-response");
+  if (paymentResponseHeader) {
+    const paymentResponse = decodeXPaymentResponse(paymentResponseHeader);
+    console.log(paymentResponse);
+  }
 }
 
 main().catch(error => {

examples/typescript/dynamic_agent/package.json

@@ -20,9 +20,9 @@
     "hono": "^4.7.7",
     "llamaindex": "^0.10.2",
     "viem": "^2.28.3",
-    "x402": "^0.2.0",
-    "x402-axios": "^0.1.0",
-    "x402-hono": "^0.1.0",
+    "x402": "workspace:*",
+    "x402-axios": "workspace:*",
+    "x402-hono": "workspace:*",
     "zod": "^3.24.3"
   },
   "devDependencies": {

examples/typescript/fullstack/auth_based_pricing/backend.ts

@@ -11,7 +11,8 @@ import {
   Network as X402Network,
   Resource as X402Resource,
   PaymentPayload,
-  settleResponseHeader
+  settleResponseHeader,
+  ERC20TokenAmount
 } from 'x402/types';
 import { useFacilitator } from 'x402/verify';
 import { exact } from 'x402/schemes';
@@ -70,6 +71,7 @@ function createExactPaymentRequirements(
     throw new Error(`Failed to process price: ${atomicAmountForAsset.error}`);
   }
   const { maxAmountRequired, asset } = atomicAmountForAsset;
+  const erc20Asset = asset as ERC20TokenAmount["asset"];
   return {
     scheme: "exact",
     network,
@@ -79,9 +81,9 @@ function createExactPaymentRequirements(
     mimeType: "application/json", // Content type of the protected resource
     payTo: BUSINESS_WALLET_ADDRESS,
     maxTimeoutSeconds: 60, // Client has 60s to complete payment after challenge
-    asset: asset.address, // e.g., USDC contract address on the specified network
+    asset: erc20Asset.address, // e.g., USDC contract address on the specified network
     outputSchema: undefined, // Optional: JSON schema for the expected response after payment
-    extra: { name: asset.eip712.name, version: asset.eip712.version }, // EIP-712 domain info for the payment asset
+    extra: { name: erc20Asset.eip712.name, version: erc20Asset.eip712.version }, // EIP-712 domain info for the payment asset
   };
 }
 

examples/typescript/fullstack/auth_based_pricing/package.json

@@ -23,16 +23,16 @@
   "author": "Your Name",
   "license": "MIT",
   "dependencies": {
-    "@coinbase/x402": "^0.3.3",
+    "@coinbase/x402": "workspace:*",
     "@hono/node-server": "^1.11.2",
     "dotenv": "^16.4.5",
     "hono": "^4.4.0",
     "node-fetch": "^3.3.2",
     "siwe": "^2.3.2",
     "viem": "^2.13.8",
-    "x402": "^0.3.2",
-    "x402-fetch": "^0.3.2",
-    "x402-hono": "^0.3.2"
+    "x402": "workspace:*",
+    "x402-fetch": "workspace:*",
+    "x402-hono": "workspace:*"
   },
   "devDependencies": {
     "@types/node": "^20.14.2",

examples/typescript/fullstack/browser-wallet-example/server/.env.example renamed to examples/typescript/fullstack/browser-wallet-example/.env.example

@@ -36,12 +36,12 @@ Learn more at [x402.org](https://x402.org) or check out the [GitHub repository](
 ### 1. Install Dependencies
 
 ```bash
-npm run install:all
+pnpm install:all
 ```
 
 ### 2. Configure the Server
 
-Create `server/.env`:
+Create `.env`:
 ```env
 FACILITATOR_URL=https://x402.org/facilitator
 NETWORK=base-sepolia
@@ -52,7 +52,7 @@ PORT=3001
 ### 3. Run Both Server and Client
 
 ```bash
-npm run dev
+pnpm dev
 ```
 
 This starts: