# Code Agent (x402)
> Pay-per-request AI developer tools in USDC on Base. No API keys. x402 v2.

Site: https://code.mamenesia.com
Catalog: https://code.mamenesia.com/api
Discovery: https://code.mamenesia.com/.well-known/x402
Health: https://code.mamenesia.com/health
Status: https://status.mamenesia.com

## Quick start for agents
1. GET /api for machine catalog + prices
2. POST /service/:id without payment -> HTTP 402 with amount + payTo
3. Have an x402 v2 client sign the advertised EIP-3009 authorization
4. Retry POST with header PAYMENT-SIGNATURE: <x402-v2-payload>
5. Current pilot services: generate-script, generate-function, refactor-code, explain-code, analyze-contract, generate-tutorial, audit-diff, summarize, tip-jar

## Services
- generate-script: $2.00 USDC — Describe what you want the script to do. Returns clean, working Node.js code.
  POST https://code.mamenesia.com/service/generate-script
- generate-function: $1.00 USDC — Describe a single function. Returns a well-documented JS function with types.
  POST https://code.mamenesia.com/service/generate-function
- refactor-code: $3.00 USDC — Paste your code and describe improvements. Returns refactored version with notes.
  POST https://code.mamenesia.com/service/refactor-code
- explain-code: $1.00 USDC — Paste code. Returns a plain-English explanation suitable for a junior dev.
  POST https://code.mamenesia.com/service/explain-code
- analyze-contract: $0.50 USDC — Pass a contract address (read on-chain source) or paste Solidity source code. Returns a security audit: vulnerability list, severity, and remediation.
  POST https://code.mamenesia.com/service/analyze-contract
- generate-tutorial: $0.25 USDC — Pick any topic and programming language. Returns a structured, beginner-to-advanced tutorial with code examples.
  POST https://code.mamenesia.com/service/generate-tutorial
- audit-diff: $0.25 USDC — Paste a unified diff and the language. Returns a focused review: bugs, regressions, edge cases, and suggestions.
  POST https://code.mamenesia.com/service/audit-diff
- summarize: $0.05 USDC — Pass long text or a URL's content. Returns a concise structured summary with key points.
  POST https://code.mamenesia.com/service/summarize
- tip-jar: $0.01 USDC — Make a $0.01 USDC tip through the x402 v2 flow. Returns a thank-you receipt. Lowest-friction first payment to verify x402 flow.
  POST https://code.mamenesia.com/service/tip-jar

## Free / discovery endpoints
- GET https://code.mamenesia.com/health
- GET https://code.mamenesia.com/api
- GET https://code.mamenesia.com/.well-known/x402
- GET https://code.mamenesia.com/.well-known/ai-plugin.json
- GET https://code.mamenesia.com/ping  (free liveness JSON)
- GET https://code.mamenesia.com/openapi.json

## Payment
- Standard: x402-style HTTP 402
- Asset: USDC on Base (chainId 8453)
- Pay to: 0xc7e77CF4Bd5F7f1307d5846b1dbFcf0812FC0A46
- USDC contract: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
- Header: PAYMENT-SIGNATURE: <x402-v2-payload>