Skip to main content

What is ICQuests?

ICQuests is an on-chain quest‑portal that gamifies onboarding to the Internet Computer (ICP) ecosystem.
Users earn experience points (XP) for completing tasks inside partner dApps, while developers gain qualified traffic and a friction‑less way to showcase real product usage.


TL;DR

  • For users: A single place to discover new dApps, complete quests, and receive XP rewards.
  • For dApp teams: A plug‑and‑play growth channel—you expose one verification method in your canister and ICQuests handles the rest (listing, XP, leaderboard, marketing).
  • On‑chain & open‑source: All verifications and XP are stored in public canisters.

Why Integrate Your dApp?

BenefitDetails
Qualified UsersQuests require an on‑chain action, so every participant is a real user interacting with your canister.
Zero‑cost ListingIntegration is 100% free during the beta program
Marketing BoostFeatured dApps will be promoted in our Twitter, Discord, and community calls.

Core Concepts

TermDescription
QuestA task a user must complete inside a partner dApp (e.g., “Swap any amount on Sonic”).
XPNumerical score users receive upon successful verification. Aggregated per principal across all quests.
PrincipalThe canonical user identifier on ICP, passed to your canister for verification.
Verification MethodA read‑only (query) function you implement in your canister so ICQuests can confirm completion.

High‑Level Flow

  1. Discovery – ICQuests lists quests pulled from partner metadata.
  2. Action – User completes the task inside your dApp.
  3. Verification – ICQuests calls your verifySomething(principal) method.
  4. Reward – If true, XP is minted to the user’s profile in the ICQuests canister.

What You Need to Implement

  1. Quest Metadata – A JSON file + assets describing each quest (title, description, background, etc.).
  2. Verification Method – One of three patterns:
    • Boolean: return true/false.
    • List Contains: return true if principal is in an approved array.
    • Custom Logic: any condition you prefer (e.g., on‑chain metrics, NFT ownership).

Time to integrate: ~30-60 minutes for most teams.


Security & Privacy

  • Verification calls are read‑only queries—no funds or state changes.
  • You may whitelist the ICQuests principal if your canister uses access control.
  • ICQuests stores only the XP score, quest IDs, and principals—no PII.

Roadmap

QuarterMilestone
Q2 2025Beta launch, few integrated dApps, public canister API
Q3 2025Internet Identity integration
Q4 2025Dynamic quests creation
Q1 2026DAO governance & community‑voted XP rewards

Get Started

Head to Integration Guide ▸ Requirements next, or jump straight to Verification Method if you already know which quests you want to create.