Godot: sistema de turnos con fases commit/reveal (integración Soroban)

[leocagli]

Objetivo

Implementar el sistema de turnos con las fases Commit → Reveal → Resolve integradas con el flujo ZK del contrato Soroban existente.

Alcance

• Autoload TurnManager con máquina de estados de fases
• Fases: COMMIT (el jugador envía acción cifrada), REVEAL (revela clave), RESOLVE (aplica resultado on-chain)
• Integración con funciones del contrato contracts/src/lib.rs: init_game, commit_action, reveal_action, finalise_turn
• Botón "Finalizar turno" en HUD que dispara la fase correcta
• Ejecución de turno de bots (aleatoria / IA simple en primer sprint)
• Señales emitidas al EventBus en cada cambio de fase

Skill de referencia

/godot-turn-system

Tareas

• Crear autoloads/TurnManager.gd con enum Phase y var current_phase
• Métodos begin_commit(), submit_commit(hash), begin_reveal(), submit_reveal(key), resolve()
• Conectar submit_commit / submit_reveal con JavaScriptBridge (ver #godot-web-bridge)
• Lógica de turno de bot: recopilar acciones aleatorias y llamar a commit_action vía bridge
• Botón "Fin de turno" en HUD que llama TurnManager.begin_commit()
• Emitir EventBus.turn_phase_changed(phase) en cada transición

Aceptación

Una partida completa de 3 turnos finaliza sin errores, las transacciones Soroban se invocan en orden correcto y el estado on-chain refleja las acciones del jugador.

🎁 Evidencia visual = reward extra

• Si tu PR incluye video demo o capturas de pantalla mostrando la funcionalidad pedida funcionando end-to-end, va a ser considerado para rewards de GrantFox en esta issue. No es obligatorio, pero suma mucho para la evaluación.

[gloskull]

Hi, I’d love to work on this issue. I have 4 years of experience across backend, frontend, full-stack, and smart contract development. I understand the task clearly and can deliver a clean, efficient, well-tested solution on time, with strong focus on code quality and maintainability. My PR will be submitted in under 10 hours.

[leocagli]

🟢 Reopened for assignment. The only interest so far was from accounts flagged for automated mass-claiming (gloskull). This issue is open — comment /assign to take it.

[leocagli]

🟢 Reopened for assignment. The only interest so far was from accounts flagged for automated mass-claiming (gloskull). This issue is open — comment /assign to take it.

[Vinaystwt]

I can take this.

I’ll implement the Godot-side turn phase state machine for COMMIT → REVEAL → RESOLVE, using TurnManager and the existing WebBridge/EventBus direction so commit and reveal actions are routed through the browser/Soroban bridge instead of being hardcoded into UI nodes.

I’ll add methods like begin_commit, submit_commit, begin_reveal, submit_reveal, and resolve, emit phase-change signals on every transition, and keep the payload shape documented for init_game, commit_action, reveal_action, and finalise_turn. I’ll keep this focused on the turn-flow integration and avoid unrelated gameplay systems.

[grantfox-oss]

🦊 GrantFox — @Vinaystwt has been assigned to this issue!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #35)
2. Your PR will be reviewed by the Bitcoindefi maintainers

Good luck! Track your progress on GrantFox.