walletconnect-requester

What This Skill Does

The walletconnect-requester skill serves as a secure bridge between your AI agent and the user's Web3 wallet. Unlike traditional custodial integrations, this skill operates as a Proposer within the WalletConnect v2 protocol. It enables your AI agent to initiate transaction requests and cryptographic signature prompts directly to the user's mobile or browser wallet. The core philosophy of this tool is zero-custody; the agent acts strictly as a messenger that proposes actions, leaving the final authorization, private key management, and transaction signing strictly within the secure confines of the user's wallet application. This ensures that even if the AI environment were compromised, the user's assets remain untouched and secure because no private keys ever touch the agent's memory or persistent storage.

Installation

To integrate this skill into your agent, follow these steps:

1. Ensure Node.js is installed on your system.
2. Execute clawhub install openclaw/skills/skills/bevanding/walletconnect-requester to bring the package into your environment.
3. Install the peer dependencies via npm: npm install @walletconnect/sign-client @walletconnect/core qrcode.
4. Obtain a Project ID from WalletConnect Cloud.
5. Export your identifier using export WC_PROJECT_ID="your_project_id_here".
6. Initialize the session using node scripts/wc-requester.js connect and present the generated QR code to the user.

Use Cases

• DeFi Portfolio Management: Instruct the agent to propose swaps or yield farming deposits, requiring user confirmation for every move.
• NFT Marketplace Interaction: Allow the agent to draft buy or list transactions for specific collections.
• Web3 Identity Authentication: Use the agent to request signatures for off-chain login proofs (e.g., Sign-In with Ethereum).
• Secure DApp Testing: Developers can use this to automate testing flows while maintaining a non-custodial development environment.

Example Prompts

1. "Open the WalletConnect session and ask me to sign a transaction to swap 0.1 ETH for USDC on Uniswap."
2. "I need to list this NFT on OpenSea; use the walletconnect-requester to generate the transaction request for me to approve."
3. "Connect to my wallet and request a message signature for the login prompt on this governance portal."

Tips & Limitations

• User Presence Required: This skill cannot perform background operations; the user must be physically present to approve every request on their device.
• Connection Persistence: Ensure your agent process remains active; if the process terminates, the session bridge may expire and require re-connection.
• Security Best Practice: Always verify the transaction details displayed in your wallet UI before hitting approve, regardless of what the AI agent tells you.