Troubleshooting Guide

1. Clear browser cache and cookies
2. Update MetaMask to latest version
3. Disable other wallet extensions (conflicts)
4. Check internet connection stable
5. Try different RPC endpoint:
   - https://testnet-rpc.wicchain.com
   - https://testnet-rpc2.wicchain.com (if exists)
6. Use hardware wallet (more stable)

1. CooldownActive Error
   └─ Wait 60 seconds after last action
   └─ Check lastActionTime on explorer
   └─ Plan transactions with cooldown in mind

2. Insufficient Allowance
   └─ Approve WICC tokens first
   └─ Check current allowance
   └─ Approve more if needed

3. Amount Too Low
   └─ Minimum stake: 100 WICC
   └─ Check meets requirements
   └─ Increase amount

4. No Claimable Rewards
   └─ Wait for interest to accumulate (1+ days)
   └─ Check pending interest > 0
   └─ Try claiming tomorrow

5. Contract State Changed
   └─ Refresh page
   └─ Get latest contract state
   └─ Retry transaction

6. Gas Limit Too Low
   └─ Increase gas limit manually
   └─ Try 50,000 - 100,000 gas
   └─ Don't worry about unused gas (refunded)

7. Slippage/Price Changed
   └─ If swapping first, adjust slippage
   └─ Try transaction again
   └─ Check current prices

1. Wait for Lower Congestion
   ├─ Check gas tracker
   ├─ Weekend usually cheaper
   ├─ Early morning UTC best
   └─ Avoid major events

2. Adjust Gas Settings
   ├─ Set gas price manually
   ├─ Use "slow" option
   ├─ Wait longer for confirmation
   └─ Don't overpay

3. Batch Operations
   ├─ Claim all positions together
   ├─ Multiple actions in one session
   ├─ Save 66% on gas
   └─ Plan ahead

4. Check Network
   ├─ Verify on WicChain (should be cheap)
   ├─ If on Ethereum = WRONG NETWORK
   ├─ Switch to WicChain Testnet
   └─ Try again

Check These:

□ Amount ≥ 100 WICC (minimum)
□ Have enough WICC balance
□ Approved enough tokens
□ Not in cooldown (60s)
□ Have WIC for gas
□ On WicChain network
□ Referral address valid (if used)
□ Contract not paused

Common Fixes:

1. Verify amount meets minimum
2. Check balance sufficient
3. Wait for cooldown to end
4. Don't use own address as referrer
5. Leave referrer empty if unsure
6. Try smaller amount first

🕐 60-Second Cooldown

After ANY transaction:
├─ Stake
├─ Claim
├─ Approve
└─ Any contract interaction

You must wait 60 seconds before next action.

How to Check:
1. Note time of last transaction
2. Add 60 seconds
3. Wait until that time
4. Try again

Pro Tip:
Plan to do multiple actions together:
1. Claim all positions
2. Wait 60 seconds
3. Claim referrals
4. Wait 60 seconds
5. Claim vesting

Claimable Amount = min(accrued, available rewards)

Contract has limited reward pool:
- totalStaked: Reserved for stakes
- rewardPool: Available for claims
- contract balance - totalStaked = available

If rewardPool low:
├─ Can only claim what's available
├─ Partial claims issued
└─ Rest waits for pool refill

Example:
- Your accrued: 100 WICC
- Available pool: 50 WICC
- You claim: 50 WICC
- Remaining: 50 WICC accrued still
- Wait for admin to refill pool

Check Pool:
- getContractStats()
- See rewardPool value
- If low, explains partial claims

Quick Fixes:
1. Refresh page (F5)
2. Clear cache (Ctrl+Shift+Delete)
3. Hard refresh (Ctrl+F5)
4. Check different device

Verify On-Chain:
1. Check wallet balance on explorer
2. Verify transaction confirmed
3. Tokens should be there
4. UI just needs refresh

Browser Issues:
1. Try incognito mode
2. Different browser
3. Disable extensions temporarily
4. Clear all site data

1. Cache Issue
   └─ Old data cached
   └─ Clear cache and refresh

2. Multiple Tabs
   └─ Other tab made transaction
   └─ This tab not updated
   └─ Refresh all tabs

3. Network Delay
   └─ Blockchain not synced yet
   └─ Wait 30 seconds
   └─ Refresh

4. Calculation Timing
   └─ Interest calculated per block
   └─ Display may lag slightly
   └─ Actual claim shows correct amount

Fix:
- Close all tabs
- Clear cache
- Reopen platform
- Single tab only
- Should show correct numbers

1. Check Link Format
   Correct: https://staking.dogwithcap.xyz?ref=0xYourAddress
   Wrong:   https://staking.dogwithcap.xyz/?ref=0xYourAddress (extra /)
   Wrong:   https://staking.dogwithcap.xyz?referral=0x... (wrong param)

2. Generate Fresh Link
   - Go to Referral page
   - Copy new link
   - Test in incognito

3. URL Encoding Issues
   - Some messengers modify links
   - Use URL shortener
   - Or share in multiple ways

4. Ask Referee to Verify
   - After clicking link
   - Check "Advanced Options" in Farm
   - Referral field should be pre-filled
   - If not, enter manually

1. Open Developer Console
   - Chrome: F12
   - Firefox: Ctrl+Shift+K
   - Safari: Cmd+Option+C

2. Go to Console Tab

3. Look for Errors
   - Red text = errors
   - Orange = warnings
   - Click to expand

4. Common Error Messages:

   "User rejected"
   └─ You declined in wallet

   "Insufficient funds"
   └─ Need more gas (WIC)

   "Nonce too low"
   └─ Pending transaction blocking
   └─ Cancel or wait

   "execution reverted"
   └─ Contract rejected
   └─ Check error reason

5. Copy Error for Support
   - Right click error
   - "Copy message"
   - Include in support ticket

1. This troubleshooting guide (you're here!)
2. [FAQ](/support/faq)
3. [User Guide](/user-guide)
4. [Smart Contract Docs](/smart-contracts)
5. Discord Community (search past Q&A)

✅ Read documentation before acting
✅ Test with small amounts first
✅ Understand cooldown system (60s)
✅ Keep gas buffer (0.1+ WIC)
✅ Verify network is WicChain
✅ Double-check amounts before confirm
✅ Use bookmarked URL only
✅ Keep wallet software updated
✅ Regular security practices
✅ Save transaction hashes

Weekly:
├─ Update wallet app
├─ Clear browser cache
└─ Review recent transactions

Monthly:
├─ Security audit
├─ Update passwords
└─ Verify backups

Quarterly:
├─ Full system review
├─ Check seed phrase backup
└─ Test recovery process

CooldownActive
└─ Wait 60 seconds after last transaction

InsufficientRewardPool
└─ Admin needs to refill rewards, try later

NoClaimableInterest
└─ Wait for 1+ full day to pass

AmountTooLow
└─ Minimum stake is 100 WICC

InvalidPosition
└─ Position doesn't exist or not yours

SelfReferral
└─ Can't refer your own address

InsufficientAllowance
└─ Approve WICC tokens first

Paused
└─ Platform temporarily paused by admin

✅ Connection: Check network, refresh, reconnect
✅ Gas: Get WIC from faucet
✅ Transaction: Wait for cooldown, check requirements
✅ Claiming: Wait full day, check reward pool
✅ Display: Refresh page, clear cache
✅ Mobile: Update app, use DApp browser