About Superteam Ukraine

We're Superteam Ukraine, and we're all about empowering our community to build awesome stuff on Solana. We help talented folks in Ukraine connect, learn, and contribute to the global Solana ecosystem.

Mission

Create an open-source, real-time arbitrage monitoring tool for Raydium CPMM pools that detects price discrepancies across pools for a given token pair and signals profitable arbitrage opportunities.

Scope Detail

Core Functionality:

• Pool Discovery: Given two mint addresses, automatically discover all relevant Raydium CPMM pools for that token pair.

• Real-Time Price Calculation: Continuously fetch and calculate accurate spot prices for each discovered pool.

• Net Profit Calculation: Compute the net profit of each arbitrage opportunity — price difference minus all applicable swap fees and transaction costs.

• Arbitrage Signaling: Surface actionable opportunities ranked by net profit, including the buy pool, sell pool, and estimated profit.

  Configuration:

• Configurable RPC endpoint.

• Configurable polling interval.

• Configurable minimum profit threshold for alerts.

• Support for .env or config file.

  Logging:

• Structured logging with timestamps.

• Log levels (info, warn, error, debug).

• Log pool discovery events, price updates, and detected opportunities.

  Interface:

• CLI or simple UI — builder's choice.

• Input: two mint addresses.

• Output: a live-updating list of arbitrage opportunities with pool addresses, prices, and net profit.

Submission Requirements

1. The tool must be built in a public GitHub repository.

2. Include a comprehensive README covering:

     - How the tool works (architecture overview).

     - Installation and setup guide.

     - Configuration reference (all supported options).

     - Usage examples with sample output.

     - Explanation of how prices and net profit are calculated.

1. The GitHub repo must have an MIT or Apache-2.0 license.

2. Submit your GitHub repository link on this listing.

Judging Criteria

• Functionality & Correctness (35%): Does the tool correctly discover pools, calculate prices, and compute net profit including fees?

• Code Quality & Architecture (25%): Is the code clean, modular, and well-structured? Is configuration properly separated from logic?

• Logging & Observability (15%): Is logging meaningful, structured, and useful for debugging?

• Developer Experience (15%): Is the README clear and thorough? Is the tool easy to set up and run?

• Interface & UX (10%): Is the CLI or UI intuitive and does it present results in a readable, actionable format?

Reward Structure

  1st Place: $150

  2nd Place: $100

  3rd Place: $50