A Confidential Wrapper Registry dApp for browsing, wrapping, unwrapping, and decrypting official ERC-20 to ERC-7984 token pairs on Sepolia and Ethereum mainnet.
Many developers create their own ERC-20 testnet tokens and ERC-7984 wrappers instead of using the official Zama Wrappers Registry. This fragments the ecosystem. Qube provides a single interface to all canonical pairs so integrations compose naturally and users get a consistent experience.
- Browse - View all official ERC-20 to ERC-7984 wrapper pairs from the on-chain registry
- Wrap - Convert any registry ERC-20 into its confidential ERC-7984 equivalent
- Unwrap - Convert confidential tokens back to their public ERC-20 form
- Decrypt - Reveal encrypted balances using EIP-712 user decryption
- Faucet - Claim official cTokenMock test tokens on Sepolia
- Dual-network - Supports Sepolia (7 pairs) and Ethereum mainnet (9 pairs)
- Docs - Built-in GitBook-style documentation with dark mode
| Network | Registry Address | Token Pairs |
|---|---|---|
| Sepolia (testnet) | 0x2f0750Bbb0A246059d80e94c454586a7F27a128e |
7 (Mock tokens) |
| Ethereum Mainnet | 0xeb5015fF021DB115aCe010f23F55C2591059bBA0 |
9 (Real tokens) |
git clone https://github.com/your-org/qube.git
cd qube
pnpm install
pnpm devOpen http://localhost:5173 and connect your wallet to Sepolia or mainnet.
| Category | Technology |
|---|---|
| Framework | React 19 |
| Language | TypeScript |
| Build | Vite 8 |
| Web3 | wagmi + viem |
| FHE | Zama FHE SDK |
| Styling | Tailwind CSS |
| Docs | react-markdown + shiki |
src/
pages/ # Route components (WrapPage, UnwrapPage, FaucetPage, etc.)
components/ # UI components including docs layout and landing page
lib/ # Core logic (tokens, config, chains, registry)
hooks/ # React hooks (balances, decryption, allowance)
providers/ # Web3 and query providers
docs/ # Markdown documentation files
Full documentation is available in src/docs/:
- Introduction - What Qube is and why it exists
- Quickstart - Get up and running in minutes
- Supported Tokens - All official pairs on both networks
- Registry - How the on-chain registry works
- Wrap / Unwrap - Token conversion flows
- Decrypt - EIP-712 user decryption
- Faucet - Claiming test tokens on Sepolia
- Fork the repository
- Create a branch:
git checkout -b feature/your-feature - Make changes and test with
pnpm dev - Submit a pull request