{"id":19096891,"url":"https://github.com/makerdao/bite-keeper","last_synced_at":"2025-04-18T16:31:31.401Z","repository":{"id":62839814,"uuid":"112648002","full_name":"makerdao/bite-keeper","owner":"makerdao","description":"Maker Keeper Framework: Keeper to bite undercollateralized cups.","archived":true,"fork":false,"pushed_at":"2023-03-15T21:41:17.000Z","size":53,"stargazers_count":50,"open_issues_count":3,"forks_count":21,"subscribers_count":20,"default_branch":"master","last_synced_at":"2025-03-11T20:37:44.906Z","etag":null,"topics":["dai","ethereum","maker-keeper","stablecoin"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/makerdao.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","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}},"created_at":"2017-11-30T18:51:17.000Z","updated_at":"2025-02-18T00:47:29.000Z","dependencies_parsed_at":"2024-11-09T03:38:08.923Z","dependency_job_id":"443647ea-7415-49d8-a79c-e3b94706796f","html_url":"https://github.com/makerdao/bite-keeper","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makerdao%2Fbite-keeper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makerdao%2Fbite-keeper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makerdao%2Fbite-keeper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/makerdao%2Fbite-keeper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/makerdao","download_url":"https://codeload.github.com/makerdao/bite-keeper/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249517937,"owners_count":21284861,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["dai","ethereum","maker-keeper","stablecoin"],"created_at":"2024-11-09T03:38:05.448Z","updated_at":"2025-04-18T16:31:31.115Z","avatar_url":"https://github.com/makerdao.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# bite-keeper\n\n![Build Status](https://github.com/makerdao/bite-keeper/actions/workflows/.github/workflows/tests.yaml/badge.svg?branch=master)\n[![codecov](https://codecov.io/gh/makerdao/bite-keeper/branch/master/graph/badge.svg)](https://codecov.io/gh/makerdao/bite-keeper)\n\nThe _DAI Stablecoin System_ incentivizes external agents, called _keepers_,\nto automate certain operations around the Ethereum blockchain.\n\n`bite-keeper` is one of the simplest keepers. It constantly monitors a `Tub` contract\nlooking for unsafe cups and bites them the moment they become unsafe. Ultimately,\nit should take into account the profit it can make by processing the resulting\ncollateral via `bust` and only waste gas on `bite` if it can make it up by\nsubsequent arbitrage. For now, it is a dumb keeper that just bites every cup\nthat can be bitten.\n\n\u003chttps://chat.makerdao.com/channel/keeper\u003e\n\n### Installation\n#### Prerequisites\n- [Python v3.6.6](https://www.python.org/downloads/release/python-366/)\n- [virtualenv](https://virtualenv.pypa.io/en/latest/)\n    - This project requires *virtualenv* to be installed if you want to use Maker's python tools. This helps with making sure that you are running the right version of python and checks that all of the pip packages that are installed in the **install.sh** are in the right place and have the right versions.\n\nIn order to clone the project and install required third-party packages please execute:\n```\ngit clone https://github.com/makerdao/bite-keeper.git\ncd bite-keeper\ngit submodule update --init --recursive\n./install.sh\n```\n\nFor some known Ubuntu and macOS issues see the [pymaker](https://github.com/makerdao/pymaker) README.\n\n## Usage\n\n```\nusage: bite-keeper [-h] [--rpc-host RPC_HOST] [--rpc-timeout RPC_TIMEOUT]\n                   --eth-from ETH_FROM [--eth-key KEYFILE_STRING]\n                   --tub-address TUB_ADDRESS [--graphql-url GRAPHQL_URL]\n                   [--gas-price GAS_PRICE] [--bitecdps-address BITECDPS_ADDRESS]\n                   [--top] [--chunks] [--debug]\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --rpc-host RPC_HOST   JSON-RPC host (default: `http://localhost:8545')\n  --rpc-timeout RPC_TIMEOUT\n                        JSON-RPC timeout (in seconds, default: 10)\n  --eth-from ETH_FROM   Ethereum account from which to send transactions\n  --eth-key KEYFILE_STRING\n                        path to keyfile (key_file=./k.json,pass_file=./p.txt\")\n  --tub-address TUB_ADDRESS\n                        Ethereum address of the Tub contract\n  --graphql-url GRAPHQL_URL\n                        GraphQL URL (default: https://sai-mainnet.makerfoundation.com/v1)\n  --bitecdps-address BITECDPS_ADDRESS\n                        Ethereum address of the BiteCdps contract\n  --gas-price GAS_PRICE\n                        Gas price in Wei (default: node default)\n  --top                 Only bite the top N cups (default: 500)\n  --chunks              Only bite N cups at a time (default: 100)\n  --debug               Enable debug output\n```\n\n## License\n\nSee [COPYING](https://github.com/makerdao/bite-keeper/blob/master/COPYING) file.\n\n### Disclaimer\n\nYOU (MEANING ANY INDIVIDUAL OR ENTITY ACCESSING, USING OR BOTH THE SOFTWARE INCLUDED IN THIS GITHUB REPOSITORY) EXPRESSLY UNDERSTAND AND AGREE THAT YOUR USE OF THE SOFTWARE IS AT YOUR SOLE RISK.\nTHE SOFTWARE IN THIS GITHUB REPOSITORY IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.\nYOU RELEASE AUTHORS OR COPYRIGHT HOLDERS FROM ALL LIABILITY FOR YOU HAVING ACQUIRED OR NOT ACQUIRED CONTENT IN THIS GITHUB REPOSITORY. THE AUTHORS OR COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS CONCERNING ANY CONTENT CONTAINED IN OR ACCESSED THROUGH THE SERVICE, AND THE AUTHORS OR COPYRIGHT HOLDERS WILL NOT BE RESPONSIBLE OR LIABLE FOR THE ACCURACY, COPYRIGHT COMPLIANCE, LEGALITY OR DECENCY OF MATERIAL CONTAINED IN OR ACCESSED THROUGH THIS GITHUB REPOSITORY.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmakerdao%2Fbite-keeper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmakerdao%2Fbite-keeper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmakerdao%2Fbite-keeper/lists"}