Bonding Progress & Feature Unlocking

One of Renatus' most innovative aspects is the progressive unlocking of AI agent capabilities tied to bonding curve progress. This approach aligns token economics with feature availability, creating a symbiotic relationship between community growth and agent functionality.

Bonding Progress System Architecture

Implementation Overview

The bonding progress system is built on a foundation of smart contract interactions and real-time data monitoring. The core components include:

  1. Progress Tracking Hook: useGetBondingProgress React hook
  2. Calculation Algorithm: calcBondingProgress utility function
  3. Feature Gating Components: Conditional rendering based on progress thresholds
  4. Real-time Updates: WebSocket-based data refreshing system

Progress Calculation Algorithm

The bonding progress calculation follows this mathematical formula:

export const calcBondingProgress = (
  tokenSupply: BigNumber,   // Total agent-token supply (18 decimals)
  constantProduct: BigNumber, // k parameter (36 decimals)
  gradThreshold: BigNumber, // Graduation threshold (18 decimals)
  reserve1: BigNumber      // Current reserve balance (18 decimals)
) => {
  // Calculate virtual offset (R1_0)
  const virtualOffset = constantProduct.div(tokenSupply);
  
  // Calculate reserve at graduation (R1_G)
  const reserveAtGrad = constantProduct.div(gradThreshold);
  
  // Calculate progress in platform tokens
  const progressPlat = BigNumber.max(reserve1.minus(virtualOffset), 0);
  
  // Calculate total required platform tokens
  const totalPlat = BigNumber.max(reserveAtGrad.minus(virtualOffset), 1);
  
  // Calculate remaining required platform tokens
  const requiredPlat = BigNumber.max(reserveAtGrad.minus(reserve1), 0);
  
  // Calculate percentage (0-100)
  const pct = progressPlat.times(100).div(totalPlat);
  const clamped = BigNumber.min(BigNumber.max(pct, 0), 100);
  
  return { 
    progressPct: clamped.toNumber(), 
    requiredPlatform: requiredPlat 
  };
};

This algorithm calculates:

  1. The percentage progress from initial state to graduation
  2. The amount of RENATUS tokens still required to reach graduation

Key technical details:

  • Refresh Rate: 3000ms (3 seconds)
  • Data Source: Direct smart contract queries using wagmi/viem
  • Optimization: Data fetching is halted after graduation
  • Chain ID: Configured via environment variable

Feature Unlocking Tiers

The platform implements progressive feature unlocking through a series of bonding thresholds. Each threshold activates specific capabilities in the agent:

Tier Implementation Architecture

Each feature in the system is gated by progress checks that determine availability:

// Conceptual implementation of feature gating
const isTelegramAvailable = (progress) => progress >= 30;
const isTwitterPostingAvailable = (progress) => progress >= 30;
const isAdvancedModerationAvailable = (progress) => progress >= 50;
const isAutoReplyAvailable = (progress) => progress >= 80;
const isAPIAccessAvailable = (isGraduated) => isGraduated === true;

Tier 1: Basic Agent (0% - Launch)

Technical implementation:

  • Base functionality always available (progress >= 0)
  • Core React components loaded unconditionally
  • Basic API endpoints accessible without progress checks
  • Minimal database schema for agent configuration

Features:

  • Web interface for direct interactions
  • Basic agent personality customization
  • Standard response capabilities
  • Single-user mode

Tier 2: Community Features (15%)

Technical implementation:

  • Gated by progress >= 15 checks
  • Enhanced database schema for multi-user support
  • Basic analytics data collection enabled
  • Additional UI components conditionally rendered

Features:

  • Multi-user support
  • Basic analytics dashboard
  • Additional customization options
  • Simple moderation rules

Tier 3: Platform Integration (30%)

Technical implementation:

  • Gated by progress >= 30 checks
  • Telegram API integration system activated
  • Twitter API OAuth flow enabled
  • Additional backend services started

Features:

  • Telegram Bot Integration
    • Basic group chat functionality
    • Command responses
    • User interaction tracking
    • Whitelist settings for access control
  • Twitter/X Integration
    • Basic posting capabilities
    • Scheduled content
    • Post template customization
    • Post frequency controls

Tier 4: Enhanced Moderation (50%)

Technical implementation:

  • Gated by progress >= 50 checks
  • Advanced moderation database schema activated
  • Enhanced content filtering algorithms enabled
  • Expanded API endpoints for moderation management

Features:

  • Advanced content filtering
  • Custom moderation rules
  • Automated response triggers
  • Whitelist/blacklist management
  • Enhanced analytics and reporting
  • Expanded post type options

Tier 5: Advanced Capabilities (80%)

Technical implementation:

  • Gated by progress >= 80 checks
  • Media processing microservices activated
  • Advanced analytics data pipeline enabled
  • Custom commands framework initialized

Features:

  • Telegram Advanced Features
    • Media processing
    • Comprehensive moderation system
    • Custom commands framework
    • Group analytics
  • Twitter Advanced Features
    • Twitter auto-replies to mentions
    • Thread creation
    • Advanced variable usage in templates
    • Engagement optimization

Tier 6: Graduated Features (100%)

Technical implementation:

  • Gated by isGraduated === true flag
  • Database schema fully upgraded
  • API rate limits increased
  • Developer access token system activated

Features:

  • Complete platform access
  • API access for custom integrations
  • Advanced analytics with exportable data
  • Priority feature updates
  • Integration with upcoming platform extensions

Post-Graduation Technical Transition

After graduation to PancakeSwap V3, several technical changes occur:

  1. Contract Migration: A new token contract is deployed with enhanced capabilities
  2. Liquidity Configuration:
    • 50% of liquidity locked permanently in LiqLocker contract
    • 50% of liquidity shares vested to token holders on configurable schedule
  3. Feature Persistence: All unlocked features remain available permanently
  4. API Enhancement: Additional API endpoints become available for developers
  5. Analytics Upgrade: Advanced analytics pipelines are activated

For technical details on the bonding curve mathematics, see our Math and Rationale documentation in the Developer Information section.