How nikhilthadani/stake-math-sdk-vicecartel works
Stake Engine Math SDK defines game-specific rules and configuration, simulates outcomes into event books and lookup data, and optimizes win distributions. The principal workflow is to run a game, generate boards and resolve game mechanics, record wins/events, then write simulation and publish artifacts; analysis and AWS upload are supporting capabilities. The tree and excerpts establish the shared runtime layers, but do not show the complete game-run orchestration, so uncertain call links are omitted. Optimization and analytics are represented at the documented capability level where their wiring is not sampled.
Main entry points: run.py Game runner · run_sims.py Simulation runner · game_executables.py Game rules · board.py Board generation
Components 20
Game definitions
- Game runner
games/template/run.py - Game configuration
games/template/game_config.py - Game rules
games/template/game_executables.py - Game overrides
games/template/game_override.py
Simulation runtime
- Game state
src/state/state.py - Simulation runner
src/state/run_sims.py - Board generation
src/calculations/board.py - Game calculations
src/calculations - Event recording
src/events/events.py - Win accounting
src/wins/win_manager.py - Book state
src/state/books.py
Outputs and optimization
- Artifact writing
src/write_data/write_data.py - Output paths
src/config/output_filenames.py - Distribution optimizer
optimization_program/src/main.rs - Optimization setup
optimization_program/optimization_config.py
Analysis and delivery
- Game analytics
utils/game_analytics/run_analysis.py - Distribution analysis
utils/analysis/distribution_functions.py - AWS upload
uploads/aws_upload.py
Other components
- Game developer
- Amazon S3
Connections 18
- Game developer → Game runner: runs game
- Game runner → Game configuration: loads settings
- Game runner → Simulation runner: starts simulations
- Simulation runner → Game state: updates state
- Game rules → Board generation: draws board
- Board generation → Game calculations: provides board
- Game calculations → Win accounting: updates wins
- Game rules → Event recording: records events
- Event recording → Book state: adds events
- Win accounting → Game state: tracks payouts
- Simulation runner → Artifact writing: writes results
- Artifact writing → Output paths: uses paths
- Game developer → Optimization setup: sets targets
- Optimization setup → Distribution optimizer: configures
- Game developer → Game analytics: analyzes results
- Game analytics → Distribution analysis: calculates metrics
- Game developer → AWS upload: requests upload
- AWS upload → Amazon S3: uploads artifacts