Curvance
  • Protocol Overview
    • Click Less, Earn More
    • Protocol Architecture
    • Asset Types
    • Liquidity Markets
      • Borrowing
      • Liquidations
      • Interest Rates
      • Oracles
      • Collateral Caps
      • Bad Debt Socialization
    • Application Specific Sequencing
    • Multichain Architecture
      • Multichain Gauge System
      • Multichain Vote Escrow System
    • New Age Liquidity Mining
      • Protocols
      • Chains
    • How Are New Assets Integrated
    • Specialized Blockchain Integrations
    • Plugin System
    • Universal Account Balance
    • Token Approval Management
    • Lending Risks
  • CVE Token
    • Token Utility
    • veCVE
      • Curvance DAO
      • Revenue Model
      • Emergency Unlock
  • Security
    • Security and Audits
  • Miscellaneous
    • RPCs and Testnet Stability
    • Glossary
    • TL;DR
      • Customer Types and Benefits
    • Brand Assets
    • Weblinks
    • Disclaimer
    • Frequently Asked Questions
  • Developer Docs
    • Overview
    • Quick Start Guides
      • Atlas Fastlane Auctions (coming soon)
      • Plugin Integration
        • List of Delegable Actions
      • Supply & Collateral
        • Lend Assets
        • Deposit into pTokens
      • Borrowing & Repayment
        • Borrow
        • Repaying Debt
      • Leverage
        • Leveraging
        • Deleveraging
    • Money Market System
      • Market Manager
      • Position Tokens (pToken)
      • Earn Tokens (eTokens)
      • Dynamic Interest Rate Model
      • Universal Balance
    • Position Management
      • Leverage
      • Deleverage / Fold
    • Dynamic Liquidation Engine (DLE)
      • OEV Liquidation System
      • Fallback Queued Liquidations
      • Bad Debt Socialization
    • Plugin & Delegation System
      • Transfer Lock Mechanism
      • Delegable Actions
    • Core Token Ecosystem
      • CVE Token
        • Multichain Support
        • Bridge Mechanisms
      • Voting Escrow CVE (veCVE)
        • Creating a Lock
        • Points System
        • Continuous Lock Mode
        • Offchain Voting Mechanism
        • Early Expiry with Penalty
        • Combining Locks
        • Multichain Lock Migration
        • Epoch Blackout Windows
    • Cross-Chain Functionality
      • Messaging Hub
      • Fee Manager
      • Reward Manager
    • Auxiliary Functionality
Powered by GitBook
On this page
  • 1. Fee Collection
  • Fee Transformation (Swaps/OTC)
  • 3. Cross-Chain Fee Distribution
  • 4. Integration with 1inch/Solvers
Export as PDF
  1. Developer Docs
  2. Cross-Chain Functionality

Fee Manager

PreviousMessaging HubNextReward Manager

Last updated 8 days ago

1. Fee Collection

The FeeManager serves as the central collection point for protocol fees across the Curvance ecosystem. It acts as a unified hub for aggregating fees generated from various protocol operations.

  • Protocol Revenue Streams: Fees collected from lending/borrowing operations, liquidations, and other protocol services flow into the FeeManager

  • Reward Token Registry: The contract maintains a registry of valid reward tokens that can be accepted as fees, enabling flexibility in fee collection

Storage Architecture:

  • rewardTokens: Array of supported token addresses

  • rewardTokenInfo: Mapping tracking token status (including OTC eligibility)

Fee Transformation (Swaps/OTC)

Before cross-chain distribution, collected fees may need transformation into the protocol's primary fee token.

Fee Token Swaps

  • Permissioned Swap Execution: Authorized harvesters can initiate swaps through the multiSwap function

  • OTC Protection: Tokens marked for OTC are protected from automated swaps

  • Token Verification: Ensures input tokens are registered reward tokens and output is the fee token

DAO OTC Mechanism

  • Price Oracle Integration: Uses Oracle Manager to determine fair market value for OTC transactions

  • Token Earmarking: Tokens can be marked as "for OTC" (value=2), preventing them from being swapped

  • Price Protection: Includes slippage control and deadline validation to ensure fair execution

3. Cross-Chain Fee Distribution

The cross-chain distribution of fees is coordinated between the FeeManager and MessagingHub.

Distribution Flow

  1. MessagingHub Pull: The MessagingHub calls pullFees() to retrieve the collected fee tokens

  2. Fee Allocation:

    1. Compounding fees are allocated to DAO address for harvester bot operations

    2. Remaining fees are sent to MessagingHub for cross-chain distribution

  3. Cross-Chain Transfer:

    1. MessagingHub uses Circle's CCTP (Cross-Chain Transfer Protocol) and Wormhole for secure cross-chain messaging

    2. Tokens are distributed proportionally based on veCVE points across chains

  4. Epoch Management:

    1. Rewards are distributed during epoch executions based on veCVE points on each chain

    2. Wormhole's Cross-Chain Query (CCQ) gathers data about locked tokens across chains

Technology Stack

  • Circle CCTP: Used for transferring fee tokens across chains

  • Wormhole: Provides the messaging infrastructure for cross-chain communications

  • Wormhole CCQ: Enables querying of lock points data from other chains

4. Integration with 1inch/Solvers

FeeManager leverages external liquidity sources to optimize token swaps

  • Offchain Solvers: Integration with 1inch and potentially other solvers for optimized swap routing

  • Swap Safety:

    • SwapperLib.swapSafe() enforces validation rules

    • External calldata checker verifies swap transactions

    • Token approvals are managed automatically

  • Permissioned Access: Only authorized harvester addresses can execute swaps

  • Swap Verification:

    • Validates input/output tokens match expected values

    • Strict swap parameter validation prevents malicious transactions

The FeeManager's cross-chain architecture enables Curvance to maintain a unified fee management system across multiple blockchains, ensuring proportional reward distribution and efficient token handling throughout the protocol ecosystem.