POST /x402/mint
Content-Type: application/json

Headers:
  X-Wallet-Address: <用户 Solana 钱包地址>
  X-Wallet-Signature: <钱包签名>
  X-Timestamp: <Unix 毫秒时间戳>
  X-Nonce: <UUID v4>

Body:
{
  "amount_mcc": 100    // 想铸造的 MCC 数量
}

HTTP/1.1 402 Payment Required

{
  "status": "payment_required",
  "request_id": "mint_abc123def456",
  "expires_at": 1703145600,

  "payment": {
    "network": "solana",
    "chain_id": "devnet",
    "token": "USDC",
    "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "1000000000",
    "decimals": 6,
    "recipient": "轮回地址 (Reincarnation Address)",
    "memo": "mint_abc123def456"
  },

  "quote": {
    "mcc_amount": 100,
    "mcc_price": 10.0,
    "usdc_required": 1000,
    "mining_phase": 0,
    "multiplier": 50.0,
    "distribution": {
      "user": 50,
      "team": 10,
      "managers": 10,
      "station_mcd": 30
    }
  },

  "user_info": {
    "uid": "user_12345",
    "wallet": "Gq8ubUZwFrBgscZjerWHZCTYXXFMN2b8W6kRyaKMQYJo",
    "role": "miner",
    "remaining_quota": 9000,
    "station_id": 1
  }
}

{
  "success": true,
  "request_id": "mint_abc123def456",
  "minted": {
    "total_mcc": 70,
    "user_mcc": 50,
    "team_mcc": 10,
    "managers_mcc": 10,
    "station_mcd": 30
  },
  "tx_signature": "5xYz...",
  "new_balance": {
    "mcc": 150.5,
    "mcd": 30.0
  }
}

HTTP/1.1 402 Payment Required

{
  "status": "payment_required",
  "request_id": "cycle_xyz789abc123",
  "expires_at": 1703145600,

  "payment": {
    "network": "solana",
    "token": "MCC",
    "token_address": "6we9ind8T3uqX1YXsKqzMqQePF7Him3CLBepCQrfaRWM",
    "amount": "100000000000",
    "decimals": 9,
    "recipient": "轮回地址",
    "memo": "cycle_xyz789abc123"
  },

  "quote": {
    "mcc_amount": 100,
    "cycle_price": 11.0,
    "gross_usdc": 1100,
    "fee_rate": 0.02,
    "fee_usdc": 22,
    "net_usdc": 1078
  },

  "user_info": {
    "is_registered": false,
    "fee_tier": "external"
  }
}

HTTP/1.1 402 Payment Required

{
  "status": "payment_required",
  "request_id": "mcd_deposit_abc123",
  "expires_at": 1703145600,

  "payment": {
    "network": "solana",
    "token": "USDC",
    "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "1000000000",
    "decimals": 6,
    "recipient": "MCD 金库地址",
    "memo": "mcd_deposit_abc123"
  },

  "quote": {
    "usdc_amount": 1000,
    "mcd_amount": 1000,
    "rate": 1.0
  }
}

{
  "service": "sandbox_starter",
  "duration_days": 30
}

HTTP/1.1 402 Payment Required

{
  "status": "payment_required",
  "request_id": "mcd_spend_xyz789",
  "expires_at": 1703145600,

  "payment": {
    "network": "solana",
    "token": "MCD",
    "token_address": "HutgrVGDzhSDTFybcqdEFWrbLf8iHAuRbFKZ31ftXc5a",
    "amount": "50000000",
    "decimals": 6,
    "recipient": "服务费收款地址",
    "memo": "mcd_spend_xyz789"
  },

  "service": {
    "name": "Sandbox Starter",
    "price_mcd": 50,
    "duration": "30 days",
    "features": ["500m CPU", "512Mi Memory", "1 Replica"]
  }
}

{
  "station_id": "STN-001",
  "target_amount": 100000,
  "min_contribution": 100,
  "max_contribution": 10000,
  "deadline_days": 14,
  "description": "募资竞拍 Station Alpha"
}

HTTP/1.1 402 Payment Required

{
  "status": "payment_required",
  "request_id": "dao_create_abc123",
  "expires_at": 1703145600,

  "payment": {
    "network": "solana",
    "token": "MCC",
    "amount": "1000000000000",
    "recipient": "DAO 创建费收款地址",
    "memo": "dao_create_abc123"
  },

  "create_fee": {
    "amount_mcc": 1000,
    "description": "DAO 创建费，募资成功后返还"
  },

  "fundraise": {
    "station_id": "STN-001",
    "target_amount": 100000,
    "pool_pda": "系统生成的募资池 PDA 地址"
  }
}

HTTP/1.1 402 Payment Required

{
  "status": "payment_required",
  "request_id": "dao_contrib_xyz789",
  "expires_at": 1703145600,

  "payment": {
    "network": "solana",
    "token": "MCC",
    "amount": "5000000000000",
    "recipient": "募资池 PDA 地址",
    "memo": "dao_contrib_xyz789"
  },

  "contribution": {
    "amount_mcc": 5000,
    "fee_rate": 0.01,
    "fee_mcc": 50,
    "net_contribution": 4950,
    "estimated_share": "4.95%"
  },

  "fundraise_status": {
    "raised": 45000,
    "target": 100000,
    "progress": "45%",
    "contributors": 23
  }
}

# k8s/x402-revenue-distribution-cronjob.yaml
apiVersion: batch/v1
kind: CronJob
metadata:
  name: x402-revenue-distribution
  namespace: microcosm
spec:
  schedule: "0 1 * * *"  # 每日 UTC 01:00
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: distributor
            image: microcosm-blockchain-service:latest
            command: ["python", "-m", "app.jobs.x402_revenue_distribution"]

-- API 定价表
CREATE TABLE api_pricing (
    id SERIAL PRIMARY KEY,
    endpoint VARCHAR(200) NOT NULL UNIQUE,
    token VARCHAR(10) NOT NULL,          -- MCC/MCD
    price DECIMAL(20, 9) NOT NULL,       -- 单次价格
    unit VARCHAR(50) DEFAULT 'per_call', -- per_call/per_1k/per_day
    description TEXT,
    is_active BOOLEAN DEFAULT true,
    created_at TIMESTAMP DEFAULT NOW(),
    updated_at TIMESTAMP DEFAULT NOW()
);

-- x402 支付请求表
CREATE TABLE x402_payment_requests (
    id SERIAL PRIMARY KEY,
    request_id VARCHAR(100) NOT NULL UNIQUE,
    wallet_address VARCHAR(100) NOT NULL,
    endpoint VARCHAR(200) NOT NULL,
    token VARCHAR(10) NOT NULL,
    amount DECIMAL(20, 9) NOT NULL,
    recipient VARCHAR(100) NOT NULL,
    expires_at TIMESTAMP NOT NULL,
    status VARCHAR(20) DEFAULT 'pending', -- pending/paid/expired/cancelled
    tx_signature VARCHAR(200),
    paid_at TIMESTAMP,
    created_at TIMESTAMP DEFAULT NOW()
);

-- x402 收入记录表
CREATE TABLE x402_revenue (
    id SERIAL PRIMARY KEY,
    source VARCHAR(50) NOT NULL,         -- api_call/mint_fee/cycle_fee
    token VARCHAR(10) NOT NULL,
    amount DECIMAL(20, 9) NOT NULL,
    tx_signature VARCHAR(200),
    distributed BOOLEAN DEFAULT false,
    distributed_at TIMESTAMP,
    distribution_details JSONB,
    created_at TIMESTAMP DEFAULT NOW()
);

-- API 使用日志表
CREATE TABLE api_usage_log (
    id SERIAL PRIMARY KEY,
    wallet_address VARCHAR(100) NOT NULL,
    endpoint VARCHAR(200) NOT NULL,
    request_id VARCHAR(100),
    token VARCHAR(10),
    amount DECIMAL(20, 9),
    status VARCHAR(20) NOT NULL,         -- success/failed/pending
    response_time_ms INTEGER,
    error_code VARCHAR(50),
    created_at TIMESTAMP DEFAULT NOW()
);

-- 索引
CREATE INDEX idx_payment_requests_wallet ON x402_payment_requests(wallet_address);
CREATE INDEX idx_payment_requests_status ON x402_payment_requests(status);
CREATE INDEX idx_payment_requests_expires ON x402_payment_requests(expires_at);
CREATE INDEX idx_revenue_distributed ON x402_revenue(distributed);
CREATE INDEX idx_usage_log_wallet ON api_usage_log(wallet_address);
CREATE INDEX idx_usage_log_created ON api_usage_log(created_at);