https://github.com/mouseless0x/rusty-sando

Implementation of a competitive v2/v3 multi-meat MEV sandwich bot written using Rust and Huff.
https://github.com/mouseless0x/rusty-sando

evm huff mev rust sandwich

Last synced: about 2 months ago
JSON representation

Implementation of a competitive v2/v3 multi-meat MEV sandwich bot written using Rust and Huff.

• Host: GitHub
• URL: https://github.com/mouseless0x/rusty-sando
• Owner: mouseless-eth
• License: mit
• Archived: true
• Created: 2023-03-19T18:17:21.000Z (almost 2 years ago)
• Default Branch: master
• Last Pushed: 2023-08-08T03:30:19.000Z (over 1 year ago)
• Last Synced: 2024-05-03T04:55:49.747Z (8 months ago)
• Topics: evm, huff, mev, rust, sandwich
• Language: Rust
• Homepage:
• Size: 18.6 MB
• Stars: 717
• Watchers: 33
• Forks: 246
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Rusty-Sando (re-write) ![license](https://img.shields.io/badge/License-MIT-green.svg?label=license) ![twitter](https://img.shields.io/twitter/follow/0xMouseless?style=social)

A practical example on how to perform V2/V3 and multi-meat sandwich attacks written using Rust and Huff.

The goal of this repo is to act as reference material for aspiring searchers. 

> **This codebase has been cleaned up and rewritten using the [`Artemis`](https://github.com/paradigmxyz/artemis) framework. (Further details in [pull request #31](https://github.com/mouseless-eth/rusty-sando/pull/31#issue-1818492576))**

## Demo

https://user-images.githubusercontent.com/97399882/226269539-afedced0-e070-4d12-9853-dfbafbcefa49.mp4

## Brief Explanation

Anytime that a transaction interacts with a Uniswap V2/V3 pool and its forks, there is some slippage introduced (routers, aggregators, other MEV bots). Sandwich bots, like this one, are a toxic form of MEV as they profit off this slippage by frontrunning the transaction pushing the price of an asset up to the slippage limit, and then immediately selling the asset through a backrun transaction.

**Bot Logic Breakdown** can be found under [bot/README.md](https://github.com/mouseless-eth/rusty-sando/tree/master/bot)

**Contract Logic Breakdown** can be found under [contract/README.md](https://github.com/mouseless-eth/rusty-sando/tree/master/contract)

## Features

- **Fully Generalized**: Sandwich any tx that introduces slippage.

- **V2 and V3 Logic**: Logic to handle Uniswap V2/V3 pools.

- **Multi-Meat**: Build and send multi-meat sandwiches.

- **Gas Optimized**: Contract written in Huff using unconventional gas optimizations.

- **Local Simulations**: Fast concurrent EVM simulations to find sandwich opportunities. 

- **Token Dust**: Stores dust at the end of every bundle for lower gas usage the next time the token is traded. 

- **Salmonella Checks**: Detect if erc20's transfer function uses any unusual opcodes that may produce different mainnet results.

## Notice

If any bugs or optimizations are found, feel free to create a pull request. **All pull requests are welcome!** 

> **Warning**

>

> **This software is highly experimental and should be used at your own risk.** Although tested, this bot is experimental software and is provided on an "as is" and "as available" basis under the MIT license. We cannot guarantee the stability or reliability of this codebase and are not responsible for any damage or loss caused by its use. We do not give out warranties. 

## Acknowledgments

- [subway](https://github.com/libevm/subway)

- [subway-rs](https://github.com/refcell/subway-rs)

- [cfmms-rs](https://github.com/0xKitsune/cfmms-rs)

- [revm](https://github.com/bluealloy/revm)

- [artemis](https://github.com/paradigmxyz/artemis)

- [huff-language](https://github.com/huff-language/huff-rs)

- [foundry](https://github.com/foundry-rs/foundry)

- [reth](https://github.com/paradigmxyz/reth)

- [ethers-rs](https://github.com/gakonst/ethers-rs)

- [ethers-flashbots](https://github.com/onbjerg/ethers-flashbots)

- [mev-template-rs](https://github.com/degatchi/mev-template-rs)