web-test-wallet-sign

Wallet Sign

Handle MetaMask signature requests and transaction popups during Web3 DApp testing.

When to Use This Skill

• During web-test execution when MetaMask popup appears
• When DApp requests signature (personal_sign, signTypedData)
• When DApp sends transaction (eth_sendTransaction)
• When DApp calls contract (write operations)

Prerequisites

1. web-test-wallet-setup completed
2. web-test-wallet-connect completed (wallet connected to DApp)
3. Browser session active with wallet

Quick Start

SKILL_DIR="<path-to-this-skill>"

# Handle any MetaMask popup (auto-detects type)
node $SKILL_DIR/scripts/wallet-sign-helper.js wallet-sign --wallet --headed --keep-open

Popup Types

1. Sign Message (personal_sign)

• Action: Auto-approve
• Risk: Low (read-only, no gas)
• Result: Always succeeds

2. Sign Typed Data (signTypedData_v4)

• Action: Auto-approve
• Risk: Low (read-only, no gas)
• Result: Always succeeds

3. Send Transaction (eth_sendTransaction)

• Action: Check gas, then approve/reject
• Risk: Medium (costs gas, transfers value)
• Result: Fails if insufficient gas

4. Contract Call (write operations)

• Action: Check gas, then approve/reject
• Risk: Medium (costs gas)
• Result: Fails if insufficient gas

Instructions

Detect and Handle Popup

SKILL_DIR="<path-to-this-skill>"

# Auto-detect popup type and handle appropriately
node $SKILL_DIR/scripts/wallet-sign-helper.js wallet-sign --wallet --headed --keep-open

Output for Signature:

{
  "success": true,
  "type": "signature",
  "subtype": "personal_sign",
  "action": "approved",
  "message": "Signature request approved"
}

Output for Transaction (success):

{
  "success": true,
  "type": "transaction",
  "action": "approved",
  "txHash": "0x...",
  "message": "Transaction sent successfully"
}

Output for Transaction (gas error):

{
  "success": false,
  "type": "transaction",
  "action": "failed",
  "error": "insufficient_gas",
  "message": "Transaction failed: insufficient funds for gas"
}