These docs are the public project references for WrapHub.
- User Guide - how to browse, wrap, unwrap, reveal, claim, create wrappers, and add custom pairs.
- Architecture - how the frontend, contracts, faucet, factory, relayer, Supabase queue, and subgraph fit together.
- Extensibility Guide - how official pairs, custom pairs, Create wrapper submissions, maintainer listing, faucet tokens, and indexed coverage are added.
- Faucet Operations - how the Sepolia gasless faucet works and how to operate it.
- Indexer Guide - how token activity and metrics are indexed.
- Deployment Guide - how to deploy contracts, subgraphs, Supabase-backed flows, and the frontend.
- Troubleshooting - common setup, wallet, faucet, decrypt, and indexer issues.
The earlier product-planning notes used during development are intentionally not part of this folder. They live in the ignored private-build-notes/ archive.