{"id":21470550,"url":"https://github.com/manifoldfinance/openmev-router-docs","last_synced_at":"2026-01-20T22:34:24.401Z","repository":{"id":41039973,"uuid":"466316934","full_name":"manifoldfinance/openmev-router-docs","owner":"manifoldfinance","description":"OpenMEV Router V01 Documentation and Specification ","archived":false,"fork":false,"pushed_at":"2022-07-07T17:56:17.000Z","size":1042,"stargazers_count":12,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-01-15T17:03:29.835Z","etag":null,"topics":["aave","defi","erc20","ethereum","flashbots","router","solidity","sushiswap","uniswap"],"latest_commit_sha":null,"homepage":"","language":"Solidity","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/manifoldfinance.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE_GPL","code_of_conduct":null,"threat_model":null,"audit":"audit/README.md","citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-03-05T01:20:14.000Z","updated_at":"2024-02-23T20:01:24.000Z","dependencies_parsed_at":"2022-07-13T18:21:06.658Z","dependency_job_id":null,"html_url":"https://github.com/manifoldfinance/openmev-router-docs","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/manifoldfinance/openmev-router-docs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manifoldfinance%2Fopenmev-router-docs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manifoldfinance%2Fopenmev-router-docs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manifoldfinance%2Fopenmev-router-docs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manifoldfinance%2Fopenmev-router-docs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/manifoldfinance","download_url":"https://codeload.github.com/manifoldfinance/openmev-router-docs/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/manifoldfinance%2Fopenmev-router-docs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28616989,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T22:24:05.405Z","status":"ssl_error","status_checked_at":"2026-01-20T22:20:31.342Z","response_time":117,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aave","defi","erc20","ethereum","flashbots","router","solidity","sushiswap","uniswap"],"created_at":"2024-11-23T09:28:13.143Z","updated_at":"2026-01-20T22:34:24.385Z","avatar_url":"https://github.com/manifoldfinance.png","language":"Solidity","funding_links":[],"categories":[],"sub_categories":[],"readme":"---\ntitle: OpenMEV Router Contract V02 for SushiSwap\ndescription: OpenMEV Router Contract Overview\nversion: 30aae18\nauthor: Sandy Bradley, Sam Bacha, Manifold Finance, Inc.\nlicense: CC-2.5-NC-ND / GPL-v3.0\n---\n\n# Open MEV Router\n\nOpenMevRouter contract serves to replace the SushiswapRouter contract on Ethereum, Avalanche and Polygon.\n\nInbuilt MEV contract. For the User it aims to offer:\n\n1. Better order routing for minimal slippage\n2. At source MEV with instant user rewards\n\n## Version 1 MEV strategies\n\n- cross-dex backruns for swaps and liquidity changes\n- reduced slippage fallback router\n\nThe contract leverages and depends on 2 external protocols:\n\n1. Aave V2 for flashloan backruns\n2. Uniswap V2 (or equivalent on another network) for backrun completion and fallback swaps\n\n## Version 2 (30aae18) testing progress\n\nSwaps and backruns are working as expected.\nA full test suite needs validation - test suite is written in - python3 (pytest/hypothesis) - solidity (ds-test/dapptools/foundry)\n\nyAcademy scheduled for auditing\n3rd party contracted auditor scheduled as well for an audit.\nPotentially some gas savings and optimisations to do.\n\n## Advantages over current setup for backruns and sandwiches\n\n- no state lag - calculations are exact at the time of execution\n- capture all sushiswap smart contract txs, not just UX\n- instant user rewards upon successful backrun\n- no bundle needed. Tx is self contained and executed accurately whenever it goes on-chain, so it does not need to compete to be at the head of the block for a pre-known state.\n- can run on Avalanche and Polygon with no change\n- transparency for methods and rewards\n- can work with or without MEV protection relay\n\n## Legal Disclaimer\n\nNon-Confidential, Restricted Disclosure. Information disclosed in\nconnection with the Project and/or any Working Group activity, including\nbut not limited to meetings, and Submissions, is not confidential,\nregardless of any markings or statements to the contrary.\nNotwithstanding the foregoing, Participants may not make any public\ndisclosures of that information without the Approval of the Steering\nMembers and/or Working Group, as applicable, authorizing that disclosure.\nAny distributions of technical information to third parties must include\na notice materially similar to the following: \"THESE MATERIALS ARE\nPROVIDED \"AS IS.\" The owners and contributors expressly disclaim any\nwarranties (express, implied, or otherwise), including implied\nwarranties of merchantability, non-infringement, fitness for a\nparticular purpose, or title, related to the materials. The entire risk\nas to implementing or otherwise using the materials is assumed by the\nimplementer and user. IN NO EVENT WILL THE OWNERS AND CONTRIBUTORS BE\nLIABLE TO ANY OTHER PARTY FOR LOST PROFITS OR ANY FORM OF INDIRECT,\nSPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY CHARACTER FROM ANY\nCAUSES OF ACTION OF ANY KIND WITH RESPECT TO THIS DELIVERABLE OR ITS\nGOVERNING AGREEMENT, WHETHER BASED ON BREACH OF CONTRACT, TORT\n(INCLUDING NEGLIGENCE), OR OTHERWISE, AND WHETHER OR NOT THE OTHER\nPARTICIPANT HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\"\n\nRepresentations, Warranties and Disclaimers. Participants represent and\nwarrant that they are legally entitled to grant the rights and promises\nset forth in this Document(s). IN ALL OTHER RESPECTS THE SUBMISSIONS ARE\nPROVIDED \"AS IS.\" The entire risk as to implementing or otherwise using\na Draft Deliverable or Approved Deliverable is assumed by the\nimplementer and user. Except as stated herein, Participants expressly\ndisclaim any warranties (express, implied, or otherwise), including\nimplied warranties of merchantability, non-infringement, fitness for a\nparticular purpose, or title, related to the material. IN NO EVENT WILL\nANY PARTICIPANT BE LIABLE TO ANY OTHER PARTY FOR LOST PROFITS OR ANY\nFORM OF INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY\nCHARACTER FROM ANY CAUSES OF ACTION OF ANY KIND WITH RESPECT TO THIS\nDocument(s), WHETHER BASED ON BREACH OF CONTRACT, TORT (INCLUDING\nNEGLIGENCE), OR OTHERWISE, AND WHETHER OR NOT THE OTHER PARTICIPANT HAS\nBEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanifoldfinance%2Fopenmev-router-docs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmanifoldfinance%2Fopenmev-router-docs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmanifoldfinance%2Fopenmev-router-docs/lists"}