→ Install from Chrome Web Store — or install from the latest release / build from source.

Note: The Chrome Web Store currently hosts v0.1.0. This repository is at v0.1.3 with additional features (governance, full-precision amounts, IBC tokens, auto-lock, address book, and improved UX).

A browser extension wallet built exclusively for the Gonka blockchain network.

• Send & Receive GNK tokens
• Full-precision amounts — all balances and transaction amounts displayed without rounding
• Import CLI wallets — import your inferenced CLI wallet by entering the mnemonic phrase it gave you during setup
• Transaction History via gonka.gg Explorer API
• Governance — browse proposals, view tally results, vote (Yes / No / Abstain / Veto), and submit new proposals
• QR Code for receiving tokens
• Secure Storage — mnemonic encrypted with AES-GCM (PBKDF2 key derivation)
• IBC token support — view and send IBC tokens alongside native GNK
• Address Book — save frequent recipients, quick-fill the Send form
• Auto-lock — configurable timeout (1 / 5 / 15 / 30 min or never)
• Private Key Export — compatible with opengnk proxy
• Gonka Inference Signer — TypeScript port of the opengnk signing scheme (RFC 6979 ECDSA)

• React 18 + TypeScript
• Vite + CRXJS (Chrome Extension MV3)
• Tailwind CSS
• CosmJS (Stargate)
• @noble/hashes + @noble/secp256k1

• Node.js 18+
• npm

npm install
npm run build

1. Open chrome://extensions/
2. Enable "Developer mode" (top-right toggle)
3. Click "Load unpacked"
4. Select the dist/ folder

npm run dev

This starts Vite in watch mode with HMR for the popup UI.

src/
  background/          # Service worker (keystore, message handlers)
  popup/               # React UI
    pages/             # Welcome, CreateWallet, Dashboard, Send, etc.
    components/        # Shared UI components
    store.ts           # Zustand state management
  lib/
    gonka.ts           # Chain configuration constants
    gonka-signer.ts    # opengnk-compatible inference request signer
    cosmos.ts          # CosmJS helpers (balance, send, stake, governance)
    api.ts             # gonka.gg Explorer API client
    crypto.ts          # AES-GCM encryption helpers
    format.ts          # Amount formatting utilities
    messaging.ts       # Chrome extension message passing
    storage.ts         # chrome.storage.local helpers

• Staking — delegate, undelegate, and claim rewards

The wallet uses the gonka.gg Explorer API to fetch transaction history for the active wallet. The API key is located in src/lib/gonka.ts (GONKA_EXPLORER_API_KEY). If you're self-hosting or forking, replace it with your own key from gonka.gg.

See CONTRIBUTING.md for development guidelines and how to submit changes.

If you discover a security vulnerability, please follow the process described in SECURITY.md. Do not open a public issue for security bugs.

MIT with Attribution — see LICENSE for details. Forks and derivative works must include visible attribution to GG Wallet by gonkalabs.com.