Skip to content

Feat/time based release schedules#343

Open
beebozy wants to merge 86 commits intoJagadeeshftw:masterfrom
beebozy:feat/time-based-release-schedules
Open

Feat/time based release schedules#343
beebozy wants to merge 86 commits intoJagadeeshftw:masterfrom
beebozy:feat/time-based-release-schedules

Conversation

@beebozy
Copy link
Contributor

@beebozy beebozy commented Jan 31, 2026

closes #152

Henry3029 and others added 30 commits January 23, 2026 10:07
- Add comprehensive event schema documentation (EVENT_SCHEMA.md)
  * Define event structures for all contracts
  * Document event versioning strategy
  * Provide indexing strategies and retention policies
  * Include monitoring hooks and filtering examples

- Implement event indexing infrastructure (internal/events/indexing.go)
  * EventIndexer for efficient event querying
  * Support for time-series, entity-based, and composite queries
  * Event aggregation capabilities
  * Event statistics and unindexed event tracking

- Implement event monitoring system (internal/events/monitoring.go)
  * EventMonitor for real-time event listening
  * AnomalyDetector for detecting unusual patterns
  * Alert generation and handling
  * EventFilter and EventAggregator utilities

- Implement advanced event filtering (internal/events/filtering.go)
  * FilterBuilder with fluent API
  * AdvancedEventFilter with operators (eq, ne, gt, gte, lt, lte, contains, in)
  * EventFilterStatistics for analytics
  * EventFilterExporter for JSON/CSV export

- Create database migration (migrations/000025_contract_events_indexing.up.sql)
  * contract_events table with comprehensive indexing
  * event_alerts table for monitoring alerts
  * event_metrics table for performance tracking
  * event_replay_log table for event replay capability
  * Materialized views for daily statistics
  * Database functions for cleanup and queries

- Add event indexing strategy guide (EVENT_INDEXING_STRATEGY.md)
  * Architecture overview and data flow
  * Database schema documentation
  * Indexing strategies (time-series, entity, composite, JSONB, materialized views)
  * Query patterns and monitoring hooks
  * Performance optimization techniques
  * Event retention policy

- Add event versioning documentation (contracts/EVENT_VERSIONING.md)
  * Semantic versioning scheme (MAJOR.MINOR.PATCH)
  * Version evolution rules and migration strategies
  * Deprecation timeline and best practices
  * Indexer compatibility patterns
  * Version roadmap

- Add implementation guide (EVENT_INDEXING_README.md)
  * Component overview and architecture
  * Usage examples for all major features
  * API integration patterns
  * Monitoring dashboard metrics
  * Performance tuning guide
  * Troubleshooting section

Key Features:
- Efficient off-chain event indexing with multiple strategies
- Real-time event monitoring and anomaly detection
- Comprehensive event schema with backward compatibility
- Event versioning for smooth schema evolution
- Advanced filtering and aggregation capabilities
- Performance metrics and SLA tracking
- Event retention policies for compliance
- Monitoring alerts and dashboards

Closes #[event-indexing-issue]
… Soroban contracts

- Add error classification system (transient, permanent, partial)
- Implement exponential backoff with jitter for retry logic
- Add circuit breaker pattern to prevent cascading failures
- Support partial success in batch operations with detailed tracking
- Implement error state persistence and monitoring
- Add comprehensive event emission for all error scenarios
- Create 20 passing unit tests covering all error recovery scenarios
- Integrate error recovery into program-escrow contract

This implementation significantly improves platform reliability by:
- Automatically retrying transient failures (network timeouts, rate limits)
- Preventing permanent error retries (insufficient funds, invalid addresses)
- Allowing batch operations to partially succeed instead of all-or-nothing
- Tracking failed batch items for targeted retry
- Implementing circuit breakers to prevent system overload
- Providing detailed error events for monitoring and debugging

All tests passing (36/36)
- Create comprehensive SDK for Grainlify contracts
- TypeScript bindings from contract ABIs
- Client classes for Core and Escrow contracts
- Examples for all workflows: lock funds, release funds, batch payouts, query escrow
- Error handling utilities
- Complete documentation and usage guide
- Remove node_modules directory from contracts/sdk
- Add node_modules/ to root .gitignore to prevent future commits
…tracts

- Added ContractPaused error (code 11) to bounty escrow
- Added IsPaused state to contract storage (DataKey enum)
- Implemented pause() and unpause() functions (admin-only)
- Implemented emergency_withdraw() for critical fund recovery (paused state only)
- Added pause checks to all state-changing functions:
  - lock_funds, release_funds, refund
  - batch_lock_funds, batch_release_funds
- Added pause events: ContractPaused, ContractUnpaused, EmergencyWithdrawal
- Applied same pause functionality to program-escrow contract
- Added pause guards to lock_program_funds, batch_payout, single_payout
- Added pause guards to create_program_release_schedule and release_prog_schedule_automatic
- Implemented is_paused() helper function for querying pause state
- Added comprehensive pause tests:
  - test_pause_functionality: validates pause/unpause and blocked operations
  - test_emergency_withdraw: validates fund recovery during pause
- All operations blocked when paused (fail-fast design)
- Read-only functions unaffected by pause state

Security features:
- Least privilege: only admins can pause/unpause or withdraw
- Fail-closed design: paused contracts reject state-changing operations
- Auditability: all sensitive actions emit events
- State persistence: pause state survives upgrades
- Idempotent operations: pause/unpause can be called multiple times safely
- Fixed duplicate error code 11: moved BatchSizeMismatch to code 18
- ContractPaused now uses code 11 (was duplicated)
- Changed IsPaused storage from instance to persistent storage for better persistence
- Added 2 pause-specific tests: test_pause_functionality and test_emergency_withdraw
- Fixed test assertions to work with Soroban SDK's no_std environment

Test Results:
- Bounty Escrow: 50/50 passing (42 existing + 2 pause tests + 6 other tests)
- All pause functionality working correctly:
  - pause() and unpause() functions properly toggle pause state
  - Pause state persists across function calls
  - is_paused() correctly reports pause status
  - emergency_withdraw() callable when paused
- Fixed initialize_program parameter order in tests (program_id, authorized_key, token)
- Removed unused Vec import
- Fixed deprecated register_stellar_asset_contract warning
- Fixed unused start variable in release_prog_schedule_automatic
- Bounty escrow: 50/50 tests passing
- Program escrow: Core registration tests passing, schedule tests have environmental context issues unrelated to pause feature
NueloSE and others added 25 commits January 28, 2026 19:47
- Accepted pause/unpause/emergency_withdraw functions from master
- Fixed all clippy warnings (unused variables, unnecessary casts, range contains)
- Fixed formatting issues
- All cargo checks pass successfully
…very-retry

feat: Implement Contract Error Recovery and Retry Mechanisms
…in-admin-page

feat(admin): add project management functionality
- Introduced a new Cargo.toml for the benchmarking package.
- Created README.md detailing the benchmarking suite and usage instructions.
- Implemented benchmarks for locking, releasing, and refunding funds in the Bounty Escrow contract.
- Added a library file to facilitate the benchmarking harness.
feat(benchmarks): add benchmarking suite for Bounty Escrow contract
…sync-toast-issues

Fix/profile resync toast issues
…query-function

Feat/escrow history query function
feat: Implement Responsive Leaderboard in Dashboard
…d-view-profile

fix: leaderboard View Profile navigates to selected userfix: correct leaderboard View Profile navigation
…bounties

feat: Implement Partial Payout Functionality for Bounties
…responsive-data-page

frontend: mobile responsiveness for data page
@vercel
Copy link

vercel bot commented Jan 31, 2026

@beebozy is attempting to deploy a commit to the Jagadeesh B's projects Team on Vercel.

A member of the Team first needs to authorize it.

@Jagadeeshftw
Copy link
Owner

@beebozy Please resolve the conflicts & keep changes only in contracts and revert the other changes

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Implement Time-Based Release Schedules