DenLabs Lab · Product · Stacks On-chain plant NFT game — grow virtual plants, graduate trees, fund real-world impact.
Grow a plant. Graduate a tree. Plant real impact.
DenGrow is an on-chain plant NFT game built on Stacks (Bitcoin L2). Users mint a virtual plant, nurture it daily through watering, and watch it evolve through 5 growth stages. When a plant graduates to a Tree, it enters a global Impact Pool — a transparent mechanism for converting virtual achievements into real-world tree planting.
- Mint & Grow: Choose from 3 seed tiers (Common, Premium, Legendary) and grow through Seed → Sprout → Plant → Bloom → Tree
- Daily Care: Water your plant once per day to earn growth points (7 points per stage)
- Unique Traits: 5 trait categories with rarity weighting generate unique visual combinations
- Impact Pool: Graduated trees enter a verifiable pool for batch redemption
- Achievement Badges: Earn on-chain badges for streaks, graduations, and collection milestones
- Sponsored Batches: Partners can sponsor impact batches with on-chain attribution
- Treasury: Dedicated on-chain treasury for managing Impact Pool funds
- On-Chain Transparency: All game state, graduations, and redemptions recorded on Stacks blockchain
Testnet: https://dengrow.vercel.app
Repository: https://github.com/den-labs/dengrow
DenGrow uses an upgradeable architecture separating data from logic:
┌──────────────────────────────────────────────────────────────────┐
│ CONTRACTS (7) │
├──────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ │
│ │ plant-nft-v2 │───▶│plant-storage │◀── Data Layer (Immutable)│
│ └──────────────┘ └──────────────┘ │
│ │ ▲ │
│ │ │ │
│ ▼ │ │
│ ┌──────────────┐ ┌──────────────┐ ┌───────────────────┐ │
│ │plant-game-v1 │───▶│impact-registry│───▶│dengrow-treasury │ │
│ └──────────────┘ └──────────────┘ └───────────────────┘ │
│ Logic Layer │ Treasury (STX mgmt) │
│ (Versionable) ▼ │
│ ┌───────────────────┐ │
│ │achievement-badges │ │
│ └───────────────────┘ │
│ Gamification Layer │
│ │
└──────────────────────────────────────────────────────────────────┘
| Contract | Purpose | Upgradeable |
|---|---|---|
plant-storage |
Stores all plant data (stage, growth, owner) | No |
plant-game-v1 |
Game logic (water, cooldowns, progression) | Yes |
plant-nft-v2 |
SIP-009 NFT standard with game hooks | Yes |
impact-registry |
Tracks graduated trees & batch redemptions | No |
achievement-badges |
On-chain badges for streaks and milestones | No |
dengrow-treasury |
Impact Pool treasury (holds/disburses STX) | No |
plant-game |
Legacy backward compatibility wrapper | No |
- Node.js 18+
- pnpm (
npm install -g pnpm) - Hiro Wallet browser extension
# Clone the repository
git clone https://github.com/den-labs/dengrow.git
cd dengrow
# Install dependencies
pnpm install
# Set up environment
cp apps/web/.env.example apps/web/.envAdd your Hiro Platform API key to apps/web/.env:
NEXT_PUBLIC_PLATFORM_HIRO_API_KEY=your-api-key-here
# Start the web app
pnpm dev
# Open http://localhost:3000cd packages/contracts
# Run all 187 tests
pnpm test
# Run with coverage report
pnpm test:reports| Contract | Address |
|---|---|
| plant-storage | ST23SRWT9A0CYMPW4Q32D0D7KT2YY07PQAVJY3NJZ.plant-storage |
| plant-game-v1 | ST23SRWT9A0CYMPW4Q32D0D7KT2YY07PQAVJY3NJZ.plant-game-v1 |
| plant-nft-v2 | ST23SRWT9A0CYMPW4Q32D0D7KT2YY07PQAVJY3NJZ.plant-nft-v2 |
| impact-registry | ST23SRWT9A0CYMPW4Q32D0D7KT2YY07PQAVJY3NJZ.impact-registry |
| achievement-badges | ST23SRWT9A0CYMPW4Q32D0D7KT2YY07PQAVJY3NJZ.achievement-badges |
| dengrow-treasury | ST23SRWT9A0CYMPW4Q32D0D7KT2YY07PQAVJY3NJZ.dengrow-treasury |
Deployer: ST23SRWT9A0CYMPW4Q32D0D7KT2YY07PQAVJY3NJZ
| Stage | Points Required | Visual |
|---|---|---|
| Seed | 0 | Starting state |
| Sprout | 7 | First leaves |
| Plant | 14 | Growing stems |
| Bloom | 21 | Flowers appear |
| Tree | 28 | Graduated! |
- Water once per day (144 blocks on mainnet, instant on testnet)
- Each successful water = +1 growth point
- After 7 waters, plant advances to next stage
- Tree stage = graduation to Impact Pool
When a plant reaches Tree stage:
- Automatically registered in
impact-registry - Enters the global Impact Pool
- Admin records batch redemptions with proof
- Proof includes hash + URL for verification
dengrow/
├── apps/
│ └── web/ # Next.js 14 frontend (App Router)
│ ├── src/app/ # Routes (/, /my-plants, /leaderboard, /achievements, /impact)
│ ├── src/components/ # React components (plants/, ui/ via shadcn)
│ ├── src/hooks/ # Custom hooks for contract calls
│ └── src/lib/ # Utilities (game/, nft/, network)
├── packages/
│ └── contracts/ # Clarity 2.0 smart contracts (7 contracts)
│ ├── contracts/ # .clar files
│ ├── tests/ # 187 tests (Vitest + Clarinet SDK)
│ └── scripts/ # Deployment & admin scripts
└── docs/ # Documentation
For project administrators:
cd packages/contracts
# Deploy impact-registry (if needed)
pnpm deploy:impact-registry
# Register existing graduated plants
pnpm register:graduated
# Record a redemption batch
pnpm redeem -- --quantity 5 --proof-url "https://example.com/proof.pdf"- Product Requirements (PRD)
- Master Plan & Milestones
- Deployment Guide
- Task Backlog
- Roadmap
- Security Considerations
- Impact Policy
- Blockchain: Stacks (Bitcoin L2)
- Smart Contracts: Clarity 2.0 — 7 contracts, 187 tests
- Frontend: Next.js 14 (App Router), React 18, shadcn/ui, Tailwind CSS 3
- Design System: Outfit font, DenGrow color palette, custom shadows and gradients
- Testing: Vitest + Clarinet SDK (contracts), Next.js build (web)
- Wallet: Hiro Wallet via @stacks/connect v8
- Package Manager: pnpm 9 + Turborepo
Contributions welcome! Please read the contributing guidelines before submitting PRs.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
MIT License - see LICENSE file for details.
Built with care for the Stacks ecosystem.