{"id":26207120,"url":"https://github.com/thecoderadi/blocksentinel","last_synced_at":"2026-04-26T07:35:23.608Z","repository":{"id":280647853,"uuid":"942700200","full_name":"TheCoderAdi/BlockSentinel","owner":"TheCoderAdi","description":null,"archived":false,"fork":false,"pushed_at":"2025-03-04T14:34:22.000Z","size":69,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-04T15:33:09.442Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","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/TheCoderAdi.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-04T14:31:18.000Z","updated_at":"2025-03-04T14:34:25.000Z","dependencies_parsed_at":"2025-03-04T15:43:41.679Z","dependency_job_id":null,"html_url":"https://github.com/TheCoderAdi/BlockSentinel","commit_stats":null,"previous_names":["thecoderadi/blocksentinel"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheCoderAdi%2FBlockSentinel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheCoderAdi%2FBlockSentinel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheCoderAdi%2FBlockSentinel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheCoderAdi%2FBlockSentinel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheCoderAdi","download_url":"https://codeload.github.com/TheCoderAdi/BlockSentinel/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243165525,"owners_count":20246721,"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-03-12T05:30:34.752Z","updated_at":"2025-12-26T07:22:33.693Z","avatar_url":"https://github.com/TheCoderAdi.png","language":"JavaScript","readme":"# BlockSentinel - Automated Blockchain Monitoring \u0026 Transaction Execution Bot\n\n## 🚀 Overview\n**BlockSentinel** is a real-time bot that listens for new blocks, automatically executes transactions, and dynamically optimizes gas fees for efficiency. It is designed for seamless blockchain automation, making it ideal for DeFi, NFT drops, smart contract execution, and MEV strategies.\n\n## 📌 Features\n- **Real-time Block Monitoring**: Listens for new blocks as soon as they are added to the blockchain.\n- **Automatic Transaction Execution**: Sends transactions the moment a new block is detected.\n- **Gas Fee Optimization**: Uses EIP-1559 gas estimation to set optimal fees dynamically.\n- **Efficient Execution**: Ensures transactions are confirmed in the next block.\n- **Robust Error Handling**: Catches failures and logs transaction statuses for debugging.\n\n## 🛠 Technologies Used\n- **Node.js**\n- **Ethers.js**\n- **Solidity** (for the smart contract interaction)\n- **Hardhat** (for contract development and testing)\n\n## 📜 Installation\n\n### 1️⃣ Clone the Repository\n```sh\ngit clone https://github.com/TheCoderAdi/BlockSentinel/\ncd BlockSentinel\n```\n\n### 2️⃣ Install Dependencies\n```sh\ncd bot \u0026\u0026 npm install\ncd contracts \u0026\u0026 npm install\n```\n\n### 3️⃣ Set Up Environment Variables\nCreate a `.env` file and add the following (bot folder):\n```\nRPC_URL=your_rpc_url\nPRIVATE_KEY=your_wallet_private_key\nCONTRACT_ADDRESS=your_smart_contract_address\n```\n\n### 4️⃣ Run the Bot\n```sh\nnode index.js\n```\n\n## ⚡ How It Works\n1. The bot **listens for new blocks** on the blockchain.\n2. When a new block is detected, it **retrieves current gas fees**.\n3. It then **executes a transaction** using optimized gas settings.\n4. Logs transaction status:\n   ```sh\n   🚀 Listening for new blocks...\n   📡 New Block Detected: 12345\n   ✅ Transaction Sent: 0xabc123...\n   ✅ Transaction Mined in Block 12346\n   ```\n\n## 📊 Use Cases\n- **Automated NFT minting**: Execute mints exactly when a new block is created.\n- **DeFi Trading Bots**: Execute trades instantly when liquidity conditions are met.\n- **Governance Voting**: Automate DAO governance votes on-chain.\n- **Security Testing**: Run smart contract security tests automatically.\n\n## 🎯 Future Improvements\n- Support for multiple transactions per block.\n- Enhanced monitoring with Telegram/Discord alerts.\n- Integration with smart contract automation frameworks.\n\n## 📄 License\nMIT License\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthecoderadi%2Fblocksentinel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthecoderadi%2Fblocksentinel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthecoderadi%2Fblocksentinel/lists"}