https://github.com/cakevm/alloy-mev-blocker-client
Extension for Alloy to subscribe to the MEV Blocker Searchers API
https://github.com/cakevm/alloy-mev-blocker-client
Last synced: 18 days ago
JSON representation
Extension for Alloy to subscribe to the MEV Blocker Searchers API
- Host: GitHub
- URL: https://github.com/cakevm/alloy-mev-blocker-client
- Owner: cakevm
- License: apache-2.0
- Created: 2025-01-22T09:03:58.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-04-21T10:11:09.000Z (about 2 months ago)
- Last Synced: 2026-04-21T12:21:24.441Z (about 2 months ago)
- Language: Rust
- Homepage:
- Size: 226 KB
- Stars: 7
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# Alloy MEV Blocker Client
This crate allows to subscribe to events from the [Searchers API](https://docs.cow.fi/mevblocker/searchers/listening-for-transactions) of [MEV Blocker](https://cow.fi/mev-blocker) with [Alloy](https://github.com/alloy-rs/alloy). Since the signature fields are stripped, the parsing of the transaction fails silently in Alloy. To address this, the extension dynamically adds these fields during deserialization, enabling a pending MEV Blocker transaction to be deserialized into an `alloy_rpc_types_eth::Transaction`.
# Why not fix this in Alloy?
It is hard to tell who is right here. Alloy has a valid point to require all fields for a valid transaction. For some clients with less strict typing, the parsing of the transaction works. This does not require any workaround and for that reason, the API of MEV Blocker is for many people easy to use. For Alloy, it is not possible to parse the transaction without the signature fields.
# Usage
See `subscribe_mev_blocker.rs` in [examples](./examples) for a full usage examples.
Example usage:
```rust
let ws_client = WsConnect::new(MEV_BLOCKER_SEARCHERS_URL);
let provider = ProviderBuilder::new().on_ws(ws_client).await?;
let subscription = provider.subscribe_mev_blocker_pending_transactions().await?;
```
# Acknowledgements
Many thanks to the [CoW DAO](https://cow.fi/) to provide such an API. And many thanks to the [alloy-rs](https://github.com/alloy-rs) team.
# License
This project is licensed under the [Apache 2.0](./LICENSE-APACHE) or [MIT](./LICENSE-MIT).