🎮 Frontend Integration Guide

// Polygon Amoy Testnet
const networkConfig = {
  chainId: 80002,
  name: 'Polygon Amoy Testnet',
  rpcUrls: ['https://rpc-amoy.polygon.technology/'],
  blockExplorerUrls: ['https://amoy.polygonscan.com/'],
  nativeCurrency: {
    name: 'MATIC',
    symbol: 'MATIC',
    decimals: 18
  }
}

const CONTRACTS = {
  RDLN: "0x133029184EC460F661d05b0dC57BFC916b4AB0eB",
  RON: "0xD86b146Ed091b59cE050B9d40f8e2760f14Ab635",
  RIDDLE_NFT: "0x529e3076cB9A48D6FAd086abE5d23ea76159e9E3"
}

// Preview tiered rewards before solving
async function previewRewards(prizePool, totalWinners, solvePosition) {
  const riddleNFT = new ethers.Contract(CONTRACTS.RIDDLE_NFT, RiddleNFTABI, signer)

  const reward = await riddleNFT.previewTieredReward(
    ethers.parseEther(prizePool.toString()),
    totalWinners,
    solvePosition
  )

  return ethers.formatEther(reward)
}

// Example: Show user what they'd earn in each tier
const tier1Reward = await previewRewards("1000000", 20, 3)  // Position 3 = Tier 1
const tier2Reward = await previewRewards("1000000", 20, 10) // Position 10 = Tier 2
const tier3Reward = await previewRewards("1000000", 20, 18) // Position 18 = Tier 3

console.log(`Tier 1: ${tier1Reward} RDLN`)
console.log(`Tier 2: ${tier2Reward} RDLN`)
console.log(`Tier 3: ${tier3Reward} RDLN`)

// Check user's current tier and progression
async function getUserProgression(userAddress) {
  const ron = new ethers.Contract(CONTRACTS.RON, RONABI, provider)

  const ronBalance = await ron.balanceOf(userAddress)
  const currentTier = await ron.getUserTier(userAddress)
  const nextTierRequirement = await ron.getNextTierRequirement(userAddress)

  return {
    ronBalance: ethers.formatEther(ronBalance),
    currentTier: getTierName(currentTier),
    nextTierRequirement: ethers.formatEther(nextTierRequirement),
    canAccessMedium: currentTier >= 1, // SOLVER tier
    canAccessHard: currentTier >= 2,   // EXPERT tier
    canAccessOracle: currentTier >= 3  // ORACLE tier
  }
}

function getTierName(tierNumber) {
  const tiers = ["NEWCOMER", "SOLVER", "EXPERT", "ORACLE"]
  return tiers[tierNumber] || "UNKNOWN"
}

// Get treasury transparency info
async function getTreasuryInfo() {
  const rdln = new ethers.Contract(CONTRACTS.RDLN, RDLNABI, provider)

  const [
    monthlyAmount,
    daysUntilNext,
    emergenciesUsed,
    daysUntilEmergency,
    maxEmergency,
    nextTimestamp
  ] = await rdln.getSupplyProtectionInfo()

  return {
    monthlyReleaseAmount: ethers.formatEther(monthlyAmount),
    daysUntilNextRelease: daysUntilNext.toString(),
    totalEmergencyUsed: ethers.formatEther(emergenciesUsed),
    daysUntilEmergencyAvailable: daysUntilEmergency.toString(),
    maxEmergencyPerYear: ethers.formatEther(maxEmergency),
    nextReleaseDate: new Date(Number(nextTimestamp) * 1000)
  }
}

// Check if monthly release can be executed (and execute it!)
async function executeMonthlyRelease() {
  const rdln = new ethers.Contract(CONTRACTS.RDLN, RDLNABI, signer)

  const canExecute = await rdln.canExecuteMonthlyRelease()

  if (canExecute) {
    const tx = await rdln.executeMonthlyOperationsRelease()
    await tx.wait()
    console.log("Monthly release executed! 1M RDLN released to operations.")
    return true
  }

  return false
}

// Step 1: Check user's starting point
async function getUserStartingPoint(userAddress) {
  const progression = await getUserProgression(userAddress)
  const rdlnBalance = await getRDLNBalance(userAddress)

  if (rdlnBalance === 0) {
    return "NEED_RDLN" // Direct to faucet/DEX
  }

  if (progression.currentTier === "NEWCOMER") {
    return "START_EASY" // Direct to EASY riddles
  }

  return "CHOOSE_DIFFICULTY" // Show all available options
}

// Step 2: Mint riddle access
async function mintRiddleAccess(sessionId) {
  const riddleNFT = new ethers.Contract(CONTRACTS.RIDDLE_NFT, RiddleNFTABI, signer)

  // Get mint cost first
  const session = await riddleNFT.riddleSessions(sessionId)
  const mintCost = session.currentMintCost

  // Approve RDLN spending
  const rdln = new ethers.Contract(CONTRACTS.RDLN, RDLNABI, signer)
  await rdln.approve(CONTRACTS.RIDDLE_NFT, mintCost)

  // Mint access NFT
  const tx = await riddleNFT.mintRiddleAccess(sessionId)
  const receipt = await tx.wait()

  // Find the token ID from events
  const event = receipt.logs.find(log =>
    log.topics[0] === ethers.id("RiddleAccessMinted(uint256,uint256,address,uint256)")
  )

  return ethers.parseInt(event.topics[2]) // tokenId
}

// Step 3: Submit answer (with anti-cheat delay)
async function submitAnswer(sessionId, questionIndex, answer, tokenId) {
  const riddleNFT = new ethers.Contract(CONTRACTS.RIDDLE_NFT, RiddleNFTABI, signer)

  // Check anti-cheat timing
  const participant = await riddleNFT.participantData(tokenId)
  const timeSinceAccess = Date.now() / 1000 - participant.accessTime

  if (timeSinceAccess < 30) {
    const waitTime = 30 - Math.floor(timeSinceAccess)
    throw new Error(`Please wait ${waitTime} more seconds before submitting`)
  }

  // Submit answer
  const answerHash = ethers.keccak256(ethers.toUtf8Bytes(answer))
  const tx = await riddleNFT.submitAnswer(sessionId, questionIndex, answerHash)

  return await tx.wait()
}

async function testCompleteJourney() {
  console.log("🧪 Testing complete Riddlen journey...")

  // 1. Get test tokens from faucet
  console.log("1. Getting RDLN tokens...")
  // (Implement faucet integration or DEX swap)

  // 2. Start with EASY riddle
  console.log("2. Minting EASY riddle access...")
  const tokenId = await mintRiddleAccess(easySessionId)

  // 3. Wait for anti-cheat delay
  console.log("3. Waiting for anti-cheat delay...")
  await new Promise(resolve => setTimeout(resolve, 30000))

  // 4. Submit correct answer
  console.log("4. Submitting answer...")
  await submitAnswer(easySessionId, 0, "correct_answer", tokenId)

  // 5. Check rewards and RON earned
  console.log("5. Checking rewards...")
  const newProgression = await getUserProgression(userAddress)
  console.log(`Earned RON! New tier: ${newProgression.currentTier}`)

  // 6. Try MEDIUM riddle if unlocked
  if (newProgression.canAccessMedium) {
    console.log("6. MEDIUM riddles now unlocked!")
  }

  console.log("✅ Complete journey test successful!")
}