KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #codex #typescript #developer-tools #ai-agents #deepseek-harness #claude-code #ai-agent #cli #react #mcp

junction

★ 60 Open GitHub ↗

UI For Using Hardware Wallets With Bitcoin Core

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![image](https://raw.githubusercontent.com/justinmoon/junction/master/logo.png)

## Usage

### Prerequisites

* `bitcoind` on testnet
* Python 3.6 or higher

See [this tweetstorm](https://twitter.com/_JustinMoon_/status/1166905722325667841?s=20) for screenshots. They'll probably go out-of-date quickly ...

Junction project uses [HWI](https://github.com/bitcoin-core/HWI) to communicate with hardware wallets. Follow [these instructions](https://github.com/bitcoin-core/HWI#prerequisites) to install libusb dependency for HWI (don't do the `poetry install` step). If you're on Linux you may need to install udev rules.

```
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
npm install
```

Run backend in terminal window with virtual environment active:

```
cd server
python server.py
```

Run frontend in another terminal window:

```
npm start
```

Open `localhost:3000` in your browser

## Features

- Supports P2SH multisig with Trezor, Ledger, and ColdCard hardware wallets
- Connects directly to your full node and monitors balance using watch-only Bitcoin Core wallet
- No javascript, minimal python dependencies

## Limitations

_This is buggy, alpha, proof-of-concept software_

- Testnet-only
- No tests
- Doesn't currently use javascript, so frequent page reloads are required and UX kinda sucks
- Doesn't support P2WSH (ColdCard has a P2WSH bug right now preventing it)
- BIP32 derivation paths hard-coded
- Only 1 wallet allowed at-a-time
- Only 1 PSBT allowed at a time
- ColdCard must be last signer added because we must upload a multisig enrollment file containing the other xpubs.
- Bitcoin Core Limitations:
    - Unconfirmed balances not correctly displayed. `getbalance` and `getunconfirmedbalance` can't find unconfirmed outputs for watch-only wallets in Bitcoin Core 18.1. A new `getbalances` API will fix this in next Bitcoin Core release.
- HWI limitations:
    - [No change detection](https://github.com/bitcoin-core/HWI/issues/170#issuecomment-491843963)
    - Cannot display multisig receiving addresses on hardware wallet display
    - Sometimes HWI thinks wallets are locked when they clearly aren't

## Testing

To run tests:

Install `bitcoind` to `test` directory

```
$ ./test/install_bitcoind.sh
```

Run tests

```
python -m unittest test.test_wallet
```

## Windows libusb dependencies:

(following [these instructions](https://nfcpy.readthedocs.io/en/latest/topics/get-started.html#installationS))
- search "command prompt"
- right click and select "run as administrator"

```
copy C:\Users\justin\Downloads\MS64\dll\libusb-1.0.dll C:\Windows\System32
copy C:\Users\justin\Downloads\MS32\dll\libusb-1.0.dll C:\Windows\SysWOW64
```

junction

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README