create-x402-app 0.1.1 → 0.1.3

package/dist/index.js

@@ -31,7 +31,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "create-x402-app",
-      version: "0.1.1",
+      version: "0.1.3",
       description: "Create a new x402 pay-per-request API project",
       keywords: [
         "x402",
@@ -57,7 +57,7 @@ var require_package = __commonJS({
       },
       files: [
         "dist",
-        "template"
+        "templates"
       ],
       scripts: {
         build: "tsup",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-x402-app",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Create a new x402 pay-per-request API project",
   "keywords": [
     "x402",
@@ -26,7 +26,7 @@
   },
   "files": [
     "dist",
-    "template"
+    "templates"
   ],
   "scripts": {
     "build": "tsup",

package/templates/backend-express/README.md

@@ -0,0 +1,56 @@
+# x402 Backend - Express
+
+A robust API server with pay-per-request endpoints using x402 on Mantle Network.
+
+## Quick Start
+
+```bash
+# Install dependencies
+npm install
+
+# Configure environment
+cp .env.example .env
+# Edit .env with your App ID from https://mantle-x402.vercel.app
+
+# Start development server
+npm run dev
+```
+
+## Endpoints
+
+| Endpoint | Price | Description |
+|----------|-------|-------------|
+| `GET /` | Free | API information |
+| `GET /api/premium` | 0.001 MNT | Premium content |
+| `GET /api/weather` | 0.0005 MNT | Weather data |
+
+## Adding New Paid Endpoints
+
+```typescript
+import { x402Express } from 'x402-mantle-sdk/server'
+
+app.get(
+  '/api/my-endpoint',
+  x402Express({ price: '0.01', token: 'MNT', testnet: true }),
+  (req, res) => {
+    // Access payment info via req.x402
+    console.log('Payment verified:', req.x402.transactionHash)
+    res.json({ data: 'Your premium content' })
+  }
+)
+```
+
+## Production
+
+```bash
+# Build
+npm run build
+
+# Start production server
+npm start
+```
+
+## Learn More
+
+- [x402 Documentation](https://mantle-x402.vercel.app)
+- [Express Documentation](https://expressjs.com)

package/templates/backend-express/env.example

@@ -0,0 +1,8 @@
+# x402 Configuration
+# Get your App ID from: https://mantle-x402.vercel.app
+
+X402_APP_ID=your_app_id_here
+X402_PLATFORM_URL=https://mantle-x402.vercel.app
+
+# Server
+PORT=3000

package/templates/backend-express/gitignore

@@ -0,0 +1,4 @@
+node_modules
+dist
+.env
+*.log

package/templates/backend-express/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "x402-backend-express",
+  "version": "1.0.0",
+  "description": "x402 API server with Express",
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "cors": "^2.8.5",
+    "express": "^4.21.0",
+    "x402-mantle-sdk": "^0.2.3"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.0.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.0.0"
+  }
+}

package/templates/backend-express/src/index.ts

@@ -0,0 +1,79 @@
+import express from 'express'
+import cors from 'cors'
+import { x402Express } from 'x402-mantle-sdk/server'
+
+const app = express()
+
+// Middleware
+app.use(cors())
+app.use(express.json())
+
+// Free endpoint - API info
+app.get('/', (req, res) => {
+  res.json({
+    name: 'x402 API',
+    version: '1.0.0',
+    endpoints: {
+      info: 'GET / - API information (free)',
+      premium: 'GET /api/premium - Premium content (0.001 MNT)',
+      weather: 'GET /api/weather - Weather data (0.0005 MNT)',
+    },
+    network: 'mantle-sepolia',
+    docs: 'https://mantle-x402.vercel.app',
+  })
+})
+
+// Premium endpoint - requires 0.001 MNT
+app.get(
+  '/api/premium',
+  x402Express({ price: '0.001', token: 'MNT', testnet: true }),
+  (req, res) => {
+    res.json({
+      success: true,
+      message: 'Premium content unlocked!',
+      data: {
+        secret: 'This is premium data that required payment.',
+        timestamp: new Date().toISOString(),
+      },
+    })
+  }
+)
+
+// Weather endpoint - requires 0.0005 MNT
+app.get(
+  '/api/weather',
+  x402Express({ price: '0.0005', token: 'MNT', testnet: true }),
+  (req, res) => {
+    res.json({
+      success: true,
+      weather: {
+        location: 'San Francisco, CA',
+        temperature: 72,
+        unit: 'fahrenheit',
+        conditions: 'Sunny',
+        humidity: 45,
+        wind: '10 mph NW',
+      },
+    })
+  }
+)
+
+// Start server
+const port = Number(process.env.PORT) || 3000
+
+app.listen(port, () => {
+  console.log(`
+╔═══════════════════════════════════════════════════════════╗
+║                   x402 Express Server                      ║
+╠═══════════════════════════════════════════════════════════╣
+║  Server running on http://localhost:${port}                    ║
+║                                                             ║
+║  Endpoints:                                                 ║
+║    GET  /              - API info (free)                   ║
+║    GET  /api/premium   - Premium content (0.001 MNT)       ║
+║    GET  /api/weather   - Weather data (0.0005 MNT)         ║
+║                                                             ║
+║  Network: mantle-sepolia (testnet)                         ║
+╚═══════════════════════════════════════════════════════════╝
+  `)
+})

package/templates/backend-express/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/backend-hono/README.md

@@ -0,0 +1,57 @@
+# x402 Backend - Hono
+
+A lightweight API server with pay-per-request endpoints using x402 on Mantle Network.
+
+## Quick Start
+
+```bash
+# Install dependencies
+npm install
+
+# Configure environment
+cp .env.example .env
+# Edit .env with your App ID from https://mantle-x402.vercel.app
+
+# Start development server
+npm run dev
+```
+
+## Endpoints
+
+| Endpoint | Price | Description |
+|----------|-------|-------------|
+| `GET /` | Free | API information |
+| `GET /api/premium` | 0.001 MNT | Premium content |
+| `GET /api/weather` | 0.0005 MNT | Weather data |
+
+## Adding New Paid Endpoints
+
+```typescript
+import { x402 } from 'x402-mantle-sdk/server'
+
+// Add middleware before the route handler
+app.use('/api/my-endpoint', x402({
+  price: '0.01',
+  token: 'MNT',
+  testnet: true
+}))
+
+app.get('/api/my-endpoint', (c) => {
+  return c.json({ data: 'Your premium content' })
+})
+```
+
+## Production
+
+```bash
+# Build
+npm run build
+
+# Start production server
+npm start
+```
+
+## Learn More
+
+- [x402 Documentation](https://mantle-x402.vercel.app)
+- [Hono Documentation](https://hono.dev)

package/templates/backend-hono/env.example

@@ -0,0 +1,8 @@
+# x402 Configuration
+# Get your App ID from: https://mantle-x402.vercel.app
+
+X402_APP_ID=your_app_id_here
+X402_PLATFORM_URL=https://mantle-x402.vercel.app
+
+# Server
+PORT=3000

package/templates/backend-hono/gitignore

@@ -0,0 +1,4 @@
+node_modules
+dist
+.env
+*.log

package/templates/backend-hono/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "x402-backend-hono",
+  "version": "1.0.0",
+  "description": "x402 API server with Hono",
+  "type": "module",
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@hono/node-server": "^1.13.0",
+    "hono": "^4.6.0",
+    "x402-mantle-sdk": "^0.2.3"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.0.0"
+  }
+}

package/templates/backend-hono/src/index.ts

@@ -0,0 +1,75 @@
+import { serve } from '@hono/node-server'
+import { Hono } from 'hono'
+import { cors } from 'hono/cors'
+import { logger } from 'hono/logger'
+import { x402 } from 'x402-mantle-sdk/server'
+
+const app = new Hono()
+
+// Middleware
+app.use('*', logger())
+app.use('*', cors())
+
+// Free endpoint - API info
+app.get('/', (c) => {
+  return c.json({
+    name: 'x402 API',
+    version: '1.0.0',
+    endpoints: {
+      info: 'GET / - API information (free)',
+      premium: 'GET /api/premium - Premium content (0.001 MNT)',
+      weather: 'GET /api/weather - Weather data (0.0005 MNT)',
+    },
+    network: 'mantle-sepolia',
+    docs: 'https://mantle-x402.vercel.app',
+  })
+})
+
+// Premium endpoint - requires 0.001 MNT
+app.use('/api/premium', x402({ price: '0.001', token: 'MNT', testnet: true }))
+app.get('/api/premium', (c) => {
+  return c.json({
+    success: true,
+    message: 'Premium content unlocked!',
+    data: {
+      secret: 'This is premium data that required payment.',
+      timestamp: new Date().toISOString(),
+    },
+  })
+})
+
+// Weather endpoint - requires 0.0005 MNT
+app.use('/api/weather', x402({ price: '0.0005', token: 'MNT', testnet: true }))
+app.get('/api/weather', (c) => {
+  return c.json({
+    success: true,
+    weather: {
+      location: 'San Francisco, CA',
+      temperature: 72,
+      unit: 'fahrenheit',
+      conditions: 'Sunny',
+      humidity: 45,
+      wind: '10 mph NW',
+    },
+  })
+})
+
+// Start server
+const port = Number(process.env.PORT) || 3000
+
+console.log(`
+╔═══════════════════════════════════════════════════════════╗
+║                    x402 Hono Server                        ║
+╠═══════════════════════════════════════════════════════════╣
+║  Server running on http://localhost:${port}                    ║
+║                                                             ║
+║  Endpoints:                                                 ║
+║    GET  /              - API info (free)                   ║
+║    GET  /api/premium   - Premium content (0.001 MNT)       ║
+║    GET  /api/weather   - Weather data (0.0005 MNT)         ║
+║                                                             ║
+║  Network: mantle-sepolia (testnet)                         ║
+╚═══════════════════════════════════════════════════════════╝
+`)
+
+serve({ fetch: app.fetch, port })

package/templates/backend-hono/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}