newtonick/hellbender-wallet
newtonick/hellbender-wallet
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity
[BREAKGLASS] A Bitcoin Multisig Coordinator
6 Commits 32 Branches 2 Tags 8.8 MiB
Swift 96.6%
Ruby 1.9%
Shell 1.5%
b7b0e7da3c
Go to file
Nick Klockenga b7b0e7da3c Release v0.1.2b21
2026-03-28 23:18:14 -04:00
.github/workflows Release v0.1.1 2026-03-16 21:37:16 -04:00
hellbender Release v0.1.2b21 2026-03-28 23:18:14 -04:00
hellbender.xcodeproj Release v0.1.2b21 2026-03-28 23:18:14 -04:00
hellbenderTests Release v0.1.2b21 2026-03-28 23:18:14 -04:00
hellbenderUITests Release v0.1.2b21 2026-03-28 23:18:14 -04:00
.gitignore Release v0.1.1 2026-03-16 21:37:16 -04:00
.swiftformat Release v0.1.1 2026-03-16 21:37:16 -04:00
LICENSE Release v0.1.1 2026-03-16 21:37:16 -04:00
README.md Release v0.1.1 2026-03-16 21:37:16 -04:00

README.md

Hellbender

Hellbender

Travel to your private keys and leave your laptop at home.

Welcome Transactions Multisig Config Import Descriptor Review Wallet

Hellbender is an iOS Bitcoin multisig coordinator written in Swift. It operates as a watch-only wallet — private keys never touch your phone. Coordinate signing across air-gapped hardware wallets using animated QR codes, bringing cold storage security with mobile convenience.

Features

  • Watch-only architecture — only public descriptors are stored on the device
  • Air-gapped QR signing — UR and BBQR animated QR codes for PSBT exchange
  • Configurable M-of-N multisig — 2-of-3, 3-of-5, and beyond
  • Full BIP-174 PSBT workflows — create, sign, combine, and broadcast
  • UTXO management — coin control and coin freezing
  • RBF fee bumping — replace-by-fee support for stuck transactions
  • Multi-network support — mainnet, testnet3, testnet4, and signet
  • Biometric security — Face ID / Touch ID lock
  • Descriptor import/export — QR scan, clipboard, and PDF export
  • Electrum server integration — connect to your own node or a public server
  • Multi-wallet profiles — manage multiple wallets in one app

Building

Requirements

  • Xcode 16.2+
  • iOS 18.6+ deployment target
  • Swift 5.0

Dependencies

All dependencies are managed via Swift Package Manager and resolve automatically:

Package Purpose
BitcoinDevKit (bdk-swift) Bitcoin operations
URKit UR encoding/decoding
URUI QR display and scanning
Bbqr BBQR encoding

Build Steps

  1. Clone the repository 
    git clone https://github.com/newtonick/hellbender-wallet.git
cd hellbender-wallet
  2. Open hellbender.xcodeproj in Xcode
  3. SPM dependencies resolve automatically on first open
  4. Build and run on a simulator or device

CI

GitHub Actions runs xcodebuild clean build analyze on every push and pull request to main.

Links

License

MIT License — see LICENSE for details.

Hellbender's dependencies use permissive licenses compatible with MIT: bdk-swift (MIT/Apache-2.0), URKit (BSD-2-Clause-Patent), URUI (BSD-2-Clause-Patent), Bbqr (Apache-2.0).