Skip to content

LeonardSEO/ArpSpoofer-Omega

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 

Repository files navigation

👾⚡ ArpSpoofer 4.0 "Omega"

The Definitive Hardware-Level ARP Validation Engine for 2026

Deployment Scenario


🌌 Overview

ArpSpoofer 4.0 Omega is a high-performance, production-grade firmware designed for the Arduino Nano and ENC28J60 Ethernet controller. Engineered for network stress-testing and RFC-compliance validation, the Omega Engine transcends the limitations of legacy scripts by implementing industrial-standard protocols, advanced rate limiting, and autonomous state recovery.

Warning

OPERATIONAL SECURITY NOTICE: This firmware is for authorized lab use and educational purposes only. Deployment on unauthorized networks may violate local laws and corporate policies. Maintain physical isolation from production environments.


🚀 Key Innovations (Omega v4.0)

  • Ouroboros State Machine: A robust logic core managing INIT, DHCP, ANNOUNCE, RUN, and RECOVERY states, ensuring 99.9% uptime on isolated segments.
  • Token-Bucket Rate Limiter: Advanced flow control allowing for high-intensity bursts while maintaining a strict, user-defined average PPS (Packets Per Second).
  • Omega Web Dashboard (V2): A lightweight, responsive, and dark-mode HTTP interface built directly into the ENC28J60 stack for real-time remote execution.
  • RFC 5227 Compliance: Implements the official IPv4 Address Conflict Detection announce sequence (3 GARPs with pseudo-random jitter).
  • Automatic PHY Recovery: Real-time link-layer monitoring. If the connection is severed or the DHCP lease is revoked, the Engine automatically transitions to recovery mode.
  • EEPROM Intelligence: Persistent storage for MAC addresses, PPS rates, and operational modes. Your tactical configuration survives power cycles.

🛠 Hardware Architecture

Component specification
Microcontroller ATmega328P (Arduino Nano)
Network Core Microchip ENC28J60 (SPI)
Logic Voltage 3.3V / 5V (Level-shifted)
Interface Serial CLI @ 115200 Baud

Module View


⚙️ Deployment Guide

1. Environment Setup

2. Firmware Integration

  1. Open ArpSpoofer4.0-Omega.ino in the IDE.
  2. Select Arduino Nano / ATmega328P (Use "Old Bootloader" if required).
  3. Compile and Flash.

🎮 Command & Control (Serial CLI)

The Omega Engine features an advanced real-time interface at 115200 baud.

Command Action Description
R<n> Set Rate Adjust PPS (1–500). Max burst handled by Bucket.
S Status Full diagnostic snapshot (Packets sent, State, IP, MAC).
P Pause Instant freeze/resume of the transmit engine.
C Commit Save current configuration to non-volatile EEPROM.
M<suffix> MAC Mod Patch the last 3 bytes of the MAC (e.g., M1A2B3C).
? Help Display the command matrix.

🌐 Omega Web Dashboard

The 4.0 Engine hosts an ultra-lightweight HTTP configuration panel reachable at the IP address assigned via DHCP. It operates asynchronously alongside the main attack loop.

  • URL: http://<device_ip>/
  • Default Auth Target: OMEGA
  • Features: Real-time PPS adjustment, Attack Toggle, and live statistics reporting.

🗺 Roadmap to 5.0

  • State Machine Overhaul
  • Token-Bucket Integration
  • EEPROM Persistence
  • Web-based Dashboard (ENC28J60 HTTP Stack)
  • Multi-Target Cycle Mode
  • OUI Impersonation Tables

📜 Legal & Licensing

Distributed under the MIT License. Original development by LeonardSEO. Project references: RFC 5227, IEEE 802.3, Microchip Data Sheets.


Maintained by Janus & Tesavek 👾⚡

About

Production-grade ArpSpoofer 4.0 'Omega' for Arduino Nano + ENC28J60. State machine, Token bucket, RFC 5227.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages