PerpsHub Extension
A browser-based assistant for learning and interacting with trading concepts.
- Type
- Browser Extension
- Status
- 🚧 Frozen Snapshot
- Built by
- PerpsHub Labs
Product Positioning
An in-browser assistant that combines term/token explanations, guided learning, and an AI trading mentor while users read or interact with trading content.
This project explores learning-first interaction, not trading infrastructure.
Core Experience Loop
How it works (User Flow)
- User browses trading-related content or Hyperliquid
- Trading terms, tokens, or sentences are passively detected
- Hover cards provide instant explanations or context
- For deeper questions, the user switches to AI Mentor
- Guided steps or Academy tasks help the user take action
- Progress, badges, or feedback reinforce learning
This loop is designed to reduce cognitive load and context switching.
Capability Map
Capability Layers
1. Context Recognition
- Trading terms and mechanisms
- Tokens and crypto-related entities
- Sentence-level patterns (planned)
2. Inline Interaction
- Hover-based explanation cards
- Token price/context cards
- Selection-enhanced lookup and suggestions
3. Guided Learning
- Step-by-step overlays on Hyperliquid
- Hyper Academy tasks and courses
- Progress and badge feedback
4. AI Mentor
- Conversational Q&A
- Personalized next-step suggestions
- Error handling, rate limiting, and fallback logic
5. (Optional) Trading Interaction
- UI-level trading panels
- Explicit confirmation and safety thresholds
- Testnet / simulation-first design philosophy
Trading Interaction on Hyperliquid (Experimental)
This extension explores direct interaction with Hyperliquid trading flows as an optional and controlled capability.
Current State
- Trading-related UI components exist within the extension
- Order construction and signing logic has been prototyped
- Multiple implementation paths are present, with inconsistent maturity
Design Principles
- Trading is explicitly opt-in, never passive
- Real trading is disabled or gated by default
- Clear confirmations and environment separation (testnet / mainnet) are required
- Safety and user intent clarity take precedence over convenience
Why it matters
The goal is not to encourage impulsive trading, but to explore how learning, context, and action can coexist in a single interface. Trading capability is treated as an advanced layer, not the core experience.
System Architecture
High-level Architecture
- Browser Extension (Core): Content scripts, hover cards, popup navigation
- API & Data Layer: Terms, tokens, suggestions, admin workflows
- AI Layer: AI mentor chat, prompt routing, fallback handling
- Admin & Ops Tools: Lightweight admin, dynamic sentence system (planned)
- Optional On-chain Components: Builder approval, quests/badges (selectively used)
The system prioritizes safety, performance, and graceful degradation.
Scope & Boundaries
Out of Scope (for this experiment)
- Acting as a trading venue or custodian
- Managing user funds or private keys
- Full-featured commercial subscription systems
- Heavy operational back-office tooling
These constraints are intentional to keep the system lightweight and exploratory.
Status & Milestones
Current Status
- Core hover interaction: ✅
- Term / token cards: ✅
- AI mentor: ⚠️ Experimental
- Guided academy & badges: 🧪 Partial
- Trading execution: 🚧 Deliberately restricted
Suggested Milestone Order
- Stable hover interaction & cards
- Lightweight admin & data API
- AI mentor chat loop
- Academy guidance & badges
- Dynamic sentence system & analytics
Relationship to PerpsHub Labs
PerpsHub Extension lives under PerpsHub Labs, a space for experiments, tools, and systems that sit adjacent to PerpsHub’s core research and content.
Some experiments evolve. Others remain as references. Both outcomes are valid.
Attribution & Source
- Some components may be open-sourced separately.
- The core implementation is currently private.
- Related modules: API, admin, builder approval, quests
- Built by PerpsHub Labs