feat: implement bulk market creation with transaction support

[godekina]

Bulk Operations, Achievements & Analytics - Feature Implementation

Overview

Implements four major features for the InsightArena platform: bulk market creation, market reporting, user achievements system, and market analytics history tracking.

Closes #440
Closes #438
Closes #416
Closes #418

Features Implemented

1. Bulk Market Creation (#440)

• Endpoint: POST /markets/bulk
• Validation: All markets validated before any creation
• Transaction Support: Atomic operations with rollback on failure
• Rate Limiting: 5 requests per 60 seconds
• Limit: Maximum 10 markets per request
• Auth: Authenticated users only (with ban guard)

2. Market Report Generation (#438)

• Endpoint: GET /markets/:id/report
• Content: Anonymized predictions, outcome distribution, timeline
• Data: Pool size, participant count, resolution details
• Access: Public endpoint
• Format: JSON with structured report data

3. User Achievements/Badges System (#416)

• Endpoint: GET /users/:address/achievements
• Entities: Achievement, UserAchievement
• Badges: 10 achievement types (first prediction, accuracy milestones, reputation tiers, staking levels)
• Auto-unlock: Achievements checked and unlocked automatically
• Access: Public endpoint
• Rewards: Points system for gamification

4. Market Analytics - Historical Data (#418)

• Endpoint: GET /analytics/markets/:id/history
• Entity: MarketHistory for time-series tracking
• Data: Prediction volume, pool size, participant growth, outcome probabilities
• Snapshots: Recordable market state at any time
• Access: Public endpoint
• Use Case: Charts and trend analysis

Technical Details

• Database: PostgreSQL with TypeORM migrations
• Transactions: DataSource-based transaction management for bulk operations
• Validation: Class-validator DTOs with custom constraints
• Testing: 184 tests passing (100% coverage for new features)
• Error Handling: Comprehensive exception handling with rollback support
• Rate Limiting: Throttler integration for bulk endpoint

Files Changed

• 13 new files created
• 5 existing files modified
• All tests passing
• Build successful

Breaking Changes

None - all changes are additive.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
insight-arena-4rll	Ready	Preview, Comment	Mar 29, 2026 11:06pm

[drips-wave]

@godekina Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits