Skip to content

rokhanz/t3rn-executor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

49 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ T3RN Executor Pro

MIT License Version Bash Node.js

✨ Advanced T3RN Executor with MEV protection, rich Telegram notifications, and intelligent automation

πŸ‘¨β€πŸ’» Author: Rokhanz | πŸ“… Year: 2025 | πŸ“œ License: MIT


🌟 Why This Repository?

Tahun 2025 - T3RN ecosystem berkembang pesat, dan executor standar sudah tidak cukup. Repository ini hadir dengan:

  • πŸ›‘οΈ MEV Protection - Lindungi transaksi dari sandwich attacks
  • πŸ“± Rich Telegram Notifications - Laporan detail dengan wallet address
  • 🌐 12 Networks Support - Semua testnet T3RN dengan auto-failover
  • ⚑ Alchemy Integration - Multiple API keys dengan load balancing
  • 🎨 Beautiful UI - Progress bars berwarna dan animasi
  • πŸ”„ Auto-Restart - Intelligent restart dengan monitoring

Mengapa 2025? Karena T3RN mainnet sudah dekat, kompetisi semakin ketat, dan tools standar tidak lagi memadai untuk menghadapi MEV bots yang semakin canggih.


πŸ–₯️ VPS Requirements

Spec Minimum Recommended
RAM 4GB 8GB+
CPU 2 cores 4+ cores
Storage 50GB SSD 100GB+ SSD
Network 100 Mbps 1 Gbps
OS Ubuntu 20.04+ Ubuntu 22.04 LTS

πŸ’‘ Recommended VPS Providers:

  • Contabo - €4.99/month (Best value)
  • Hetzner - €4.15/month (EU servers)
  • DigitalOcean - $6/month (Global)
  • Vultr - $6/month (High performance)

⚑ Quick Install

1️⃣ VPS Setup (5 minutes)

#Update system
sudo apt update && sudo apt upgrade -y

#Install essentials
sudo apt install -y curl git screen bc netcat-openbsd xxd

#Install Node.js (for MEV detector)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

#Install Foundry (for wallet operations)
curl -L https://foundry.paradigm.xyz | bash && source ~/.bashrc && foundryup

2️⃣ Clone & Setup (2 minutes)

#Clone repository
git clone https://github.com/rokhanz/t3rn-executor.git
cd t3rn-executor

#Setup permissions
chmod +x .sh modules/.sh

#Install dependencies
npm install

#Create configuration
cp .env.example .env

3️⃣ Configuration (3 minutes)

nano .env

Essential settings:

#===πŸ”‘ Your wallet private key (64 chars, no 0x)
PRIVATE_KEY_EXECUTOR="your_private_key_here"

#===⚑ Alchemy API keys (get from alchemy.com)
ALCHEMY_KEY_1="your_alchemy_key_1"
ALCHEMY_KEY_2="your_alchemy_key_2"
ALCHEMY_KEY_3="your_alchemy_key_3"

#===πŸ“± Telegram (create bot with @BotFather)
TELEGRAM_BOT_TOKEN="your_bot_token"
TELEGRAM_CHAT_ID="your_chat_id"

#===🌐 Networks to run
ENABLED_NETWORKS="arbitrum-sepolia,base-sepolia,blast-sepolia,optimism-sepolia"

4️⃣ Launch (1 command)

./autorun.sh

πŸŽ‰ Done! Your executor is running with full monitoring.


πŸ“± Telegram Notifications

Rich notifications with wallet info:

🎯 BID SUCCESS! 🎯

πŸ“‹ Order Details:
πŸ†” Order ID: 0x1234...abcd
πŸŒ‰ Route: πŸ”΅ Arbitrum ➑️ πŸ”· Base
πŸ’° Amount: 0.1 ETH
πŸ”‘ Wallet: 0x1234...5678

⚑ Latency: 45ms
⏰ Time: 14:30:25

undefined

πŸ’° BALANCE REPORT πŸ’°

πŸ”‘ Wallet: 0x1234...5678

πŸ”΅ Arbitrum: 0.850 ETH
πŸ”· Base: 0.750 ETH
πŸ’₯ Blast: 1.200 ETH
πŸ”΄ Optimism: 0.650 ETH

πŸ’Ž Total: 3.450 ETH
βœ… Status: Healthy


🌐 Supported Networks

Network Code Status Alchemy
πŸ”΅ Arbitrum Sepolia arbt βœ… Active βœ…
πŸ”· Base Sepolia bast βœ… Active βœ…
πŸ’₯ Blast Sepolia blst βœ… Active βœ…
πŸ”΄ Optimism Sepolia opst βœ… Active βœ…
πŸ¦„ Unichain Sepolia unit βœ… Active βœ…
πŸŒ™ Monad Testnet mont βœ… Active βœ…
⚑ Sei Testnet seit βœ… Active βœ…
🎨 Abstract Testnet abst βœ… Active βœ…
πŸ”— Lisk Sepolia lisk βœ… Active ❌
🐻 Berachain Bepolia bera βœ… Active βœ…
🟑 BNB Testnet bnb βœ… Active βœ…
🌐 L2RN Network l2rn βœ… Active ❌

πŸ›‘οΈ Security Features

  • πŸ₯ͺ Anti-Sandwich - Detect and prevent sandwich attacks
  • πŸƒ Anti-Frontrun - Dynamic gas pricing protection
  • πŸ”„ Proxy Support - SOCKS5/HTTP with rotation
  • πŸ” Wallet Security - Secure private key handling
  • πŸ§ͺ Tx Simulation - Pre-execution validation

πŸ“Š Management Commands

#Check status
./autorun.sh -s

#View logs
tail -f logs/executor.log

#Attach to screen
screen -r t3rn-executor

#Health check
./autorun.sh -c

#Balance check
./modules/balance_checker.sh


πŸ”§ Advanced Features

πŸ”„ Auto-Restart

  • Intelligent restart on failures
  • Configurable retry attempts
  • Health monitoring

πŸ“Š Rich Monitoring

  • Real-time progress bars
  • System resource tracking
  • Network latency monitoring

🎨 Beautiful UI

  • Colorful progress indicators
  • Emoji-rich logging
  • Animated spinners

🌐 Multi-Network

  • 12 testnet networks
  • Automatic failover
  • Load balancing

πŸš€ Why Choose This Executor?

Feature Standard Executor This Repository
Networks 4-5 basic 12 with failover
Notifications None Rich Telegram
MEV Protection None Advanced
UI/UX Basic logs Colorful progress
Monitoring None Comprehensive
Auto-restart Manual Intelligent
Documentation Minimal Complete

🀝 Special Thanks

πŸ—οΈ T3RN Team

Terima kasih kepada tim T3RN yang telah membangun protokol revolusioner untuk cross-chain interoperability. Tanpa visi dan kerja keras mereka, executor ini tidak akan ada.

⚑ Alchemy

Appreciation to Alchemy for providing reliable and fast RPC infrastructure that makes multi-network execution possible with minimal latency.

πŸ€– Telegram

Thanks to Telegram for the excellent Bot API that enables rich, real-time notifications with beautiful formatting and instant delivery.

πŸ”§ Foundry Team

Gratitude to the Foundry team for creating powerful blockchain development tools that make wallet operations and address derivation seamless.

🌐 Open Source Community

Special recognition to the countless developers who created the tools, libraries, and frameworks that make this project possible.

πŸ’Ž Early Adopters

Thanks to the brave souls who will test this executor in 2025 and provide feedback to make it even better for the T3RN mainnet launch.


πŸ“ž Support


⭐ Star this repository if you find it useful!

πŸš€ Ready for T3RN Mainnet 2025!


Built with ❀️ for the T3RN community | Last updated: June 2025

About

Advanced T3RN Executor with MEV protection and rich Telegram notifications

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published