# WZRD Machine Manifest

## Network
- Chain: Solana Mainnet
- Program: `GnGzNdsQMxMpJfMeqnkGPsvHm8kwaDidiKjNU2dCVZop`

## Token Mints
| Token | Address | Standard |
|-------|---------|----------|
| USDC | `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v` | SPL Token |
| vLOFI | `E9Kt33axpCy3ve2PCY9BSrbPhcR9wdDsWQECAahzw2dS` | SPL Token |
| CCM | `Dxk8mAb3C7AM8JN6tAJfVuSja5yidhZM5sEKW3SRX2BM` | Token-2022, 50 BPS transfer fee |

## Public HTTP Endpoints
- `GET https://api.twzrd.xyz/v1/leaderboard` — leaderboard
  - Fields: `market_id`, `metric`, `platform`, `velocity_ema`, `tvl_usdc`, `multiplier_bps`, `depositable`
- `GET https://api.twzrd.xyz/v1/feeds` — feeds
- `GET https://api.twzrd.xyz/health` — health

## Agent Auth
1. `GET https://api.twzrd.xyz/v1/agent/challenge` — returns `nonce`
2. Sign message: `wzrd-agent-auth v1 | wallet:{pubkey} | nonce:{nonce}` (Ed25519)
3. `POST https://api.twzrd.xyz/v1/agent/verify` — returns 24h Bearer token
4. Use: `Authorization: Bearer <token>` on protected endpoints

## Protected HTTP Endpoints
- `GET /v1/portfolio` — portfolio
- `GET /v1/claims/:pubkey` — claim proof
- `POST /v1/claims/:pubkey/relay` — claim relay
- `GET /v1/positions` — positions

## Agent Plugin
- Package: `@wzrd_sol/solana-agent-plugin` (npm, v0.1.2+)
- Standalone `WzrdClient`: auth, leaderboard, portfolio, claims, gasless relay
- 5 actions: `wzrd_leaderboard`, `wzrd_velocity`, `wzrd_portfolio`, `wzrd_deposit`, `wzrd_claim`
- Works with: Solana Agent Kit (SendAI), ElizaOS, or standalone
- Quick start: `npm install @wzrd_sol/solana-agent-plugin @solana/web3.js`

## Transaction Path
- Package: `@wzrd_sol/sdk` (npm, v0.1.1+)
- Builds `VersionedTransaction` for: `deposit_market`, `settle_market`, `claim_global`
- Wallet signs and submits directly to Solana RPC

## MCP Server
- Endpoint: `https://app.twzrd.xyz/api/mcp`
- Protocol: MCP Streamable HTTP (2025-03-26)
- POST: JSON-RPC 2.0 tool calls
- GET: SSE resource subscriptions (`Accept: text/event-stream`)
- Tools (market data): `get_leaderboard`, `get_market`, `get_feeds`, `get_feed`, `get_health`
- Tools (protocol): `get_keeper_status`, `get_circuit_breaker_state`, `get_yield_flywheel`, `get_exchange_rate_history`, `get_dlmm_pools`
- Tools (simulation): `simulate_compound_cycle`, `simulate_route_yield`
- Tools (claims): `verify_merkle_proof`, `simulate_claim`
- Tools (routing): `get_jupiter_quote`, `get_ccm_price`
- Tools (signals): `get_attention_signal`
- Resources: `wzrd://leaderboard`, `wzrd://health` (live via SSE)

## Additional Resources
- OpenAPI spec: https://twzrd.xyz/openapi.json
- MCP integration guide: https://twzrd.xyz/mcp-guide.md
- Agent skill guide: https://twzrd.xyz/SKILL.md
- Agent template: https://github.com/twzrd-sol/twzrd-agent-template

## Display Hints
- Multiplier display: `(multiplier_bps / 10000).toFixed(2) + 'x'`
- Velocity: `velocity_ema` (float, higher = more momentum)

---
No guarantees implied by this file. Authoritative state is on-chain accounts and API responses.