A simple, modular, and fast framework for writing MEV bots in Rust.
  • Rust 74.1%
  • Solidity 25%
  • Julia 0.8%
Find a file
History 2023-10-04 14:46:21 -07:00
.github/workflows Add docker build in CI (#25) 2023-06-19 17:41:28 -07:00
assets chore: transfer repo 2023-05-04 17:07:53 +02:00
bin Init functionality by adding a small CLI (#16) 2023-06-01 19:52:36 -07:00
crate-template Matchmaker Client (#18) 2023-06-02 16:46:12 -07:00
crates Update BlindArb.t.sol (#47) 2023-10-04 14:46:21 -07:00
docker chore: transfer repo 2023-05-04 17:07:53 +02:00
examples/mev-share-arb Multiple actions returned from process_event if needed (#43) 2023-08-06 22:03:16 -07:00
.dockerignore chore: transfer repo 2023-05-04 17:07:53 +02:00
.gitignore chore: transfer repo 2023-05-04 17:07:53 +02:00
Cargo.lock feat: Chainbound x Artemis integration (#59) 2023-10-03 00:37:11 -07:00
Cargo.toml feat: migrate mev share dependencies (#39) 2023-07-26 18:08:45 -04:00
Dockerfile Fix docker build (#22) 2023-06-07 14:40:53 -07:00
justfile chore: clean up documentation (#1) 2023-05-04 19:03:47 +02:00
LICENSE-APACHE chore: transfer repo 2023-05-04 17:07:53 +02:00
LICENSE-MIT chore: transfer repo 2023-05-04 17:07:53 +02:00
README.md Update README.md (#52) 2023-10-04 12:32:11 -07:00
rustfmt.toml chore: transfer repo 2023-05-04 17:07:53 +02:00

CI status Telegram Chat

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:

Build, Test and Run

First, make sure the following are installed:

  1. Anvil

In order to build, first clone the github repo:

git clone https://github.com/paradigmxyz/artemis
cd artemis

Next, run tests with cargo:

cargo test --all

In order to run the opensea sudoswap arbitrage strategy, you can run the following command:

cargo run -- --wss <INFURA_OR_ALCHEMY_KEY> --opensea-api-key <OPENSEA_API_KEY> --private-key <PRIVATE_KEY> --arb-contract-address <ARB_CONTRACT_ADDRESS> --bid-percentage <BID_PERCENTAGE>

where ARB_CONTRACT_ADDRESS is the address to which you deploy the arb contract.

Acknowledgements