sink-1

[skushagra9]

🚀 feat: Complete VUSD Mint Adapter & Core Engine Fixes

🔧 New VUSD Mint Adapter

• Created vusd-mint.ts adapter to track Mint events with full metadata capture
• Added example configuration vusd-mint.absinthe.json for Ethereum mainnet
• Integrated VUSD token pricing via Vesper VDollar CoinGecko feed

🏗️ Dual Sink Architecture

• Implemented API Sink for production Absinthe API integration
• Configured proper batching and error handling for API submissions

⚙️ Transaction Processing Fixes

• Fixed transaction data capture by adding transaction: true to log subscriptions
• Enhanced event processing to include gasUsed, gasPrice, from/to fields (previously incorrect)
• Resolved transaction context extraction for complete gas fee analysis
• Added proper logIndex handling for event ordering (previously incorrect)

💰 Pricing & ValueUSD Resolution

• Fixed valueUSD calculations with robust price lookup mechanisms (previously incorrect for txn events)
• Integrated ETH pric for gas fee USD calculations

📊 Time-Weighted Balance Schema Refinement

• Updated balance key structure: bal:{asset}:{user}:{contractAddress}
• Fixed contract-specific window processing and isolation
• Improved window cleanup and state management per contract

🔄 Configuration Enhancements

• Enhanced block range handling (if toBlock = 0, it would continue till the latest block)
• Streamlined environment variable loading (for absintheApiClient)

🛠️ Core Engine Improvements

• Fixed contract address normalization (consistent lowercase)
• Enhanced asset discovery with automatic Redis tracking
• Improved multi-contract support with proper isolation

📈 Event Enrichment Pipeline

(done because we don't have startTs and endTs for txn events, we can make it a single function in future)

Added enrichEventsWithAssetPrice for asset price resolution

• Purpose: Calculates USD value for each event's asset amount
• Process:
  • Fetches asset metadata (decimals) from cache
  • Converts raw amount to display amount using decimals
  • Queries Redis time-series for asset price at event timestamp
  • Implements fallback to last known price if exact timestamp unavailable
  • Sets displayAmount and valueUsd fields on events

Added enrichEventsWithGasPricing for gas fee USD calculations

• Purpose: Calculates transaction gas costs in USD for comprehensive cost analysis

• Process:

  • Uses WETH address (0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2) as gas token
  • Fetches ETH price from Redis at transaction timestamp
  • Calculates: gasFeeWei = gasPrice × gasUsed
  • Converts: gasFeeNative = gasFeeWei ÷ 10^18 (Wei to ETH)
  • Final: gasFeeUsd = gasFeeNative × ethPrice
  • Sets gasFeeUsd field on events

• Enhanced buildEvents with eventName field and proper timestamp handling

• Improved cleanup pipeline for API-ready data formatting

🔍 Data Structure Fixes

• Added base field to RawEvent interface for enriched data
• Enhanced event metadata with complete transaction context
• Fixed field sanitization before API submission
• Improved type consistency across processing pipeline

📝 Important Note: Asset Configuration Requirement
Token Address vs Contract Address Clarification:
Required: VUSD token address (0x677ddbd918637E5F2c79e164D402454dE7dA8619) must be explicitly configured in main.ts and feed config
Why: The pricing engine needs the actual token address to fetch metadata (decimals, symbol) for proper amount calculations
Previous confusion: Initially attempted using the minting contract address, which doesn't contain token metadata
Recommendation: This pattern should be better documented as it's not immediately obvious that token addresses (not contract addresses) are required for asset configuration
This distinction is crucial for proper decimal handling and price resolution in the enrichment pipeline.