# Nukez -- LLM index

Name: Nukez
Base URL: https://api.nukez.xyz
Docs: https://docs.nukez.xyz

Start here:
- Discovery (JSON): https://docs.nukez.xyz/.well-known/nukez.json
- OpenAPI (canonical): https://docs.nukez.xyz/openapi.json
- Tools (LLM-friendly): https://docs.nukez.xyz/v1/tools.json

Core behavior:
- x402 payment flow: request -> pay (Solana or EVM/Monad) -> confirm -> receipt
- Multi-chain support: optional pay_network (e.g., "solana-devnet", "monad-testnet") and pay_asset (e.g., "SOL", "MON", "USDC", "USDT", "WETH") at request time
- Confirm accepts both Solana signatures and EVM tx hashes via X402-TX header
- Provision: signed_provision returns locker manifest (locker_id + file_api); optional operator_pubkey for delegation
- Per-file operations: create/list/get/delete file metadata and mint short URLs
- Bytes transfer via provider-opaque short URLs (HTTP PUT/GET to `https://api.nukez.xyz/f/{token}`)
- Optional provider selection at request time (`provider`: gcs, mongodb, storj, arweave, filecoin, firestore)
- Operator delegation: register Ed25519 operator keys to perform file ops on behalf of locker owner
- Verification bundle: self-contained proof package at GET /v1/storage/verification-bundle
- Auth via signed envelopes (X-Nukez-Envelope + X-Nukez-Signature)

Docs:
- https://docs.nukez.xyz/docs/AGENT_BRIEFING.md
- https://docs.nukez.xyz/docs/AGENT_FLOW.md
- https://docs.nukez.xyz/docs/ERROR_RECOVERY.md