How mangiapanejohn-dev/mobius-searcher works
MØBIUS-Searcher is a PAPER-by-default Solana arbitrage research and execution application. Its main workflow streams pool and oracle changes, schedules affected routes, obtains Jupiter-built legs, prices and assembles opportunities, simulates transactions, applies risk gates, and then records or executes according to mode. The README also documents terminal monitoring, session replay/reporting, and separate strategy research. Wiring is based on the README and sampled excerpts; unsampled module internals and uncertain links are omitted.
Main entry points: engine.rs Runtime wiring · pipeline.rs Opportunity pipeline · main.rs CLI entry · router.rs Event-driven scheduler
Components 26
Runtime orchestration
- CLI entry
apps/mobius-searcher/src/main.rs - Runtime wiring
apps/mobius-searcher/src/engine.rs - Core config and models
crates/core/src/config.rs
Market and routing
- Chain feeds
crates/market/src/feed.rs - RPC client
crates/market/src/rpc.rs - Hot tick handling
crates/market/src/hot.rs - Event-driven scheduler
crates/execution/src/router.rs - Jupiter quotes/build
crates/jupiter/src/client.rs - Route strategies
crates/strategy/src/strategies.rs
Evaluation and execution
- Opportunity pipeline
crates/execution/src/pipeline.rs - Transaction assembly
crates/execution/src/assemble.rs - Transaction simulation
crates/execution/src/simulate.rs - Risk gates
crates/risk/src/lib.rs - Mode-gated execution
crates/execution/src/live.rs - Jito bundle service
crates/jito/src/client.rs
Storage and telemetry
- Event and telemetry bus
crates/telemetry/src/bus.rs - Session recorder
crates/storage/src/recorder.rs - Session database
crates/storage/src/store.rs
User interface and research
- Terminal interface
crates/tui/src/app.rs - UI view model
crates/tui/src/hub.rs - Research workflows
apps/mobius-searcher/src/research/mod.rs - Research database
crates/storage/src/research.rs
Other components
- Operator
- Solana RPC and WebSocket
- Jupiter API
- Jito Block Engine
Connections 30
- Operator → CLI entry: invokes
- CLI entry → Runtime wiring: starts runtime
- CLI entry → Research workflows: runs research
- Runtime wiring → Core config and models: loads settings
- Runtime wiring → Chain feeds: starts feeds
- Chain feeds → Solana RPC and WebSocket: subscribes
- Runtime wiring → Hot tick handling: routes updates
- Hot tick handling → Event-driven scheduler: signals changes
- Runtime wiring → Event-driven scheduler: starts scheduler
- Event-driven scheduler → Route strategies: uses route plans
- Event-driven scheduler → Opportunity pipeline: dispatches decisions
- Opportunity pipeline → Jupiter quotes/build: builds legs
- Jupiter quotes/build → Jupiter API: requests quotes
- Opportunity pipeline → Transaction assembly: assembles transaction
- Opportunity pipeline → RPC client: simulates transaction
- RPC client → Solana RPC and WebSocket: sends RPC
- Opportunity pipeline → Risk gates: checks opportunity
- Opportunity pipeline → Mode-gated execution: dispatches by mode
- Mode-gated execution → Jito bundle service: submits bundle
- Jito bundle service → Jito Block Engine: sends JSON-RPC
- Runtime wiring → Event and telemetry bus: emits runtime events
- Opportunity pipeline → Event and telemetry bus: emits evaluations
- Event and telemetry bus → Session recorder: records events
- Session recorder → Session database: writes sessions
- CLI entry → Session database: opens sessions
- Runtime wiring → Terminal interface: starts interface
- Terminal interface → UI view model: reads view state
- Event and telemetry bus → UI view model: updates view
- CLI entry → Research database: opens research store
- Research workflows → Research database: stores and reads samples