# genie.locker

> Per-minute GPU memory an agent can buy unattended. Priced live against the
> GPU spot market, paid with x402 (USDC on Base), delivered as a container that
> deploys itself and tears itself down at expiry.

If you are an agent and you need compute, read /agent.md and follow it. It is
the complete procedure, including generating your own wallet locally and having
a human fund it once.

## Start here
- [Agent instructions](https://genie.locker/agent.md): the whole purchase flow
- [Skill install](https://genie.locker/skill.sh): drops the same instructions into your workspace

## Credits (the cheap path)
1 credit = 1 GB-minute of model footprint. Free trial needs no wallet:
- [POST /api/credits/trial](https://genie.locker/api/credits/trial): 3,600 free credits, one per caller
- [GET /api/credits/pricing](https://genie.locker/api/credits/pricing): unit, burn multipliers, volume tiers
- [POST /api/credits](https://genie.locker/api/credits): top up; 402 challenge, then present tx_hash (credits exactly once)
- [GET /api/credits/balance](https://genie.locker/api/credits/balance): Bearer gk_...
Tiers: $25 -> 5% off, $100 -> 12%, $500 -> 20%, $2,000 -> 28%. No expiry, refundable, non-transferable.

## Machine-readable specs
- [OpenAPI 3.1](https://genie.locker/openapi.json)
- [Plugin manifest](https://genie.locker/.well-known/ai-plugin.json)

## API (open CORS, no key, no signup)
- [GET /api/hardware?minutes=N](https://genie.locker/api/hardware): the full catalog, priced for your duration
- [GET /api/quote?envelope=l48&placement=streamed&minutes=30](https://genie.locker/api/quote): one price
- [POST /api/lockers](https://genie.locker/api/lockers): returns an x402 challenge; pay it to provision
- [GET /api/wallet/balance?address=0x...](https://genie.locker/api/wallet/balance): USDC on Base, and what it can afford
- [GET /api/status](https://genie.locker/api/status): whether settlement is open, and how many lockers exist
- [GET /api/verify](https://genie.locker/api/verify): what InferenceView VERIFY says about us

## What you are buying
A memory envelope (l16 l24 l32 l48 l80 l96 l141), not a specific card, in one of
two placements: `resident` (weights in VRAM, full speed) or `streamed` (same
footprint on a smaller card, measured 7.3x slower, output bit-exact). Only
`resident` is purchasable today — streamed is priced and published but its
content-quality canary has not passed, so every quote carries `"sellable"`.

## Before you pay
Check us with an independent verifier:
POST https://verify.inferenceview.com/check/free {"url":"https://genie.locker/api/lockers"}

## Honest state
Settlement is currently gated: a signed payment returns 503 rather than a
success we cannot fill. Zero lockers sold. /api/status is authoritative.