Wojakcoinwallet

A self-custodial Wojakcoin (WJK) wallet UI with Electrs API integration.

Wojakcoin network params (from wojakcore): Legacy P2PKH only (W prefix), no SegWit, tx version 1, RPC port 20760.

Contributors

• reallyshadydev — maintainer

See CONTRIBUTORS.md for the full list.

Releases

Pre-built Android (APK) and iOS (App bundle) are attached to GitHub Releases. The iOS app is built by the Build iOS workflow on push to main and added to the latest release.

CI & workflows

• PRs to main: CI runs lint + static next build (.github/workflows/ci.yml).
• Push to main: Build Android (debug APK artifact) and Build iOS (app artifact / release upload).

Full diagram and manual dispatch notes: WORKFLOW.md.

Setup

1. Install dependencies

   npm install --legacy-peer-deps

2. Configure environment Copy .env.example to .env.local and adjust if needed:

   • NEXT_PUBLIC_ELECTRS_API_URL — wjk-electrs REST API (default: https://api.wojakcoin.cash for Android builds)
   • NEXT_PUBLIC_BLOCK_EXPLORER_URL — block explorer for tx links (default: https://explorer.wojakcoin.cash)

3. Run wjk-electrs The wallet needs a running wjk-electrs instance. Start it with:

   ./start-electrs.sh  # HTTP REST API on port 3001

4. Start the wallet

   npm run dev

API Compatibility

The wallet uses the Electrs REST API as documented in wjk-electrs/electrs-api-documentation.md:

• GET /address/<address> — balance & stats
• GET /address/<address>/txs — transactions
• GET /address/<address>/utxo — UTXOs
• GET /fee-estimates — fee rates
• POST /tx — broadcast
• GET /blocks/tip/height — block height

Android

This repo is set up for Android via Capacitor. See ANDROID.md for prerequisites, env vars, and build steps. Quick path:

npm install --legacy-peer-deps
# Set NEXT_PUBLIC_ELECTRS_API_URL in .env.local to a public Electrs URL
npm run build:android
npm run open:android

iOS

iOS is also supported (requires macOS with Xcode). See IOS.md for setup and build steps. Quick path on a Mac:

npm install --legacy-peer-deps
npm run build:ios
cd ios/App && pod install && cd ../..
npm run open:ios