Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/paradigmxyz/artemis
A simple, modular, and fast framework for writing MEV bots in Rust.
https://github.com/paradigmxyz/artemis
Last synced: 5 days ago
JSON representation
A simple, modular, and fast framework for writing MEV bots in Rust.
- Host: GitHub
- URL: https://github.com/paradigmxyz/artemis
- Owner: paradigmxyz
- License: apache-2.0
- Created: 2023-04-25T20:47:17.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-03-05T03:15:09.000Z (9 months ago)
- Last Synced: 2024-11-30T10:02:00.964Z (12 days ago)
- Language: Rust
- Homepage:
- Size: 2.35 MB
- Stars: 2,339
- Watchers: 50
- Forks: 448
- Open Issues: 30
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
- awesome-rust - artemis - A simple, modular, and fast framework for writing MEV bots. (Applications / Blockchain)
- awesome-rust - artemis - A simple, modular, and fast framework for writing MEV bots. (Applications / Blockchain)
- fucking-awesome-rust - artemis - A simple, modular, and fast framework for writing MEV bots. (Applications / Blockchain)
- fucking-awesome-rust - artemis - A simple, modular, and fast framework for writing MEV bots. (Applications / Blockchain)
README
[][gh-ci]
[![Telegram Chat][tg-badge]][tg-url]
[gh-ci]: https://github.com/paradigmxyz/reth/actions/workflows/rust.yml
[tg-badge]: https://img.shields.io/badge/chat-telegram-blue
## What is Artemis?
Artemis is a framework for writing MEV bots in Rust. It's designed to be simple, modular, and fast.
At its core, Artemis is architected as an event processing pipeline. The library is made up of three main components:
1. *Collectors*: *Collectors* take in external events (such as pending txs, new blocks, marketplace orders, etc. ) and turn them into an internal *event* representation.
2. *Strategies*: *Strategies* contain the core logic required for each MEV opportunity. They take in *events* as inputs, and compute whether any opportunities are available (for example, a strategy might listen to a stream of marketplace orders to see if there are any cross-exchange arbs). *Strategies* produce *actions*.
3. *Executors*: *Executors* process *actions*, and are responsible for executing them in different domains (for example, submitting txs, posting off-chain orders, etc.).
## Strategies
The following strategies have been implemented:
- [Opensea/Sudoswap NFT Arbitrage](/crates/strategies/opensea-sudo-arb/): A strategy implementing atomic, cross-market NFT arbitrage between Seaport and Sudoswap.
## Build, Test and Run
First, make sure the following are installed:
1. [Anvil](https://github.com/foundry-rs/foundry/tree/master/crates/anvil#installing-from-source)
In order to build, first clone the github repo:
```sh
git clone https://github.com/paradigmxyz/artemis
cd artemis
```
Next, run tests with cargo:
```sh
cargo test --all
```
In order to run the opensea sudoswap arbitrage strategy, you can run the following command:
```sh
cargo run -- --wss --opensea-api-key --private-key --arb-contract-address --bid-percentage
```
where `ARB_CONTRACT_ADDRESS` is the address to which you deploy the [arb contract](/crates/strategies/opensea-sudo-arb/contracts/src/SudoOpenseaArb.sol).
## Acknowledgements
- [subway](https://github.com/libevm/subway)
- [subway-rs](https://github.com/refcell/subway-rs)
- [cfmms-rs](https://github.com/0xKitsune/cfmms-rs)
- [rusty-sando](https://github.com/mouseless-eth/rusty-sando)
- [bundle-generator](https://github.com/Alcibiades-Capital/mev_bundle_generator/blob/master/Cargo.toml)
- [ethers-rs](https://github.com/gakonst/ethers-rs)
- [ethers-flashbots](https://github.com/onbjerg/ethers-flashbots)
[tg-url]: https://t.me/artemis_devs