mev-toolkit/README.md

# 🦈⛓ 1337 mev toolkit

<br>

##### the concept of maximal extractable value (mev) was coined by the 2019 research paper [flashboys 2.0](https://arxiv.org/abs/1904.05234), 
##### and encompasses the profits generated by participant parties when producing new blocks on a blockchain.

<br>

<br>


## 🍕 notes && code in this repo

<br>

### mev extraction strategies

<br>

* [arbitrage](arbitrage)
* [nft arbitrage](nft_arbitrage)
* [front-running](front_running)
* [back-running](back_running)
* [sandwiching](sandwiching)
* [liquidations](liquidations)
* [flashloans](flashloans)

<br>

### "retired" or learning mev bots

<br>

* [cake sniper](https://github.com/Supercycled/cake_sniper)
* [ape bot](https://github.com/duckdegen/apebot)
* [synthetix bot](https://github.com/bertmiller/sMEV)
* [flashbot's simple arb](https://github.com/flashbots/simple-arbitrage)
* [searcher-sponsored-tx](https://github.com/flashbots/searcher-sponsored-tx)
* [searcher-minter](https://github.com/flashbots/searcher-minter)
* [subway](https://github.com/libevm/subway)
* [bundle generator](https://github.com/Alcibiades-Capital/mev_bundle_generator)
* [optimal sandwich](https://github.com/mevcheb/optimal-sandwich)
* [amm Arbitrageur](https://github.com/paco0x/amm-arbitrageur)
* [mev bot in q using kdb+](https://github.com/sambacha/q-evm)
* [liquidation Aave protocol example](https://github.com/ialberquilla/aave-liquidation)
* [liquidator-v3](https://github.com/blockworks-foundation/liquidator-v3)
* [limit sniper](https://github.com/CryptoGnome/Limit-Sniper)
* [pool-sniper](https://github.com/Anish-Agnihotri/pool-sniper)
* [globinmode longtail nft](https://github.com/Anish-Agnihotri/goblinmode)
* [binance alpha bot](https://github.com/duckdegen/apebot)
* [hummingbot rading bots](https://hummingbot.org/)
* [cow solver templante](https://github.com/cowprotocol/solver-template-py)
* [cowsol](https://github.com/MEV-WAIFU-LABS/cow_arbitrage_solver)



<br>

### mev on the chains

* [MEV on ethereum](MEV_on_Ethereum)
* [MEV on avalanche](MEV_on_Avalanche)
* [MEV on solana](MEV_on_Solana)
* [MEV on cosmos](MEV_on_Cosmos)




<br>

### healthy mev extraction


* [flashbots](flashbots)
* [cow.fi](cowfi)
* [rook.fi](rook)
* [twamm designs](twamm)
* [0x protocol and rfq](0x_protocol)

<br>

### building a toolkit


* [anatomy of mev bots](anatomy_of_mev_bots)
* [nodes on ethereum](NODES_on_Ethereum)

<br>

### related defi stuff

* [oracles and twap](oracles)
* [uniswap](uniswap)
* [defi and day trading](defi_and_trading)
* [tokenomics](tokenomics)


<br>


---

## 🍟 resources && tools


<br>

### mev explorers

* [zero MEV](https://www.zeromev.org/)
* [public MEV explorer](https://metablock.dev/tools/mev/)
* [dashboard by metablock](https://mev.metablock.dev/1/dashboard)



<br>

### tx analysis

<br>


##### ethereum mainnet

<br>

* [ethvm](https://www.ethvm.com/)
* [ethtx transaction decoder](https://ethtx.info/)
* [txn finance](https://txn.finance/)
* [ethereum token explorer](https://ethplorer.io/)
* [anyblock explorer and txs](https://explorer.anyblock.tools/)
* [blockscout block explorer](https://blockscout.com/eth/mainnet/)
* [blockchair blocks explorer](https://blockchair.com/ethereum)
* [oklink block and tokens explorer](https://www.oklink.com/en/eth)
* [phalcon tx explorer](https://phalcon.blocksec.com/)
* [breadcrumbs](https://www.breadcrumbs.app/home)

<br>

##### goerli testnet

<br>

* [etherscan goerli](https://goerli.etherscan.io/)




<br>

### gas trackers

<br>

* [eth gas alert](https://ethgasalerts.xyz/)
* [gas price io](https://www.gasprice.io/)
* [ethereum gas tracker](https://www.useweb3.xyz/gas)
* [nansei gas tracker](https://pro.nansen.ai/gas-tracker)
* [gas fee prediction](https://www.blocknative.com/gas-estimator)
* [gastrology](https://dethgasstation.eth.link/)




<br>

### data && analytics


* [mev dashboard by flashbots](https://explore.flashbots.net/).
* [nansen](https://www.nansen.ai/)
* [token terminal](https://tokenterminal.com/terminal)
* [westerngate, arbritage measured](Westerngate.xyz)
* [eigenPhi arbitrage scan](https://eigenphi.io/)
* [parsec.finance](https://parsec.finance/)
* [flashloans](https://tools.blocksec.com/flashloan/eth)
* [sandwiched?](https://sandwiched.wtf/)
* [etherscan data on flashbots](https://etherscan.io/blocks/label/flashbots)
* [MEV data corpus by manifold](https://github.com/manifoldfinance/mev-corpus)


##### awesome dune boards

* [ethereum tx reverts](https://dune.com/kroeger0x/ethereum-transaction-reverts)
* [dune board for gas prices](https://dune.com/kroeger0x/gas-prices)
* [sleuthing hashed function and event signatures](https://dune.com/agaperste/event-and-function-signature-sleuthing?)


<br>





### other supporting tools

<br>

* [eth converter](https://eth-converter.com/)
* [smart contract allowance checker](https://app.unrekt.net/)
* [tornado cash pool anonymity](https://tutela.xyz/)
* [eth detective](https://www.ethtective.com/address/)
* [contracts diff checker](https://etherscan.io/contractdiffchecker)
* [ultrasound money dahsboard](https://ultrasound.money/)
* [revoke.cash](https://revoke.cash/)
* [ankr rpc endpoints](https://www.ankr.com/rpc/)
* [back run me](https://backrunme.com/swap)

<br>


---

## 🍿 general articles

<br>

- [Endgame by Vitalik](https://vitalik.ca/general/2021/12/06/endgame.html)
- [Escaping the Dark Forest by samczsun](https://samczsun.com/escaping-the-dark-forest/)
- [How to Build an Ethereum Mining Pool by Dragonfly research](https://medium.com/dragonfly-research/how-to-build-an-ethereum-mining-pool-6be356520b7a)
- [MEV and Me by Paradigm](https://research.paradigm.xyz/MEV)
- [Return to the Dark Forest by rekt](https://rekt.news/return-to-the-dark-forest/)
- [Modern MEV sandwich attacks on Ethereum routers by totlsota](https://mirror.xyz/totlsota.eth/9JaNkZ1XQfQD6Y79aLYHC_kb_dSBoJ2JYiag5BuGGM8)
- [Dr. Reorg or: How I Learned to Stop Worrying and Love MEV by Saneel Sreeni](https://medium.com/dragonfly-research/dr-reorg-or-how-i-learned-to-stop-worrying-and-love-mev-2ee72b428d1d)
- [How To Light Up The Dark Forest by Robert Miller](https://writings.flashbots.net/writings/the-anatomy-of-an-inspector/)
- [Hiding in Plain Sight by samczsun](https://samczsun.com/hiding-in-plain-sight/)
- [We Live In A Mempool: Backrunning the MEV Crisis by Tom Schmidt](https://medium.com/dragonfly-research/we-live-in-a-mempool-backrunning-the-mev-crisis-a4ea0b493b05)
- [Wrecking sandwich traders for fun and profit](https://github.com/Defi-Cartel/salmonella)
- [Surrogeth: Tricking frontrunners into being transaction relayers](https://ethresear.ch/t/surrogeth-tricking-frontrunners-into-being-transaction-relayers/6937/1)
- [KeeperDAO plan for MEV protection](https://blog.keeperdao.com/how-to-protect-yourself-from-mev-and-get-paid-for-it/)
- [The enemy of your enemy is not your friend](https://fiona.mirror.xyz/QXdCOAggA5g_j5R_JpO-V5LqK89EbimnYIV6c2rOsT0)
- [How to use Flashbots](https://cryptomarketpool.com/how-to-use-flashbots/)
- [Flashbots bundler explore](https://flashbots-explorer.marto.lol/)
- [Ethereum is a Dark Forest by Paradigm](https://www.paradigm.xyz/2020/08/ethereum-is-a-dark-forest)



<br>

---


## 🍌 mev research 

<br>

* [MEV.day 2022](https://mevday.org/)
* [MEV data corpus](https://github.com/manifoldfinance/mev-corpus)
* [the Daily Ape on MEV](https://thedailyape.notion.site/MEV-8713cb4c2df24f8483a02135d657a221)
* [cryptocurrency Historical Data Snapshot](https://coinmarketcap.com/historical/)
* [cross-domain mev](https://arxiv.org/abs/2112.01472)
* [MEV wiki](https://www.mev.wiki/)
* [barnabe.eth on pbs](https://barnabe.substack.com/p/pbs)
* [mev extraction strategies](https://docs.google.com/presentation/d/1YVFLnh_MnDtDDQjucW-UKxLD28iGlyi_Pj1ri_hGqRs/edit#slide=id.g125078237b3_0_84)

<br>

#### research papers

- [Flash Boys 2.0, the original article](https://arxiv.org/pdf/1904.05234.pdf)
- [Towards a Theory of Maximal Extractable Value I, Diamandis et al](https://people.eecs.berkeley.edu/~ksk/files/MEV_CFMM.pdf)
- [SoK: Transparent Dishonesty: Front-running Attacks on Blockchain](https://arxiv.org/pdf/1902.05164.pdf)
- [KeeperDAO's whitepaper](https://github.com/keeperdao/whitepaper/blob/main/whitepaper.pdf)
- [DEX Arbitrage, Mathematical Optimisations & Me](https://noxx.substack.com/p/dex-arbitrage-mathematical-optimisations)
- [A list of open problems in DeFi by Emperor](https://mirror.xyz/0xemperor.eth/0guEj0CYt5V8J5AKur2_UNKyOhONr1QJaG4NGDF0YoQ)
- [Combining GHOST and Casper](https://arxiv.org/abs/2003.03052)
- [Three Attacks on Proof-of-Stake Ethereum](https://arxiv.org/abs/2110.10086)
- [Two Attacks On Proof-of-Stake GHOST/Ethereum](https://arxiv.org/abs/2203.01315)


<br>

---


## 🌭 bonus: 𝕋𝕙𝕖 𝕞𝕒𝕜𝕖 𝕠𝕗 𝕒 𝕔𝕪𝕡𝕙𝕖𝕣𝕡𝕦𝕟𝕜

<br>

* [a graduate course in applied cryptography](http://toc.cryptobook.us/)
* [the cypherpunk manifest by eric hughes](https://activism.net/cypherpunk/manifesto.html)
* [the hacker manifest by the mentor](http://phrack.org/issues/7/3.html)
* [bitcoin Whitepaper by satoshi nakamoto](https://bitcoin.org/bitcoin.pdf)
* [teal organizations](https://reinventingorganizationswiki.com/)
* [decentralization, by vitalik](https://medium.com/@VitalikButerin/the-meaning-of-decentralization-a0c92b76a274)


<br>
<br>