solana-arb-executor

Was macht solana-arb-executor?

Gerüst für den Rust Ausführungs-Hotpath für Solana-Arbitrage: stream -> detect -> simulate -> bundle -> land, verpackt in einem Risikogate (Limits, Circuit Breaker, Kill-Switch) und einem Bestätigungsgate. Dies ist die On-Chain-Ebene, die vorherige Arbeiten nur analysieren: agiprolabs/claude-trading-skills ist Python-Analyse (Signale, Backtests, keine Ausführung), und TypeScript-Arb-Skills überlassen den latency-empfindlichen Landing-Pfad anderen. Dies ist die echte Lücke – der Teil, der schnell, korrekt und sicher sein muss.

Ehrliche Wirtschaftlichkeit (tragend): Räumliche DEX-Arb auf Solana ist infrastrukturdominiert und hart umkämpft; rohe Preisunterschiede gehen an Parteien mit besserer Netzwerkposition als einer einzelnen Box. Der dauerhafte Vorteil eines Einzelhändlers ist nicht rohe Geschwindigkeit – es ist korrekte Landung (simuliere zuerst, richtiger CU-Preis, Trinkgeld-Bemessung, Wiederholungsdisziplin), Risikodisziplin (Limits/Breaker/Kill-Switch) und weniger umkämpfte Gelegenheiten (Funding-Basis, kursübergreifende Ratenlücken, langfristigere Spielzüge). Dies ist Gerüst + Wissen, kein gehosteter Bot und keine garantierte Gewinnmaschine.

VORRANG (vor jedem Code-Gen lesen)

1. references/safety-rails.md ZUERST lesen. Jeder ausgegebene Ausführungspfad beachtet es.
2. Niemals Code ausgeben, der eine geldbewegende/signierende Transaktion ohne eine explizite typisierte menschliche Bestätigungsgate sendet; kein Flag deaktiviert es. Standard DRY_RUN=true, REQUIRE_CONFIRM=true. Immer vor dem Senden simulieren.
3. Verwende die festgelegten Crate-Versionen in references/sdk-versions.md (verifiziert 2026-06). Flagge jito-sdk-rust als frühes 0.x.
4. Delegiere Programm-/Anchor-/IDL-/Transaktions-Signierarbeit an ../solana-dev/ über references/delegation.md. Dupliziere es nicht hier.
5. Obligatorische Limits (max-notional, max-position, daily-loss) + Circuit Breaker + Kill-Switch-Gate vor jeder Order, bevor sie die Bestätigungsgate erreichen kann.

Aufgabenrouting-Leitfaden

Ordne die Absicht des Benutzers genau einem Blatt zu.

Benutzer fragt nach...	Öffne dieses Blatt
Hotpath-Design / Latenz-Budget	references/architecture.md
Stream-Konten/Slots / ShredStream-Aufnahme	references/streaming-ingestion.md
Jito-Bundle / Trinkgeld / Leader-Timing	references/jito-bundles.md
Transaktion landen / Prioritätsgebühr / simulieren / Wiederholungen	references/transaction-landing.md
Gelegenheit erkennen / Spread / Schwelle	references/opportunity-detection.md
Risiko / Circuit Breaker / Kill-Switch / Limits	references/risk-and-killswitch.md
Sicherheit / Bestätigungsgate	references/safety-rails.md
Crate / Version / Installation	references/sdk-versions.md
Programm / Anchor / Signieren	references/delegation.md

Progressive Offenlegung

• Router (diese Datei): nur Verweise – kein Masseninhalt.
• Blätter (~60-200 Zeilen jeweils): dicht, korrekt, minimal. Code lebt in skill/templates/.
• Reine Logik ist offline-testbar: templates/src/fees.rs und templates/src/risk.rs sind nur std und eigenständig – führe rustc --edition 2021 --test fees.rs (und risk.rs) eigenständig aus. Die vollständige Crate (stream.rs, jito.rs, detector.rs, main.rs) kompiliert mit cargo build gegen die festgelegten Crates.
• Delegation: ../solana-dev/ für Programm / Tx / Signieren.

Agenten

Agent	Rolle	Modell
agents/arb-execution-architect.md	Entwirft das Latenz-Budget, die Aufnahme-/Landungs-Topologie und den Risikorahmen vor dem Code	opus
agents/rust-perf-engineer.md	Verbindet Stream -> Detektor -> RiskGate -> Simuliere-zuerst-Jito-Bundle	sonnet

Befehle

Befehl	Tut
commands/scaffold-executor.md	Gib das Executor-Crate-Skelett aus (DRY_RUN + REQUIRE_CONFIRM Standardwerte)
commands/wire-yellowstone.md	Generiere das Yellowstone gRPC-Aufnahmemodul mit Wiederverbindung/Backoff
commands/add-killswitch.md	Füge das RiskGate mit Limits + Circuit Breaker + Kill-Switch ein