CLI + On-Chain Arbitrage Program
The CLI + On-Chain Arbitrage Program is the operational core of the Atomic Arbitrage Ecosystem. It connects analytical insights from the off-chain tools (Monitor and Strategy Platform) to the actual execution logic that performs real arbitrage operations directly on the Solana blockchain.
Together, the CLI and the on-chain program form a lightweight, low-latency execution engine capable of scanning, validating, and executing arbitrage opportunities entirely on-chain, without reliance on external APIs or RPCs.
Overview
This component acts as the bridge between decision and execution. It consumes optimized strategy configurations from the Strategy Platform, applies them in real time, and interacts directly with Solana smart contracts to execute trades.
By running the CLI locally (or in a hosted environment) and connecting to the Atomic Program deployed on-chain, users can perform arbitrage with minimal infrastructure overhead and maximum transparency.
The result is a self-sustained execution layer that operates without any external dependencies or centralized intermediaries.
Design Principles
The CLI + On-Chain Arbitrage Program was built around three key design goals:
Native Performance – Every transaction and calculation is handled directly through Solana’s runtime, removing external RPC latency and third-party overhead.
Cost Efficiency – Each arbitrage “scan” typically consumes only 5,000–12,000 lamports, depending on route depth and transaction density.
Interoperability – Seamlessly integrates with all other ecosystem modules, ensuring smooth data exchange between analysis, monitoring, and execution.
This architecture ensures high-frequency operation even during periods of heavy network congestion.
Execution Flow
Below is the high-level lifecycle of a single arbitrage operation:
Strategy Initialization The user loads a configuration generated by the Strategy Platform. It contains all relevant parameters — spread threshold, fee limits, and preferred DEX pools.
Scanning Phase The CLI scans live Solana data streams for price deviations that meet the configured criteria. These scans are performed continuously with extremely low compute overhead.
Commitment Phase When a potential arbitrage is detected, the On Chain program validates the route.
Execution Phase The on-chain program executes the full trade atomically. It handles swaps, transfers, and profit calculation entirely within the Solana runtime.
Reporting Phase After execution, the program emits structured logs that are parsed by the CLI and forwarded to the Real-Time Monitor. The Strategy Platform uses this data to improve subsequent simulations.
This cycle repeats continuously, maintaining constant alignment between the analytics, monitor, and execution layers.
Key Advantages
1. Full Autonomy
The CLI and on-chain program together form a self-operating arbitrage engine that requires no centralized servers or infrastructure. All computations, validations, and executions occur on-chain or within your own local environment.
2. Minimal Fees
Through optimized instruction batching and efficient transaction construction, average cost per arbitrage attempt remains between 5,000–12,000 lamports — significantly lower than RPC-based bots.
3. Low Latency
Because execution happens directly on Solana, there are no RPC bottlenecks. Typical transaction landing times average below 300ms, depending on network load.
4. Reliability
Each operation is atomic and verifiable on-chain. Failures, partial executions, or inconsistent states are impossible by design — every transaction either completes or reverts entirely.
5. Transparency
All executions are visible on-chain and fully traceable through the Real-Time Monitor. No hidden endpoints or proprietary APIs — just pure, verifiable Solana transactions.
Integration with Other Components
Real-Time Monitor: Displays wallet activity, fee consumption, and transaction success in real time based on CLI output.
Strategy Platform: Generates and exports configuration files that determine the CLI’s scanning and execution behavior.
Transaction Landing Engine: Handles final transaction delivery and confirmation, bypassing external RPCs to ensure high landing consistency.
Each connection is native — no manual linking or setup required.
Security Considerations
The on-chain program uses Solana’s standard instruction model — all operations are signed and verified by the wallet owner.
It’s strongly recommended to use a dedicated wallet for arbitrage operations.
The system is fully transparent — you can verify every instruction and transaction directly on-chain.
Last updated