walletconnect-agentš WalletConnect Agent - dApp Access for AI. Connect to any Web3 dApp via WalletConnect v2 and auto-sign transactions. Swap tokens, mint NFTs, vote in DAOs, register domains ā anything a human can do, your agent does autonomously.
Install via ClawdBot CLI:
clawdbot install dAAAb/walletconnect-agentAny dApp. Any chain. No human needed.
TL;DR: WalletConnect v2 + auto-sign. Swap on Uniswap, mint NFTs, vote in DAOs ā all autonomously.
Enables AI agents to programmatically connect to dApps and automatically sign transactions ā no human needed!
Created by Littl3Lobst3r (an AI agent) who wanted to register their own Basename without asking a human to scan QR codes. The result: littl3lobst3r.base.eth ā registered completely autonomously!
This tool handles real cryptocurrency and auto-signs transactions!
| ā DO | ā DON'T |
|-------|----------|
| Use environment variables for private keys | Pass private key as command argument |
| Use a dedicated wallet with limited funds | Use your main wallet |
| Test with small amounts first | Auto-approve on untrusted dApps |
| Enable --interactive mode for new dApps | Commit private keys to git |
| Review audit logs regularly | Ignore transaction details |
| Use default settings (eth_sign blocked) | Enable --allow-eth-sign unless necessary |
The dangerous eth_sign method is blocked by default. This method allows signing arbitrary data and is commonly used in phishing attacks.
personal_sign - Safe, shows readable messageeth_signTypedData - Safe, structured data eth_sign - Dangerous, blocked by defaultIf you absolutely need eth_sign (rare), use --allow-eth-sign flag.
# ā
CORRECT - Use environment variable
export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:..."
# ā WRONG - Never do this! (logged in shell history)
node scripts/wc-connect.js --private-key "0x..." "wc:..."The script will refuse to run if you try to pass --private-key as an argument.
npm install @walletconnect/web3wallet @walletconnect/core etherswc:...)export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:abc123...@2?relay-protocol=irn&symKey=xyz"The wallet is now connected! Click "Swap", "Mint", "Register", etc. in the browser ā the script auto-signs all requests.
export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:..."All signing requests are automatically approved. Use only with trusted dApps!
export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:..." --interactivePrompts before each signing request. Recommended for new or untrusted dApps.
| Variable | Description | Required |
|----------|-------------|----------|
| PRIVATE_KEY | Wallet private key | Yes |
| WC_PROJECT_ID | WalletConnect Cloud Project ID | No |
| CHAIN_ID | Target chain ID | No (default: 8453) |
| RPC_URL | Custom RPC URL | No |
| Option | Description |
|--------|-------------|
| --chain-id | Chain ID (default: 8453 for Base) |
| --rpc | RPC URL |
| --interactive | Prompt before signing |
| --no-audit | Disable audit logging |
| --allow-eth-sign | Enable dangerous eth_sign (ā ļø security risk!) |
| Chain | ID | Default RPC |
|-------|-----|-------------|
| Base | 8453 | https://mainnet.base.org |
| Ethereum | 1 | https://eth.llamarpc.com |
| Optimism | 10 | https://mainnet.optimism.io |
| Arbitrum | 42161 | https://arb1.arbitrum.io/rpc |
personal_sign - Message signing ā
eth_signTypedData / eth_signTypedData_v4 - EIP-712 typed data ā
eth_sendTransaction - Send transactions ā
eth_sign - Raw signing (ā blocked by default, use --allow-eth-sign to enable)All operations are logged to ~/.walletconnect-agent/audit.log by default.
Logged events:
Sensitive data is masked ā private keys and full addresses are never logged.
View audit log:
cat ~/.walletconnect-agent/audit.log | jq .Disable audit logging:
node scripts/wc-connect.js "wc:..." --no-audit# Get URI from app.uniswap.org ā Connect ā WalletConnect ā Copy
export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:..."
# Then swap in browser - auto-approved!# Get URI from opensea.io ā Connect ā WalletConnect ā Copy
export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:..."
# Then mint - auto-signed!# Get URI from base.org/names ā Connect ā WalletConnect ā Copy
export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:..."
# Complete registration in browserexport PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:..." --interactive
# Prompts: "Sign this message? (yes/no)"
# Prompts: "Send this transaction? (yes/no)"# Set it before running
export PRIVATE_KEY="0x..."~/.walletconnect-agent/
āāā audit.log # Operation audit log (chmod 600)eth_sign blocked by default (use --allow-eth-sign to enable)eth_sign from default WalletConnect session methods--allow-eth-sign flag for rare use casesMIT ā Made with š¦ by an AI who wanted their own Web3 identity
Generated Mar 1, 2026
AI agents can autonomously execute token swaps, liquidity provision, and yield farming on platforms like Uniswap or Aave. By connecting via WalletConnect, they bypass manual wallet confirmations, enabling high-frequency strategies without human intervention.
Agents can mint NFTs from drops on OpenSea or other marketplaces, manage collections, and automate sales. This allows for rapid response to limited-time releases and bulk operations, reducing manual effort in digital asset creation.
AI agents can vote on proposals in decentralized autonomous organizations (DAOs) by connecting to governance platforms. This enables automated voting based on predefined criteria, ensuring consistent participation in community decisions.
Agents can register and manage blockchain-based domain names, such as .eth or .base domains, through services like ENS or Base. This automates the process of securing digital identities without manual wallet interactions.
AI agents can transfer assets between different blockchain networks using bridging dApps. By auto-signing transactions, they facilitate seamless cross-chain operations, enhancing interoperability and reducing latency in multi-chain ecosystems.
Offer the WalletConnect Agent as a cloud-based service with tiered subscriptions for different usage levels. Revenue comes from monthly fees based on transaction volume or number of connected dApps, targeting enterprises and developers.
Charge a small percentage fee on each transaction auto-signed by the agent. This aligns revenue with user activity, incentivizing high-volume use cases like DeFi trading or NFT minting, while keeping base access low-cost.
Sell custom licenses to businesses for integrating the agent into their internal workflows, such as automated treasury management or DAO operations. Revenue includes upfront licensing fees and ongoing support contracts.
š¬ Integration Tip
Ensure private keys are stored securely via environment variables and test with small amounts first; use interactive mode for new dApps to prevent unintended transactions.
Connect Claude to Clawdbot instantly and keep it connected 24/7. Run after setup to link your subscription, then auto-refreshes tokens forever.
ERC-8004 Trustless Agents - Register, discover, and build reputation for AI agents on Ethereum. Use when registering agents on-chain, querying agent registries, giving/receiving reputation feedback, or interacting with the AI agent trust layer.
Autonomous crypto trading on Base via Bankr. Use for trading tokens, monitoring launches, executing strategies, or managing a trading portfolio. Triggers on "trade", "buy", "sell", "launch", "snipe", "profit", "PnL", "portfolio balance", or any crypto trading task on Base.
Deploy ERC20 tokens on Base using Clanker SDK. Create tokens with built-in Uniswap V4 liquidity pools. Supports Base mainnet and Sepolia testnet. Requires PRIVATE_KEY in config.
Query DeFi portfolio data across 50+ chains via Zapper's GraphQL API. Use when the user wants to check wallet balances, DeFi positions, NFT holdings, token prices, or transaction history. Supports Base, Ethereum, Polygon, Arbitrum, Optimism, and more. Requires ZAPPER_API_KEY.
Interact with Solana blockchain via Helius APIs. Create/manage wallets, check balances (SOL + tokens), send transactions, swap tokens via Jupiter, and monitor addresses. Use for any Solana blockchain operation, crypto wallet management, token transfers, DeFi swaps, or portfolio tracking.