OPTN Wallet is a Bitcoin Cash wallet focused on secure transaction flows, CashTokens support, and extensibility for external apps.

This README is the high-level entrypoint. Technical implementation and integration details live in docs/.

• Developer Docs Index
• Build and Release Scripts
• Wallet Architecture
• Integration Guide
• Addon Development Guide
• Addon SDK Reference

There are two primary ways to integrate with OPTN Wallet:

• Wallet-to-dApp via WalletConnect.
• In-wallet addon apps using the Addon manifest + Addon SDK model.

Start with Integration Guide, then go deeper into addon docs if you are building embedded wallet apps.

1. Clone and install:

git clone https://github.com/OPTNLabs/OPTNWallet.git
cd OPTNWallet
npm install

2. Configure environment:

cp .env.sample .env

Set at least:

• VITE_WC_PROJECT_ID for WalletConnect
• Any API keys you need for your local flows

3. Run:

npm run dev

• npm run typecheck
• npm run test
• npm run addons:validate
• npm run build

See Build and Release Scripts for Android APK/AAB commands and iOS preparation commands.

• src/pages/ UI routes and host screens
• src/services/ runtime services (wallet, tx, addons, policy)
• src/types/ shared domain models (including addon manifest/capabilities)
• src/addons/builtin/ curated built-in addon manifests
• schemas/ JSON schemas (including addon manifest schema)
• docs/ technical documentation

• Website: https://www.optnwallet.com/
• Source: https://github.com/OPTNLabs/OPTNWallet