Skip to content

Changelog

All notable changes to Web3 Agent Kit are documented here.

[1.14.0] - 2026-07-21

Security

  • REST API now requires authentication (X-API-Key / WEB3_API_KEY) on all sensitive endpoints; server fails closed and refuses to start if WEB3_API_KEY is unset
  • Default API bind host changed from 0.0.0.0 to 127.0.0.1; explicit 0.0.0.0 now logs a network-exposure warning
  • CORS configuration hardened via CORS_ALLOWED_ORIGINS env var; unsafe * + credentials combination is rejected at startup
  • /wallet/create disabled by default (ENABLE_WALLET_CREATE_ENDPOINT=false), clearer one-time-secret warning

Fixed

  • Spend governor now enforced by default on every Agent, and no longer crashes when integrated into Agent._act()
  • GET /wallet/balance/{address} now queries the requested address instead of the env wallet's balance

Added

  • Wallet.from_keystore(path, password) for standard Ethereum JSON keystore files

Removed

  • Unused httpx2 dependency

Breaking Changes

  • WEB3_API_KEY is now mandatory to start the REST API server
  • AgentConfig.governor is active by default with conservative spend limits

[1.13.0] - 2026-07-14

Changed

  • Version bump to 1.13.0 across package metadata (__init__.py, pyproject.toml)

[1.12.0] - 2026-07-12

Fixed

  • CRITICAL DX: package import path is now web3_agent_kit (was incorrectly installed as src)
  • README/docs/examples import paths aligned with real package name
  • CLI version string synced to release version
  • Notification module duplication cleaned (notifications/ canonical; utils/notif_* are shims)

Added

  • Agent(private_key=...) convenience constructor
  • Agent.execute() alias for Agent.run()
  • CI import smoke test for public package path

Changed

  • Source tree renamed: src/ → web3_agent_kit/
  • Pytest/coverage config now tracks web3_agent_kit

Stats

  • 1,149 tests passing
  • 61% coverage
  • Public import: from web3_agent_kit import Agent, Wallet, Chain

[1.11.0] - 2026-07-11

Added

  • Solana module — full Solana blockchain integration
  • SolanaClient — async RPC client (getBalance, getTokenAccounts, sendTransaction, getTransaction, getTokenSupply)
  • SolanaWallet — keypair management, send SOL/SPL tokens, sign messages (base58/base64)
  • JupiterDEX — Jupiter aggregator (quote, swap, token search, price API)
  • SolanaNFT — Metaplex DAS API (getAssetsByOwner, getAsset, collections, portfolio summary)
  • DEX Aggregator — unified multi-chain DEX interface
  • EVM: 1inch, Paraswap, 0x Protocol
  • Solana: Jupiter
  • get_best_quote() auto-selects best provider across all chains
  • 73 new tests — 45 Solana + 14 Aggregator + 14 NFT
  • pyproject.toml: added solana optional deps (solders, spl-token, base58)

Changed

  • Chain.SOLANA enum now backed by real implementation (was stub)
  • solders import is lazy — only loaded when SolanaWallet is instantiated

[1.10.0] - 2026-07-06

Added

  • Async airdrop module — 31 time.sleep() calls converted to asyncio.sleep() / page.wait_for_timeout()
  • scheduler.py, discovery.py, faucet.py, onchain.py, multi_wallet.py, wl_grinder.py, form_filler.py, base.py
  • Simulator test suite — 29 new tests for TransactionSimulator
  • PyPI trusted publisher — OIDC-based auto-publish on GitHub Release (no API token needed)

Changed

  • AirdropScheduler.start() now uses async event loop in background thread
  • AirdropScheduler.run_task_now() is now async (await)
  • FaucetClaimer.claim_chain() is now async (await)
  • AirdropFarmer.farm_campaign() is now async (await)
  • CI: added pytest-asyncio dependency for async test support

Stats

  • 27 modules (was 23)
  • 163 source files (was 115)
  • 1,033 tests passing (was 991)
  • 60% coverage (was 31%)
  • 8 chains supported

[1.9.1] - 2026-07-01

Fixed

  • Coverage badge: 58% → 31% (actual)
  • Version bump to 1.9.1

Stats

  • 23 modules
  • 115 source files
  • 991 tests passing
  • 31% coverage
  • 8 chains supported

[1.9.0] - 2026-06-30

Added

  • Oracle Aggregator — Multi-source price feeds (Chainlink, DexScreener, CoinGecko) with weighted median, cache, and auto-fallback
  • Event Listener — On-chain event subscription with webhooks, callbacks, and background polling
  • Transaction Simulator — Pre-flight TX verification via eth_call, Tenderly API, and local fork
  • Account Abstraction — ERC-4337 bundler, paymaster integration (Pimlico), smart account factory (SimpleAccount, Safe, Kernel)
  • Cross-chain Messaging — LayerZero + Wormhole + CCIP unified API with status tracking and fee estimation
  • Governance — Snapshot + Tally + on-chain governor, proposal tracking, voting power, delegation
  • .env.example with all module configurations
  • Integration test suite (tests/test_integration.py)
  • PyPI auto-publish workflow via GitHub Actions
  • Aave V3, Curve, Uniswap V3 DeFi integrations

Changed

  • restaking/ moved to plugins/restaking/ — now a plugin, not a core module
  • notifications/ merged into utils/ — backward-compatible re-exports maintained
  • README updated with 6 new module sections, architecture diagram, and stats
  • PyPI keywords updated with oracle, erc4337, governance, cross-chain, layerzero, simulation
  • Version bump to 1.9.0

Stats

  • 23 modules (was 18)
  • 115 source files (was 104)
  • 32,743 lines of code
  • 991 tests passing (was 986)
  • 31% coverage
  • 8 chains supported (was 7)

[1.8.0] - 2026-06-29

Added

  • Aave V3 integration — supply, borrow, repay, liquidation
  • Curve Finance — swaps across all pool types, gauge deposits
  • Uniswap V3 — pool queries, multi-hop quotes, position NFTs

Changed

  • CI workflow fixed (httpx2 typo removed)
  • README stats updated

[1.7.0] - 2026-06-28

Added

  • Restaking module — EigenLayer, Babylon BTC, Solana restaking
  • Notifications module — Telegram, Discord, email alerts
  • Plugin system — custom tool registration
  • MEV protection — Flashbots, private mempool

[1.6.0] - 2026-06-06

Added

  • CLI tool wak — 7 commands for terminal usage (info, doctor, wallet, gas, token, examples, agent)
  • ASCII art banner on CLI startup
  • click + rich CLI dependencies

Changed

  • Updated README with CLI tool usage
  • Version bump to 1.6.0

[1.5.0] - 2026-06-05

Added

  • Gas optimizer with historical analysis
  • Portfolio tracker with P&L
  • Cross-chain bridge via Li.Fi + Socket