\n\n#### 1. Download wallets\n\n```sh\nnpx w3wallets metamask polkadotjs\n```\n\nShort aliases are also supported:\n\n```sh\nnpx w3wallets mm pjs\n```\n\nThe unzipped files are stored in the `.w3wallets/` directory. Add `.w3wallets` to `.gitignore`.\n\n\nCLI Options\n\n```\nUSAGE:\n npx w3wallets [OPTIONS] \n\nTARGETS:\n Alias name Known wallet alias (metamask, polkadotjs)\n Short alias Short form (mm, pjs)\n Extension ID 32-character Chrome extension ID\n URL Chrome Web Store URL\n\nOPTIONS:\n -h, --help Show help message\n -l, --list List available wallet aliases\n -o, --output Output directory (default: .w3wallets)\n -f, --force Force re-download even if already exists\n --debug Save raw .crx file for debugging\n\nEXAMPLES:\n npx w3wallets metamask # Download MetaMask\n npx w3wallets mm pjs # Download all wallets (short)\n npx w3wallets --list # List available aliases\n npx w3wallets -o ./extensions metamask # Custom output directory\n npx w3wallets --force mm # Force re-download\n```\n\n\n\n#### 2. Wrap your fixture with `withWallets`\n\nInstall the required wallets into Chromium using `withWallets`.\n\n```ts\n// your-fixture.ts\nimport { withWallets, metamask, polkadotJS } from \"w3wallets\";\nimport { test as base } from \"@playwright/test\";\n\nexport const test = withWallets(base, metamask, polkadotJS);\n\nexport { expect } from \"@playwright/test\";\n```\n\n#### 3. Use the installed wallets in tests\n\nMost commonly, you will use the following methods:\n\n1. `onboard`: to set up your wallet\n2. `approve`: for operations that confirm actions\n3. `deny`: for actions that reject or cancel operations\n\n```ts\nimport { test, expect } from \"./your-fixture\";\n\ntest(\"Can connect MetaMask to dApp\", async ({ page, metamask }) => {\n const mnemonic =\n \"set your seed phrase test test test test test test test junk\";\n\n await metamask.onboard(mnemonic);\n await page.goto(\"https://your-dapp.com\");\n\n await page.getByRole(\"button\", { name: \"Connect Wallet\" }).click();\n await metamask.approve();\n\n await expect(page.getByText(\"Connected\")).toBeVisible();\n});\n```\n\n## Caching\n\nWallet onboarding can be slow. Caching lets you run the setup once and reuse the browser profile across tests.\n\n#### 1. Create a setup file\n\nCreate a `*.cache.ts` file in a `wallets-cache/` directory (default):\n\n```ts\n// wallets-cache/default.cache.ts\nimport { prepareWallet, metamask } from \"w3wallets\";\n\nexport default prepareWallet(metamask, async (wallet, page) => {\n await wallet.onboard(\"your seed phrase ...\", \"YourPassword123!\");\n});\n```\n\n#### 2. Build the cache\n\n```sh\nnpx w3wallets cache\n```\n\n\nCLI Options\n\n```\nUSAGE:\n npx w3wallets cache [OPTIONS] [directory]\n\nOPTIONS:\n -f, --force Force rebuild even if cache exists\n --headed Run browser in headed mode\n directory Directory containing *.cache.{ts,js} files (default: ./wallets-cache/)\n```\n\n\n\nThe cached profiles are stored in `.w3wallets/cache/`. The `.w3wallets` directory should already be in `.gitignore`.\n\n#### 3. Use cached wallets in tests\n\nImport the setup and pass it to `withWallets`:\n\n```ts\nimport { test as base, expect } from \"@playwright/test\";\nimport { withWallets } from \"w3wallets\";\nimport cachedMetamask from \"./wallets-cache/default.cache\";\n\nconst test = withWallets(base, cachedMetamask);\n\ntest(\"wallet is ready\", async ({ metamask }) => {\n await metamask.unlock(\"YourPassword123!\");\n // wallet is already onboarded\n});\n```\n\n> **Note:** All wallets in a test must be either all cached or all non-cached.\n\n## Configuration\n\nConfigure library behavior via environment variables:\n\n| Variable | Description | Default |\n| -------------------------- | ------------------------------------------------------------------------- | ----------- |\n| `W3WALLETS_ACTION_TIMEOUT` | Timeout (ms) for all wallet actions (click, fill, navigation, assertions) | `undefined` |\n\nExample:\n\n```sh\n# In .env or CI environment\nW3WALLETS_ACTION_TIMEOUT=60000\n```\n\nThis only affects w3wallets library code. Your own Playwright configuration remains independent.\n","readmeFilename":"README.md"}
![\"Metamask](\"https://images.ctfassets.net/clixtyxoaeas/1ezuBGezqfIeifWdVtwU4c/d970d4cdf13b163efddddd5709164d2e/MetaMask-icon-Fox.svg\"){kind=icon}
\n ![\"Polkadot](\"https://polkadot.js.org/logo.svg\"){kind=logo}
\n