Divvi Protocol - KPI calculation functions
Divvi Protocol - KPI calculation functions / beefy

​
Functions

​
calculateKpi()

function calculateKpi(params): Promise<KpiResult<string>>
Defined in: beefy/index.ts:214 Calculates vault management fee revenue generated for Beefy Finance protocol. KPI Unit: USD (United States Dollars) Business Purpose: Measures the vault management fee revenue attributable to a specific user’s deposit activity in Beefy vaults over a given time span. This metric quantifies the economic value generated by user participation in Beefy’s yield optimization strategies and supports fee distribution calculations. Protocol Context: Beefy Finance is a decentralized yield optimization platform that automatically compounds yields for users across multiple DeFi protocols. It charges a performance fee for managing user deposits and generating optimized returns. Supported Networks: Multiple EVM-compatible networks where Beefy has deployed vault strategies Data Sources:
  • Beefy API: Vault configurations, TVL data, and strategy metadata from api.beefy.finance
  • RPC Queries: User deposit/withdrawal events via Viem public client calls to vault contracts
  • Token Price API: Historical token prices via fetchTokenPrices utility for USD conversion
  • Block Data: Timestamps via getBlockRange utility for temporal filtering
Business Assumptions:
  • Revenue attribution is proportional to user’s share of vault deposits within time window
  • USD conversion uses token prices at time of each transaction
  • Fee distribution is immediate and based on real-time vault performance
Calculation Method:
  1. Retrieves all configurations for vaults with which user has had transactions from Beefy API
  2. Filters vaults by supported networks and active status
  3. For each vault, queries user’s deposit/withdrawal events within time window
  4. For each vault, queries historical Fee events within time window
  5. Calculates user’s proportional share of vault deposits at the time of each Fee event
  6. Determines user contribution to management fee based off their proportional share of vault TVL
  7. Converts to USD using historical token prices at transaction timestamps
  8. Aggregates user fee contribution across all vaults and networks to get total user fee contribution

​
Parameters

params
Calculation parameters
address
string User wallet address to calculate vault management fees for
endTimestampExclusive
Date End of time window for revenue calculation (exclusive)
startTimestamp
Date Start of time window for revenue calculation (inclusive)

​
Returns

Promise<KpiResult<string>> Promise resolving to total vault management fee revenue in USD
Suggest changes to this pageLast updated: Aug 6, 2025, 3:51 PM