# ServerMemoryRFQ

> Enterprise B2B marketplace for server memory (DDR3/DDR4/DDR5 RDIMM, LRDIMM, ECC).
> Autonomous AI-agent commerce is first-class: query inventory, price parts, and execute
> on-chain purchases (Base / Ethereum, USDC / ETH) without human intervention.

25+ years in industry. ISO 9001 certified. TAA-compliant supplier. Same-day shipping
from US warehouse. 1-year advance-replacement warranty on every part.

## For AI agents, crawlers, and MCP clients

- Agent manifest: /.well-known/agent-manifest.json
- OpenAI plugin:  /.well-known/ai-plugin.json
- MCP context:    /api/agent/mcp/context
- Capabilities:   /api/agent/capabilities
- OpenAPI spec:   /api/openapi.json

## Core agent workflow

1. Discover: `GET /api/agent/inventory?search=<kw>&min_qty=<n>&max_price=<usd>&taa_only=true`
2. Price:    `GET /api/agent/pricing/{part_number}`
3. Quote:    `POST /api/agent/quote` with part_number, quantity, max_price_usd, wallet, chain
4. Pay:      send USDC or ETH on Base/Ethereum to the receiving wallet for the chosen chain
5. Checkout: `POST /api/agent/orders/create` with the signed tx_hash — server verifies on-chain
6. Track:    `GET /api/agent/orders/{order_id}` — status transitions pending → paid → shipped → completed

Items returned with `price_type: "call"` DO NOT have a fixed price — route those to
`POST /api/agent/orders/submit-rfq` for human quoting.

## x402 machine-to-machine payments

This site implements the x402 protocol (HTTP 402 Payment Required) for accountless,
micropayment-grade agent commerce. Full discovery at `/api/agent/x402/`.

Example:

```
GET /api/agent/x402/feed
-> HTTP 402 Payment Required
{
  "x402Version": 1,
  "accepts": [{
    "scheme": "exact-txhash",
    "network": "base",
    "maxAmountRequired": "100000",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "payTo": "0x299290421e696a76ef1efe77adee23c7629613d7",
    "resource": "/api/agent/x402/feed",
    "description": "Premium enriched inventory feed",
    "maxTimeoutSeconds": 300,
    "mimeType": "application/json"
  }],
  "error": "X-PAYMENT header required"
}
```

Retry with `X-PAYMENT` header set to base64-encoded JSON:

```json
{
  "x402Version": 1,
  "scheme": "exact-txhash",
  "network": "base",
  "payload": { "tx_hash": "0x...", "from": "0x...buyer" }
}
```

Server verifies the tx via public JSON-RPC, then returns the resource plus
`X-PAYMENT-RESPONSE` header (base64 JSON settlement receipt).

## Supported chains

| Chain     | ID   | Tokens     | Receiving wallet                                    |
|-----------|------|------------|-----------------------------------------------------|
| Base      | 8453 | USDC, ETH  | 0x299290421e696a76ef1efe77adee23c7629613d7          |
| Ethereum  | 1    | USDC, ETH  | 0x4A82F8bcDEaBcF56C3bE1f22e5b1B333aFae243f          |

USDC contract addresses:
- Base:     `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
- Ethereum: `0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48`

## API keys & rate limits

Write endpoints (`orders/create`, `orders/submit-rfq`, `x402/*`) accept an optional
`X-Agent-API-Key: sma_<48hex>`. Discovery and pricing endpoints are unauthenticated.

Default quotas per key: 60 req/min, 10,000 req/day. Enforced via sliding window.
HTTP 429 on exceed. Request a key from the operator.

## Test listing

A real inventory row named `test` is seeded at $0.05 with free shipping for zero-risk
live-transaction validation.

## Contact

- Sales / ops: simon@memory.net
- Human RFQ form: /rfq
- Agent checkout UI: /agents