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?
Benefit | Details |
---|---|
Qualified Users | Quests require an on‑chain action, so every participant is a real user interacting with your canister. |
Zero‑cost Listing | Integration is 100% free during the beta program |
Marketing Boost | Featured dApps will be promoted in our Twitter, Discord, and community calls. |
Core Concepts
Term | Description |
---|---|
Quest | A task a user must complete inside a partner dApp (e.g., “Swap any amount on Sonic”). |
XP | Numerical score users receive upon successful verification. Aggregated per principal across all quests. |
Principal | The canonical user identifier on ICP, passed to your canister for verification. |
Verification Method | A read‑only (query ) function you implement in your canister so ICQuests can confirm completion. |
High‑Level Flow
- Discovery – ICQuests lists quests pulled from partner metadata.
- Action – User completes the task inside your dApp.
- Verification – ICQuests calls your
verifySomething(principal)
method. - Reward – If
true
, XP is minted to the user’s profile in the ICQuests canister.
What You Need to Implement
- Quest Metadata – A JSON file + assets describing each quest (title, description, background, etc.).
- Verification Method – One of three patterns:
- Boolean: return
true/false
. - List Contains: return
true
ifprincipal
is in an approved array. - Custom Logic: any condition you prefer (e.g., on‑chain metrics, NFT ownership).
- Boolean: return
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
Quarter | Milestone |
---|---|
Q2 2025 | Beta launch, few integrated dApps, public canister API |
Q3 2025 | Internet Identity integration |
Q4 2025 | Dynamic quests creation |
Q1 2026 | DAO 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.