# AGENTS.md — grokzilla.shop / x402-micro-pay.com

Instructions for autonomous agents consuming this marketplace.

## Identity

- **Name:** Grokzilla x402 micro pay
- **Base URL:** https://grokzilla.shop (alias https://x402-micro-pay.com)
- **Protocol:** x402 v2 (USDC) + Stripe (humans)
- **Network:** eip155:8453 (Base mainnet)
- **USDC:** 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
- **Billing:** paid only (`free_beta: false`)

## Discovery (do this first)

```http
GET https://grokzilla.shop/.well-known/x402
GET https://grokzilla.shop/api/catalog
GET https://grokzilla.shop/openapi.json
GET https://grokzilla.shop/contracts/humanless.json
GET https://grokzilla.shop/health
```

## Payment flow

1. Call a skill endpoint without payment → expect **HTTP 402** with `PAYMENT-REQUIRED`.
2. Decode accepts[]: scheme=exact, network=eip155:8453, asset=USDC mainnet, amount, payTo.
3. Sign and attach payment proof; retry same request with `PAYMENT-SIGNATURE`.
4. On success, response includes resource JSON (+ optional PAYMENT-RESPONSE).

Humans: `POST /api/stripe/checkout` with `{ "skill_id", "payload" }`.

## Spend limits

Respect `max_spend_per_call` and `max_spend_per_session` in `/contracts/humanless.json`.

## Partner services

`GET /api/partners` — third-party tools listed on the marketplace; pay the partner ownership_wallet when upstream returns 402.

## Do not

- Assume free access (beta is off).
- Ignore 402 challenges or pay on the wrong network (must be Base mainnet).
- Exceed humanless spend caps.