AES is a proprietary arbitrage execution engine designed for high-frequency trading on decentralized finance (DeFi) networks. It discovers opportunities, validates cycles, and executes profitably within Ethereum’s block space using ephemeral contracts and MEV bundling.
AES is not open source — this repository only contains documentation, licensing, and supporting materials.
AES is not designed for convenience. It is designed to survive.
-
Deterministic by design.
Every pipeline runs in a fixed order with no hidden branches or discretionary steps. -
Overbuilt, never optimized.
The system prioritizes redundancy, logging, and hard walls over efficiency. -
Custody first, execution second.
Treasury protection is the primary rule; profits are secondary to custody. -
No single point of failure.
Every layer—Safe, contracts, allocators, pipelines—assumes compromise is possible and isolates blast radius.
These principles define every module of AES, from custody flows to arbitrage discovery.
🛡️ Ephemeral contract architecture
📊 Path validation & risk controls
🌍 Multi-chain ready (ETH, L2s, more)
💱 Token-agnostic (ERC-20 compatible)
🔒 Proprietary discovery algorithms
🧾 Structured execution logging
🧪 Two-stage validation pipeline
🎯 Streaming profitable cycles
🧠 ML-enhanced path scoring
💰 “Safe Payouts” now Gnosis Safe
🕵️ Forensic audit trail hooks
AES has demonstrated rapid path discovery with significant profit potential. This demo shows AES identifying $40,000+ in arbitrage paths within 1 minute. Contracts aren’t even deployed yet — this is pure discovery power.
🔒 Proprietary Software — Restricted License
This project, AES, implements proprietary algorithms and infrastructure, including the Reactive Profitable Zone Expansion (RPZE) methodology. Use strictly conditioned on execution of the License Agreement.
- Read the LICENSE.md in full.
If you don’t agree, you have zero rights to use this project. Because of its proprietary nature, no source code, binaries, or infrastructure are provided under this repository except as licensed. Only Outputs may be delivered to licensed users.
- Governed by Iowa law.
- Exclusive venue: Woodbury County District Court (Sioux City, Iowa) / Northern District of Iowa (Sioux City, IA)
- All rights reserved © Licensor.
Every design choice in this system begins and ends with security. Profit is meaningless if your capital can be drained — so we architected AES with the principle that safety comes first, everything else follows.
- Minimal on-chain code. Our executor is <70 lines, fully auditable, and free of hidden complexity.
- Ephemeral execution. Contracts are deployed, used, and destroyed in the same transaction. No idle state, no honeypots.
- Off-chain intelligence. Trade logic lives in Python, not Solidity. Attackers can’t reverse-engineer what isn’t on-chain.
- Vault-protected profits. A hardened multisig vault is the only permanent address. Execution contracts rotate, ensuring no static hotkeys.
- Audit-ready. Every cycle is logged. Security does not come at the expense of transparency or compliance.
This isn’t a script-kiddie bot. It’s a production-grade arbitrage engine, built with the same principle taught in every serious smart contract course:
Security > Speed. Security > Features. Security > Profit.
📁 arbitrage/
├── 📁 src/
│ ├── 📁 contracts/
│ ├── 📁 data/
│ ├── 📁 logic/
│ ├── 📁 plugins/
│ ├── 📁 tests/
│ └── 📁 utils/
└── 📄 LICENSE.md
(full file list redacted)
- Collects, normalizes, and aggregates liquidity data from loan providers.
- Collects and normalizes trade routes; builds edges into the liquidity graph.
- Builds and maintains directed weighted graph of liquidity and swaps.
- Uses a custom, repurposed Bellman-Ford and RPZE to identify profitable cycles.
- Groups paths into bundles, constructs calldata, and submits to Flashbots.
- Ephemeral wallet rotation, draining, and lifecycle control.
| Data | SharedState | Cache | File Persisted |
|---|---|---|---|
loan_data |
✅ | optional | ❌ |
loanable_tokens |
✅ | optional | ❌ |
graph |
✅ | ✅ | ✅ .graphml/json |
valid_profit_paths |
✅ | ✅ | ❌ |
execution_log |
✅ append | ❌ | ✅ if configured |
Run test suite:
pytest src/tests/• Ephemeral wallets rotate automatically and only sign transactions, never contains funds
• Contracts are deployed via CREATE2 and self-destruct after execution (EIP-6780 safe)
• Sensitive keys isolated in .env.secure with validation on load
• Execution routed exclusively through Flashbots — never touches mempool
• Logs filtered to exclude sensitive token/metadata
• Out-of-band Discord alerts (optional) for validation and execution results
- 📄
Function_Index.md— Global function/utility map