{"id":20030762,"url":"https://github.com/generationsoftware/pt-v5-draw-auction-gh-action-bot--testnet","last_synced_at":"2025-06-13T11:07:34.803Z","repository":{"id":237339724,"uuid":"794314747","full_name":"GenerationSoftware/pt-v5-draw-auction-gh-action-bot--testnet","owner":"GenerationSoftware","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-18T18:22:30.000Z","size":1521,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-13T11:06:12.371Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GenerationSoftware.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2024-04-30T22:04:09.000Z","updated_at":"2025-03-18T18:22:34.000Z","dependencies_parsed_at":"2024-05-21T23:33:16.773Z","dependency_job_id":"83667788-9125-417e-954c-c2b603b4c898","html_url":"https://github.com/GenerationSoftware/pt-v5-draw-auction-gh-action-bot--testnet","commit_stats":null,"previous_names":["generationsoftware/pt-v5-draw-auction-gh-action-bot--testnet"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/GenerationSoftware/pt-v5-draw-auction-gh-action-bot--testnet","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GenerationSoftware%2Fpt-v5-draw-auction-gh-action-bot--testnet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GenerationSoftware%2Fpt-v5-draw-auction-gh-action-bot--testnet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GenerationSoftware%2Fpt-v5-draw-auction-gh-action-bot--testnet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GenerationSoftware%2Fpt-v5-draw-auction-gh-action-bot--testnet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GenerationSoftware","download_url":"https://codeload.github.com/GenerationSoftware/pt-v5-draw-auction-gh-action-bot--testnet/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GenerationSoftware%2Fpt-v5-draw-auction-gh-action-bot--testnet/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259634348,"owners_count":22887697,"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":[],"created_at":"2024-11-13T09:28:10.417Z","updated_at":"2025-06-13T11:07:34.780Z","avatar_url":"https://github.com/GenerationSoftware.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PoolTogether v5 Draw Auction Bot - GitHub Actions\n\n### DISCLAIMER: These bots are meant for intermediates \u0026 experts to run and modify to their liking. There is a lot of prerequisite knowledge about blockchains, private keys, swaps, and GitHub infrastructure that should be known before running a bot. If anyone ever asks you for your private key _do not give it to them_. Nobody from Generation Software, Pooltime, or PoolTogether will ever ask you for your private key.\n\nThis repo contains two simple scripts ([index.ts](/index.ts) and [.github/workflows/cron.yml](/.github/workflows/cron.yml)) to run the Generation Software PoolTogether v5 Draw Auction bot using GitHub Actions.\n\nYou can simply fork this repo, enter your own custom environment variables in your newly-forked GitHub Repository's Settings (`Settings` -\u003e `Secrets and variables` -\u003e `Actions` -\u003e `New repository secret`), and enable automated workflow runs.\n\n**Note**: You require your own GitHub account to fork this repository and run the GitHub Actions.\n\n[\u003cimg src=\"/images/one-click-deploy@2x.png?raw=true\" width=\"169\" height=\"37\"/\u003e](https://github.com/GenerationSoftware/pt-v5-draw-auction-gh-action-bot/fork \"one click deploy button\")\n\n[Fork / deploy this bot](https://github.com/GenerationSoftware/pt-v5-draw-auction-gh-action-bot/fork)\n\n---\n\n### Installation:\n\n[\u003cimg src=\"https://github.com/GenerationSoftware/pt-v5-liquidator-gh-action-bot/blob/main/images/video-thumb--new.jpg\" width=\"50%\"\u003e](https://www.youtube.com/watch?v=Dt-ibfZH-LU \"Watch the 1-minute installation video\")\n\n[Watch the 1-minute video](https://www.youtube.com/watch?v=Dt-ibfZH-LU), or:\n\n1. [Fork this repository](#user-content-1-fork-this-repository)\n2. [Set your environment variables](#user-content-2-set-your-environment-variables)\n3. [Enable automated workflows](#user-content-3-enable-automated-workflows)\n4. [View logs](#user-content-4-view-logs)\n5. [(Optional) Change Chain or Reward Recipient](#user-content-5-optional-change-chain-or-reward-recipient)\n\n**Note**: This process is essentially the same for the [Prize Claimer](https://github.com/GenerationSoftware/pt-v5-prize-claimer-gh-action-bot/) and [Liquidator](https://github.com/GenerationSoftware/pt-v5-liquidator-gh-action-bot) bots as well.\n\n---\n\n#### 1. Fork this repository\n\nStart by forking this bot to your own new repository - this essentially deploys your very own copy of the bot. You can give it a custom name if you like:\n\n\u003e \u003ckbd\u003e\u003cimg src=\"https://github.com/GenerationSoftware/pt-v5-liquidator-gh-action-bot/blob/main/images/screenshot-forking-0.jpg?raw=true\" /\u003e\u003c/kbd\u003e\n\n\u003e \u003ckbd\u003e\u003cimg src=\"https://github.com/GenerationSoftware/pt-v5-liquidator-gh-action-bot/blob/main/images/screenshot-forking-1.jpg?raw=true\" /\u003e\u003c/kbd\u003e\n\n[\u003cimg src=\"https://github.com/GenerationSoftware/pt-v5-draw-auction-gh-action-bot/blob/main/images/one-click-deploy@2x.png?raw=true\" width=\"169\" height=\"37\"/\u003e](https://github.com/GenerationSoftware/pt-v5-draw-auction-gh-action-bot/fork \"one click deploy button\")\n\n[Fork / deploy this bot](https://github.com/GenerationSoftware/pt-v5-draw-auction-gh-action-bot/fork)\n\n#### 2. Set your environment variables\n\nOnce the repository has been forked you can update your `Secrets` (under `Settings`) to point to your own API keys. Each bot requires 2 secrets: a private key which will send transactions on your bot's behalf, and a RPC URL such as one from [Infura](https://www.infura.io/) or [Alchemy](https://www.alchemy.com/).\n\n\u003e \u003ckbd\u003e\u003cimg src=\"https://github.com/GenerationSoftware/pt-v5-liquidator-gh-action-bot/blob/main/images/screenshot-settings-1.jpg?raw=true\" /\u003e\u003c/kbd\u003e\n\n\u003e \u003ckbd\u003e\u003cimg src=\"https://github.com/GenerationSoftware/pt-v5-liquidator-gh-action-bot/blob/main/images/screenshot-settings-2-jsonrpc.jpg?raw=true\" /\u003e\u003c/kbd\u003e\n\n`JSON_RPC_URL`: We will need JSON_RPC_URLs for each network you want to use. The following are required for each network you want the bot to run against: `BASE_SEPOLIA_JSON_RPC_URL`, `ARBITRUM_SEPOLIA_JSON_RPC_URL`, `OPTIMISM_SEPOLIA_JSON_RPC_URL`, `SCROLL_SEPOLIA_JSON_RPC_URL`, `GNOSIS_CHIADO_JSON_RPC_URL`.\n\n\u003e \u003ckbd\u003e\n\u003e \u003cimg src=\"https://github.com/GenerationSoftware/pt-v5-liquidator-gh-action-bot/blob/main/images/screenshot-settings-4-privkey.jpg?raw=true\" /\u003e\n\u003e \u003c/kbd\u003e\n\n`CUSTOM_RELAYER_PRIVATE_KEY`: We recommend creating a brand new EVM account and only sending a small amount of ETH (less than $100) to it for relaying your bot transactions. In the rare case that the account gets compromised you will only lose whatever ETH is currently in it.\n\n\u003e \u003ckbd\u003e\u003cimg src=\"https://github.com/GenerationSoftware/pt-v5-liquidator-gh-action-bot/blob/main/images/screenshot-settings-3-covalent-api.jpg?raw=true\" /\u003e\u003c/kbd\u003e\n\n`COVALENT_API_KEY`: a Covalent API key is needed to assist the bot in looking up dollar values of tokens. You can register for a free API key here: [https://www.covalenthq.com/platform/auth/register/](https://www.covalenthq.com/platform/auth/register/)\n\n\u003e \u003ckbd\u003e\u003cimg src=\"https://github.com/GenerationSoftware/pt-v5-liquidator-gh-action-bot/blob/main/images/screenshot-settings-5-some.jpg?raw=true\" /\u003e\u003c/kbd\u003e\n\n#### 3. Enable automated workflows\n\nBy default, GitHub does not enable automated workflows for newly forked repositories. Navigate to the `Actions` tab to enable workflows on your newly forked repository:\n\n\u003e \u003ckbd\u003e\u003cimg src=\"https://github.com/GenerationSoftware/pt-v5-liquidator-gh-action-bot/blob/main/images/screenshot-actions-0-nothing.jpg?raw=true\" /\u003e\u003c/kbd\u003e\n\nClick 'I understand my workflows, go ahead and enable them'.\n\n\u003e \u003ckbd\u003e\u003cimg src=\"https://github.com/GenerationSoftware/pt-v5-liquidator-gh-action-bot/blob/main/images/screenshot-actions-2-disabled.jpg?raw=true\" /\u003e\u003c/kbd\u003e\n\n**Important!** Click the little 'Enable workflow' button in the top-right corner.\n\n\u003e \u003ckbd\u003e\u003cimg src=\"https://github.com/GenerationSoftware/pt-v5-liquidator-gh-action-bot/blob/main/images/screenshot-actions-3-enabled.jpg?raw=true\" /\u003e\u003c/kbd\u003e\n\nYou should see the success message above.\n\n#### 4. View logs\n\nTo see if the bot is working correctly, check the logs under `Actions`. **You may need to wait 5 - 10 minutes** for the first scheduled task to show up. Following that, the bot will attempt to run every 5 minutes. However, GitHub may throttle the amount of runs based on how overloaded GitHub Actions is at that time.\n\n\u003e \u003ckbd\u003e\u003cimg src=\"https://github.com/GenerationSoftware/pt-v5-liquidator-gh-action-bot/blob/main/images/screenshot-actions-4-logs.jpg?raw=true\" /\u003e\u003c/kbd\u003e\n\nClick the name of the run to see the logs. For instance, one of my runs is simply named \"Cronjob\". I can open that up, then click on the \"Run bot\" line to see the outcome of the bot.\n\n#### 5. (Optional) Change Chain, Minimum Profit Threshold (in USD$) or Reward Recipient:\n\nIn the [.github/workflows/cron.yml](/.github/workflows/cron.yml) file you can update the following variables: `CHAIN_ID`, `MIN_PROFIT_THRESHOLD_USD`, and/or `REWARD_RECIPIENT`. This will allow you to change which chain you are running the bot against, how much profit you want to make per transaction, and who (which EVM EOA account) receives the profits earned.\n\n###### `CHAIN_ID`: Simply the chain ID. You can find most chain ID's on [https://chainlist.org/](https://chainlist.org/)\n\n###### `MIN_PROFIT_THRESHOLD_USD`: This is in $USD, so 0.1 would be $0.10 per transaction\n\n###### `REWARD_RECIPIENT`: Any typical account address, if left blank this will default to the relayer account set by the `CUSTOM_RELAYER_PRIVATE_KEY` variable.\n\n## Lastly:\n\nThe Draw Auction bot's relayer account needs to be stocked with ETH, to pay gas fees and RNG fees for transactions. We recommend keeping less than $100 in value on the relayer at a time in case your private key were to get compromised.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgenerationsoftware%2Fpt-v5-draw-auction-gh-action-bot--testnet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgenerationsoftware%2Fpt-v5-draw-auction-gh-action-bot--testnet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgenerationsoftware%2Fpt-v5-draw-auction-gh-action-bot--testnet/lists"}