https://github.com/BobTheBuidler/dank_mids

Async web3py middleware that collects eth calls and batches them into multicalls, then batches those multicalls into jsonrpc batches along with all your other calls in the background.
https://github.com/BobTheBuidler/dank_mids

asyncio ethereum evm jsonrpc multicall python web3 web3py

Last synced: about 2 months ago
JSON representation

Async web3py middleware that collects eth calls and batches them into multicalls, then batches those multicalls into jsonrpc batches along with all your other calls in the background.

• Host: GitHub
• URL: https://github.com/BobTheBuidler/dank_mids
• Owner: BobTheBuidler
• License: mit
• Created: 2022-05-16T22:01:16.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2024-04-11T15:13:23.000Z (9 months ago)
• Last Synced: 2024-04-11T21:00:10.057Z (9 months ago)
• Topics: asyncio, ethereum, evm, jsonrpc, multicall, python, web3, web3py
• Language: Python
• Homepage: https://bobthebuidler.github.io/dank_mids/
• Size: 3.28 MB
• Stars: 80
• Watchers: 5
• Forks: 7
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: license

Awesome Lists containing this project

README

        
# Dank Mids

Dank Mids is a EVM RPC batching library that helps reduce the number of HTTP requests to a node, saving time and resources. It automatically collects eth_call calls into [multicalls](https://github.com/makerdao/multicall#multicall-) and bundles all RPC calls together in [jsonrpc](https://www.jsonrpc.org/specification#batch) [batch](https://geth.ethereum.org/docs/interacting-with-geth/rpc/batch) calls. tl;dr: its fast as fuck.

![image](https://github.com/BobTheBuidler/dank_mids/assets/70677534/3ecb46aa-f33a-41bd-85fb-c6d2433c7154)

The goal of this tool is to reduce the workload on RPC nodes and allow users to make calls to their preferred node more efficiently. This optimization is especially useful for developers writing scripts that perform large-scale blockchain analysis, as it can save development time and resources.

![](https://i.imgur.com/o9FUmAn.jpg)

### Installation

To install Dank Mids, use pip:

`pip install dank-mids`

### Usage with web3.py

The primary function you need to use Dank Mids is `setup_dank_w3_from_sync`. This function takes a sync Web3 instance and wraps it for async use. If using dank_mids with eth-brownie, you can just import the premade dank_web3 object as well

Example usage of Dank Mids with web3py:

```python

from dank_mids.helpers import setup_dank_w3_from_sync

dank_web3 = setup_dank_w3_from_sync(w3)

# OR

from dank_mids.helpers import dank_web3

# Then:

random_block = await dank_web3.eth.get_block(123)

```

### Usage with eth-brownie

- [Dank Brownie Example Commented Code](./examples/dank_brownie_example.py)

### Usage with ape

- COMING SOON: Dank Mids will also work with [ape](https://github.com/ApeWorX/ape).

### Testimonials

[Yearn](https://yearn.finance) big brain [Tonkers Kuma](https://github.com/tonkers-kuma) had this to say:

![image](https://user-images.githubusercontent.com/70677534/211255488-e76e641c-a0fe-461c-a4e5-27c45a3fea5b.png)

### Notes

You can also set `DANK_MIDS_DEMO_MODE=True` to see a visual representation of the batching in real time on your console.