Skip to main content

User Flow

This page describes the end-to-end journey for a user interacting with ICQuests, from discovering a quest to earning XP.

1. Discover Quests​

  • Users visit the ICQuests portal to browse available quests from integrated dApps.
  • Each quest lists its requirements, XP reward, and a link to the partner dApp.

2. Connect Wallet​

  • Users connect their Internet Identity (or other supported wallet) to ICQuests.
  • The user's principal is used to track XP and quest completions.

3. Complete a Quest​

  • The user follows the quest instructions and performs the required action inside the partner dApp (e.g., make a swap, mint an NFT, top up a canister).

4. Verification​

  • After completing the action, the user returns to ICQuests and clicks "Verify".
  • ICQuests calls the verification method exposed by the partner dApp's canister, passing the user's principal.
  • The verification method checks on-chain state and returns true if the quest is complete.

5. Earn XP & Rewards​

  • If verification succeeds, ICQuests mints XP to the user's profile and marks the quest as completed.
  • The user's XP and completed quests are stored on-chain in the ICQuests canister.
  • Users can view their XP, completed quests, and leaderboard position.

Visual Flow​

  1. Browse Quests → 2. Connect Wallet → 3. Complete Action in dApp → 4. Verify → 5. Earn XP

Note: All verification and XP tracking is on-chain and transparent. No private user data is stored.