Overview
Silverback lets you create your own Python bots that respond in real-time to blockchain events. The Silverback library leverages the Ape development framework, as well as it's ecosystem of plugins and packages, to let you to develop capable automated bots that trigger your own custom Python logic whenever a specific event occurs.
Silverback bots are excellent for use cases that require continuous monitoring for specific conditions, and then require a direct response such as sending a notification or submitting a transaction.
Some examples of these types of bots:
- Index raw events from a protocol, and derive bespoke metrics in real-time
- Monitor new pool creations, and deposit liquidity if conditions are favorable
- Measure trading activity of a pool, and use those metrics to inform your own trading algorithm
- Listen for large swaps by whales, in order to update a Telegram group or Discord channel
- Perform protocol actions such as liquidations or oracle updates
Dependencies
- python3 version 3.10 or greater, python3-dev
Installation
Silverback relies heavily on the Ape development framework, so it's worth it to familarize yourself with how to install Ape and any necessary plugins using the Ape installation userguide.
It is suggested that you use a virtual environment of your choosing,
and then install the Silverback package via one of the following options.
via pip
You can install the latest release via pip:
pip install silverback
via uv
You can install the latest release via uv
uv tool install silverback
To install 2nd/3rd party Ape plugins using `uv tool`, you will need to add
`--with ape-<plugin name>` to ensure the environment has them.
Quick Usage
View the example to see how to use the library to build a bot. The example shows off a variety of Silverback's features and functionality, and you can learn more about this in the development guide.
Running Locally
Download the example to bots/example.py.
The example makes use of the [Ape Tokens](https://github.com/ApeWorX/ape-tokens) plugin.
Be sure to properly configure your environment for the USDC and YFI tokens on Ethereum mainnet.
To run this bot against a live network, this SDK includes a simple command you can use as follows:
silverback run example --network :mainnet:alchemy
Running from a Container
Silverback makes it really easy to containerize your bots in order to run them inside of a container orchestrator.
This makes running our example even easier, all you need is docker (or podman) installed and then you can run via:
$ docker run -it ghcr.io/apeworx/silverback-example:latest -- run --network :mainnet
The base silverback image we publish uses Python 3.11 for it's runtime.
Make sure all your packages are installable using this version.
For convienence, we offer the Silverback Platform, which is a hosted service that allows you to run many of your bots concurrently on different blockchain networks.
Development
This project is under active development to match the capabilities of the Silverback Platform. Things might not be in their final state and breaking changes may occur in minor revisions. Comments, questions, criticisms and pull requests are welcomed.
See Contributing for more information.
1 maintainer
Metadata
1 maintainer
Release files for silverback 0.7.38
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| silverback-0.7.38.tar.gz | 102.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| silverback-0.7.38-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 174.3 kB
Release files / silverback-0.7.38.tar.gz
| Download URL | silverback-0.7.38.tar.gz |
|---|---|
| Size | 102.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b2e852b1aee1dbec2c8316d6db3ff2a87b78981a84f35765853e2302f41ac387
|
|
BLAKE2b-256 checksum How to use checksums |
41bfd4e73c0f7706efa7ed29d18f405058ba6630deb83cc102ed25fdacaac464
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 19, 2026.
Transparency logRelease files / silverback-0.7.38-py3-none-any.whl
| Download URL | silverback-0.7.38-py3-none-any.whl |
|---|---|
| Size | 71.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fa79b9c60e552e3fd0715237604cc657b6c7de5b4444d08506ced7c1e32e7f23
|
|
BLAKE2b-256 checksum How to use checksums |
af17f779bfa01790b309b99b20713ea554682334e7efb8acfec8dc04c6cdc569
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jan 19, 2026.
Transparency log
