Keeperhub Matcha

A TypeScript wrapper for integrating 0x Protocol (Matcha) with KeeperHub workflows. This wrapper provides quote fetching, token swaps, and price monitoring capabilities.

Features 🔄 Token Swap Quotes - Get real-time quotes for any token pair 💱 Swap Execution - Get transaction data for executing swaps 📊 Price Tracking - Monitor token prices with caching 🚨 Price Alerts - Create and monitor price alerts 🔗 KeeperHub Integration - Built-in adapter for KeeperHub workflows

KeeperHub Matcha is a TypeScript wrapper that bridges the 0x Protocol (Matcha) with KeeperHub workflows, enabling DeFi automation. Here's how it's architected:

Core Architecture The project uses a three-layer pattern:

API Client Layer (OxAPIClient) - Communicates directly with 0x Protocol's HTTP API using Axios, handling requests for quotes and swaps with proper parameter mapping.

Wrapper Layer (MatchaWrapper) - Provides the main business logic, wrapping the API client with additional features like price caching (30-second TTL), price alert management, and quote formatting. This shields consumers from raw API complexity.

Adapter Layer (MatchaKeeperHubAdapter) - Bridges the wrapper with KeeperHub's action system, converting KeeperHub action parameters into wrapper calls and formatting responses for workflow execution