Protocol Data

Overview

The Protocol Data module provides static configuration for supported DeFi protocols on the Stacks blockchain. This data is used throughout the application for protocol selection, filtering, and AI strategy generation. Source: src/services/protocolData.js

PROTOCOLS

Array of protocol configurations with detailed metadata.

export const PROTOCOLS: Array<Protocol>

Protocol Object Structure

array

Array of protocol configuration objects

string

Unique protocol identifier (lowercase, no spaces)

string

Display name of the protocol

string

Protocol category: "Lending", "DEX", "Yield", or "Stacking"

string

Annual Percentage Yield (numeric string, e.g., “8.2”)

string

Total Value Locked (formatted string, e.g., “$48.2M”)

string

Supported assets (e.g., “sBTC”, “STX”, “sBTC/STX”)

string

Risk level: "Low", "Medium", or "High"

string

Short description of the protocol’s functionality

string

Official protocol website URL

string

Brand color (hex code, e.g., “#F7931A”)

string

Emoji icon for visual identification

Available Protocols

Zest Protocol

Type: Lending
APY: 8.2%
TVL: $48.2M
Risk: LowLend and borrow Bitcoin-backed assets with transparent on-chain rates.Visit Protocol →

{
  id: 'zest',
  name: 'Zest Protocol',
  type: 'Lending',
  apy: '8.2',
  tvl: '$48.2M',
  asset: 'sBTC',
  risk: 'Low',
  description: 'Lend and borrow Bitcoin-backed assets with transparent on-chain rates.',
  url: 'https://zestprotocol.com',
  color: '#F7931A',
  icon: '🏦',
}

Bitflow

Type: DEX
APY: 12.4%
TVL: $31.7M
Risk: MediumDecentralized exchange aggregator for the best sBTC swap rates on Stacks.Visit Protocol →

ALEX Lab

Type: DEX
APY: 15.1%
TVL: $124.5M
Risk: MediumThe leading Bitcoin DeFi super app — swap, earn, and launch on Stacks.Visit Protocol →

Hermetica

Type: Yield
APY: 18.7%
TVL: $9.8M
Risk: HighBitcoin-backed synthetic dollar yielding protocol built on Stacks.Visit Protocol →

StackingDAO

Type: Stacking
APY: 9.5%
TVL: $89.3M
Risk: LowLiquid stacking protocol — stack STX and keep liquidity with stSTX.Visit Protocol →

Granite

Type: Lending
APY: 7.8%
TVL: $18.6M
Risk: LowBorrow stablecoins against your Bitcoin collateral on Stacks.Visit Protocol →

Velar

Type: DEX
APY: 11.3%
TVL: $431K
Risk: MediumPerpetuals and spot trading protocol on Bitcoin L2 via Stacks.Visit Protocol →

RISK_STYLES

CSS class mappings for risk level styling.

export const RISK_STYLES = {
  Low: 'text-green-500',
  Medium: 'text-yellow-500',
  High: 'text-red-500',
};

Usage Example

function RiskBadge({ risk }) {
  return (
    <span className={RISK_STYLES[risk]}>
      {risk} Risk
    </span>
  );
}

FILTER_TYPES

Available protocol type filters.

export const FILTER_TYPES = ['All', 'Lending', 'DEX', 'Yield', 'Stacking'];

Usage Example

import { FILTER_TYPES } from './services/protocolData';

function ProtocolFilter({ selected, onSelect }) {
  return (
    <div>
      {FILTER_TYPES.map(type => (
        <button
          key={type}
          onClick={() => onSelect(type)}
          className={selected === type ? 'active' : ''}
        >
          {type}
        </button>
      ))}
    </div>
  );
}

Usage Examples

import { PROTOCOLS } from './services/protocolData';

// Get all protocols
console.log(PROTOCOLS);

// Filter by type
const lendingProtocols = PROTOCOLS.filter(p => p.type === 'Lending');

// Sort by APY
const sortedByAPY = [...PROTOCOLS].sort((a, b) => 
  parseFloat(b.apy) - parseFloat(a.apy)
);

// Find specific protocol
const zest = PROTOCOLS.find(p => p.id === 'zest');

import { PROTOCOLS, RISK_STYLES } from './services/protocolData';

function ProtocolGrid() {
  return (
    <div className="grid">
      {PROTOCOLS.map(protocol => (
        <div key={protocol.id} className="card">
          <span className="icon">{protocol.icon}</span>
          <h3>{protocol.name}</h3>
          <p>{protocol.description}</p>
          
          <div className="stats">
            <span>APY: {protocol.apy}%</span>
            <span>TVL: {protocol.tvl}</span>
            <span className={RISK_STYLES[protocol.risk]}>
              {protocol.risk} Risk
            </span>
          </div>
          
          <a href={protocol.url} target="_blank">
            Visit Protocol
          </a>
        </div>
      ))}
    </div>
  );
}

import { getAIStrategy } from './services/aiService';
import { PROTOCOLS } from './services/protocolData';

async function generateStrategy(userAddress, portfolio, riskProfile) {
  const strategy = await getAIStrategy({
    address: userAddress,
    stxBalance: portfolio.stxBalance,
    sbtcBalance: portfolio.sbtcBalance,
    totalUSD: portfolio.totalUSD,
    riskProfile,
    protocols: PROTOCOLS, // Pass all protocols to AI
  });
  
  return strategy;
}

import { PROTOCOLS, FILTER_TYPES } from './services/protocolData';
import { useState } from 'react';

function ProtocolExplorer() {
  const [filter, setFilter] = useState('All');
  
  const filtered = filter === 'All'
    ? PROTOCOLS
    : PROTOCOLS.filter(p => p.type === filter);
  
  const sorted = [...filtered].sort((a, b) =>
    parseFloat(b.apy) - parseFloat(a.apy)
  );
  
  return (
    <div>
      <div className="filters">
        {FILTER_TYPES.map(type => (
          <button
            key={type}
            onClick={() => setFilter(type)}
            className={filter === type ? 'active' : ''}
          >
            {type}
          </button>
        ))}
      </div>
      
      <div className="protocols">
        {sorted.map(protocol => (
          <ProtocolCard key={protocol.id} {...protocol} />
        ))}
      </div>
    </div>
  );
}

Protocol Statistics

Total Protocols

7 protocols supported

Average APY

11.9% across all protocols

Total TVL

$322.6M combined liquidity

Risk Distribution

3 Low, 3 Medium, 1 High risk protocols

Protocol Types

Lending (3)
DEX (3)
Yield (1)
Stacking (1)

Protocols that allow lending and borrowing:

Zest Protocol - 8.2% APY
Granite - 7.8% APY
Average: 8.0% APY

Best Practices

Keep Data Updated

APY and TVL should be updated regularly (consider dynamic data sources)

Type Safety

Validate protocol data structure when extending or modifying

Consistent Formatting

Use consistent formats for APY (string numbers) and TVL (e.g., “$XM”)

Icon Selection

Use recognizable emojis that represent the protocol’s function

Extending Protocol Data

To add a new protocol:

const newProtocol = {
  id: 'new-protocol',           // Unique, lowercase ID
  name: 'New Protocol',         // Display name
  type: 'Lending',              // Must match FILTER_TYPES
  apy: '10.5',                  // String number
  tvl: '$25M',                  // Formatted string
  asset: 'sBTC',                // Supported assets
  risk: 'Medium',               // Low/Medium/High
  description: 'Description',   // Short pitch
  url: 'https://...',           // Official site
  color: '#000000',             // Brand color
  icon: '🎯',                   // Emoji
};

export const PROTOCOLS = [
  ...existingProtocols,
  newProtocol,
];

AI Service - Uses protocol data for strategy generation
useProtocols Hook - React hook for filtering protocols
Compare Protocols Page - UI for protocol comparison

Getting Started

Services

Hooks

Overview

PROTOCOLS

Protocol Object Structure

Available Protocols

Zest Protocol

Zest Protocol

Bitflow

Bitflow

ALEX Lab

ALEX Lab

Hermetica

Hermetica

StackingDAO

StackingDAO

Granite

Granite

Velar

Velar

RISK_STYLES

Usage Example

FILTER_TYPES

Usage Example

Usage Examples

Protocol Statistics

Total Protocols

Average APY

Total TVL

Risk Distribution

Protocol Types

Best Practices

Keep Data Updated

Type Safety

Consistent Formatting

Icon Selection

Extending Protocol Data

​Overview

​PROTOCOLS

​Protocol Object Structure

​Available Protocols

​Zest Protocol

Zest Protocol

​Bitflow

Bitflow

​ALEX Lab

ALEX Lab

​Hermetica

Hermetica

​StackingDAO

StackingDAO

​Granite

Granite

​Velar

Velar

​RISK_STYLES

​Usage Example

​FILTER_TYPES

​Usage Example

​Usage Examples

​Protocol Statistics

Total Protocols

Average APY

Total TVL

Risk Distribution

​Protocol Types

​Best Practices

Keep Data Updated

Type Safety

Consistent Formatting

Icon Selection

​Extending Protocol Data

​Related Resources

Overview

PROTOCOLS

Protocol Object Structure

Available Protocols

Zest Protocol

Bitflow

ALEX Lab

Hermetica

StackingDAO

Granite

Velar

RISK_STYLES

Usage Example

FILTER_TYPES

Usage Example

Usage Examples

Protocol Statistics

Protocol Types

Best Practices

Extending Protocol Data

Related Resources