ZKGate Docs

← HOME

OVERVIEW

ZKGate is a privacy-first ecosystem for zero-knowledge cryptography. It provides a unified interface for managing private transactions, API tokens, wallets, and ZK proof generation across multiple blockchain networks.

Built with Next.js 16, React 19, and TypeScript. Features a brutalist CLI-inspired terminal with 40+ commands and advanced ZK primitives.

GETTING STARTED

Login

Navigate to the ecosystem and log in with any username. A unique ZK ID and wallet address are generated deterministically from your credentials.

Supported Chains

Solana (SOL) • Ethereum (ETH) • Base (BASE) • BSC (BSC) • Starknet (STARKNET) • Zcash (ZEC)

MODULES

API TOKENS

Generate and manage API tokens for programmatic access. Each token includes usage metrics and revocation controls.

WALLET

Create, import, and manage wallets across multiple chains. Switch between wallets, backup seeds, and track balances.

POOL

Manage liquidity pools, deposit/withdraw funds, and generate ZK proofs for privacy-preserving transactions.

LAUNCHPAD

Discover and participate in token launches. Track hot tokens and recent launches across the ecosystem.

DEX

Swap tokens with route optimization. Get quotes, compare routes, and execute swaps with minimal slippage.

SDK / API

Integrate ZKGate into your application. Browse SDK documentation, generate code snippets (JS/cURL/REST), and view integration logs.

TERMINAL

Advanced CLI interface with 40+ commands. Manage sessions, wallets, pools, tokens, and execute ZK operations programmatically.

TERMINAL COMMANDS

help — Show all available commands
clear — Clear terminal output
zk connect — Initialize ZKGate connection
zk wallet list — List all wallets
zk wallet create — Create new wallet on default chain
zk pool list — List all liquidity pools
zk pool prove --pool <name> — Generate ZK proof for pool
zk dex quote --from SOL --to ETH --amount 100 — Get swap quote
zk api token list — List API tokens
zk sdk info — Show SDK information and integration guides

Type help <command> for detailed usage. Tab autocomplete supported.

API REFERENCE

POST /api/app/session/login

Authenticate and create session. Returns zkId, address, and authHash.

GET /api/app/tokens

List all API tokens. POST to generate new token.

GET /api/app/wallets

List all wallets. PATCH to switch active wallet.

GET /api/app/pools

List liquidity pools. PATCH to deposit/withdraw/prove.

POST /api/app/terminal/execute

Execute terminal command. Returns parsed output with type-tagged lines.

GET /api/app/dex/quote

Get swap quote for token pair. Includes routes and rates.

All endpoints require active session. Responses include type metadata for client-side UI rendering.

ARCHITECTURE

Client

React Context-based state management (useEcosystemStore, useTerminalStore). All UI components use CSS custom properties for theming. Dynamic module imports prevent landing page bundle bloat.

Server

In-memory singleton stores for mock data (token-store, wallet-store, pool-store, session-store, sdk-store). Deterministic data generation via fake-crypto utilities ensures reproducible zkIds and proofs.

Persistence

Schema-versioned localStorage (zkgate.v1). Session tokens and private keys never persisted. Passwords never stored or transmitted to frontend.

Design System

Brutalist aesthetic: 0px border-radius, scanline overlay, Space Grotesk + Work Sans fonts, CSS token-based theming. Terminal uses pixel-perfect alignment and monospace rendering.

SECURITY

Password Handling: Passwords are used only for deterministic zkId generation and never transmitted to the server after login. Never stored in localStorage.

API Tokens: Full tokens shown once on creation only. Revocation removes all credentials immediately. Never logged in plaintext.

Secure Login: Terminal hides password input behind dedicated AssistantSecureLogin form. Password prompts bypass terminal output logging.

Session Management: zkId and authHash used for session validation. No server-side database; authentication is deterministic.

TECH STACK

Frontend
React 19 • TypeScript • Tailwind v4 • Next.js 16
State
React Context • localStorage • In-memory stores
Tooling
Turbopack • ESLint • TypeScript Strict
Design
CSS Custom Props • Pixel Avatars • SVG Icons

ZKGate • Privacy-first ecosystem for zero-knowledge cryptography

// Built with Next.js 16 • React 19 • TypeScript