contract-interaction-diagrams.md

Contract Interaction Diagrams

These diagrams document how the frontend coordinates Lernza's contracts for the main MVP flows.

The current codebase uses quest as the quest contract name. The diagrams use "Quest Contract" so the user-facing concept and the on-chain module stay aligned.

Flows

• Quest creation flow
• Enrollment flow
• Funding flow
• Milestone completion and reward distribution flow

Notes

• The frontend is the orchestration layer for MVP flows. Lernza contracts do not call each other directly.
• Not every flow touches all three contracts. The frontend only calls the contracts needed for that user action.
• Funding and payout flows also interact with the Stellar asset contract that backs the reward token.