Skip to main content

Economy Module

The hybrid settlement layer for competitive games: off-chain heavy execution, on-chain trustless financial finality.

Overview​

The Economy module is the financial trust anchor of Monsuta Core.

It is designed around a hybrid architecture:

  • Off-chain systems handle high-frequency and computation-heavy tasks (competition logic, standings, payout calculation, orchestration).
  • On-chain contracts handle fund custody, settlement finalization, claims, refunds, and verifiable state transitions.

This split preserves performance while protecting player funds and settlement integrity.

Core Principle: Hybrid by Design​

For competitive games, putting everything on-chain is expensive and slow; keeping everything off-chain is fast but trust-heavy.

Monsuta’s model intentionally combines both:

Off-chain (game backend + workers)​

  • Match/tournament computation
  • Ranking, seasons, leagues, and final standings
  • Exact payout amount calculation
  • Queueing and operational automation
  • Monitoring and alerting

On-chain (Economy contracts)​

  • Prize fund escrow
  • Lifecycle state enforcement
  • Immutable result finalization
  • Winner claim rights
  • Cancellation/refund guarantees
  • Treasury fee accounting

Current Economy Components​

ComponentStatusRole
Prize PoolsImplemented + testedTrustless escrow and payout settlement for tournaments/events
NFT StakingIn progress / expanded operational modelNon-custodial reward distribution with off-chain epoch computation + on-chain verification
TreasuryPlanned/partial design stageRevenue routing and allocation layer

Prize Pools: Current Status​

Prize Pools are currently the most mature part of the Economy module.

What is live in the implementation​

  • Factory + pool architecture in place (PrizePoolFactory + per-competition PrizePool proxies)
  • Full competition lifecycle support:
    • Created -> Registering -> Active -> Finalized -> Completed
    • cancellation path: -> Cancelled -> refund
  • Settlement support for:
    • Native AVAX pools
    • ERC-20 pools
  • Operational scripts for:
    • deploy, preflight, verify, status
    • create/open/fund/register/activate/results/claim/cancel/refund
  • Distributor worker scaffold and runtime for automated result submission + audits
  • Passing contract lifecycle tests (native and ERC-20 paths)

Why this matters​

This already enables the core value proposition:

  1. Competition outcomes can be computed off-chain for speed.
  2. Funds remain escrowed on-chain.
  3. Winners claim directly from contract-enforced settlement.

Security Boundary​

A key design objective is separation of powers:

  • Backend/server can determine competition results and submit them through authorized pathways.
  • Contracts enforce who can do what and when.
  • Winners do not rely on manual custodial payout transfers from operators.

This reduces operational trust assumptions where money moves.

Practical Integration Pattern​

Competition backend finalizes standings
        ->
Payout amounts computed off-chain
        ->
Settlement payload queued/signed
        ->
Authorized submission to PrizePool
        ->
Pool finalizes
        ->
Winners claim on-chain

This is the intended “massively hybrid” operating model for Monsuta Core.

What Comes Next (Economy Roadmap Focus)​

Priority direction for near-term hardening and scale:

  1. Prize Pool settlement hardening

    • Stronger attestation/signature verification flows
    • Operational idempotency and replay-safe submission patterns
    • Monitoring/alerting around stale and near-deadline pools

  2. Operational readiness

    • Expanded smoke-test evidence
    • Admin role safety (multisig/rotation runbooks)
    • Incident and recovery procedures

  3. Treasury progression

    • Complete treasury routing architecture
    • Integrate fee and reward flow controls with Prize Pools and staking

Why Other Games Can Reuse This​

The Economy module is intentionally modular and game-agnostic:

  • Use Prize Pools alone if you only need competition escrow.
  • Add staking if you need long-term participation rewards.
  • Add treasury when you need programmable allocation flows.

You can adopt only what your game needs while keeping settlement guarantees where they matter most.

Summary​

The Economy module is not “all on-chain” and not “all off-chain.”
It is intentionally hybrid:

  • Off-chain for speed and complexity
  • On-chain for custody and settlement trust

Today, Prize Pools are the strongest realized part of this vision and already provide a practical path to trust-minimized competitive payouts.