x402 技术文档

# 使用 npm
npm install x402

# 使用 yarn
yarn add x402

# 使用 pip (Python)
pip install x402

// TypeScript/Node.js
import { paymentMiddleware } from 'x402';

app.use('/api', paymentMiddleware('0xYourAddress', {
  '/weather': '$0.01',
  '/premium': '$0.05'
}));

// 客户端代码
import { payForResource } from 'x402/client';

const response = await payForResource(
  'https://api.example.com/weather',
  '$0.01',
  'base-sepolia'
);

console.log('数据:', response.data);

import express from 'express';
import { paymentMiddleware } from 'x402';

const app = express();

// 基础集成
app.use('/api', paymentMiddleware('0xYourAddress', {
  '/weather': '$0.01',
  '/news': '$0.05'
}));

// 自定义配置
app.use('/api', paymentMiddleware('0xYourAddress', {
  '/weather': {
    amount: '$0.01',
    network: 'base-sepolia',
    description: 'Weather API access',
    maxTimeout: 30
  }
}));

app.listen(3000, () => {
  console.log('Server running on port 3000');
});

from flask import Flask
from x402 import payment_middleware

app = Flask(__name__)

# 集成支付中间件
app.wsgi_app = payment_middleware(
    app.wsgi_app,
    '0xYourAddress',
    {
        '/weather': '$0.01',
        '/news': '$0.05'
    }
)

@app.route('/')
def hello():
    return 'Hello World!'

if __name__ == '__main__':
    app.run(debug=True)

import { payForResource } from 'x402/client';

// 简单调用
const response = await payForResource(
  'https://api.example.com/weather',
  '$0.01',
  'base-sepolia'
);

// 带参数调用
const response = await payForResource(
  'https://api.example.com/weather',
  '$0.01',
  'base-sepolia',
  {
    city: 'Beijing',
    units: 'metric'
  }
);

console.log('响应:', response.data);

from x402 import pay_for_resource

# 调用付费资源
response = pay_for_resource(
    'https://api.example.com/weather',
    '$0.01',
    'base-sepolia'
)

# 带参数调用
response = pay_for_resource(
    'https://api.example.com/weather',
    '$0.01',
    'base-sepolia',
    {
        'city': 'Beijing',
        'units': 'metric'
    }
)

print('响应:', response['data'])

// 完整的天气API服务示例
import express from 'express';
import { paymentMiddleware } from 'x402';

const app = express();

// x402支付中间件
app.use('/api/weather', paymentMiddleware('0xYourAddress', {
  '/current': '$0.01',
  '/forecast': '$0.03'
}));

// 天气API端点
app.get('/api/weather/current', (req, res) => {
  const weatherData = {
    temperature: 22.5,
    humidity: 65,
    description: '晴朗',
    city: req.query.city || '北京'
  };
  
  res.json(weatherData);
});

app.get('/api/weather/forecast', (req, res) => {
  const forecastData = {
    city: req.query.city || '北京',
    days: [
      { date: '2025-01-01', temp: 20, description: '多云' },
      { date: '2025-01-02', temp: 18, description: '小雨' },
      { date: '2025-01-03', temp: 22, description: '晴朗' }
    ]
  };
  
  res.json(forecastData);
});

app.listen(3000);

// 文章付费墙示例
import express from 'express';
import { paymentMiddleware } from 'x402';

const app = express();

// 文章付费中间件
app.use('/articles', paymentMiddleware('0xYourAddress', {
  '/blockchain-guide': '$0.05',
  '/ai-trends': '$0.03',
  '/web3-intro': '$0.02'
}));

// 文章端点
app.get('/articles/blockchain-guide', (req, res) => {
  const article = {
    title: '区块链技术完全指南',
    content: '区块链技术是一种分布式账本技术...',
    author: '技术专家',
    readTime: '15分钟'
  };
  
  res.json(article);
});

app.get('/articles/ai-trends', (req, res) => {
  const article = {
    title: '2025年AI发展趋势',
    content: '人工智能正在快速发展...',
    author: 'AI研究员',
    readTime: '10分钟'
  };
  
  res.json(article);
});

app.listen(3000);