WebWallet

WebWallet is a Vite + React app that gives you a stand-alone blockchain wallet in your web browser.

Getting Started

1. Run nvm install once if needed, then nvm use to switch to the pinned Node version from .nvmrc.
2. Install dependencies with npm ci.
3. Create a local env file with cp .env.development.example .env.development.
4. Start the app with npm run dev.

Development Environment

.env.development is intentionally ignored by Git so local values stay on your machine. Commit changes to .env.development.example when the set of supported variables changes.

Current development env variables:

• VITE_MOCK_PASSKEY=true enables the mock passkey flow.
• VITE_MOCK_PRIVATE_KEY= is optional. Leave it blank to generate a random mock private key at startup.
• VITE_SEPOLIA_BUNDLER_URL= is optional. Point it at a Pimlico-compatible Sepolia RPC if you want to pay gas in ERC-20 tokens like USDC.

When VITE_MOCK_PRIVATE_KEY is not set, the app prints a generated value to the browser console in a copy-pasteable format so it can be added back to .env.development and reused across restarts.

Scripts

• npm run dev starts the Vite dev server.
• npm run build creates a production build.
• npm run lint runs ESLint.
• npm run test runs the test suite once.