# WaaP (Wallet as a Protocol) Documentation

> WaaP is a non-custodial Web3 wallet by human.tech that uses Two-Party Computation (2PC) to eliminate single points of failure. It provides 1-click onboarding via email, phone, or social login, EIP-1193 compatibility, and works across all dApps. WaaP is available as an SDK (`@human.tech/waap-sdk`) for browser-based dApps and a CLI (`@human.tech/waap-cli`) for AI agents and scripts.

## Getting Started

- [What is WaaP?](https://docs.waap.xyz/): Product overview — 2PC security, seamless UX, cross-dapp compatibility, Apps vs Agents paths
- [WaaP for Apps](https://docs.waap.xyz/for-apps): SDK quick start — integrate WaaP into a dApp in under 5 minutes (EVM and Sui)
- [WaaP for Agents](https://docs.waap.xyz/for-agents): CLI quick start — programmatic wallet access for AI agents and scripts
- [Starter Agents](https://docs.waap.xyz/starter-agents): Pre-built agent configurations you can launch in minutes
- [Playground](https://docs.waap.xyz/playground): Interactive playground for configuring WaaP initialization with live code generation
- [Support](https://docs.waap.xyz/support): Developer support channels (Telegram, Discord) and FAQ

## WaaP for Apps (SDK)

- [Quick Start](https://docs.waap.xyz/for-apps/start): Integrate WaaP with EVM chains (Ethereum, Polygon, Base, etc.) or Sui — tabbed guide
- [Sign Messages](https://docs.waap.xyz/for-apps/sign): Sign arbitrary messages (EVM personal_sign, Sui signPersonalMessage) and EIP-712 typed data
- [Transactions](https://docs.waap.xyz/for-apps/tx): Send transactions on EVM and Sui, async transactions
- [Styling](https://docs.waap.xyz/for-apps/style): Style the WaaP wallet modal with CSS and dark mode
- [EVM Methods](https://docs.waap.xyz/for-apps/methods/evm): EVM SDK method reference — initWaaP, login, logout, request, requestEmail, requestSBT, events
- [Sui Methods](https://docs.waap.xyz/for-apps/methods/sui): Sui SDK method reference — Wallet Standard features, dapp-kit hooks, requestEmail
- [Permission Tokens](https://docs.waap.xyz/for-apps/permission-token): Pre-approved transaction scopes for seamless dApp UX (EVM)

### EVM Guides

- [EVM Quick Start](https://docs.waap.xyz/for-apps/evm): Integrate WaaP into an EVM dApp — install, initialize, connect with wagmi or ethers
- [EVM Sign Messages](https://docs.waap.xyz/for-apps/evm/sign): Sign messages and typed data on EVM chains
- [EVM Transactions](https://docs.waap.xyz/for-apps/evm/tx): Send transactions on EVM chains
- [EVM Methods](https://docs.waap.xyz/for-apps/evm/methods): EVM-specific SDK method reference
- [EVM Permission Tokens](https://docs.waap.xyz/for-apps/evm/permission-token): Permission Tokens on EVM chains
- [EVM Styling](https://docs.waap.xyz/for-apps/evm/style): Style WaaP modal for EVM integrations

### Sui Guides

- [Sui Quick Start](https://docs.waap.xyz/for-apps/sui): Integrate WaaP into a Sui dApp — install, initialize, connect with dapp-kit
- [Sui Sign Messages](https://docs.waap.xyz/for-apps/sui/sign): Sign messages on Sui
- [Sui Transactions](https://docs.waap.xyz/for-apps/sui/tx): Send transactions on Sui
- [Sui Methods](https://docs.waap.xyz/for-apps/sui/methods): Sui-specific SDK method reference
- [Sui Styling](https://docs.waap.xyz/for-apps/sui/style): Style WaaP modal for Sui integrations

### Switch to WaaP (Apps)

- [WaaP vs Privy](https://docs.waap.xyz/for-apps/switch-to-waap/waap-vs-privy): Side-by-side comparison of WaaP and Privy — architecture, pricing, features, and migration support
- [Migrating from Privy](https://docs.waap.xyz/for-apps/switch-to-waap/migrating-from-privy): Step-by-step migration guide from Privy embedded wallets to WaaP with account pregeneration

## WaaP for Agents (CLI)

- [CLI Commands](https://docs.waap.xyz/for-agents/commands): Full command reference — signup, login, sign, send-tx, policy, 2fa
- [Agent Patterns](https://docs.waap.xyz/for-agents/patterns): 2FA flows, risk levels, session management, RPC auto-resolution

### Switch to WaaP (Agents)

- [WaaP vs Privy Server Wallets](https://docs.waap.xyz/for-agents/switch-to-waap/waap-vs-privy-server-wallets): Comparison of WaaP CLI and Privy server-side wallets for agent use cases
- [WaaP vs Coinbase Agent Wallets](https://docs.waap.xyz/for-agents/switch-to-waap/waap-vs-coinbase-agent-wallets): Comparison of WaaP CLI and Coinbase Agent Wallets

## Starter Agents

- [Starter Agents](https://docs.waap.xyz/starter-agents): Pre-built agent configurations and templates you can launch in minutes

## SDK & CLI Reference

- [SDK & CLI Reference](https://docs.waap.xyz/sdk-cli-reference): Side-by-side tabbed comparison of SDK and CLI for common operations

## Supported Networks

- [EVM Networks](https://docs.waap.xyz/networks/evm): Supported EVM chains list and how to add custom chains via EIP-3085
- [Sui Networks](https://docs.waap.xyz/networks/sui): Supported Sui networks and switching between them

## Overview

### Features

- [Features Overview](https://docs.waap.xyz/overview/features): Permission Tokens, Async Transactions
- [Permission Tokens](https://docs.waap.xyz/overview/features/permission-tokens): Pre-approved transaction scopes for seamless UX (SDK and CLI)
- [Async Transactions](https://docs.waap.xyz/overview/features/async-transactions): Non-blocking transaction flow with event-driven status updates

### Architecture & Security

- [Core Architecture](https://docs.waap.xyz/overview/architecture-security-model/architecture): 2PC architecture — Sovereign Share, Security Share, TEE
- [Compared to WaaS](https://docs.waap.xyz/overview/architecture-security-model/compared-to-waas): Feature comparison between WaaP and Wallet-as-a-Service
- [Malware Resistance](https://docs.waap.xyz/overview/architecture-security-model/malware-resistance): How 2PC protects against compromised servers, devices, and networks
- [Blind Signing Resistance](https://docs.waap.xyz/overview/architecture-security-model/blind-signing-resistance): Transaction simulation and secure device communication channels
- [Audits & Security Partners](https://docs.waap.xyz/overview/architecture-security-model/audit-reports): Security audits (Cure53, Hexens, Least Authority, Halborn) and architecture consultants

### Recipes

- [Recipes Index](https://docs.waap.xyz/recipes): Filterable index of all recipes by use case (Apps / Agents)
- [Stablecoins](https://docs.waap.xyz/recipes/stablecoins): Send, receive, and manage USDC with WaaP and wagmi
- [Token Swapping](https://docs.waap.xyz/recipes/swap): Token swap recipe using Uniswap
- [DeFi Yield](https://docs.waap.xyz/recipes/yield): Earn yield on stablecoins using Aave V3 lending markets
- [Human Passport](https://docs.waap.xyz/recipes/human-passport): WaaP + Human Passport identity verification integration
- [Smart Accounts](https://docs.waap.xyz/recipes/smart-accounts): ERC-4337 smart accounts with Permissionless.js
- [WalletConnect](https://docs.waap.xyz/recipes/walletconnect): Reown WalletKit integration for browser wallets
- [Polymarket Agent](https://docs.waap.xyz/recipes/waap-cli-polymarket-agent): Build an autonomous Polymarket trading agent with WaaP CLI
- [DAO Governance Agent](https://docs.waap.xyz/recipes/waap-cli-snapshot-agent): Build an autonomous Snapshot voting agent with WaaP CLI
- [Upcoming Recipes](https://docs.waap.xyz/recipes/upcoming): Planned recipes and integration examples

### Other

- [Code Examples](https://docs.waap.xyz/overview/examples): Real-world WaaP integration examples and templates
- [Quick Demo](https://docs.waap.xyz/overview/quick-demo): Interactive demo of WaaP wallet features embedded in the docs

## Key Technical Details

- **SDK package**: `@human.tech/waap-sdk` (npm)
- **CLI package**: `@human.tech/waap-cli` (npm)
- **SDK entry point**: `initWaaP()` — initializes the SDK and sets up `window.waap`
- **CLI entry point**: `waap-cli signup` / `waap-cli login` — creates session at `~/.waap-cli/session.json`
- **Provider interface**: EIP-1193 compliant via `window.waap.request()` (SDK) or `waap-cli request` (CLI)
- **Authentication methods**: email, phone, social (Google, Twitter, Discord, LinkedIn, Apple, Coinbase, GitHub), wallet (injected, WalletConnect)
- **Supported EVM mainnets**: Ethereum, Optimism, Gnosis, Polygon, Fantom, zkSync, Shape, Base, Arbitrum One, Celo, Avalanche, Linea, Scroll, Aurora
- **Supported EVM testnets**: Ethereum Sepolia, Optimism Sepolia, Base Sepolia, Polygon Amoy, Optimism Goerli
- **Supported Sui networks**: mainnet, testnet, devnet
- **Security model**: 2PC — Sovereign Share (user, via Human Network) + Security Share (TEE)
- **Policy controls (CLI)**: Daily spend limits (0–$10,000), risk-based 2FA triggers, Permission Tokens for autonomous flows
- **2FA methods (CLI)**: Email, phone, Telegram, external hardware wallet
- **SDK integrations**: wagmi, ethers.js v6, viem, @mysten/dapp-kit, or direct `window.waap` usage
- **Agent integrations**: skills.sh compatible, works with Claude, Cursor, Copilot