Team Wallet #

Preview
The features described below are in preview at the moment.

Overview #

Team Wallets facilitate collaborative management of shared virtual currencies among teams, enhancing collective economic strategies and resource allocation. It allows team members to view balances, while granting exclusive fund management capabilities to team admins to ensure coordination and prevent misuse.

Key Operations #

Team Wallet enables teams to manage shared funds, promoting strategic resource management and cooperative gameplay. The system supports:

  • Viewing wallet balances and recent transaction updates.
  • Admin-exclusive currency modifications through grants.
  • Prevention of negative balances.

Get #

  • Retrieve the current wallet balances and recent update history.

Grant (Admins only) #

  • Modify wallet balances by adding or deducting currency.
  • Ensures that deductions do not exceed available balances, preventing negative balances.

Example Implementation #

Clan Donation and Rewards System (PvP Game Scenario) #

  • Donation: Team members contribute Soft Currency to the shared clan wallet.
  • Investment: Admins allocate funds for team-wide buffs or tournament entry fees.
  • Rewards: Winning competitions grants Hard Currency or valuable resources to the shared wallet.
  • Redistribution: Admins strategically reinvest earnings into upgrades or further event entries.

This example demonstrates how the Team Wallet promotes strategic team coordination, individual contributions to shared goals, and competitive gameplay.

Key Terms #

  • Shared Wallet: Single wallet accessible to all team members but managed by admins.
  • Grant Funds: An admin-controlled operation for safely adding or subtracting currency.
  • Currency Initialization: Automatic wallet setup based on predefined configurations, removing manual setup needs.
  • Versioned Storage: Version-controlled storage updates ensure data integrity and concurrency control.

Important Sub-concepts #

Access Control #

  • View: Members can view wallet balances and transaction updates.
  • Modify: Only Admins can modify wallet balances.

Negative Grants #

  • Allow admins to deduct funds using negative values.
  • Ensure deductions are never greater than the available balance.

Hard Currency #

  • Accepted through in-game activities like in-app purchases (IAP), tournaments, and special events.

Technical Considerations #

Null or Missing Currencies #

  • Transactions involving undefined currencies are rejected.
  • The wallet supports only currencies predefined in the Hiro configuration.

Version Control in Storage #

  • Utilized to handle concurrent wallet updates.
  • Prevents conflicts and maintains consistency across all team member views.