(λ)ClarityQuest
Built for the Stacks Ecosystem · Powered by Clarinet WASM

Learn Clarity.
Solve Challenges.
Earn on Stacks.

20 progressive in-browser challenges that take you from your first (define-public) to writing a DAO voting contract. No installs. Real feedback. On-chain proof.

See how it works →
clarity-guard-demo.clar
Your solution
(check-age u25)
waiting...
(check-age u18)
waiting...
(check-age u17)
waiting...
(check-age u0)
waiting...
20
Clarity Challenges
3
Difficulty Tracks
0
Setup Required
3
On-Chain NFT Badges
12
Concepts Covered
Challenge Tracks

From your first function
to production-grade contracts

Three progressive tracks that build real Clarity intuition — not just syntax familiarity.

⚒️ Intermediate
Real Contracts
Vaults, tokens, NFTs, and multi-party contracts. The patterns used in production dApps.
#9Key-Value Store65 XP🔒
#10Whitelist Check65 XP🔒
#11Deposit Ledger70 XP🔒
#12Guarded Setter70 XP🔒
#13Option Handling75 XP🔒
#14Filter a List75 XP🔒
#15Running Max80 XP🔒
Unlock at 400 XP (Builder tier)
🏛️ Advanced
Protocol-Level
DAOs, cross-contract calls, PoX wrappers, and security patterns from real audits.
#16Mini Fungible Token100 XP🔒
#17NFT Ownership Registry100 XP🔒
#18Role-Based Access Control105 XP🔒
#19Block-Height Escrow150 XP🔒
#20Voting & Tally120 XP🔒
Unlock at 800 XP (Architect tier)
How It Works

Four steps from zero to on-chain

ClarityQuest runs entirely in your browser. No wallet needed to start. Connect when you're ready to claim.

📖
Read the challenge
Each challenge explains one Clarity concept with a clear problem statement, example inputs, expected outputs, and progressive hints if you get stuck.
✏️
Write your Clarity
Type in the editor with Clarity syntax highlighting and parenthesis depth guides. The editor shows nesting depth visually so you always know where you are.
Run tests instantly
Powered by Clarinet WASM — your code executes in the browser against hidden test cases. See pass/fail per test with exact expected vs. got output.
🏅
Mint your proof
Complete a tier and mint a SIP-009 NFT badge on Stacks. A permanent, verifiable credential in your wallet that proves your Clarity skill level.
The Editor

A Clarity IDE. In your browser.

Split-pane view. Challenge on the right, code in the middle, instant feedback at the bottom.

Challenges
1
#1 Hello, ClarityE
2
#2 Add Two UintsE
3
#3 Even or OddE
4
#4 Clamp a ValueE
5
#5 Boolean LogicE
6
#6 String ConcatenationE
7
#7 Simple CounterE
8
#8 Sum a ListE
Intermediate
9
#9 Key-Value StoreM
10
#10 Whitelist CheckM
11
#11 Deposit LedgerM
Progress0 XP
solution.clar
notes.md
1
2
3
4
5
6
7
8
;; ClarityQuest — live demo: a Clarity guard pattern(define-public (check-age (age uint))(begin(asserts! (>= age u18) (err u1))(ok "adult")))
Test Results
Console
Hints
(check-age u25) → (ok "adult")
(check-age u18) → (ok "adult")
(check-age u17) → (err u1)
(check-age u0)  → (err u1)
🎉 All 4 tests passed · +50 XP earned · Claim badge at 400 XP
asserts!errresponse
Guard Pattern · demo
Write check-age that takes a uint and returns (ok "adult") if ≥ 18, or (err u1) if not.

This is the core Clarity guard pattern you'll use in every real contract.
Test Cases
(check-age u25)
→ (ok "adult")
(check-age u18)
→ (ok "adult")
(check-age u17)
→ (err u1)
(check-age u0)
→ (err u1)
+50 XP
on completion
On-Chain Achievement Badges

Prove your skills.
Permanently.

Three SIP-009 NFT badges minted on Stacks. Connect your Leather or Xverse wallet and claim when you hit each threshold.

🌱
Apprentice
Clarity Apprentice
You understand Clarity's fundamentals — types, state, responses, and access control. The foundation every Stacks builder needs.
Complete the Core Clarity track · Apprentice tier
SIP-009 · on Stacks
⚒️
Builder
Clarity Builder
You can write production-grade Clarity — STX vaults, fungible tokens, NFT contracts, and multi-party patterns. You're building real things now.
Reach 400 XP · complete the Real Contracts track
SIP-009 · on Stacks
🏛️
Architect
Clarity Architect
You've mastered Clarity at the protocol level — DAOs, PoX wrappers, cross-contract calls, and audit-grade security patterns. You're ready to ship anything.
Reach 800 XP · all 20 challenges
SIP-009 · on Stacks
Leaderboard

The Clarity builders.
Ranked.

Your .btc name shows automatically if you have one. Weekly resets keep competition fresh.

#
Builder
XP
Solved
Tier
1
🟠
nakamoto.btc
SP2C...4KX9
🏛️
1,640
20
Architect
2
🔵
stacksqueen.btc
SP7F...M3R1
🏛️
1,580
20
Architect
3
🟣
akinola.btc
SP3K...9HW2
⚒️
820
15
Builder
4
🟡
defi-monk.btc
SP9Q...2JK7
⚒️
740
14
Builder
5
🌿
SP1X...R4T8
no .btc name
🌱
390
8
Apprentice
6
🌊
clarity-dev.btc
SP4H...W9P2
🌱
220
4
Apprentice
Free forever · No wallet needed to start

Start writing Clarity
right now.

Challenge #1 is waiting. No installs, no setup, no excuses. Just you and a blank Clarity function.

View leaderboard
Open source  ·   MIT licensed  ·   Built on Stacks