Build with a clear picture
Run Qozmo locally and understand its wallet, data, and quantum integration layers.
Run locally
Use Node.js 22 or 24. Qozmo uses Next.js App Router, React and TypeScript. The wallet requires a secure browser context; localhost supports the required cryptography.
npm ci
npm run devOpen the URL printed by the development server. The landing page is /, the app is /dashboard/, and this documentation is /docs/.
Validate and build
npm run typecheck
npm test
npm run buildThe application uses a static export. The production output is in out/. A static build does not bundle a server-side relay or automatically publish the application.
Implementation map
| Area | Source |
|---|---|
| Everyday encrypted vault | lib/wallet/vault.ts |
| Supported networks and token holdings | lib/wallet/networks.ts · assets.ts · token-balances.ts |
| Qozmo Quantum application adapter | lib/wallet/quantum/client.ts · storage.ts |
| Integrated WOTS core | lib/wallet/quantum-sdk/ |
| Quantum deployment pins | lib/wallet/quantum-deployment.json |
| Quantum UI | components/dashboard/quantum-wallet.tsx |
| Documentation content and navigation | lib/docs-content.ts · components/docs/ |
Quantum deployment and relay policy
Qozmo checks the chain, recorded deployment block, runtime hashes for EntryPoint/factory/implementation, and their links before signing. Adding a chain entry alone does not deploy a quantum account system or authorize mainnet signing.
The existing testnet manifest pins EntryPoint 0x0000000071727De22E5E9d8BAf0edAc6f37da032, factory 0xBe3a0B5f698a4F83C7679aAe7E7743D5E3d2F468, and implementation 0xcCBA0b7B10f809e8f3B3C1e9835acDeEdC020c39.
External read services
Prices and historical data come from Kraken, protocol TVL from DefiLlama, and balances/receipts from the selected chain RPC. These are external services, not a Qozmo account indexer or custody service. No analytics or provider credential is required to read this documentation.