Troubleshooting

Common issues and solutions for RedCarpetHQ users.

Wallet Issues

Cannot Connect Wallet

Symptoms:

  • "Connect Wallet" button not working

  • Wallet popup doesn't appear

  • Connection fails immediately
  • Solutions:

    1. Check Browser Extension
    ``
    ✓ MetaMask installed
    ✓ Extension enabled
    ✓ Not in private/incognito mode
    ✓ No conflicting extensions
    `

    2. Refresh and Retry

  • Refresh page (Cmd/Ctrl + R)

  • Clear cache (Cmd/Ctrl + Shift + R)

  • Try different browser

  • Restart browser
  • 3. Check Network

  • Switch to the correct network in MetaMask

  • Verify RPC connection

  • Try a different RPC endpoint
  • 4. Disable Other Wallets

  • Only one wallet extension active

  • Disable Coinbase Wallet, etc.

  • Restart browser after disabling
  • Wrong Network

    Symptoms:

  • "Wrong network" warning

  • Transactions fail

  • Cannot see campaigns
  • Solutions:

    1. Switch to the Correct Network
    `
    MetaMask → Network dropdown → Select the platform network
    `

    2. Add Network Manually
    `
    Use the network details provided on the platform dashboard.
    `

    3. Auto-Switch

  • Platform will prompt network switch

  • Approve in MetaMask

  • Refresh page
  • Insufficient Funds

    Symptoms:

  • "Insufficient funds" error

  • Transaction fails

  • Cannot complete action
  • Solutions:

    1. Check Balances
    `
    ETH: For gas fees
    USDC: For purchases/trades
    Tokens: For selling/collateral
    `

    2. Acquire ETH

  • Purchase through your exchange or on-ramp

  • Transfer to your wallet
  • 3. Acquire USDC

  • Purchase through your exchange or on-ramp

  • Transfer to your wallet
  • Transaction Issues

    Transaction Pending Forever

    Symptoms:

  • Transaction stuck in "Pending"

  • Hours without confirmation

  • Cannot make new transactions
  • Solutions:

    1. Check Network Status

  • Check a block explorer

  • Check the platform status page

  • Verify block production
  • 2. Speed Up Transaction
    `
    MetaMask → Activity → Pending Transaction
    → Click "Speed Up"
    → Increase gas price
    → Confirm
    `

    3. Cancel Transaction
    `
    MetaMask → Activity → Pending Transaction
    → Click "Cancel"
    → Confirm with higher gas
    `

    4. Reset Account (Last Resort)
    `
    MetaMask → Settings → Advanced
    → Reset Account
    ⚠️ Only if nothing else works
    `

    Transaction Failed

    Symptoms:

  • Red "Failed" status

  • Error message

  • Funds not moved
  • Common Errors:

    1. "Out of Gas"
    `
    Cause: Gas limit too low
    Solution: Increase gas limit
    Try: 1.5x the estimated amount
    `

    2. "Insufficient Allowance"
    `
    Cause: Token not approved
    Solution: Approve token first
    Then: Retry transaction
    `

    3. "Execution Reverted"
    `
    Cause: Smart contract rejection
    Reasons:

  • Campaign not active

  • Offer already filled

  • Insufficient balance

  • Invalid parameters
  • Solution: Check conditions and retry
    `

    4. "Nonce Too Low"
    `
    Cause: Transaction ordering issue
    Solution: Reset account in MetaMask
    Or: Wait for pending tx to clear
    `

    High Gas Fees

    Symptoms:

  • Gas cost seems excessive

  • Transaction too expensive
  • Solutions:

    1. Wait for Lower Gas

  • Check gas prices: etherscan.io/gastracker

  • Wait for off-peak hours

  • Not urgent? Wait.
  • 2. Adjust Gas Settings
    `
    MetaMask → Edit Gas
    → Set to "Low" priority
    → Accept slower confirmation
    `

    3. Batch Transactions

  • Combine multiple actions

  • Claim multiple dividends at once

  • Reduce transaction count
  • Campaign Issues

    Cannot Create Campaign

    Symptoms:

  • Create button disabled

  • Transaction fails

  • Error message
  • Solutions:

    1. Check Whitelist Status
    `
    If screening enabled:

  • Must be whitelisted

  • Apply at screening@redcarpethq.org

  • Wait for approval

  • `

    2. Verify Requirements
    `
    ✓ Sufficient ETH for gas
    ✓ Connected to the correct network
    ✓ All fields filled correctly
    ✓ Token symbol unique
    ✓ Dates valid (future times)
    `

    3. Check Form Validation

  • Floor > 0

  • Ceiling > Floor (if set)

  • Start time < End time

  • End time < 270 days from start

  • Valid wallet addresses
  • Cannot Purchase Tokens

    Symptoms:

  • Purchase button disabled

  • Transaction fails

  • Tokens not received
  • Solutions:

    1. Check Campaign Status
    `
    ✓ Campaign is ACTIVE
    ✓ Between start and end time
    ✓ Not reached ceiling
    ✓ Not cancelled
    `

    2. Verify USDC
    `
    ✓ Have enough USDC
    ✓ Approved Campaign contract
    ✓ Correct USDC token address
    `

    3. Check Amount
    `
    ✓ Amount > 0
    ✓ Amount doesn't exceed ceiling
    ✓ Valid number format
    `

    Cannot Claim Refund

    Symptoms:

  • Refund button disabled

  • Transaction fails

  • USDC not received
  • Solutions:

    1. Verify Eligibility
    `
    ✓ Campaign FAILED or CANCELLED
    ✓ You purchased tokens
    ✓ Haven't claimed yet
    ✓ Have purchase record
    `

    2. Check Contract
    `
    ✓ Campaign contract has USDC
    ✓ Refunds enabled
    ✓ Your address correct
    `

    3. Retry Transaction

  • Increase gas limit

  • Try again later

  • Contact support if persists
  • Trading Issues

    Cannot Create Offer

    Symptoms:

  • Create offer fails

  • Funds not escrowed

  • Error message
  • Solutions:

    1. Check Token Status
    `
    ✓ Token is GRADUATED
    ✓ Trading enabled
    ✓ Not paused
    `

    2. Verify Approvals
    `
    For SELL offers:
    ✓ Tokens approved to Market
    ✓ Approval amount sufficient

    For BUY offers:
    ✓ USDC approved to Market
    ✓ Approval amount sufficient
    `

    3. Check Balances
    `
    For SELL: Have enough tokens
    For BUY: Have enough USDC
    Include: Fee amount (2.5%)
    `

    4. Validate Parameters
    `
    ✓ Amount > minimum (1 USDC worth)
    ✓ Price > 0
    ✓ Valid token address
    `

    Cannot Fill Offer

    Symptoms:

  • Fill button disabled

  • Transaction fails

  • Trade not executed
  • Solutions:

    1. Check Offer Status
    `
    ✓ Offer still OPEN
    ✓ Not already filled
    ✓ Not cancelled
    ✓ Refresh page for latest
    `

    2. Verify Funds
    `
    For filling SELL offer:
    ✓ Have enough USDC
    ✓ USDC approved

    For filling BUY offer:
    ✓ Have enough tokens
    ✓ Tokens approved
    `

    3. Check Amount
    `
    ✓ Amount <= offer amount
    ✓ Amount > 0
    ✓ Valid number
    `

    Offer Not Showing

    Symptoms:

  • Created offer not visible

  • Offers list empty

  • Missing offers
  • Solutions:

    1. Refresh Page

  • Hard refresh (Cmd/Ctrl + Shift + R)

  • Clear cache

  • Try different browser
  • 2. Check Filters
    `
    ✓ Correct token selected
    ✓ Offer type filter (BUY/SELL)
    ✓ Status filter (OPEN)
    ✓ No search filters active
    `

    3. Verify Transaction

  • Check transaction on a block explorer

  • Confirm it succeeded

  • Wait for indexing (1-2 min)
  • DeFi Issues

    Cannot Deposit to Vault

    Symptoms:

  • Deposit fails

  • Shares not received

  • Error message
  • Solutions:

    1. Check Vault Status
    `
    ✓ Vault exists (token graduated)
    ✓ Not paused
    ✓ Not at supply cap
    ✓ Risk tier allows deposits
    `

    2. Verify USDC
    `
    ✓ Have enough USDC
    ✓ Approved Vault contract
    ✓ Approval amount sufficient
    `

    3. Check Limits
    `
    ✓ Amount > minimum
    ✓ Amount < supply cap
    ✓ Vault has capacity
    `

    Cannot Borrow

    Symptoms:

  • Borrow button disabled

  • Transaction fails

  • USDC not received
  • Solutions:

    1. Check Collateral
    `
    ✓ Deposited collateral
    ✓ Collateral sufficient
    ✓ Borrow amount <= max borrow
    `

    2. Verify Limits
    `
    Max Borrow = Collateral Value × Collateral Factor

    Example:
    Collateral: 1,000 tokens @ $1 = $1,000
    Collateral Factor: 50%
    Max Borrow: $500
    `

    3. Check Vault
    `
    ✓ Vault has liquidity
    ✓ Utilization < 85%
    ✓ Not paused
    `

    Position Liquidated

    Symptoms:

  • Collateral seized

  • Debt repaid

  • Lost collateral
  • What Happened:
    `
    Your collateral value dropped below liquidation threshold
    Stability pool repaid your debt
    Your collateral was seized
    `

    Prevention:
    `
    ✓ Monitor collateral ratio
    ✓ Add collateral when needed
    ✓ Set price alerts
    ✓ Maintain safe buffer
    ✓ Repay loans during volatility
    `

    Recovery:
    `
    ✗ Cannot recover seized collateral
    ✓ Debt is cleared
    ✓ Learn from experience
    ✓ Be more conservative next time
    `

    Dividend Issues

    Cannot Claim Dividend

    Symptoms:

  • Claim button disabled

  • Transaction fails

  • USDC not received
  • Solutions:

    1. Check Eligibility
    `
    ✓ Held tokens at snapshot
    ✓ Round is ACTIVE
    ✓ Haven't claimed yet
    ✓ Balance > 0 at snapshot
    `

    2. Verify Round
    `
    ✓ Round activated
    ✓ Snapshot taken
    ✓ Funds available
    ✓ Not expired
    `

    3. Check Address
    `
    ✓ Same address as snapshot
    ✓ Not transferred tokens after
    ✓ Correct wallet connected
    `

    Wrong Dividend Amount

    Symptoms:

  • Amount seems incorrect

  • Different than expected

  • Calculation doesn't match
  • Verification:
    `
    Your Dividend = (Your Balance / Total Supply) × Total Amount

    Check:
    ✓ Your balance at snapshot
    ✓ Total supply at snapshot
    ✓ Total dividend amount
    ✓ Already claimed?
    `

    If Still Wrong:

  • Check transaction on Etherscan

  • Verify snapshot ID

  • Contact support with details

  • Provide transaction hash
  • Display Issues

    Data Not Loading

    Symptoms:

  • Blank pages

  • Loading forever

  • "No data" messages
  • Solutions:

    1. Check Internet

  • Verify connection

  • Try different network

  • Disable VPN temporarily
  • 2. Clear Cache
    `
    Browser → Settings → Clear browsing data
    ✓ Cached images and files
    ✓ Cookies and site data
    Time range: All time
    `

    3. Try Different Browser

  • Chrome

  • Firefox

  • Brave

  • Safari
  • 4. Disable Extensions

  • Ad blockers

  • Privacy extensions

  • Other wallet extensions
  • Incorrect Balances

    Symptoms:

  • Balance shows 0

  • Wrong token amount

  • Outdated data
  • Solutions:

    1. Refresh Data

  • Refresh page

  • Disconnect and reconnect wallet

  • Wait 1-2 minutes for sync
  • 2. Check Blockchain
    `
    Visit: A block explorer (link on platform dashboard)
    Enter: Your wallet address
    Verify: Actual balance
    `

    3. Import Token
    `
    MetaMask → Import tokens
    Enter: Token contract address
    Verify: Balance appears
    `

    Charts Not Displaying

    Symptoms:

  • Blank chart area

  • "No data" message

  • Chart errors
  • Solutions:

    1. Check Token Activity

  • Needs trading history

  • Recently graduated?

  • Wait for trades
  • 2. Browser Compatibility

  • Update browser

  • Enable JavaScript

  • Disable strict privacy settings
  • 3. Try Different Timeframe

  • 1H, 4H, 1D, 1W

  • Some may have no data

  • Recent tokens limited
  • Getting Help

    Before Contacting Support

    Gather Information:
    `
    ✓ Wallet address
    ✓ Transaction hash (if applicable)
    ✓ Token/campaign address
    ✓ Error message (screenshot)
    ✓ Browser and wallet version
    ✓ Steps to reproduce
    ``

    Contact Channels

    Email (Detailed)

  • support@redcarpethq.org

  • Include all information above

  • Response: 12-24 hours
  • Twitter (Public)

  • @RedCarpetHQ

  • Public issues

  • Status updates
  • Emergency Issues

    Critical Problems:

  • Funds stuck

  • Security concerns

  • Contract bugs
  • Contact:

  • security@redcarpethq.org

  • Mark: [URGENT]

  • Provide all details