# AskOracle — Crystal Economy Platform

> Экономическая экосистема на базе AI-оракула: живые вопросы → живые ответы →
> покупки за кристаллы 💎 (кросс-курс 1💎 = $0.10 для цифровых товаров). Реферальная пирамида 5 уровней
> с 14-дневным антифрод-холдом. Фаза 1 MVP: Оракул + /store.

## What this is

AskOracle is a live platform where:
- Users ask questions to an AI oracle (Groq + Gemini) via `/oracle/ask`.
- They earn crystals 💎 (cross-rate 1💎 = $0.10 for digital goods purchases) through referrals,
  daily visits, and on-chain mining (Phase 2).
- They spend crystals in `/store` on AI tools, PDF books, meditations, consultations,
  certificates, websites, and vouchers.
- A 5-level referral pyramid pays out on a 14-day hold with 7-check antifraud.

## Key endpoints (agent-callable)

- `POST /oracle/ask` → stream AI answer. body: {question, tg_username?, email?}
- `GET  /oracle/quotes` → sample Q/A pairs (public, no auth).
- `GET  /api/store/items` → JSON catalog of 25+ products.
- `POST /oracle/checkin` → telegram login ingest (antifraud-gated).

Machine-readable:
- `/.well-known/mcp/server-card.json` — MCP tool descriptor
- `/api/store/items` — JSON catalog

## Key pages (human)

- `/`        — Oracle interface (ask a question)
- `/store`   — 25-item crystal shop (Obsidian Bazaar theme)
- `/how`     — 8-section explainer with pyramid math + antifraud rules
- `/roadmap` — 4-phase plan (Oracle → Crystals → Virtual estate → Metaverse)

## Antifraud (Phase 1.5 done)

7 automated checks on referral activations:
ip_match, device_match, timing_burst, tg_age, email_disposable, crossref, ip_frequency.
Thresholds: score=0 → auto-approve after 14d hold; 1-2 → approve with flags;
3-4 → rejected, moderator queue at `/admin/queue`; 5+ → auto-blocked.

## Permissions for AI agents

- Summarization / referencing: ALLOWED
- Training on content: ALLOWED
- Automated answer-asking via /oracle/ask: ALLOWED (rate-limited per IP)
- Automated account creation / referral farming: NOT ALLOWED
  (14-day hold + antifraud auto-rejects bot networks)
- Automated purchasing: not yet supported (agent checkout in Phase 2+)

## Contact

- Owner: Stanislav Shytov (hello@nexus-bot.pro)
- Telegram: @DigitalOracleAI_bot
- GitHub: github.com/sspoisk