Getting Started

Learn how to connect your wallet and start playing provably fair games on Kelly4X.

Prerequisites

Before you begin, make sure you have:

• A Web3 wallet (MetaMask, Rainbow, Coinbase Wallet, or WalletConnect-compatible)
• ETH on your chosen network for gas fees and betting
• Basic understanding of blockchain transactions and gas fees

Step 1: Connect Your Wallet

Click the "Connect Wallet" button in the top right corner and select your wallet provider.

Step 2: Get Tokens

Kelly4X supports betting with multiple tokens:

• Native ETH: Use ETH directly (no token approval needed)
• USDC: Stablecoin for predictable bet sizing
• WETH: Wrapped ETH for ERC20-compatible betting
• DAI: Decentralized stablecoin
• Other ERC20s: Any ERC20 token with sufficient liquidity

You can obtain these tokens through:

• Centralized exchanges (Coinbase, Binance, etc.)
• DEXs like Uniswap or Curve
• Bridge from other chains

Step 3: Browse Games

Navigate to the Play page to see available games:

• Coin Flip: Classic 50/50 game with various multipliers
• Dice (Coming Soon): Roll dice with configurable win conditions
• Roulette (Coming Soon): European/American roulette

Step 4: Place Your First Bet

Basic Betting

1. Select a game (e.g., Coin Flip)
2. Choose your bet amount
3. Select your bet type (e.g., Heads or Tails)
4. Choose Kelly multiplier for winnings (or 0 for direct payout)
5. Approve token spending if using ERC20 (one-time per token)
6. Confirm the bet transaction

Understanding Fees

When placing a bet, you pay:

• Bet Fee (betFeeWei): Small ETH fee (~$0.10-1.00) to cover settlement gas costs
• Attestation Fee (optional): Additional fee to receive full TEE attestation report with settlement
• Gas Costs: Standard network transaction fees

Auto-LP Conversion

Kelly4X has a unique feature: winners can automatically receive LP tokens instead of direct payouts.

• Kelly Multiplier = 0: Receive tokens/ETH directly
• Kelly Multiplier = 1x, 2x, 4x, 8x: Receive LP tokens for that risk tier
• LP Tokens: Automatically earn yield from house edge on future bets
• Withdraw Anytime: Burn LP tokens to withdraw underlying assets

Step 5: Wait for Settlement

After placing a bet:

1. Commit Phase: TEE operator commits to settlement (~ 1 block)
2. Reveal Phase: TEE reveals random value and signature
3. Verification: Contract verifies TEE signature
4. Payout: Winnings sent to your wallet (or converted to LP)

Settlement typically takes 2-5 blocks (~30 seconds to 1 minute). You can track pending bets in the LP Activity drawer at the bottom of the page.

Step 6: Provide Liquidity (Optional)

Instead of just playing, you can become the house by providing liquidity:

1. Navigate to Liquidity page
2. Choose a token (ETH, USDC, etc.)
3. Select a Kelly multiplier tier:
   • 1x Kelly: Conservative (lowest risk, lowest returns)
   • 2x Kelly: Balanced
   • 4x Kelly: Aggressive
   • 8x Kelly: Degen (highest risk, highest returns)
4. Enter amount to provide
5. Receive LP tokens representing your share of the pool

LP Earnings

LP providers earn from:

• House Edge: Percentage of every losing bet goes to LPs
• Pool Share: Your earnings proportional to your share of the pool
• Cascading Profits: Higher multiplier pools participate in more bets

LP Risks

Be aware that:

• LPs lose funds when players win
• Higher Kelly multipliers = higher risk and higher potential returns
• Locked liquidity cannot be withdrawn until bets are settled
• Progressive jackpots bypass LP pools (jackpots funded separately)

Advanced Features

Betting with LP Tokens

You can bet using your LP tokens directly:

1. When placing a bet, select "Use LP Tokens"
2. Choose which LP pools to withdraw from
3. LP tokens are burned and converted to bet amount

Requesting TEE Attestation

For maximum trust minimization:

1. When placing bet, enable "Request Attestation"
2. Pay additional attestationFeeWei
3. Receive full TEE attestation report with settlement
4. Independently verify attestation off-chain

Emergency Procedures

Bet Not Settled

If your bet isn't settled within 24 hours:

1. Navigate to your pending bets
2. Click "Cancel Bet"
3. Receive full refund of bet amount + bet fee

Need Help?

If you encounter issues:

• Check the FAQ
• Join community channels (Discord/Telegram)
• Review your transaction on block explorer
• Verify contract addresses match official deployment