web-test-wallet-sign

Automate MetaMask signature and transaction popups during Web3 DApp testing.

1|Updated Dec 22, 2025
One-click install
npx skills add https://github.com/automata-network/agent-skills --skill web-test-wallet-sign
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web-test-wallet-sign
Source: https://github.com/automata-network/agent-skills/tree/main/web-test-wallet-sign
Command: npx skills add https://github.com/automata-network/agent-skills --skill web-test-wallet-sign

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires playwright, and includes scripts (resource) components.

What problem does it solve?

This Skill automates MetaMask signature requests and wallet popups during Web3 DApp testing, reducing manual intervention and test flakiness.

Core Features & Use Cases

  • Automatic popup detection: Auto-detects signature, transaction, and connect popups from MetaMask and handles them accordingly.
  • Gas-aware transactions: Checks gas beforehand and approves only when funds are sufficient; surfaces gas errors for test failures.
  • Deterministic results: Outputs structured JSON logs and optional screenshots for debugging.

Quick Start

Use the web-test-wallet-sign skill to automatically handle MetaMask popups during your web3 tests.

  • Prepare your test environment with wallet installed and connected.
  • Run:
  • SKILL_DIR="<path-to-this-skill>"
  • node $SKILL_DIR/scripts/wallet-sign-helper.js wallet-sign --wallet --headed --keep-open

Frequently Asked Questions about web-test-wallet-sign

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate MetaMask popups during Web3 testing?

Automate MetaMask popups by using a wallet-sign helper that detects and handles signature requests, transactions, and connect prompts automatically. The Skill intercepts popup types, validates gas availability, and approves or rejects based on test conditions, eliminating manual intervention and reducing test flakiness.

Can I use Playwright to test Web3 DApps with MetaMask?

Yes. Playwright combined with wallet-sign automation handles MetaMask interactions during Web3 DApp testing. The Skill uses Playwright to detect popups, perform gas checks, and auto-approve transactions, producing structured JSON logs and screenshots for debugging test failures.

What types of MetaMask requests can be automated?

The Skill automates personal_sign and signTypedData signature requests, eth_sendTransaction transaction approvals, and contract call popups. Each request type is auto-detected, validated for sufficient funds, and approved or rejected to ensure deterministic and consistent test results.

How do I set up a test environment for automated wallet signing?

Prepare your test environment by installing MetaMask, connecting a wallet, and specifying the Skill directory path. Then run the wallet-sign-helper script with the --wallet, --headed, and --keep-open flags to initialize popup automation during web3 test execution.

Does wallet automation handle gas validation before approving transactions?

Yes. The Skill checks gas availability before approving any transaction and surfaces gas errors when funds are insufficient. This gas-aware logic ensures only valid transactions proceed, preventing failed tests due to insufficient balance and enabling clear error reporting.

What output does the wallet-sign automation produce?

The Skill produces structured JSON logs capturing popup types, approval decisions, and transaction results. Optional screenshots document each interaction step, providing comprehensive debugging data to diagnose test failures and validate wallet behavior during Web3 DApp testing.