{"id":28468001,"url":"https://github.com/apeworx/silverback","last_synced_at":"2026-01-19T23:04:50.396Z","repository":{"id":144710198,"uuid":"600516375","full_name":"ApeWorX/silverback","owner":"ApeWorX","description":"Listen and respond to on-chain events in real-time","archived":false,"fork":false,"pushed_at":"2026-01-14T05:53:37.000Z","size":15402,"stargazers_count":128,"open_issues_count":22,"forks_count":14,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-01-14T09:22:44.809Z","etag":null,"topics":["ape","apeworx","python3","silverback"],"latest_commit_sha":null,"homepage":"https://apeworx.io/silverback","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ApeWorX.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":"funding.json","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["ApeWorX"],"custom":["https://etherscan.io/address/wallet.apeworx.eth"]}},"created_at":"2023-02-11T18:26:42.000Z","updated_at":"2026-01-14T05:52:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"b459e6a7-6a43-4b5b-adea-9d2dc4272ecb","html_url":"https://github.com/ApeWorX/silverback","commit_stats":null,"previous_names":["silverbackltd/sdk","apeworx/silverback"],"tags_count":77,"template":false,"template_full_name":"ApeWorX/project-template","purl":"pkg:github/ApeWorX/silverback","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ApeWorX%2Fsilverback","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ApeWorX%2Fsilverback/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ApeWorX%2Fsilverback/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ApeWorX%2Fsilverback/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ApeWorX","download_url":"https://codeload.github.com/ApeWorX/silverback/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ApeWorX%2Fsilverback/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28588971,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-19T20:45:59.482Z","status":"ssl_error","status_checked_at":"2026-01-19T20:45:41.500Z","response_time":67,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ape","apeworx","python3","silverback"],"created_at":"2025-06-07T08:06:21.033Z","updated_at":"2026-01-19T23:04:50.389Z","avatar_url":"https://github.com/ApeWorX.png","language":"Python","funding_links":["https://github.com/sponsors/ApeWorX","https://etherscan.io/address/wallet.apeworx.eth"],"categories":[],"sub_categories":[],"readme":"# Overview\n\nSilverback lets you create your own Python bots that respond in real-time to blockchain events.\nThe Silverback library leverages the [Ape](https://docs.apeworx.io/ape/stable/userguides/quickstart)\ndevelopment framework, as well as it's ecosystem of plugins and packages, to let you to develop\ncapable automated bots that trigger your own custom Python logic whenever a specific event occurs.\n\nSilverback bots are excellent for use cases that require continuous monitoring for specific conditions,\nand then require a direct response such as sending a notification or submitting a transaction.\n\nSome examples of these types of bots:\n\n- Index raw events from a protocol, and derive bespoke metrics in real-time\n- Monitor new pool creations, and deposit liquidity if conditions are favorable\n- Measure trading activity of a pool, and use those metrics to inform your own trading algorithm\n- Listen for large swaps by whales, in order to update a Telegram group or Discord channel\n- Perform protocol actions such as liquidations or oracle updates\n\n## Dependencies\n\n- [python3](https://www.python.org/downloads) version 3.10 or greater, python3-dev\n\n## Installation\n\nSilverback relies heavily on the Ape development framework, so it's worth it to familarize yourself\nwith how to install Ape and any necessary plugins using the\n[Ape installation userguide](https://docs.apeworx.io/ape/stable/userguides/quickstart#installation).\n\n```{note}\nIt is suggested that you use a virtual environment of your choosing,\nand then install the Silverback package via one of the following options.\n```\n\n### via `pip`\n\nYou can install the latest release via [`pip`](https://pypi.org/project/pip):\n\n```bash\npip install silverback\n```\n\n### via `uv`\n\nYou can install the latest release via [`uv`](https://docs.astral.sh/uv/getting-started/installation)\n\n```bash\nuv tool install silverback\n```\n\n```{note}\nTo install 2nd/3rd party Ape plugins using `uv tool`, you will need to add\n`--with ape-\u003cplugin name\u003e` to ensure the environment has them.\n```\n\n## Quick Usage\n\nView [the example](https://github.com/ApeWorX/silverback/blob/main/bots/example.py)\nto see how to use the library to build a bot.\nThe example shows off a variety of Silverback's features and functionality,\nand you can learn more about this in the [development guide](https://docs.apeworx.io/silverback/stable/userguides/development).\n\n### Running Locally\n\nDownload the example to `bots/example.py`.\n\n```{note}\nThe example makes use of the [Ape Tokens](https://github.com/ApeWorX/ape-tokens) plugin.\nBe sure to properly configure your environment for the USDC and YFI tokens on Ethereum mainnet.\n```\n\nTo run this bot against a live network, this SDK includes a simple command you can use as follows:\n\n```sh\nsilverback run example --network :mainnet:alchemy\n```\n\n### Running from a Container\n\nSilverback makes it really easy to containerize your bots in order to run them inside of a container orchestrator.\nThis makes running our example even easier, all you need is `docker` (or `podman`) installed and then you can run via:\n\n```sh\n$ docker run -it ghcr.io/apeworx/silverback-example:latest -- run --network :mainnet\n```\n\n```{note}\nThe base silverback image we publish uses Python 3.11 for it's runtime.\nMake sure all your packages are installable using this version.\n```\n\nFor convienence, we offer the [Silverback Platform](https://silverback.apeworx.io),\nwhich is a hosted service that allows you to run many of your bots concurrently on different blockchain networks.\n\n## Development\n\nThis project is under active development to match the capabilities of the\n[Silverback Platform](https://silverback.apeworx.io).\nThings might not be in their final state and breaking changes may occur in minor revisions.\nComments, questions, criticisms and pull requests are welcomed.\n\nSee [Contributing](https://github.com/ApeWorX/silverback?tab=contributing-ov-file) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapeworx%2Fsilverback","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapeworx%2Fsilverback","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapeworx%2Fsilverback/lists"}