​

Monaco Protocol SDK v0.4.1

​

Indexer Improvements & Bug Fixes

​

What’s New

• TypeScript 5.9+: Full type safety and IntelliSense support with latest TypeScript
• viem 2.31+: Updated to latest viem for improved blockchain interactions
• Better Type Inference: Improved TypeScript configuration for optimal developer experience

• Alloy Migration: Replaced deprecated ethers.rs with modern alloy library for blockchain interactions
• WebSocket Event Listening: Native WebSocket support for vault event monitoring (no longer requires special RPC provider filters)
• Broader RPC Compatibility: Works with any standard EVM provider, including free tiers like Rhino
• Repository Pattern: Cleaner data access layer with dedicated repositories for applications, blockchain events, and processed blocks
• Enhanced Gap Detection: Improved logic for detecting and backfilling missed blockchain events

• Withdrawal Events: Fixed withdrawal event signature causing withdrawal events not to be indexed correctly
• Whitelist App: Resolved critical bug in the whitelist application
• Configuration: Improved environment variable naming consistency across indexer services

​

Technical Details

• TypeScript 5.9+: Full type safety and IntelliSense support
• viem 2.31+: Modern Ethereum library for blockchain interactions

​

TypeScript Configuration

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "nodenext",
    "moduleResolution": "nodenext",
    "strict": true,
    "esModuleInterop": true,
    "resolveJsonModule": true
  }
}

// New repositories for cleaner data access
ApplicationRepository
BlockchainEventsRepository  
ProcessedBlocksRepository
TradingPairsRepository

Before: HTTP polling with filters (limited provider support)
After:  WebSocket subscriptions (works with any EVM provider)

# Updated variable names for consistency
INDEXER_RPC_URL=https://your-rpc-provider.com
INDEXER_POLLING_INTERVAL_MS=12000
DATABASE_URL=postgresql://...

• Detects gaps in processed blocks
• Automatically backfills missing events
• Better logging for monitoring indexer health
• Improved error handling and retry logic

​

Migration Guide

1. Review the updated .env.example file in the indexer/ directory
2. Update environment variable names to match new conventions
3. Restart the indexer service
4. Monitor logs for successful WebSocket connection

# Restart indexer after configuration updates
cargo run -p indexer

npm install @0xmonaco/[email protected] viem@^2.31.0

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "nodenext",
    "moduleResolution": "nodenext",
    "strict": true,
    "esModuleInterop": true,
    "resolveJsonModule": true
  }
}

• Better type safety with TypeScript 5.9+
• Enhanced blockchain interactions with viem 2.31+
• Improved IntelliSense and autocomplete
• No breaking changes to existing code

​

Packages Updated

• Indexer Service: v0.4.1 with alloy migration
• Data Layer: Enhanced with new repositories
• Infrastructure: Updated Docker and configuration files

• @0xmonaco/[email protected]
• @0xmonaco/[email protected]
• @0xmonaco/[email protected]
• @0xmonaco/[email protected]

​

Installation

npm install @0xmonaco/[email protected]
npm install @0xmonaco/[email protected]  # For React applications

npm install @0xmonaco/core
npm install @0xmonaco/react  # For React applications

​

Benefits

• Enhanced type safety with TypeScript 5.9+ (better IntelliSense and autocomplete)
• Improved blockchain interactions with viem 2.31+
• Better developer experience with optimized TypeScript configuration

• More reliable event indexing
• Broader RPC provider compatibility
• Better error messages and logging
• Cleaner codebase following repository pattern

• Reduced RPC provider requirements (no special filters needed)
• More cost-effective infrastructure (free tier providers work)
• Improved monitoring with better gap detection
• Enhanced reliability with automatic backfilling

​

Related Changes

• Indexer refactored to use alloy with repository pattern
• Enhanced vault event handling with WebSocket support
• Docker and environment configuration updates
• Comprehensive test coverage additions

​

Testing & Coverage

• Vault listener integration tests
• Repository unit tests
• Event handling edge cases
• Gap detection and backfilling tests

​

Commit References

• 3a0d893d - Refactor indexer to use alloy
• d352c7d5 - Fix Withdrawal Event Signature
• 7ac2afd4 - Fixed critical bug in whitelist app
• 764d87ed - Move alloy to workspace, cleanup dependencies