Savings Rooms
What are Savings Rooms?
Savings Rooms are the core unit of Money Race. Each room is a group savings challenge where participants commit to periodic deposits (daily or weekly) and earn yield based on consistency.
Key Principles:
🔐 Principal Protected — Your deposits are always returned 100%
🆓 Gasless — All transactions sponsored by backend
📊 Proportional Yield — Rewards based on consistency, not penalties
👥 Group Advantage — Larger vaults generate better yields
Room Parameters
When creating or joining a room, you'll see these configurable parameters:
Duration
Minimum 7 days
Total challenge length
Deposit Amount
Custom (USDC)
Amount per period (e.g., 10 USDC)
Period Length
Daily or Weekly
How often deposits are made
Strategy
Conservative / Balanced / Aggressive
Risk & yield profile (4%/8%/15% APY)
Privacy
Public or Password-protected
Room accessibility
Examples:
Creating a Room
Steps:
Navigate to Dashboard → "Create Room"
Set Parameters:
Get AI Recommendation (Optional)
Describe your goal to EigenAI
AI suggests optimal strategy and parameters
Review Summary:
Total periods calculated automatically
Expected yield projection shown
Gasless transaction confirmed
Confirm Creation
Room is created on-chain
Shareable link generated
Room enters OPEN status
Note: Creating a room does NOT automatically join it. You must join separately with your first deposit.
Joining a Room
Requirements:
✅ Connected account (Sui wallet or Google via zkLogin) ✅ Sufficient USDC for initial deposit ✅ Room has available spots ✅ Room is in OPEN status (not started yet)
Steps:
Browse Rooms — Explore available rooms on dashboard
Review Details — Check duration, deposit amount, strategy
Make First Deposit — Deposit exact amount (gasless!)
Receive Confirmation — PlayerPosition NFT created for you
Track Progress — Monitor your consistency on leaderboard
Gasless: You only need USDC. Backend sponsors all gas fees in SUI.
Room Lifecycle
Rooms have 3 states defined in the smart contract:
1. OPEN 🟢
What you can do:
Join the room
Review room parameters
Invite friends
2. ACTIVE 🟡
What you can do:
Make periodic deposits (daily/weekly)
View your position on leaderboard
Track your deposit history
Monitor yield accrual
Important:
You can only deposit once per period
Missing a deposit = less yield share (NOT penalized on principal)
Period is determined by start time + period length
3. FINISHED ✅
What you can do:
Claim your principal + yield
View final statistics
Check your rank
Claim is gasless!
How Deposits Work
Period Calculation
Example (Daily):
Start time: Jan 1, 00:00
Period length: 24 hours
Jan 1 → Period 0
Jan 2 → Period 1
Jan 3 → Period 2
Example (Weekly):
Start time: Jan 1, 00:00
Period length: 7 days
Jan 1-7 → Period 0
Jan 8-14 → Period 1
Deposit Rules
✅ Can deposit:
During your assigned period
Exact deposit amount only
Once per period maximum
Gasless transaction
❌ Cannot deposit:
Before room starts
After room is finalized
In a period you already deposited
Wrong amount
Yield Distribution
Money Race uses proportional distribution — NOT penalties.
Formula:
Example:
Room: 5 periods, 10 USDC deposit/period, Balanced strategy (~8% APY)
Alice
5/5 (100%)
5
4.545 USDC
50 USDC
54.545 USDC
Bob
4/5 (80%)
4
3.636 USDC
40 USDC
43.636 USDC
Carol
2/5 (40%)
2
1.818 USDC
20 USDC
21.818 USDC
Key Insights:
Everyone gets their principal back 100%
Yield shared proportionally by consistency
No penalties for missing deposits
Missing deposits only reduces your yield share, not capital
Room Discovery
Finding Rooms:
Public Rooms:
Browse all available rooms on the Active Room tab
Filter by duration, deposit amount, strategy
Sort by participants, APY, time remaining
Visible to all users on the dashboard
Private Rooms:
Private rooms are designed for users who want to save together with people they know — friends, family, or community groups
Private rooms do NOT appear in the Active Room tab, keeping them hidden from public browsing
To join a private room, users must search by Room Password or Room ID shared by the room creator
Once joined, private rooms will appear in the My Room tab alongside your other rooms
Same mechanics and yield distribution as public rooms — only the visibility differs
How to Join a Private Room:
Get the Room Password or Room ID from the room creator
Use the search/join feature on the dashboard
Enter the password or ID to find the room
Make your first deposit to join (gasless!)
The room will now be visible in your My Room tab
Advanced Features
Leaderboard
Track your position in real-time:
Rank — Based on consistency (deposits made)
Total Deposited — Your cumulative deposits
Consistency % — Deposits made / Total periods
Projected Yield — Estimated rewards
Room Analytics
View comprehensive stats:
Total participants
Total deposits (vault size)
Current yield accrued
Room progress %
Strategy performance
Testnet vs Mainnet
Yield Source
Simulated (cuts from principal)
Real (from DeFi protocols)
Principal
Reduced by simulated yield
Stays 100% intact
Protocols
None (simulation)
Scallop, Navi, Cetus, etc.
APY
Fixed (4%/8%/15%)
Variable (market rates)
Note: Current testnet simulates yield by moving principal to reward pool. Mainnet will deploy funds to real Sui DeFi protocols, so your principal remains untouched and yield comes from external sources.
Tips for Success
Choose Realistic Duration — Don't commit to periods you can't fulfill
Set Reminders — Mark deposit days on calendar
Join with Friends — Social accountability increases consistency
Start Conservative — Begin with shorter durations, lower amounts
Use AI Recommendation — Let EigenAI suggest optimal parameters
Last updated