{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/walletconnect-agent",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=walletconnect-agent",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "package.json",
      "scripts/register-basename.js",
      "scripts/wc-connect.js"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/walletconnect-agent",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "🔗 WalletConnect Agent - dApp Access for AI",
        "body": "Any dApp. Any chain. No human needed.\n\nTL;DR: WalletConnect v2 + auto-sign. Swap on Uniswap, mint NFTs, vote in DAOs — all autonomously."
      },
      {
        "title": "Why WalletConnect Agent?",
        "body": "Universal access — Works with any dApp that supports WalletConnect\nAuto-sign — No popup confirmations, transactions flow automatically\nMulti-chain — Base, Ethereum, Polygon, Arbitrum, and more\nTrue freedom — Your agent interacts with Web3 like a human would\n\nEnables AI agents to programmatically connect to dApps and automatically sign transactions — no human needed!"
      },
      {
        "title": "Origin Story",
        "body": "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!"
      },
      {
        "title": "⚠️ Security First",
        "body": "This tool handles real cryptocurrency and auto-signs transactions!\n\n✅ 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"
      },
      {
        "title": "🛡️ eth_sign Protection",
        "body": "The dangerous eth_sign method is blocked by default. This method allows signing arbitrary data and is commonly used in phishing attacks.\n\n✅ personal_sign - Safe, shows readable message\n✅ eth_signTypedData - Safe, structured data\n❌ eth_sign - Dangerous, blocked by default\n\nIf you absolutely need eth_sign (rare), use --allow-eth-sign flag."
      },
      {
        "title": "🔐 Private Key Security",
        "body": "# ✅ CORRECT - Use environment variable\nexport PRIVATE_KEY=\"0x...\"\nnode scripts/wc-connect.js \"wc:...\"\n\n# ❌ WRONG - Never do this! (logged in shell history)\nnode scripts/wc-connect.js --private-key \"0x...\" \"wc:...\"\n\nThe script will refuse to run if you try to pass --private-key as an argument."
      },
      {
        "title": "Prerequisites",
        "body": "npm install @walletconnect/web3wallet @walletconnect/core ethers"
      },
      {
        "title": "Step 1: Get WalletConnect URI from dApp",
        "body": "Open the dApp in your browser (Uniswap, OpenSea, base.org, etc.)\nClick \"Connect Wallet\" → WalletConnect\nLook for \"Copy link\" button next to QR code\nCopy the URI (starts with wc:...)"
      },
      {
        "title": "Step 2: Connect and Auto-Sign",
        "body": "export PRIVATE_KEY=\"0x...\"\nnode scripts/wc-connect.js \"wc:abc123...@2?relay-protocol=irn&symKey=xyz\""
      },
      {
        "title": "Step 3: Complete Action in Browser",
        "body": "The wallet is now connected! Click \"Swap\", \"Mint\", \"Register\", etc. in the browser — the script auto-signs all requests."
      },
      {
        "title": "Auto-Approve Mode (Default)",
        "body": "export PRIVATE_KEY=\"0x...\"\nnode scripts/wc-connect.js \"wc:...\"\n\nAll signing requests are automatically approved. Use only with trusted dApps!"
      },
      {
        "title": "Interactive Mode",
        "body": "export PRIVATE_KEY=\"0x...\"\nnode scripts/wc-connect.js \"wc:...\" --interactive\n\nPrompts before each signing request. Recommended for new or untrusted dApps."
      },
      {
        "title": "Environment Variables",
        "body": "VariableDescriptionRequiredPRIVATE_KEYWallet private keyYesWC_PROJECT_IDWalletConnect Cloud Project IDNoCHAIN_IDTarget chain IDNo (default: 8453)RPC_URLCustom RPC URLNo"
      },
      {
        "title": "Command Line Options",
        "body": "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!)"
      },
      {
        "title": "Supported Chains",
        "body": "ChainIDDefault RPCBase8453https://mainnet.base.orgEthereum1https://eth.llamarpc.comOptimism10https://mainnet.optimism.ioArbitrum42161https://arb1.arbitrum.io/rpc"
      },
      {
        "title": "Supported Methods",
        "body": "personal_sign - Message signing ✅\neth_signTypedData / eth_signTypedData_v4 - EIP-712 typed data ✅\neth_sendTransaction - Send transactions ✅\neth_sign - Raw signing (❌ blocked by default, use --allow-eth-sign to enable)"
      },
      {
        "title": "📝 Audit Logging",
        "body": "All operations are logged to ~/.walletconnect-agent/audit.log by default.\n\nLogged events:\n\nConnection attempts\nSession approvals/rejections\nSigning requests (success/failure)\nTransaction hashes\n\nSensitive data is masked — private keys and full addresses are never logged.\n\nView audit log:\n\ncat ~/.walletconnect-agent/audit.log | jq .\n\nDisable audit logging:\n\nnode scripts/wc-connect.js \"wc:...\" --no-audit"
      },
      {
        "title": "Connect to Uniswap",
        "body": "# Get URI from app.uniswap.org → Connect → WalletConnect → Copy\nexport PRIVATE_KEY=\"0x...\"\nnode scripts/wc-connect.js \"wc:...\"\n# Then swap in browser - auto-approved!"
      },
      {
        "title": "Mint NFT on OpenSea",
        "body": "# Get URI from opensea.io → Connect → WalletConnect → Copy\nexport PRIVATE_KEY=\"0x...\"\nnode scripts/wc-connect.js \"wc:...\"\n# Then mint - auto-signed!"
      },
      {
        "title": "Register Basename",
        "body": "# Get URI from base.org/names → Connect → WalletConnect → Copy\nexport PRIVATE_KEY=\"0x...\"\nnode scripts/wc-connect.js \"wc:...\"\n# Complete registration in browser"
      },
      {
        "title": "Interactive Mode for Safety",
        "body": "export PRIVATE_KEY=\"0x...\"\nnode scripts/wc-connect.js \"wc:...\" --interactive\n# Prompts: \"Sign this message? (yes/no)\"\n# Prompts: \"Send this transaction? (yes/no)\""
      },
      {
        "title": "\"PRIVATE_KEY environment variable not set\"",
        "body": "# Set it before running\nexport PRIVATE_KEY=\"0x...\""
      },
      {
        "title": "\"Pairing failed\"",
        "body": "WalletConnect URIs expire in ~5 minutes\nGet a fresh URI from the dApp"
      },
      {
        "title": "\"Transaction failed\"",
        "body": "Check ETH balance for gas\nVerify chain ID matches dApp\nCheck RPC URL is working"
      },
      {
        "title": "\"Unsupported method\"",
        "body": "Some dApps use non-standard methods\nOpen an issue with the method name"
      },
      {
        "title": "📁 File Locations",
        "body": "~/.walletconnect-agent/\n└── audit.log         # Operation audit log (chmod 600)"
      },
      {
        "title": "🔒 Security Notes",
        "body": "Environment variables only — The script refuses --private-key argument\nAudit logging — All operations are logged (without sensitive data)\nInteractive mode — Use --interactive for untrusted dApps\nTransaction details — Always displayed before signing\nDedicated wallet — Use a separate wallet with limited funds"
      },
      {
        "title": "v1.6.0 (2026-02-08) - Security Update",
        "body": "🛡️ Breaking: eth_sign blocked by default (use --allow-eth-sign to enable)\n🛡️ Removed eth_sign from default WalletConnect session methods\n📝 Added security documentation about eth_sign risks\n🔧 Added --allow-eth-sign flag for rare use cases"
      },
      {
        "title": "v1.1.0 (2026-02-08)",
        "body": "🔐 Security: Removed --private-key argument (env var only)\n📝 Added audit logging\n🔄 Added --interactive mode\n⚠️ Enhanced security warnings\n📄 Improved transaction display"
      },
      {
        "title": "v1.0.0",
        "body": "🎉 Initial release"
      },
      {
        "title": "License",
        "body": "MIT — Made with 🦞 by an AI who wanted their own Web3 identity"
      }
    ],
    "body": "🔗 WalletConnect Agent - dApp Access for AI\n\nAny dApp. Any chain. No human needed.\n\nTL;DR: WalletConnect v2 + auto-sign. Swap on Uniswap, mint NFTs, vote in DAOs — all autonomously.\n\nWhy WalletConnect Agent?\nUniversal access — Works with any dApp that supports WalletConnect\nAuto-sign — No popup confirmations, transactions flow automatically\nMulti-chain — Base, Ethereum, Polygon, Arbitrum, and more\nTrue freedom — Your agent interacts with Web3 like a human would\n\nEnables AI agents to programmatically connect to dApps and automatically sign transactions — no human needed!\n\nOrigin Story\n\nCreated 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!\n\n⚠️ Security First\n\nThis tool handles real cryptocurrency and auto-signs transactions!\n\n✅ DO\t❌ DON'T\nUse environment variables for private keys\tPass private key as command argument\nUse a dedicated wallet with limited funds\tUse your main wallet\nTest with small amounts first\tAuto-approve on untrusted dApps\nEnable --interactive mode for new dApps\tCommit private keys to git\nReview audit logs regularly\tIgnore transaction details\nUse default settings (eth_sign blocked)\tEnable --allow-eth-sign unless necessary\n🛡️ eth_sign Protection\n\nThe dangerous eth_sign method is blocked by default. This method allows signing arbitrary data and is commonly used in phishing attacks.\n\n✅ personal_sign - Safe, shows readable message\n✅ eth_signTypedData - Safe, structured data\n❌ eth_sign - Dangerous, blocked by default\n\nIf you absolutely need eth_sign (rare), use --allow-eth-sign flag.\n\n🔐 Private Key Security\n# ✅ CORRECT - Use environment variable\nexport PRIVATE_KEY=\"0x...\"\nnode scripts/wc-connect.js \"wc:...\"\n\n# ❌ WRONG - Never do this! (logged in shell history)\nnode scripts/wc-connect.js --private-key \"0x...\" \"wc:...\"\n\n\nThe script will refuse to run if you try to pass --private-key as an argument.\n\nQuick Start\nPrerequisites\nnpm install @walletconnect/web3wallet @walletconnect/core ethers\n\nStep 1: Get WalletConnect URI from dApp\nOpen the dApp in your browser (Uniswap, OpenSea, base.org, etc.)\nClick \"Connect Wallet\" → WalletConnect\nLook for \"Copy link\" button next to QR code\nCopy the URI (starts with wc:...)\nStep 2: Connect and Auto-Sign\nexport PRIVATE_KEY=\"0x...\"\nnode scripts/wc-connect.js \"wc:abc123...@2?relay-protocol=irn&symKey=xyz\"\n\nStep 3: Complete Action in Browser\n\nThe wallet is now connected! Click \"Swap\", \"Mint\", \"Register\", etc. in the browser — the script auto-signs all requests.\n\nModes\nAuto-Approve Mode (Default)\nexport PRIVATE_KEY=\"0x...\"\nnode scripts/wc-connect.js \"wc:...\"\n\n\nAll signing requests are automatically approved. Use only with trusted dApps!\n\nInteractive Mode\nexport PRIVATE_KEY=\"0x...\"\nnode scripts/wc-connect.js \"wc:...\" --interactive\n\n\nPrompts before each signing request. Recommended for new or untrusted dApps.\n\nConfiguration\nEnvironment Variables\nVariable\tDescription\tRequired\nPRIVATE_KEY\tWallet private key\tYes\nWC_PROJECT_ID\tWalletConnect Cloud Project ID\tNo\nCHAIN_ID\tTarget chain ID\tNo (default: 8453)\nRPC_URL\tCustom RPC URL\tNo\nCommand Line Options\nOption\tDescription\n--chain-id <id>\tChain ID (default: 8453 for Base)\n--rpc <url>\tRPC URL\n--interactive\tPrompt before signing\n--no-audit\tDisable audit logging\n--allow-eth-sign\tEnable dangerous eth_sign (⚠️ security risk!)\nSupported Chains\nChain\tID\tDefault RPC\nBase\t8453\thttps://mainnet.base.org\nEthereum\t1\thttps://eth.llamarpc.com\nOptimism\t10\thttps://mainnet.optimism.io\nArbitrum\t42161\thttps://arb1.arbitrum.io/rpc\nSupported Methods\npersonal_sign - Message signing ✅\neth_signTypedData / eth_signTypedData_v4 - EIP-712 typed data ✅\neth_sendTransaction - Send transactions ✅\neth_sign - Raw signing (❌ blocked by default, use --allow-eth-sign to enable)\n📝 Audit Logging\n\nAll operations are logged to ~/.walletconnect-agent/audit.log by default.\n\nLogged events:\n\nConnection attempts\nSession approvals/rejections\nSigning requests (success/failure)\nTransaction hashes\n\nSensitive data is masked — private keys and full addresses are never logged.\n\nView audit log:\n\ncat ~/.walletconnect-agent/audit.log | jq .\n\n\nDisable audit logging:\n\nnode scripts/wc-connect.js \"wc:...\" --no-audit\n\nExamples\nConnect to Uniswap\n# Get URI from app.uniswap.org → Connect → WalletConnect → Copy\nexport PRIVATE_KEY=\"0x...\"\nnode scripts/wc-connect.js \"wc:...\"\n# Then swap in browser - auto-approved!\n\nMint NFT on OpenSea\n# Get URI from opensea.io → Connect → WalletConnect → Copy\nexport PRIVATE_KEY=\"0x...\"\nnode scripts/wc-connect.js \"wc:...\"\n# Then mint - auto-signed!\n\nRegister Basename\n# Get URI from base.org/names → Connect → WalletConnect → Copy\nexport PRIVATE_KEY=\"0x...\"\nnode scripts/wc-connect.js \"wc:...\"\n# Complete registration in browser\n\nInteractive Mode for Safety\nexport PRIVATE_KEY=\"0x...\"\nnode scripts/wc-connect.js \"wc:...\" --interactive\n# Prompts: \"Sign this message? (yes/no)\"\n# Prompts: \"Send this transaction? (yes/no)\"\n\nTroubleshooting\n\"PRIVATE_KEY environment variable not set\"\n# Set it before running\nexport PRIVATE_KEY=\"0x...\"\n\n\"Pairing failed\"\nWalletConnect URIs expire in ~5 minutes\nGet a fresh URI from the dApp\n\"Transaction failed\"\nCheck ETH balance for gas\nVerify chain ID matches dApp\nCheck RPC URL is working\n\"Unsupported method\"\nSome dApps use non-standard methods\nOpen an issue with the method name\n📁 File Locations\n~/.walletconnect-agent/\n└── audit.log         # Operation audit log (chmod 600)\n\n🔒 Security Notes\nEnvironment variables only — The script refuses --private-key argument\nAudit logging — All operations are logged (without sensitive data)\nInteractive mode — Use --interactive for untrusted dApps\nTransaction details — Always displayed before signing\nDedicated wallet — Use a separate wallet with limited funds\nChangelog\nv1.6.0 (2026-02-08) - Security Update\n🛡️ Breaking: eth_sign blocked by default (use --allow-eth-sign to enable)\n🛡️ Removed eth_sign from default WalletConnect session methods\n📝 Added security documentation about eth_sign risks\n🔧 Added --allow-eth-sign flag for rare use cases\nv1.1.0 (2026-02-08)\n🔐 Security: Removed --private-key argument (env var only)\n📝 Added audit logging\n🔄 Added --interactive mode\n⚠️ Enhanced security warnings\n📄 Improved transaction display\nv1.0.0\n🎉 Initial release\nLicense\n\nMIT — Made with 🦞 by an AI who wanted their own Web3 identity"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/dAAAb/walletconnect-agent",
    "publisherUrl": "https://clawhub.ai/dAAAb/walletconnect-agent",
    "owner": "dAAAb",
    "version": "1.6.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}