eth_retry
Stop transient errors from wasting your time!
eth_retry is a Python library that provides one decorator, eth_retry.auto_retry.
auto_retry will automatically catch known transient exceptions that are common in the Ethereum/EVM ecosystem and will reattempt to evaluate your decorated function up to os.environ['MAX_RETRIES'] (default: 10) times.
Supports both synchronous and asynchronous functions.
Covers many common transient errors in the EVM ecosystem, including:
- RPC timeouts
- Block explorer API rate-limiting
- Generic exceptions:
- ConnectionError
- HTTPError
- ReadTimeout
- TimeoutError
- eth-brownie specific errors:
- sqlite3.OperationalError: database is locked
Installation:
pip install eth_retry
or
pip install git+https://github.com/BobTheBuidler/eth_retry.git
Usage:
import eth_retry
@eth_retry.auto_retry
def some_function_that_errors_sometimes():
i = 0
am = 1
doing = 2
stuff = 3
return stuff
error_free_result = some_function_that_errors_sometimes()
Between attempts, eth_retry will time.sleep for a random period between os.environ['MIN_SLEEP_TIME'] (default: 10) and os.environ['MAX_SLEEP_TIME'] (default: 20) seconds. The period is randomized to help prevent repetitive rate-limiting issues with parallelism by staggering the retries.
On the nth retry, the sleep period is multiplied by n so that the target endpoint can cool off in case of rate-limiting.
After os.environ['MAX_RETRIES'] failures, eth_retry will raise the exception.
Environment:
# Minimum sleep time in seconds. Integer. Defaults to 10.
MIN_SLEEP_TIME=10
# Maximum sleep time in seconds. Integer. Defaults to 20.
MAX_SLEEP_TIME=20
# Maximum number of times to retry. Integer. Defaults to 10.
MAX_RETRIES=10
1 maintainer
Metadata
1 maintainer
Release files for eth-retry 0.3.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| eth_retry-0.3.8.tar.gz | 5.3 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| eth_retry-0.3.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 11.9 kB
Release files / eth_retry-0.3.8.tar.gz
| Download URL | eth_retry-0.3.8.tar.gz |
|---|---|
| Size | 5.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
53fba6afd2b89f4450d1f4c0e6cd929d33bd88f3bbf3225526f56db299530f3f
|
|
BLAKE2b-256 checksum How to use checksums |
4e9af5fcd9f3ab43428dbe70e189785d2858e4df1b0aea7d61b5759ab61d9cea
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.14.6 Linux/6.17.0-1020-azure
|
Release files / eth_retry-0.3.8-py3-none-any.whl
| Download URL | eth_retry-0.3.8-py3-none-any.whl |
|---|---|
| Size | 6.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5d1e188cddf2a1ec106faad57cb42d98694a21cea3e6fe3ca44c1fb37ff4f0c6
|
|
BLAKE2b-256 checksum How to use checksums |
5968bc63b2081cede3dcc7421c42ee073df8376605161b70704e1432624ab142
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/2.4.1 CPython/3.14.6 Linux/6.17.0-1020-azure
|
