Skip to content

YieldStark is a non-custodial yield optimizer that intelligently allocates your Bitcoin (WBTC) into the most profitable DeFi opportunities across the Starknet ecosystem. By leveraging real-time price feeds and pool analytics from Pragma, Vesu, and Ekubo, it automates staking, rebalancing, and reinvestment - maximizing returns without manual effort.

Notifications You must be signed in to change notification settings

MakindeAhmed2110/YieldStark

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

14 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

YieldStark πŸš€

Starknet Hackathon BTCfi Pragma

Smart WBTC yield automation on Starknet. Deposit once, earn more through intelligent rebalancing across vesuxyz & EkuboProtocol

YieldStark is a non-custodial yield optimizer that intelligently allocates Bitcoin (WBTC) into the most profitable DeFi opportunities across the Starknet ecosystem. Built with Next.js and Starknet, it provides a seamless experience for BTC holders to earn yield directly on their assets.

YieldStark Logo

🎯 Problem Statement

Bitcoin holders looking to earn yield face several significant roadblocks:

-Lack of Native Yield Options

-Yield strategies are spread across multiple protocols, requiring manual research bridging, and tracking.

-Navigating yield farming, bridging, and gas optimization is too technical for the typical BTC holder.

πŸ’‘ Solution

YieldStark solves the complexity of earning BTC-native yield through three core components:

  1. AI-Powered Yield Engine -Real-time APY tracking across BTC strategies -Predictive modeling for optimal rebalancing -Risk-adjusted portfolio rotation

  2. Automated Smart Execution -Non-custodial BTC deposits into top-performing pools -Rebalancing and compounding based on performance data -Auto-conversion of rewards into BTC

  3. Pragma Data Integration -On-chain APY feeds for BTC strategies -Real-time pool metrics and risk signals -Decentralized and verifiable price + yield data

πŸ€– Agent Decision Logic

import { VesuOracleService } from "../services/vesuOracle";
import { EkuboOracleService } from "../services/ekuboOracle";

export async function decideBestProtocol() {
  const vesuAPY = await VesuOracleService.getInstance().calculateAPY();
  const ekuboAPR = await EkuboOracleService.getInstance().calculateAPR();

  return vesuAPY > ekuboAPR ? "vesu" : "ekubo";
}

// Usage:
// const best = await decideBestProtocol();
// // Use `best` to allocate funds accordingly

πŸ—οΈ YieldStark Agent Architecture

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Pragma Price Feeds │───▢│  Analysis Engine   │───▢│  Strategy Engine   β”‚
β”‚ Vesu API           β”‚    β”‚  - APY Calculation β”‚    β”‚  - Allocation      β”‚
β”‚ Ekubo API          β”‚    β”‚  - Risk Metrics    β”‚    β”‚  - Rebalancing     β”‚
β”‚ Historical Data    β”‚    β”‚  - Market Trends   β”‚    β”‚  - Execution Plan  β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
         β–²                        β”‚                        β”‚
         β”‚                        β–Ό                        β–Ό
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ User Portfolio     β”‚    β”‚   Risk Management  β”‚    β”‚ Performance &      β”‚
β”‚ - Deposits         │────▢   & Alerts         │────▢ Learning Module    β”‚
β”‚ - Withdrawals      β”‚    β”‚   - Thresholds     β”‚    β”‚ - Backtesting      β”‚
β”‚ - Balances         β”‚    β”‚   - Notifications  β”‚    β”‚ - Optimization     β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜    β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

The YieldStark agent continuously collects data from integrated protocols and oracles, analyzes yield and risk, and executes optimal rebalancing strategies for user portfolios.

Features

  • Bitcoin-Native Yield Optimization: Focuses exclusively on Bitcoin, unlocking optimized yield opportunities without complex bridges or synthetic assets
  • AI-Driven Rebalancing: Dynamically reallocates BTC deposits across top-performing protocols like Vesu and Ekubo
  • Built on Starknet: Leverages Starknet's scalability and zero-knowledge infrastructure for fast, low-cost transactions
  • Real-time Price Tracking: Integrated with Pragma for accurate BTC/USD price feeds
  • PWA Support: Progressive Web App functionality for enhanced mobile experience

πŸ— Codebase Architecture

YieldStark/
β”œβ”€β”€ app/
β”‚   β”œβ”€β”€ dashboard/                # User dashboard UI
β”‚   └── page.tsx                  # Landing page
β”œβ”€β”€ components/                   # Reusable React components
β”œβ”€β”€ config/                       # Configuration files (contracts, env)
β”œβ”€β”€ hooks/                        # Custom React hooks
β”œβ”€β”€ services/
β”‚   β”œβ”€β”€ vesuOracle.ts             # Vesu APY & price feed integration
β”‚   β”œβ”€β”€ ekuboOracle.ts            # Ekubo APR integration
β”‚   β”œβ”€β”€ positionTracker.ts        # User position & profit tracking
β”‚   β”œβ”€β”€ priceFeed.ts              # Pragma price feed integration
β”‚   β”œβ”€β”€ vesu.ts                   # Vesu protocol execution logic
β”‚   β”œβ”€β”€ vesuVToken.ts             # Vesu vToken logic
β”‚   └── web3/                     # Web3 utilities and protocol calls
β”œβ”€β”€ utils/                        # Utility functions and constants
β”œβ”€β”€ contracts/                    # Cairo smart contracts (if present)
└── public/
    β”œβ”€β”€ logo.png                  # Project logo
    └── agent-architecture.png    # Architecture diagram

Tech Stack

  • Frontend: Next.js 15.3.2, React 19.0.0
  • Styling: Tailwind CSS, DaisyUI
  • Blockchain: Starknet
  • State Management: Zustand
  • Testing: Vitest, Testing Library

πŸš€ Getting Started

Prerequisites

  • Node.js (v18 or higher)
  • yarn
  • A Starknet wallet (e.g., Argent X)

Installation

  1. Clone the repository:
git clone https://github.com/yourusername/YieldStark.git
cd YieldStark/packages/nextjs
  1. Install dependencies:
yarn install
  1. Create a .env file:
cp .env.example .env
  1. Start the development server:
yarn dev

The application will be available at http://localhost:3000

πŸ“š Documentation

Detailed documentation is available in the docs directory:

πŸ“ˆ Performance

-Up to 4x higher BTC yield compared to passive strategies

-100% automated strategy rotation powered by real-time Pragma feeds

-Rebalancing logic optimized for gas-efficiency and execution success

πŸ›£ Roadmap

Phase 1: Core Infrastructure (Current)

  • Vesu and Ekubo strategy integration
  • Statistical analysis engine
  • Pragma data feed connection
  • Minimalist frontend for deposits and tracking

Phase 2: Advanced Features (Q3 2025)

  • Mobile-friendly dashboard
  • AI-powered rebalancing engine
  • BTC staking and performance analytics

πŸ‘₯ Target Users

  1. Bitcoin Maximalists

    • Want to earn yield without leaving BTC
    • Prefer BTC-denominated returns over altcoins
    • Avoid complex DeFi exposure
  2. Long-term Holders

    • Automated rebalancing
    • Risk management
    • Portfolio optimization

πŸ“’ Stay Connected

Follow us for updates, insights, and behind-the-scenes development:

🧡 X Thread: View our hackathon Prototype thread on X

🐦 Follow us on X: @YieldStark

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • Starknet Foundation
  • Vesu Protocol
  • Ekubo Protocol
  • Pragma Oracle

Built with ❀️ for Starknet Re{ignite} Hackathon 2025

About

YieldStark is a non-custodial yield optimizer that intelligently allocates your Bitcoin (WBTC) into the most profitable DeFi opportunities across the Starknet ecosystem. By leveraging real-time price feeds and pool analytics from Pragma, Vesu, and Ekubo, it automates staking, rebalancing, and reinvestment - maximizing returns without manual effort.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages