v1.6.0 — CLI Tool Release

🎉 v1.6.0 — CLI Tool Release

New: wak CLI Command

Build and run Web3 AI agents directly from your terminal!

pip install web3-agent-kit
wak info      # Show version & capabilities
wak doctor    # Check environment
wak examples  # List example scripts

Commands

• wak info — Library version, stats, capabilities
• wak doctor — Environment check (Python, deps, .env)
• wak examples — List 19 example scripts
• wak wallet balance — Check wallet balance
• wak token check — Token safety analysis
• wak gas — Gas price estimation
• wak agent — Run autonomous AI agent

Dependencies

• Added: click>=8.0, rich>=13.0

Install

pip install web3-agent-kit==1.6.0

Full Changelog: v1.5.0...v1.6.0

v1.5.0 — Major Repo Reorganization

🏗️ Major Repo Reorganization

Reorganized src/ flat files into logical subdirectory modules:

New Structure

• src/agent/ — Agent core + LLM integration
• src/wallet/ — Wallet, multi-wallet, watcher, approval manager
• src/bridge/ — Cross-chain bridge agent
• src/chains/ — Chain definitions and RPC management
• src/portfolio/ — Portfolio tracker
• src/trading/ — Token sniper + DCA bot
• src/gas/ — Gas optimizer
• src/defi/ — DeFi protocols + yield optimizer (merged)

Other Changes

• Added __all__ exports to every __init__.py
• Added py.typed marker (PEP 561 type checking)
• Moved content files to blog/ and docs/
• Updated all test/example/API imports
• 565 tests passing ✅
• Backward compatible — all from web3_agent_kit import ... paths still work

Install

pip install web3-agent-kit==1.5.0

v1.4.0 — MEV, NFT, Notifications

🚀 v1.4.0 — MEV, NFT, Notifications

Three major modules added!

✨ New Features

MEV Protection

• Flashbots integration
• Private transaction relay
• Sandwich attack detection
• Bundle creation and simulation

NFT Module

• Collection info and floor price
• Wallet NFT tracking
• Rarity calculation
• Trending collections
• Listing tracking

Notification System

• Telegram alerts
• Discord webhooks
• Slack webhooks
• Generic webhooks
• Price alerts, trade alerts, gas alerts

📊 Stats

• 565 tests
• 25+ modules
• CI green

📦 Installation

pip install web3-agent-kit==1.4.0

v1.3.0 — Real Execution Layer

🔥 v1.3.0 — Real Execution Layer

Real browser automation for airdrop applications — not just scanning!

✨ New Features

• Form Filler: Auto-fill Typeform, Google Forms, generic HTML forms
• WL Grinder: Auto-apply NFT whitelist spots
  • Bulk apply with delay
  • Platform detection (Typeform, Google Forms, Premint, Gleam)
  • Reusable profiles
  • Screenshot proof
• Profile System: Save and reuse user profiles for form filling

📊 Stats

• 565 tests
• 22 examples
• 20+ modules
• CI green

📦 Installation

pip install web3-agent-kit==1.3.0

🔥 Usage

from web3_agent_kit.airdrop import WLGrinder, WLProfile

profile = WLProfile(
    wallet="0x...",
    twitter="@user",
    email="user@email.com",
)
grinder = WLGrinder(profile)
result = grinder.apply("https://typeform.com/to/abc123")

v1.2.0 — Security Module

🔒 v1.2.0 — Security Module

Comprehensive token security analysis toolkit.

✨ New Features

• TokenAnalyzer: Full security analysis for tokens
• Honeypot Detection: Check if token can be sold before buying
• Rug Pull Checker: Assess rug pull risk factors
• Contract Audit: Detect hidden mint, blacklist, pause, proxy patterns
• Tax Checker: Buy/sell tax analysis
• Liquidity Analysis: Locked %, lock duration
• Holder Analysis: Concentration, whale detection
• Safety Score: 0-100 score with risk levels
• GoPlus API: Real-time token security data
• DexScreener: Liquidity data integration

📊 Stats

• 565 tests (+36 new)
• 20 examples
• 20+ modules
• CI green

📦 Installation

pip install web3-agent-kit==1.2.0

🔥 Usage

from web3_agent_kit.security import TokenAnalyzer, SecurityConfig

analyzer = TokenAnalyzer(SecurityConfig(chain="base"))
report = analyzer.analyze_token("0x...")

print(f"Safety Score: {report.safety_score}/100")
print(f"Is Honeypot: {report.is_honeypot}")

v1.1.0 — Airdrop Automation Suite

🪂 v1.1.0 — Airdrop Automation Suite

Complete airdrop automation toolkit with 6 new modules.

✨ New Features

• Campaign Discovery: Auto-scan 7 platforms (Galxe, Zealy, Layer3, QuestN, TaskOn, Intract, Port3)
• On-chain Airdrop: DeFi farming plans for Base, Ethereum, Arbitrum, Optimism, Scroll, Linea, zkSync
• Daily Task Scheduler: Recurring task automation with retry logic
• Points Dashboard: Track points across all platforms with history
• Referral Manager: Generate, track, and optimize referral links
• Faucet Claimer: Auto-claim testnet tokens from 12+ faucets

📊 Stats

• 529 tests (+59 new)
• 19 examples
• 20+ modules
• CI green

📦 Installation

pip install web3-agent-kit==1.1.0

v1.0.0 — Full Airdrop Automation Platform

🚀 v1.0.0 — Full Airdrop Automation Platform

Major release with complete airdrop automation ecosystem.

✨ New Features

• 8 Platform Executors: Galxe, Zealy, Layer3, Gleam, QuestN, TaskOn, Intract, Port3
• Browser Automation: Playwright-based task completion
• CAPTCHA Solver: AntiCaptcha integration (hCaptcha, reCAPTCHA, GeeTest)
• Plugin System: Extend with custom platform executors
• CLI Tool: Command-line interface for airdrop farming
• Multi-wallet: Sybil avoidance, wallet rotation
• Session Persistence: Save/restore login sessions

📊 Stats

• 470 tests
• 18 examples
• 15+ modules
• REST API (18 endpoints)
• CI green (Python 3.10, 3.11, 3.12)

📦 Installation

pip install web3-agent-kit==1.0.0

v0.6.0 — Gas Optimizer, Wallet Watcher, Approval Manager

🚀 New Features

⛽ Gas Optimizer

• Smart gas estimation with EIP-1559 support
• Timing recommendations (execute now vs wait)
• Batch transaction optimization
• Gas level categorization (Low/Medium/High/Very High)
• Multi-chain support

👁️ Wallet Watcher

• Monitor whale wallets across chains
• Balance change alerts with severity levels
• Alert callbacks for Telegram/Discord notifications
• Persistent watchlist with tags
• Balance snapshots and history

🔐 Approval Manager

• Scan wallet for active token approvals
• Risk assessment (Safe/Moderate/High/Critical)
• Known protocol database (Uniswap, Aave, 1inch, etc.)
• Revoke unlimited approvals
• Revoke unknown contract approvals

📊 Stats

• 215+ tests passing
• 18 examples
• 14 modules

📦 Install

pip install web3-agent-kit==0.6.0

v0.5.0 — DCA Bot + Telegram Bot Template

🚀 New Features

📈 DCA Bot

• Dollar-cost average into any token automatically
• Intervals: Hourly, Daily, Weekly, Biweekly, Monthly
• Spending limits: max buys, max total, auto-stop
• Cost average analysis with price range tracking
• Persistent orders (survives restarts)
• Execution callbacks for notifications

🤖 Telegram Bot Template

• Ready-to-deploy showcase for web3-agent-kit
• Commands: /balance, /portfolio, /dca, /gas, /help
• Inline keyboard buttons for easy navigation
• Deploy guide: systemd, PM2, or screen

📊 Stats

• 184 tests passing
• 66% coverage
• 15 examples
• 11 modules

📦 Install

pip install web3-agent-kit==0.5.0

v0.4.0 — Yield Optimizer, Multi-Wallet, Plugins

🚀 New Features

🌾 Yield Optimizer

• Cross-protocol APY comparison via DeFiLlama API
• Auto-compound rewards when above threshold
• 6 supported protocols: Aave V3, Compound V3, Morpho, Lido, Rocket Pool, Fluid
• Risk assessment (LOW/MEDIUM/HIGH)
• Portfolio summary with P&L tracking

👛 Multi-Wallet Manager

• Create/import multiple wallets
• Wallet groups and tags for organization
• Batch send (native + ERC20) with delay control
• Consolidated portfolio view across all wallets
• Fund consolidation to single target wallet
• Export addresses (JSON/CSV)

🔌 Plugin System

• Abstract Plugin base class with lifecycle hooks
• PluginRegistry for discovery and management
• PluginManager with agent lifecycle integration
• Hooks: on_transaction, on_block, on_price_update, on_startup, on_shutdown
• Discovery: local directories, Python entry points, manual registration
• Example plugin: GasTrackerPlugin

📊 Stats

• 66 tests passing
• 42% coverage
• 13 examples
• 3 new modules (yield_optimizer, multi_wallet, plugins)

📦 Install

pip install web3-agent-kit==0.4.0