Use Cases

Common Scenarios

This document covers typical user scenarios and how to handle them effectively.

---

Use Case 1: First-Time Staker

Scenario

A user has never used 5xFaction before and wants to participate in their first 7-day epoch.

Preconditions

• User has a Web3 wallet

• User has some ETH for gas

• Currently in deposit phase (Days 1-2)

Steps

Expected Outcome

• User has 100 USDC staked in SHADOW faction

• User waits through 5-day lock phase

• User checks results at end of Day 7

---

Use Case 2: Switching Factions

Scenario

User is currently in SHADOW but wants to switch to BLADE before deposit phase ends (Day 1-2).

Preconditions

• User has existing stake

• Currently in deposit phase (Days 1-2)

Process

1. Withdraw current stake

   withdrawInk(full_amount)

2. Join new faction

   joinClan(BLADE)

3. Re-stake

   stakeInk(amount)

Important Notes

• Faction change requires full withdrawal first

• Must be in deposit phase (Days 1-2 only)

• Gas costs for 3 transactions

• Cannot switch during lock phase (Days 3-7)

---

Use Case 3: Adding to Existing Stake

Scenario

User already has 100 USDC in PILLAR and wants to add 50 more.

Preconditions

• Already in a faction

• In deposit phase (Days 1-2)

• Has USDC balance

Steps

Key Point

No need to join faction again — just stake more during deposit phase.

---

Use Case 4: Emergency Withdrawal

Scenario

User needs to withdraw funds urgently, regardless of game state.

Availability

Phase	Days	Can Withdraw?
Deposit Phase	1-2	✅ Yes
Lock Phase	3-7	✅ Yes
Any Time	All	✅ Yes

Process

// User can always withdraw
withdrawInk(amount);
// USDC returned immediately

Important

• Withdrawal during lock phase means forfeiting any potential yield

• Principal is always 100% accessible

• No penalties for early withdrawal

---

Use Case 5: Claiming Epoch Rewards

Scenario

User's faction won the epoch after 7 days and they want to claim their yield share.

Preconditions

• User was in winning faction

• 7-day epoch has ended

• clearCanvas() has been called

How Yield Works

The 5-day lock phase generates yield from DeFi lending:

Example

• Total yield (5 days): 500 USDC

• BLADE wins with 500,000 USDC TVL

• User has 10,000 USDC in BLADE

• User share: (10,000 / 500,000) × 500 = 10 USDC

---

Use Case 6: Triggering New Epoch

Scenario

7-day epoch has ended but no one has called clearCanvas() yet.

Who Can Call

Anyone — it's a public function with no permissions.

Incentive

First caller pays gas but enables new epoch for everyone.

Process

// Anyone can call after 7 days elapsed
contract.clearCanvas();
// Previous epoch resolved
// New deposit phase begins

---

Use Case 7: Analyzing Current Meta

Scenario

Strategic user on Day 1-2 wants to find the optimal faction to join.

Step 1: Get Current TVLs

Faction	TVL
SHADOW	$45,000
BLADE	$80,000
SPIRIT	$30,000
PILLAR	$65,000
WIND	$40,000

Step 2: Calculate Scores

SHADOW = (SPIRIT + WIND) - (BLADE + PILLAR) = 70K - 145K = -75K
BLADE  = (SHADOW + PILLAR) - (SPIRIT + WIND) = 110K - 70K = +40K ⭐
SPIRIT = (BLADE + WIND) - (SHADOW + PILLAR) = 120K - 110K = +10K
PILLAR = (SHADOW + SPIRIT) - (BLADE + WIND) = 75K - 120K = -45K
WIND   = (BLADE + PILLAR) - (SHADOW + SPIRIT) = 145K - 75K = +70K ⭐⭐

Step 3: Decision

Current leader: WIND (+70K)

Options:

1. Follow the leader — Join WIND for safety

2. Counter-play — Join WIND's predators (SHADOW/SPIRIT) hoping others do the same

Step 4: Timing Consideration

Timing	Strategy
Early Day 1	More uncertainty, TVL can shift significantly
Late Day 2	Last chance to adjust, more stable picture

---

Use Case 8: Long-Term Strategy

Scenario

User wants to participate across multiple 7-day epochs with consistent returns.

Weekly Commitment

Week 1: Join → Wait 7 days → Results
Week 2: Adjust → Wait 7 days → Results
Week 3: Refine → Wait 7 days → Results
...

Strategy Options

Strategy	Risk	Description
Momentum	Medium	Always join current highest score on Day 2
Contrarian	High	Join unpopular factions on Day 1
Compound	Low	Reinvest winnings each epoch
Meta-Read	High	Predict Day 2 late shifts

Multi-Epoch Flow