{"id":26984383,"url":"https://github.com/l9t-development/grpc-rug-detection-bot","last_synced_at":"2025-04-03T17:37:39.790Z","repository":{"id":281072289,"uuid":"944113406","full_name":"L9T-Development/grpc-rug-detection-bot","owner":"L9T-Development","description":"Rug detection bot with grpc","archived":false,"fork":false,"pushed_at":"2025-03-06T20:17:29.000Z","size":7,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-06T21:23:08.348Z","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/L9T-Development.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}},"created_at":"2025-03-06T20:05:35.000Z","updated_at":"2025-03-06T20:24:53.000Z","dependencies_parsed_at":"2025-03-06T21:33:17.041Z","dependency_job_id":null,"html_url":"https://github.com/L9T-Development/grpc-rug-detection-bot","commit_stats":null,"previous_names":["0xtan1319/grpc-rug-detection-bot"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/L9T-Development%2Fgrpc-rug-detection-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/L9T-Development%2Fgrpc-rug-detection-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/L9T-Development%2Fgrpc-rug-detection-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/L9T-Development%2Fgrpc-rug-detection-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/L9T-Development","download_url":"https://codeload.github.com/L9T-Development/grpc-rug-detection-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247050660,"owners_count":20875514,"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":"2025-04-03T17:37:39.220Z","updated_at":"2025-04-03T17:37:39.778Z","avatar_url":"https://github.com/L9T-Development.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# *Geyser grpc Rug Detection Bot*\n\n## Contact\n\nIf you need help or any question, contact here: [Telegram](https://t.me/shiny0103)  [Twitter](https://x.com/0xTan1319)\n\n## How it works\n\n- It uses the Geyser gRPC plugin to subscribe to all the latest slots received from the gRPC server.\n- It monitors token addresses and checks for suspicious inflows to specific wallet addresses.\n- If the inflow to a wallet address exceeds a defined threshold, it logs a warning indicating potential rug pull activity.\n\n## Prerequisites\n\n- Ensure you have the necessary environment variables set up in the `.env` file.\n- Install the required dependencies by running `npm install` or `yarn install`.\n\n## Code usage\n\n- **constants/constants.ts**: Retrieves variables from the `.env` file.\n- **streaming/stream-token.ts**: Contains the main logic for subscribing to token transactions and detecting suspicious inflows.\n- **utils.ts**: Utility functions for handling gRPC subscriptions and other common tasks.\n- **grpc-requests-type.ts**: Defines different gRPC request types for monitoring token transactions.\n- **logger.ts**: Configures the logging mechanism for the project.\n\n## Running the Bot\n\n1. **Start the Rug Detection Bot**:\n   - Run the following command to start monitoring a specific token address:\n     ```bash\n     ts-node src/streaming/stream-token.ts --token-address \u003cTOKEN_ADDRESS\u003e\n     ```\n\n2. **Example Command**:\n   - To monitor a token address and log suspicious inflows:\n     ```bash\n     ts-node src/streaming/stream-token.ts --token-address \u003cTOKEN_ADDRESS\u003e\n     ```\n\n## Configuration\n\n- **Threshold**: You can configure the threshold for suspicious inflows in the `stream-token.ts` file.\n- **Logging**: Adjust the logging level and format in the `logger.ts` file.\n\n## Additional Information\n\n- The bot uses the `@solana/web3.js` library to interact with the Solana blockchain.\n- The gRPC client is configured to connect to the Geyser gRPC server for real-time transaction data.\n\n## Troubleshooting\n\n- Ensure your environment variables are correctly set in the `.env` file.\n- Check the logs for any error messages and adjust the configuration as needed.\n- Make sure you have a stable internet connection to receive real-time data from the gRPC server.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fl9t-development%2Fgrpc-rug-detection-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fl9t-development%2Fgrpc-rug-detection-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fl9t-development%2Fgrpc-rug-detection-bot/lists"}