Communitygithub.com

alexbanda08/solana-arb-executor

Exécution d'arbitrage Rust à faible latence sur Solana, conçue pour le Solana AI Kit : ingestion Yellowstone gRPC, bundles Jito avec simulation préalable, envoi de transactions, gestion des risques et kill-switch. Licence MIT.

Qu'est-ce que solana-arb-executor ?

Cette compétence fournit un squelette Rust pour le chemin critique d'exécution d'arbitrage sur Solana : un pipeline complet `stream -> détection -> simulation -> bundle -> envoi`, encapsulé dans une barrière de risque (plafonds, coupe-circuit, kill-switch) et une barrière de confirmation humaine. Contrairement aux outils d'analyse Python (comme agiprolabs/claude-trading-skills) ou aux compétences TypeScript qui abandonnent la partie sensible à la latence, ce projet cible spécifiquement l'exécution rapide, correcte et sécurisée. Il est conçu pour être utilisé avec des agents AI tels que Claude Code sur des éditeurs comme Cursor ou VS Code. L'avantage durable d'un opérateur individuel n'est pas la vitesse brute, mais le placement correct des transactions (simulation d'abord, estimation des frais, taille du pourboire, discipline de réessai), la discipline de risque (plafonds/coupe-circuit/kill-switch), et les opportunités moins disputées (écarts de taux, opérations à plus long terme). La compétence inclut des références détaillées sur l'architecture, l'ingestion de flux, les bundles Jito, l'envoi de transactions, la détection d'opportunités, la gestion des risques et la sécurité. Le code est structuré en modules Rust testables hors ligne et le squelette du projet peut être généré via des commandes dédiées.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add alexbanda08/solana-arb-executor

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait solana-arb-executor ?

Met en place le chemin chaud d'exécution Rust pour l'arbitrage Solana : stream -> détection -> simulation -> bundle -> envoi, encadré par une barrière de risque (plafonds, coupe-circuit, kill-switch) et une barrière de confirmation. Il s'agit de la couche on-chain que les travaux antérieurs ne faisaient qu'analyser : agiprolabs/claude-trading-skills est en Python pour l'analyse (signaux, backtests, pas d'exécution), et les compétences TypeScript d'arbitrage abandonnent le chemin sensible à la latence. C'est le véritable espace blanc – la partie qui doit être rapide, correcte et sûre.

Économie honnête (élément porteur) : l'arbitrage spatial DEX sur Solana est dominé par l'infrastructure et fortement contesté ; les écarts de prix bruts vont aux acteurs ayant une meilleure position réseau qu'une seule machine. L'avantage durable d'un opérateur individuel n'est pas la vitesse brute – c'est le placement correct des transactions (simulation d'abord, bon prix CU, taille du pourboire, discipline de réessai), la discipline de risque (plafonds/coupe-circuit/kill-switch), et les opportunités moins disputées (écarts de taux de financement, écarts de taux entre plateformes, opérations à plus long horizon). Ceci est un squelette + des connaissances, pas un bot hébergé et pas une machine à profit garantie.

PRÉCÉDENCE (à lire avant toute génération de code)

  1. Lisez references/safety-rails.md en premier. TOUT chemin d'exécution émis doit lui obéir.
  2. N'émettez jamais de code qui envoie une transaction de transfert de fonds / de signature sans une barrière de confirmation humaine typée explicite ; aucun drapeau ne la désactive. Valeurs par défaut DRY_RUN=true, REQUIRE_CONFIRM=true. Toujours simuler avant de soumettre.
  3. Utilisez les versions de crate épinglées dans references/sdk-versions.md (vérifiées 2026-06). Signalez jito-sdk-rust comme étant un early 0.x.
  4. Déléguez le travail lié aux programmes / Anchor / IDL / signature de transactions à ../solana-dev/ via references/delegation.md. Ne le dupliquez pas ici.
  5. Plafonds obligatoires (notional max, position max, perte quotidienne max) + coupe-circuit + kill-swift gate chaque ordre avant qu'il ne puisse atteindre la barrière de confirmation.

Guide d'orientation des tâches

Faites correspondre l'intention de l'utilisateur à exactement une feuille.

L'utilisateur demande...Ouvrez cette feuille
conception du chemin chaud / budget de latencereferences/architecture.md
flux de comptes/slots / ingestion ShredStreamreferences/streaming-ingestion.md
bundle Jito / pourboire / timing du leaderreferences/jito-bundles.md
envoi de transaction / frais de priorité / simulation / réessaisreferences/transaction-landing.md
détection d'opportunité / spread / seuilreferences/opportunity-detection.md
risque / coupe-circuit / kill-switch / plafondsreferences/risk-and-killswitch.md
sécurité / barrière de confirmationreferences/safety-rails.md
crate / version / installationreferences/sdk-versions.md
programme / Anchor / signaturereferences/delegation.md

Divulgation progressive

  • Routeur (ce fichier) : uniquement des pointeurs – aucun contenu volumineux.
  • Feuilles (~60-200 lignes chacune) : denses, correctes, minimales. Le code vit dans skill/templates/.
  • La logique pure est testable hors ligne : templates/src/fees.rs et templates/src/risk.rs sont std-only et autonomes – exécutez rustc --edition 2021 --test fees.rs (et risk.rs) indépendamment. La crate complète (stream.rs, jito.rs, detector.rs, main.rs) se compile avec cargo build en utilisant les crates épinglées.
  • Délégation : ../solana-dev/ pour les programmes / transactions / signatures.

Agents

AgentRôleModèle
agents/arb-execution-architect.mdConçoit le budget de latence, la topologie d'ingestion/envoi et l'enveloppe de risque avant le codeopus
agents/rust-perf-engineer.mdRelie le stream -> détecteur -> RiskGate -> bundle Jito avec simulation préalablesonnet

Commandes

CommandeAction
commands/scaffold-executor.mdÉmet le squelette de la crate exécutrice (valeurs par défaut DRY_RUN + REQUIRE_CONFIRM)
commands/wire-yellowstone.mdGénère le module d'ingestion gRPC Yellowstone avec reconnexion/backoff
commands/add-killswitch.mdAjoute le RiskGate avec plafonds + coupe-circuit + kill-switch

Skills associés