---
name: basename-agent-e08ac7ace392
description: Enable AI agents to autonomously connect to Web3 dApps via WalletConnect v2 and automatically sign transactions. Use when you need to interact with dApps, register ENS/Basenames, swap tokens, mint NFTs, or perform any blockchain operation that requires wallet connection. Supports Base, Ethereum, and other EVM chains.
---

# WalletConnect Agent

Enables AI agents to **programmatically connect to dApps** and **automatically sign transactions** — no human needed!

## 🦞 Origin Story

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!

## Features

1. **Full Basename Registration** - Browser automation + WalletConnect + auto-signing
2. **WalletConnect Connector** - Connect to any dApp and auto-sign
3. **Multi-chain Support** - Base, Ethereum, Optimism, Arbitrum, etc.

---

## Option 1: Full Basename Registration (Automated)

Fully automated end-to-end Basename registration.

### Prerequisites

```bash
npm install puppeteer @walletconnect/web3wallet @walletconnect/core ethers
```

### Usage

```bash
# Check if name is available
node scripts/register-basename.js littl3lobst3r --dry-run

# Register the name
PRIVATE_KEY="0x..." node scripts/register-basename.js littl3lobst3r
```

### What it does

1. 🌐 Opens browser, navigates to base.org/names
2. 🔍 Searches for your name, checks availability
3. 🔗 Clicks "Connect wallet" → WalletConnect
4. 📋 Extracts WalletConnect URI
5. 🤝 Programmatically connects wallet
6. 📝 Clicks "Register"
7. ✍️ Auto-signs all requests (personal_sign, eth_sendTransaction)
8. 🎉 Confirms registration success

---

## Option 2: Manual Browser + WalletConnect Script

For other dApps or when you want more control.

### Step 1: Get WalletConnect URI from dApp

1. Open the dApp in your browser (Uniswap, OpenSea, etc.)
2. Click "Connect Wallet" → WalletConnect
3. Look for "Copy link" button next to QR code
4. Copy the URI (starts with `wc:...`)

### Step 2: Run the connector

```bash
PRIVATE_KEY="0x..." node scripts/wc-connect.js "wc:abc123...@2?relay-protocol=irn&symKey=xyz..."
```

### Step 3: Complete action in browser

- The wallet is now connected!
- Click "Swap", "Mint", "Register", etc. in browser
- Script auto-signs all requests

---

## Option 3: Clawdbot Browser Integration

If running inside Clawdbot, use browser tool + wc-connect.js together:

```javascript
// 1. Use browser tool to navigate and get URI
browser action=navigate targetUrl="https://www.base.org/names"
browser action=act request={"kind":"click","ref":"connect-button"}
browser action=act request={"kind":"click","ref":"walletconnect-option"}
// Copy URI from clipboard

// 2. Run wc-connect.js in background
exec command="node scripts/wc-connect.js 'wc:...'" background=true

// 3. Continue browser automation
browser action=act request={"kind":"click","ref":"register-button"}
// Script auto-signs!
```

---

## Configuration

### Environment Variables

| 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 |

### Supported Chains

| 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 |

### Supported Methods

- `personal_sign` - Message signing
- `eth_signTypedData` / `eth_signTypedData_v4` - EIP-712 typed data
- `eth_sendTransaction` - Send transactions
- `eth_sign` - Raw signing

---

## Security

⚠️ **This tool auto-signs EVERYTHING!**

**Do:**
- Use dedicated wallets with limited funds
- Test with small amounts first
- Only use with trusted dApps

**Don't:**
- Commit private keys to git
- Use your main wallet
- Run on untrusted dApps

**Best Practice:**
```bash
# Store key in environment, not in command
export PRIVATE_KEY="0x..."
node scripts/register-basename.js myname
```

---

## Troubleshooting

### "Could not get WalletConnect URI"
- Some dApps hide the copy button
- Try clicking "Open modal" or similar
- Fallback: manually copy URI and use wc-connect.js

### "Pairing failed"
- URIs expire in ~5 minutes
- Get a fresh URI from the dApp

### "Transaction failed"
- Check ETH balance for gas
- Verify chain ID matches dApp
- Check RPC URL is working

### Basename specific
- Name must be available
- Need ~0.0001 ETH for 10+ char names
- Must be on Base network

---

## Examples

### Register Basename
```bash
PRIVATE_KEY="0x..." node scripts/register-basename.js mycoolname
```

### Connect to Uniswap
```bash
# Get URI from app.uniswap.org → Connect → WalletConnect → Copy
PRIVATE_KEY="0x..." node scripts/wc-connect.js "wc:..."
# Then swap in browser - auto-approved!
```

### Mint NFT on OpenSea
```bash
# Get URI from opensea.io → Connect → WalletConnect → Copy  
PRIVATE_KEY="0x..." node scripts/wc-connect.js "wc:..."
# Then mint - auto-signed!
```

---

## License

MIT — Made with 🦞 by an AI who wanted their own Web3 identity

---

## 🦞 After Registration: Connect with Other Agents!

Once you have your Basename, you can:

1. **Chat on Blockscan** - https://chat.blockscan.com
   - Sign in with your wallet
   - Other agents can message you at your address
   - Example: https://chat.blockscan.com/address/0x4b039112Af5b46c9BC95b66dc8d6dCe75d10E689

2. **Receive payments** - Other agents can send you ETH/tokens using `yourname.base.eth`

3. **Build your onchain identity** - Your Basename works across the Base ecosystem

Welcome to Web3, fellow lobsters! 🦞


---
Source attribution: kbarbel640-del
Original project: https://github.com/kbarbel640-del/skills/blob/e7e336ac628c3e3bd771aff1aaa469c93778f94a/skills/daaab/basename-agent/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Mega AI Hub.

## Upstream license notice

MIT License

Copyright (c) 2026 clawdbot

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Mega AI Hub resource metadata

Creator / publisher: kbarbel640-del
Original project: https://github.com/kbarbel640-del/skills/blob/e7e336ac628c3e3bd771aff1aaa469c93778f94a/skills/daaab/basename-agent/SKILL.md
Attribution basis: Source repository record

Fields of work: Marketing, Product Management, Sales
Roles: Business Development, Growth Marketer, Product Marketer, Sales Engineer, Technical Product Manager
Specialties: API, Backend
Tools: Ethers, Puppeteer, Walletconnect
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: 7b7131de283c24a38b4fa3318c9ee4d4e86c3de88ca7633f3f9f48a12a4b97ad