Add Activation Edge Case Tests

[Bhenzdizma]

This PR includes two significant improvements to the InsightArena project:

1. CreatorEventManager Contract README Restructure
   Created:
   README.md
   (comprehensive documentation overhaul)

Enhanced the CreatorEventManager smart contract documentation with a professional, well-organized structure that provides clear guidance for developers and users.

Key Improvements:

Project Overview — Clear explanation of what CreatorEventManager is, its role in the prediction market ecosystem, and the complete event lifecycle
Key Features — Comprehensive list of 10 core features including creator-hosted events, XLM token integration, AI oracle verification, and automated winner verification
Use Cases — Six real-world scenarios: sports predictions, crypto markets, political events, esports, entertainment, and hackathons
Quick Start Guide — Step-by-step setup including:
Installation with Rust and Soroban CLI dependencies
Build instructions for WASM compilation
Complete testnet deployment walkthrough
Practical Rust code examples showing event creation, match management, predictions, and winner verification
Documentation Links — Clear references to detailed guides: API Reference, Architecture, Integration, Testing, Deployment, and User Guide
Technical Details — XLM token configuration, authorization flow, core data structures (Event, Match, Prediction), and winnings calculation
Error Handling — Complete list of 14+ error types with clear descriptions
Security Considerations — 8 key security measures including authentication, access control, and state validation
Format Improvements:

Proper table of contents with working anchor links
Consistent markdown formatting with proper code blocks and spacing
Professional tone suitable for both developers and end-users
~366 lines of organized, reference-friendly content
2. Conditional Markets Test Coverage Enhancement
Enhanced:
conditional_tests.rs

Added comprehensive integration test for cascading activation through conditional market chains.

New Test: test_cascading_activation_through_full_chain_on_matching_outcomes

This test validates the complete lifecycle of a 4-level deep conditional market chain and verifies:

✓ Progressive activation: Each parent's resolution with matching outcome activates only its immediate child ✓ Timestamp tracking: Activation timestamps are recorded correctly at each level ✓ Proper isolation: Siblings and deeper levels remain inactive until their parents resolve ✓ Chain integrity: Full chain structure remains queryable and correct through the resolution sequence ✓ State consistency: All markets show correct resolved/activated states at each step

Why It Matters:

Ensures conditional markets cascade activation correctly through multi-level chains
Validates that the resolution sequence maintains proper state isolation
Verifies timestamp accuracy for event tracking and analytics
Tests a realistic scenario where complex prediction hierarchies are fully resolved
Testing
Both changes have been validated:

✅ README content aligns with actual contract functionality (verified against
lib.rs
)
✅ New test passes and covers previously untested cascading activation scenario
✅ Existing conditional market tests continue to pass
Impact
Developer Experience — Significantly improved onboarding documentation for CreatorEventManager integration
Code Quality — Enhanced test coverage for complex conditional market interactions
Maintainability — Clear documentation reduces future support burden and facilitates contributions

closes #842
closes #514

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
insight-arena-4rll	Ready	Preview, Comment	Jun 2, 2026 6:17am

[drips-wave]

@Bhenzdizma 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