Skip to content

CHANGELOG.md

Latest commit

 

History

History
45 lines (36 loc) · 3.58 KB

CHANGELOG.md

File metadata and controls

45 lines (36 loc) · 3.58 KB
Raw

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

Added

  • admin_resolve_stalled_match — admin-gated recovery function for Active matches stuck after the 24-hour player rollback window expires and the oracle has failed to submit a result for more than 7 days. Provides a bounded recovery path so funds are never permanently locked in the event of prolonged oracle outage or lost signing keys.
  • ADMIN_STALL_WINDOW_SECONDS constant (7 days) — configurable threshold after which admin can invoke stall resolution, long enough not to compete with the player-initiated 24-hour rollback window.
  • admin_freeze_player / admin_unfreeze_player — targeted per-player freeze that blocks a single address from creating matches and depositing, without pausing the contract for other users. The freeze reason is stored on-chain; is_player_frozen / get_frozen_players expose state. Fund-recovery paths (cancel/expire/claim) and oracle settlement of existing matches are deliberately unaffected.

Fixed

  • Active matches with no oracle response are no longer permanently unrecoverable after the 24-hour dispute_and_rollback_match window elapses. The new admin recovery function closes the gap identified in Issue #1274, ensuring funds can always be recovered after a bounded stall period.

1.0.0 - 2026-06-29

Added

  • Soroban escrow smart contract for trustless chess wagering on Stellar
  • Match lifecycle management: Pending → Active → Completed / Cancelled states
  • create_match — register a wager with stake amount, token address, and Lichess/Chess.com game ID
  • deposit — both players lock funds into escrow before the game starts
  • submit_result / submit_result_with_oracle_record — oracle submits verified result and triggers automatic payout in a single transaction
  • cancel_match — either player can cancel before the match becomes active
  • expire_match — anyone can expire a match after the configured timeout elapses; stakes are refunded
  • Draw handling — both players receive their stake back on a draw result
  • Flexible token support — any Stellar token is accepted by default; once an admin allowlists at least one token, only allowlisted tokens are accepted
  • add_allowed_token admin function for token allowlist management
  • get_match, get_player_matches, get_pending_matches, get_active_matches query helpers
  • is_funded and get_escrow_balance escrow inspection helpers
  • Oracle contract for bridging Lichess API results on-chain
  • Admin controls: pause / unpause, update_oracle, transfer_admin, configurable match timeout
  • On-chain event emission for all state transitions (see README Events Reference)
  • Oracle service (Rust) polling Lichess for game results and submitting them to the contract
  • Frontend scaffold (React + Vite + TypeScript) with Stellar wallet integration
  • Event indexer service for querying historical match and payout data
  • Deployment scripts for testnet and mainnet (scripts/deploy.sh, scripts/deploy_testnet.sh)
  • Comprehensive test suite covering match creation, deposits, payouts, draws, cancellations, and error paths
  • Documentation: architecture overview, oracle design, threat model & security, deployment guide, error codes reference, interactive tutorial, and FAQ