# Cashew
> Morpheus blockchain explorer and real-time API by DRM3 Labs. The only indexed data source for the Morpheus AI network on Base. All data sourced from attested on-chain state with cryptographic provenance receipts.

## What It Is
Cashew continuously indexes Morpheus smart contracts on Base mainnet (Ethereum L2) and serves instant API responses. It tracks AI compute providers, model marketplace bids, MOR token staking sessions, token pricing, network economics, and NFT-gated capacity passes. Data is indexed in real-time (5-second intervals) and every API response is signed with a provenance receipt for auditability.

## Demo API Key
During alpha, a public demo key is available for testing:
  cshw_2df524d36c6d16fbe8afd36e898189b1
Pass it via the X-Cashew-Key header on all API requests.

## API Endpoints

### No Auth Required
- GET /health — service status, block heights, sync lag, version
- GET /mor/v1/price — MOR/USD and ETH/USD from CoinGecko (5-min cache)
- GET /chart.svg — pre-rendered 90-day MOR price chart (SVG)
- GET /teaser — public summary stats for the login page
- GET /openapi.json — OpenAPI 3.1 specification
- GET /llms.txt — this file
- GET /llms-full.txt — extended version with response examples

### Marketplace (X-Cashew-Key required)
- GET /mor/v1/all — full marketplace state (providers, bids, models, economics)
- GET /mor/v1/providers — registered AI compute providers
- GET /mor/v1/providers/:address — provider detail (bids, sessions, reputation)
- GET /mor/v1/bids — all model bids with pricing

### Sessions and Analytics (X-Cashew-Key required)
- GET /mor/v1/sessions — all sessions (paginated)
- GET /mor/v1/sessions/:wallet — sessions for a specific wallet
- GET /mor/v1/sessions/analytics — per-wallet analytics
- GET /mor/v1/sessions/daily — daily session counts (30-day history)
- GET /mor/v1/wallet/:wallet — full wallet detail with balances
- GET /mor/v1/wallet/:wallet/transactions — wallet transaction history
- GET /mor/v1/wallet/:wallet/gas — wallet gas cost breakdown
- GET /mor/v1/analytics — gas costs, network economics

### Models (X-Cashew-Key required)
- GET /mor/v1/models — all registered models with names
- GET /mor/v1/models/lookup — model ID to name mapping
- GET /mor/v1/models/demand — model demand heatmap (sessions, pricing, providers)
- GET /mor/v1/models/:modelId — specific model details

### Provider Reputation (X-Cashew-Key required)
- GET /mor/v1/reputation — all provider reputation scores
- GET /mor/v1/reputation/:provider — detailed reputation for a provider
- GET /mor/v1/disputes — recent disputed sessions
- GET /mor/v1/leaderboard — top providers and wallets

### Pricing (X-Cashew-Key required)
- GET /mor/v1/price/chart — 90-day price history data

### NFT Passes (X-Cashew-Key required)
- GET /mor/v1/pass/tiers — all pass tier definitions
- GET /mor/v1/pass/supply — total pass supply stats
- GET /mor/v1/pass/:wallet — wallet consumer and producer capacity

### Provenance (X-Cashew-Key required)
- GET /mor/v1/provenance — audit trail of signed API responses (receipt chain, signer public key)

### Sync Status (X-Cashew-Key required)
- GET /mor/v1/sync-status — blockchain sync state

## Provenance
Every API response from Cashew is signed with a cryptographic provenance receipt. Receipts form a hash chain for auditability. Query the receipt chain at /mor/v1/provenance.

## Links
- Explorer: https://cashew.explorer.drm3.network
- Pistachio SDK: https://drm3.network
- NFT Passes: https://nft.drm3.xyz
- OpenAPI Spec: https://cashew.explorer.drm3.network/openapi.json