๐Ÿ† UNSTOPPABLE HACKATHON 2025

๐ŸŽฎ Fleet SDK Quest

Gamified Educational Tutorial for Ergo Developers

โšก Bounty: ฮฃ1,578 ERG | Track: Open
๐Ÿš€ Codecatalysts
๐ŸŽ“ LNMIIT, Jaipur
Ayush Sharma
๐Ÿ‘‘ Leader
Yatharth Vardaan
๐Ÿ’ป Member

๐Ÿšจ The Problem

Why developers struggle to build on Ergo

Learning Fleet SDK is frustrating:

  • ๐Ÿ“š Documentation scattered across 10+ repositories
  • โŒ No working examples โ€” most code is outdated
  • ๐Ÿ“ˆ Steep learning curve discourages 80% of beginners
  • ๐ŸŽฎ No engagement โ€” dry docs don't motivate
  • ๐Ÿ”ง Broken code samples waste developer time

Result: Fewer dApps built on Ergo ๐Ÿ˜ž

๐Ÿ’ก Our Solution

Fleet SDK Quest โ€” Learn by Playing

A complete, gamified educational tutorial that transforms learning Fleet SDK from frustrating to fun! ๐ŸŽฎ

โŒ Problem โœ… Our Solution
Fragmented docs All-in-one tutorial site
No working code 86 tests + 9 examples
Steep learning curve Gamified XP system
No practice environment Interactive playground

๐Ÿ“Š By The Numbers

86
Passing Tests
9
Examples
4
Tutorials
11
Milestones

โœจ Key Features

๐ŸŽฎ
Gamified Learning
Earn XP & achievements
๐Ÿ“š
4 Tutorial Tracks
Progressive learning path
๐Ÿ’ป
Interactive Playground
Code in browser
๐Ÿงช
86 Verified Tests
Vitest + MockChain
๐Ÿ“–
VitePress Docs
Searchable & beautiful
๐Ÿ”—
Real Patterns
Official SDK code

โœ… Bounty Milestones

ALL 11 MILESTONES COMPLETE

โœ“ Transaction Outputs
โœ“ Box Selection
โœ“ Token Minting
โœ“ NFT Minting
โœ“ Smart Contracts
โœ“ Registers (R4-R9)
โœ“ Contract Signing
โœ“ Data Inputs
โœ“ Compile Constants
โœ“ ErgoPay
โœ“ Wallet Connection
โ˜… BONUS: Playground

๐Ÿ—๏ธ System Architecture

๐Ÿ“–
VitePress Docs
4 Tutorials โ€ข Playground
๐Ÿงช
Test Suite
86 Tests โ€ข Vitest
๐Ÿ’ป
Examples
9 Files โ€ข TypeScript
โฌ‡
โšก
Fleet SDK v0.6.4
core wallet mock-chain compiler
โฌ‡
๐Ÿ”—
Ergo Blockchain
Testnet / Mainnet

๐Ÿ› ๏ธ Tech Stack

Layer Technology Purpose
๐Ÿ“– Documentation VitePress 1.6.4 Interactive Vue-powered docs
๐Ÿงช Testing Vitest + MockChain Fast, isolated blockchain tests
๐Ÿ“ Language TypeScript 5.3 Type-safe development
โšก SDK Fleet SDK 0.6.4 All 8 packages integrated
๐Ÿ”„ CI/CD GitHub Actions Auto test & deploy

๐Ÿ’ป Code Sample

Building an ERG transfer in just 10 lines

basic-transfer.ts
import { OutputBuilder, TransactionBuilder } from "@fleet-sdk/core";

// Create output with 1 ERG
const output = new OutputBuilder(
  "1000000000", // 1 ERG in nanoERG
  recipientAddress
);

// Build the transaction
const tx = new TransactionBuilder(currentHeight)
  .from(inputs)          // Select input boxes
  .to(output)            // Add output
  .sendChangeTo(sender)  // Change address
  .payMinFee()           // Auto-calculate fee
  .build();              // Build unsigned tx

๐ŸŽฌ Live Demo

terminal
# Clone and run in under 2 minutes!

$ git clone https://github.com/ayushap18/fleet-sdk-tutorial
$ cd fleet-sdk-tutorial
$ npm install

# Run all 86 tests
$ npm test
โœ“ 86 tests passed

# Start interactive docs
$ npm run docs:dev
โžœ Local: http://localhost:5173/

# Run an example
$ npm run example:basic
โœ“ Transaction built successfully!

๐ŸŒ Impact

๐Ÿ‘ฉโ€๐Ÿ’ป For Developers

  • Learn Fleet SDK in hours, not weeks
  • Copy-paste working code patterns
  • Test locally before deploying
  • Progress tracking with XP system

๐Ÿ”— For Ergo Ecosystem

  • Lower barrier to entry
  • More dApp developers onboarded
  • Growing community of builders
  • Better documentation standard

๐Ÿš€ Future Roadmap

Phase Feature Timeline
v1.1 Video tutorials for each guide Q1 2025
v1.2 DeFi integration examples (SigmaUSD, Spectrum) Q2 2025
v1.3 Multi-language support (ES, CN, RU) Q3 2025
v2.0 AI-powered code assistant integration Q4 2025

๐Ÿ”— Resources

๐Ÿ’ฐ Ergo Wallet Address
9gKJBgaEiZzvg5xddsS3BXH6jG5VfJ2k2GiWk6GfemwbKY1X7QC

๐Ÿ™ Thank You!

Making Ergo Development Accessible for Everyone

๐ŸŽฎ Fleet SDK Quest | Level Up Your Skills
๐Ÿš€ Codecatalysts
๐ŸŽ“ LNMIIT, Jaipur
Ayush Sharma
๐Ÿ‘‘ Leader
Yatharth Vardaan
๐Ÿ’ป Member
GitHub: @ayushap18

โ“ Questions? Let's discuss!