Introduction

web3market-kit

A CLI toolkit for scaffolding, developing, and deploying Solidity dApps. Handles project setup, contract compilation, code generation, React hook generation, and deployment to EVM chains.

npm install -g @web3marketlabs/cli

Then scaffold a project:

w3m new my-project --template token-standard

Documentation

Overview

web3market-kit is a monorepo with 9 packages organized into four layers:

Layer 1: Shared Configuration

PackageDescription
@web3marketlabs/tsconfigShared TypeScript configuration

Layer 2: Core Libraries

PackageDescription
@web3marketlabs/sdkChain definitions, ABI utilities, Viem client factories, type exports
@web3marketlabs/configConfiguration loader and Zod schema for kit.config.ts
@web3marketlabs/codegenTypeScript binding and React hook generation from compiled contracts
@web3marketlabs/apiHono API server — authentication, templates, deployment preflight, AI endpoints

Layer 3: Feature Packages

PackageDescription
@web3marketlabs/componentsComponent registry (token) with Handlebars templates
@web3marketlabs/reactReact components (KitProvider, ConnectButton, TransactionButton)

Layer 4: CLI

PackageDescription
@web3marketlabs/cliCLI binary (w3m) — new, auth, add, dev, test, deploy, generate, templates, audit
@web3marketlabs/create-web3-dappnpx @web3marketlabs/create-web3-dapp — runs w3m new under the hood

What Works Without Authentication

All local development features work without authentication:

  • w3m new — Create projects from templates or interactively
  • w3m dev — Start Anvil + deploy + frontend dev server
  • w3m test — Run contract and TypeScript tests
  • w3m audit — Run Slither security analysis
  • w3m — Interactive workspace menu
  • Local deployment — Deploy to Anvil from the workspace menu

Authentication is only required for deploying to testnets and mainnets (w3m deploy --chain <chain>), browsing templates (w3m templates), and marketplace publishing (w3m publish).

Supported Chains

ChainChain IDType
Ethereum1Mainnet
Sepolia11155111Testnet
Arbitrum One42161Mainnet
Arbitrum Sepolia421614Testnet
Base8453Mainnet
Base Sepolia84532Testnet
Polygon137Mainnet
Polygon Amoy80002Testnet
Optimism10Mainnet
Optimism Sepolia11155420Testnet
Anvil (local)31337Local

Requirements

  • Node.js 20+
  • Foundry (recommended) for smart contract compilation, testing, and deployment
  • Package manager: pnpm (recommended), npm, yarn, or bun