wakamex / silverback

Blockchain automation library, and SDK for the (upcoming) Silverback platform

Home Page:https://www.apeworx.io/silverback

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Quick Start

Silverback lets you create and deploy your own Python bots that respond to on-chain events. The Silverback library leverages the Ape development framework as well as it's ecosystem of plugins and packages to enable you to develop simple-yet-sophisticated automated applications that can listen and respond to live chain data.

Silverback applications are excellent for use cases that involve continuously monitoring and responding to on-chain events, such as newly confirmed blocks or contract event logs.

Some examples of these types of applications:

  • Monitoring new pool creations, and depositing liquidity
  • Measuring trading activity of popular pools
  • Listening for large swaps to update a telegram group

Documentation

Read the development userguide to learn more how to develop an application.

Dependencies

  • python3 version 3.8 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 it's plugins using the Ape installation userguide.

via pip

You can install the latest release via pip:

pip install silverback

via setuptools

You can clone the repository and use setuptools for the most up-to-date version:

git clone https://github.com/ApeWorX/silverback.git silverback
cd silverback
python3 setup.py install

Quick Usage

Checkout the example to see how to use the library.

To run your bot against a live network, this SDK includes a simple runner you can use via:

$ silverback run "example:app" --network :mainnet:alchemy

NOTE: The example is designed to work with Python 3.9+, and we suggest using 3.11+ for speed.

Docker Usage

$ docker run --volume $PWD:/home/harambe/project --volume ~/.tokenlists:/home/harambe/.tokenlists apeworx/silverback:latest run "example:app" --network :mainnet:alchemy

Development

This project is in development and should be considered a beta. Things might not be in their final state and breaking changes may occur. Comments, questions, criticisms and pull requests are welcomed.

About

Blockchain automation library, and SDK for the (upcoming) Silverback platform

https://www.apeworx.io/silverback

License:Apache License 2.0


Languages

Language:Python 98.8%Language:Dockerfile 1.2%