Web3 Agent Kit¶

Build autonomous AI agents that interact with blockchains — in minutes, not months.

pip install web3-agent-kit

Get Started View on GitHub

v1.14.0

Version

24+

Modules

1,225

Tests

8

Chains

MIT

License

🚀 From Zero to Agent in 5 Lines¶

from web3_agent_kit import Agent, Wallet, Chain
from web3_agent_kit.defi import Uniswap

agent = Agent(wallet=Wallet.from_env("PRIVATE_KEY"), chains=[Chain.BASE], tools=[Uniswap()])
result = agent.run("Swap 0.1 ETH to USDC on Base")
print(result)

Or use the CLI — no Python needed:

wak agent --goal "Swap 0.1 ETH to USDC on Base" --wallet 0x...

✨ Everything You Need¶

🤖

Agent Framework¶

Goal-driven autonomous agents with LLM reasoning. Natural language in, on-chain actions out.

💰

DeFi Tools¶

Uniswap V2/V3, Aerodrome, Aave, Curve. Real swaps, quotes, approvals, slippage protection.

🎯

Airdrop Suite¶

Galxe, Zealy, Layer3, Gleam, QuestN, Intract. Multi-wallet farming, auto-discovery.

🔐

Security Audit¶

Static analysis, fuzzing, exploit PoC, forensics. 10 specialized audit skills built-in.

⚡

MEV Bots¶

Cross-DEX arbitrage, liquidation bot, Flashbot support. Extract value from mempool.

🖼️

NFT Tools¶

Deploy collections, batch mint, marketplace listing. ERC-721A optimized.

📈

Trading Bots¶

DCA with price triggers, yield optimizer, token sniper. Automated strategies.

🌉

Cross-Chain Bridge¶

Li.Fi + Socket aggregators. Best routes, lowest fees, 8 chains.

🔮

Oracle Aggregator¶

Multi-source price feeds — Chainlink, DexScreener, CoinGecko. Weighted median, auto-fallback, cache.

📡

Event Listener¶

On-chain event subscription with webhooks, callbacks, and background polling. Real-time monitoring.

🧪

Transaction Simulator¶

Pre-flight TX verification via eth_call, Tenderly, or local fork. Catch reverts before broadcasting.

🔑

Account Abstraction¶

ERC-4337 bundler, paymaster integration, smart account factory. SimpleAccount, Safe, Kernel support.

🔗

Cross-Chain Messaging¶

LayerZero + Wormhole + CCIP unified API. Send messages, query status, estimate fees.

🗳️

Governance¶

Snapshot + Tally + on-chain governor. Proposal tracking, voting power, delegation management.

🛠️

CLI Tool¶

wak — 7 commands for terminal usage. Check balances, gas, run agents, zero Python.

🏗️ Architecture¶

User / Application
        │
        ▼
┌───────────────────────────┐
│     Agent Framework       │
│  Goal → LLM → Tool → TX  │
└─────────────┬─────────────┘
              │
   ┌──────────┼──────────┐
   │   Safety Layer      │
   │  Governor + Kill SW │
   └──────────┼──────────┘
              │
   ┌──────────┼────────────────────────────────────────┐
   │          Tool Ecosystem                            │
   │  DeFi · Airdrop · Security · MEV · NFT · Trading   │
   │  Portfolio · Bridge · Gas · Wallet · Oracle        │
   │  Events · Simulator · Account Abstraction          │
   │  Messaging · Governance · Plugins · Utils          │
   └──────────┼────────────────────────────────────────┘
              │
   ┌──────────┼──────────┐
   │  Chain Abstraction   │
   │  ETH · BASE · ARB   │
   │  OP · MATIC · BSC   │
   │  AVAX · SOLANA   │
   └─────────────────────┘

⚡ Quick Start¶

PythonCLIAirdrop FarmingSecurity AuditOracleSimulate TX

from web3_agent_kit import Agent, Wallet, Chain, ChainManager
from web3_agent_kit.defi import Uniswap

chain_manager = ChainManager(chains=[Chain.BASE])
wallet = Wallet.from_env("PRIVATE_KEY", chain_manager=chain_manager)
uniswap = Uniswap(chain_manager=chain_manager)

agent = Agent(wallet=wallet, chains=[Chain.BASE], tools=[uniswap])
result = agent.run("Swap 0.1 ETH to USDC on Base")

# Check your wallet
wak wallet

# Check gas prices
wak gas

# Run an agent
wak agent --goal "Swap 0.1 ETH to USDC on Base" --wallet 0x...

from web3_agent_kit.airdrop import MultiWalletManager

manager = MultiWalletManager.from_csv("wallets.csv")
manager.execute_on_all("swap", token_in="ETH", token_out="USDC", amount=0.01)

from web3_agent_kit.security import StaticAnalyzer

analyzer = StaticAnalyzer()
results = analyzer.analyze("contracts/Token.sol")
for vuln in results.vulnerabilities:
    print(f"[{vuln.severity}] {vuln.name}")

from web3_agent_kit.oracle import OracleAggregator

oracle = OracleAggregator()
price = oracle.get_price("ETH")
print(f"ETH: ${price.usd:.2f} (sources: {price.sources})")

from web3_agent_kit.simulator import TransactionSimulator

sim = TransactionSimulator(chain_manager=cm)
result = sim.simulate(to=router, data=calldata, from_addr=wallet.address)
print(f"Would revert: {result.would_revert}, gas: {result.gas_used}")

📦 Supported Chains¶

Chain	Status	DeFi	Bridge
Ethereum	✅	✅	✅
Base	✅	✅	✅
Arbitrum	✅	✅	✅
Optimism	✅	✅	✅
Polygon	✅	✅	✅
Avalanche	✅	—	✅
BSC	✅	—	✅
Solana	✅	—	—

🤝 Contributing¶

We welcome contributions! Whether it's bug reports, feature requests, documentation improvements, or code contributions.

Contributing Guide

Built by [Maulana](https://github.com/ulsreall) · [Twitter](https://twitter.com/itseywacc) · [PyPI](https://pypi.org/project/web3-agent-kit/)