Superteam Academy — decentralized learning platform on Solana with soulbound XP tokens (Token-2022), Metaplex Core credentials, course registry, achievements, and creator incentives. Covers Anchor program development, testing with LiteSVM/Mollusk/Trident.
日本語に翻訳 name: superteam-academy-dev
description: Superteam Academy — decentralized learning platform on Solana with soulbound XP tokens (Token-2022), Metaplex Core credentials, course registry, achievements, and creator incentives. Covers Anchor program development, testing with LiteSVM/Mollusk/Trident.
user-invocable: true
Superteam Academy Skill
What this Skill is for
Use this Skill when the user asks for:
On-chain program development for the Academy platform
XP token minting (soulbound Token-2022)
Course registry and enrollment logic
Lesson completion and bitmap tracking
Finalize course / award XP flows
Metaplex Core credential issuance and upgrades (soulbound via PermanentFreezeDelegate)
Achievement system (create, award, deactivate)
Minter role management (register, revoke, reward XP)
Anchor program development, testing, security
Deployment workflows (devnet → mainnet)
Core Concepts
Account Structure (6 PDAs + Metaplex Core NFTs)
Account Seeds Purpose Config ["config"]Singleton: authority, backend signer, XP mint Course ["course", course_id.as_bytes()]Course metadata, creator, track, XP amounts Enrollment ["enrollment", course_id.as_bytes(), user.key()]Lesson bitmap, completion timestamps, credential ref (closeable) MinterRole ["minter", minter.key()]Registered XP minter with optional per-call cap (closeable via revoke_minter) AchievementType ["achievement", achievement_id.as_bytes()]Achievement definition: name, collection, supply cap, XP reward AchievementReceipt ["achievement_receipt", achievement_id.as_bytes(), recipient.key()]Proof of award — PDA collision prevents double-awarding Credential NFT Metaplex Core asset (1 per learner per track) Soulbound, wallet-visible, upgradeable via URI + Attributes plugin
Instructions (16 Total)
Category Instructions Platform Management (2) initialize, update_configCourses (2) create_course, update_courseEnrollment & Progress (6) enroll, complete_lesson, finalize_course, close_enrollment, issue_credential, upgrade_credentialMinter Roles (3) register_minter, revoke_minter, reward_xpAchievements (3) create_achievement_type, award_achievement, deactivate_achievement_type
Core Learning Loop
ENROLL → COMPLETE LESSONS → FINALIZE COURSE → ISSUE CREDENTIAL → CLOSE ENROLLMENT
Enroll : Learner signs, prerequisite check, create Enrollment PDAComplete Lessons : Backend signs, set bitmap bit, mint lesson XP (Token-2022 CPI)Finalize Course : Backend signs, verify all lessons done, mint completion bonus + creator XPIssue Credential : Backend signs, Metaplex Core createV2 CPI (PermanentFreezeDelegate + Attributes plugins)Close Enrollment : Learner signs, reclaim rent (immediate if completed, 24h cooldown if not)
Key Design Decisions
XP = soulbound Token-2022 token (NonTransferable + PermanentDelegate)Credentials = Metaplex Core NFTs — soulbound via PermanentFreezeDelegate, wallet-visible, upgradeableConfig PDA = update authority of all track collection NFTsfinalize_course and issue_credential are splitCompletion bonus merged into finalize_course — bonus XP = floor(xp_per_lesson * lesson_count / 2)No LearnerProfile PDA — XP balance tracked via Token-2022 ATARotatable backend signer stored in ConfigReserved bytes on all accounts for future-proofing without migrationsrevoke_minter closes the MinterRole PDA
Technology Stack
Layer Stack Programs Anchor 0.31+, Rust 1.82+ Token Standard Token-2022 (NonTransferable, PermanentDelegate, MetadataPointer, TokenMetadata) Credentials Metaplex Core NFTs (soulbound via PermanentFreezeDelegate) Testing Mollusk, LiteSVM, Trident (fuzz) Client TypeScript, @coral-xyz/anchor, @solana/web3.js Frontend Next.js 14+, React, Tailwind CSS RPC Helius (DAS API for XP leaderboard + credential NFT queries) Content Arweave (immutable course content) Multisig Squads (platform authority)
Compute Budgets
Instruction CU Budget initialize ~50K create_course ~15K complete_lesson ~30K finalize_course ~50K issue_credential ~50-100K upgrade_credential ~50-100K award_achievement ~80K
Operating Procedure
1. Classify the task
Platform setup (Config, authority)
Course management (create, update, track assignment)
Enrollment flow (enroll, lessons, finalize, credentials, close)
Minter roles (register, revoke, reward XP)
Achievements (create type, award, deactivate)
Account structure (PDAs, state)
Access control (backend signer, authority, minter permissions)
Testing (unit, integration, fuzz)
Security (audit, attack vectors)
Deployment (devnet, mainnet)
2. Implementation Checklist
Always verify:
Account validation (owner, signer, PDA seeds + bump)
Backend signer matches Config.backend_signer
Checked arithmetic throughout (checked_add, checked_sub, checked_mul)
Bitmap operations correct for lesson tracking
Events emitted for state changes
Canonical PDA bumps stored (never recalculated)
Reserved bytes preserved on account modifications
CPI target program IDs validated
3. Testing Requirements
Unit test (Mollusk): Each instruction in isolationIntegration test (LiteSVM): Full enroll → complete lessons → finalize → credential flowFuzz test (Trident): Random amounts, edge cases, bitmap boundsAttack test : Unauthorized signer, double completion, supply exhaustion
Progressive Disclosure (read when needed)
Programs & Development
programs-anchor.md — Anchor patterns, constraints, testing pyramid, IDL generation
Testing & Security
testing.md — LiteSVM, Mollusk, Trident, CI guidancesecurity.md — Vulnerability categories, program checklists
Deployment
deployment.md — Devnet/mainnet workflows, verifiable builds, multisig
Ecosystem & Reference
ecosystem.md — Token standards, DeFi protocolsidl-codegen.md — Codama/Shank client generationresources.md — Official documentation links
Task Routing Guide
User asks about... Primary file(s) Anchor program code programs-anchor.md Unit/integration testing testing.md Fuzz testing (Trident) testing.md Security review, audit security.md Deploy to devnet/mainnet deployment.md Token standards, SPL, Token-2022 ecosystem.md Generated clients, IDL idl-codegen.md Official docs and resources resources.md
Canonical Docs
Document Purpose docs/SPEC.mdSource of truth for all program behavior docs/ARCHITECTURE.mdAccount maps, data flows, CU budgets docs/INTEGRATION.mdFrontend integration guide