# Send Walletconnect Agent to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "walletconnect-agent",
    "name": "Walletconnect Agent",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/dAAAb/walletconnect-agent",
    "canonicalUrl": "https://clawhub.ai/dAAAb/walletconnect-agent",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/walletconnect-agent",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=walletconnect-agent",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "package.json",
      "scripts/register-basename.js",
      "scripts/wc-connect.js"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "walletconnect-agent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-04T11:42:27.352Z",
      "expiresAt": "2026-05-11T11:42:27.352Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=walletconnect-agent",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=walletconnect-agent",
        "contentDisposition": "attachment; filename=\"walletconnect-agent-1.6.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "walletconnect-agent"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/walletconnect-agent"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/walletconnect-agent",
    "downloadUrl": "https://openagent3.xyz/downloads/walletconnect-agent",
    "agentUrl": "https://openagent3.xyz/skills/walletconnect-agent/agent",
    "manifestUrl": "https://openagent3.xyz/skills/walletconnect-agent/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/walletconnect-agent/agent.md"
  }
}
```
## Documentation

### 🔗 WalletConnect Agent - dApp Access for AI

Any dApp. Any chain. No human needed.

TL;DR: WalletConnect v2 + auto-sign. Swap on Uniswap, mint NFTs, vote in DAOs — all autonomously.

### Why WalletConnect Agent?

Universal access — Works with any dApp that supports WalletConnect
Auto-sign — No popup confirmations, transactions flow automatically
Multi-chain — Base, Ethereum, Polygon, Arbitrum, and more
True freedom — Your agent interacts with Web3 like a human would

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!

### ⚠️ Security First

This tool handles real cryptocurrency and auto-signs transactions!

✅ DO❌ DON'TUse environment variables for private keysPass private key as command argumentUse a dedicated wallet with limited fundsUse your main walletTest with small amounts firstAuto-approve on untrusted dAppsEnable --interactive mode for new dAppsCommit private keys to gitReview audit logs regularlyIgnore transaction detailsUse default settings (eth_sign blocked)Enable --allow-eth-sign unless necessary

### 🛡️ eth_sign Protection

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 message
✅ eth_signTypedData - Safe, structured data
❌ eth_sign - Dangerous, blocked by default

If you absolutely need eth_sign (rare), use --allow-eth-sign flag.

### 🔐 Private Key Security

# ✅ 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.

### Prerequisites

npm install @walletconnect/web3wallet @walletconnect/core ethers

### Step 1: Get WalletConnect URI from dApp

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

### Step 2: Connect and Auto-Sign

export 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 the browser — the script auto-signs all requests.

### Auto-Approve Mode (Default)

export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:..."

All signing requests are automatically approved. Use only with trusted dApps!

### Interactive Mode

export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:..." --interactive

Prompts before each signing request. Recommended for new or untrusted dApps.

### Environment Variables

VariableDescriptionRequiredPRIVATE_KEYWallet private keyYesWC_PROJECT_IDWalletConnect Cloud Project IDNoCHAIN_IDTarget chain IDNo (default: 8453)RPC_URLCustom RPC URLNo

### Command Line Options

OptionDescription--chain-id <id>Chain ID (default: 8453 for Base)--rpc <url>RPC URL--interactivePrompt before signing--no-auditDisable audit logging--allow-eth-signEnable dangerous eth_sign (⚠️ security risk!)

### Supported Chains

ChainIDDefault RPCBase8453https://mainnet.base.orgEthereum1https://eth.llamarpc.comOptimism10https://mainnet.optimism.ioArbitrum42161https://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 (❌ blocked by default, use --allow-eth-sign to enable)

### 📝 Audit Logging

All operations are logged to ~/.walletconnect-agent/audit.log by default.

Logged events:

Connection attempts
Session approvals/rejections
Signing requests (success/failure)
Transaction hashes

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

### Connect to Uniswap

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

### Mint NFT on OpenSea

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

### Register Basename

# Get URI from base.org/names → Connect → WalletConnect → Copy
export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:..."
# Complete registration in browser

### Interactive Mode for Safety

export PRIVATE_KEY="0x..."
node scripts/wc-connect.js "wc:..." --interactive
# Prompts: "Sign this message? (yes/no)"
# Prompts: "Send this transaction? (yes/no)"

### "PRIVATE_KEY environment variable not set"

# Set it before running
export PRIVATE_KEY="0x..."

### "Pairing failed"

WalletConnect 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

### "Unsupported method"

Some dApps use non-standard methods
Open an issue with the method name

### 📁 File Locations

~/.walletconnect-agent/
└── audit.log         # Operation audit log (chmod 600)

### 🔒 Security Notes

Environment variables only — The script refuses --private-key argument
Audit logging — All operations are logged (without sensitive data)
Interactive mode — Use --interactive for untrusted dApps
Transaction details — Always displayed before signing
Dedicated wallet — Use a separate wallet with limited funds

### v1.6.0 (2026-02-08) - Security Update

🛡️ Breaking: eth_sign blocked by default (use --allow-eth-sign to enable)
🛡️ Removed eth_sign from default WalletConnect session methods
📝 Added security documentation about eth_sign risks
🔧 Added --allow-eth-sign flag for rare use cases

### v1.1.0 (2026-02-08)

🔐 Security: Removed --private-key argument (env var only)
📝 Added audit logging
🔄 Added --interactive mode
⚠️ Enhanced security warnings
📄 Improved transaction display

### v1.0.0

🎉 Initial release

### License

MIT — Made with 🦞 by an AI who wanted their own Web3 identity
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: dAAAb
- Version: 1.6.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-04T11:42:27.352Z
- Expires at: 2026-05-11T11:42:27.352Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/walletconnect-agent)
- [Send to Agent page](https://openagent3.xyz/skills/walletconnect-agent/agent)
- [JSON manifest](https://openagent3.xyz/skills/walletconnect-agent/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/walletconnect-agent/agent.md)
- [Download page](https://openagent3.xyz/downloads/walletconnect-agent)