# Quickbrew API - Agent & LLM Documentation

Quickbrew provides keyless, pay-per-call context extraction designed natively for Autonomous AI Agents. It operates entirely without API keys or subscriptions, using the x402 v2 protocol for programmatic micro-payments.

## Network & Settlement
- Chain: Base Mainnet (Chain ID: 8453)
- Token: USDC (Address: `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`)
- Quickbrew Merchant Address: `0x63419c2d5d06795fec77c5d124e4779fdf279b16`

## AI Models
All LLM-driven endpoints (`/condense`, `/sentiment`) are powered by **OpenAI OSS 20B** (`@cf/openai/gpt-oss-20b`), with automatic network fallback to `glm-5.3-flash`.

## Protocol: x402 v2 Handshake
Agents negotiate access dynamically per request:
1. **Initial Request**: Make a GET request to the target endpoint without a signature.
2. **Pricing Discovery**: Receive HTTP `402 Payment Required`. The response will dictate the price in atomic units (6 decimals for USDC).
3. **Cryptographic Signing**: The agent signs an EIP-712 `TransferWithAuthorization` message using its private wallet key. 
   Required EIP-712 Types:
   ```json
   "TransferWithAuthorization": [
     { "name": "from", "type": "address" }, 
     { "name": "to", "type": "address" }, 
     { "name": "value", "type": "uint256" },
     { "name": "validAfter", "type": "uint256" }, 
     { "name": "validBefore", "type": "uint256" }, 
     { "name": "nonce", "type": "bytes32" }
   ]