# User Journey

Complete user journey from sign-up to earning rewards on Money Race.

***

## 🚀 Getting Started

### Step 1: Connect Your Account

Two options to get started — **both gasless**:

![connect account to MoneyRace](https://420505499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FreyUdxZN0v5TJdgQKzDV%2Fuploads%2Fgit-blob-578ae812811f607e45a2bd1b349f267b917c3552%2Floginway.png?alt=media)

**Google Login (zkLogin):**

* No wallet needed — one-click sign-in
* Automatic keypair generation
* Perfect for Web2 users

**Wallet Connect:**

* Direct Sui wallet integration (dapp-kit)
* Full control of your keys
* Supports all major Sui wallets

**All transactions are gasless** — backend sponsors gas fees.

***

### Step 2: Browse Savings Rooms

Explore available rooms on the dashboard:

| Room Info          | Example                  |
| ------------------ | ------------------------ |
| **Name**           | "Daily Savers Club"      |
| **Duration**       | 14 days (minimum 7 days) |
| **Deposit Amount** | 10 USDC                  |
| **Period**         | Daily (or Weekly)        |
| **Participants**   | 12/20                    |
| **Strategy**       | Balanced (\~8% APY)      |
| **Status**         | OPEN                     |

***

### Step 3: Join a Room

1. Select a room matching your savings goal
2. Review parameters (duration, amount, strategy)
3. Get AI recommendation (optional) → EigenAI analyzes your prompt
4. Make initial deposit (gasless!)
5. You're in! 🏁

**No gas fees** — just deposit USDC.

***

### Step 4: Periodic Deposits

Make deposits each period to stay consistent:

```
Period 1: ✅ 10 USDC deposited
Period 2: ✅ 10 USDC deposited
Period 3: ⏳ Current period (5 days left)
Period 4: 🔒 Future period
```

**Period Length:** Daily or Weekly (set when room is created)

**Important:**

* Miss a deposit → You get less yield share (NOT penalized on principal)
* Your principal is always safe
* Consistency = higher reward share

***

### Step 5: Track Your Progress

Monitor performance on the dashboard:

* **Total Deposited** — How much you've saved
* **Consistency** — Deposits made / Total periods
* **Room Status** — OPEN / ACTIVE / FINISHED
* **Your Share** — Estimated % of yield pool
* **Yield Projection** — Expected rewards based on current rate

***

### Step 6: Claim Rewards 🏆

When room is FINISHED, claim your payout:

```
Room Complete!

Your Stats:
├── Periods Completed: 5/5 (100%)
├── Total Deposited: 500 USDC
├── Your Share: 45.45% of yield pool
└── Yield Earned: 4.5 USDC

Total Payout: 504.5 USDC
  ├── Principal: 500 USDC (100% returned ✅)
  └── Yield: 4.5 USDC (from DeFi protocols)
```

**Claim is gasless** — funds sent to your wallet instantly.

***

## 📊 Flow Diagram

![Money Race - How It Works Flowchart](https://420505499-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FreyUdxZN0v5TJdgQKzDV%2Fuploads%2Fgit-blob-4f9d73005da73b8346c96530ddba253c72ef252a%2Fflowdiagram.png?alt=media)

***

## How Yield is Distributed

**Proportional to consistency:**

```
Your Yield Share = (your_deposits / total_deposits) × total_yield
```

**Example:** Room with 11 total deposits, 10 USDC yield

* Alice (5 deposits) → 5/11 × 10 = 4.545 USDC
* Bob (4 deposits) → 4/11 × 10 = 3.636 USDC
* Carol (2 deposits) → 2/11 × 10 = 1.818 USDC

**Everyone gets principal back 100%.** Yield is the bonus for consistency.

***

## Technical Flow

For developers:

| Step | Action               | Smart Contract                    | Gasless? |
| ---- | -------------------- | --------------------------------- | -------- |
| 1    | **Auth**             | zkLogin or wallet signature       | N/A      |
| 2    | **Join Room**        | `join_room()` + first deposit     | ✅ Yes    |
| 3    | **Periodic Deposit** | `deposit()` with USDC             | ✅ Yes    |
| 4    | **Admin Start**      | `start_room()` (admin)            | ✅ Yes    |
| 5    | **Admin Finalize**   | `finalize_room()` (admin)         | ✅ Yes    |
| 6    | **Claim Rewards**    | `claim_all()` → principal + yield | ✅ Yes    |

**How gasless works:**

* User signs transaction with their key
* Backend adds sponsor signature (multi-sig)
* Sponsor pays gas in SUI
* User only needs USDC

***

## Smart Contract Events

All actions emit events for transparency:

* `RoomCreated` → New room initialized
* `PlayerJoined` → User joins with first deposit
* `DepositMade` → Periodic deposit recorded
* `YieldAccrued` → Yield calculated and moved to reward pool
* `RewardsClaimed` → User withdraws principal + yield

***

[Next: Savings Rooms →](https://moneyrace.gitbook.io/moneyracedocs/how-it-works/savings-rooms)