All Projects → LedgerHQ → satstack

LedgerHQ / satstack

Licence: BSD-2-Clause License
Bitcoin full node with Ledger Live

Programming Languages

go
31211 projects - #10 most used programming language
python
139335 projects - #7 most used programming language
shell
77523 projects
Makefile
30231 projects

Projects that are alternatives of or similar to satstack

bitcoin-development-with-go
[Work in Progress] A little book on Bitcoin Development with Go (golang)
Stars: ✭ 19 (-83.19%)
Mutual labels:  btcd
ledgible
Web-based double-entry accounting (ledger-cli frontend)
Stars: ✭ 58 (-48.67%)
Mutual labels:  ledger
ledger
🏛 A programmable financial ledger that makes complex money flows easy
Stars: ✭ 267 (+136.28%)
Mutual labels:  ledger
total recall
Turn any csv into Ledger journals. Canonical repository can be found at -->
Stars: ✭ 16 (-85.84%)
Mutual labels:  ledger
r-ledger
R package for importing data from plain text accounting files
Stars: ✭ 34 (-69.91%)
Mutual labels:  ledger
chrome-extension-wallet
Harmony Chrome Extension Wallet
Stars: ✭ 54 (-52.21%)
Mutual labels:  ledger
ledgers
No description or website provided.
Stars: ✭ 26 (-76.99%)
Mutual labels:  ledger
beancount-mobile
Your personal finance manager. iOS and Android App for Beancount.io
Stars: ✭ 75 (-33.63%)
Mutual labels:  ledger
beancount-boilerplate-cn
docs.google.com/spreadsheets/d/1jnds3X_-RSTN4ATuOFV-v6tar0KfAla88vC43Vq6ubc/edit#gid=0
Stars: ✭ 186 (+64.6%)
Mutual labels:  ledger
vscode-ledger
Visual Studio Code support for Ledger files
Stars: ✭ 18 (-84.07%)
Mutual labels:  ledger
Nault
⚡ The most advanced Nano wallet with focus on security, speed and robustness
Stars: ✭ 228 (+101.77%)
Mutual labels:  ledger
rust-ledger-parser
Rust library for parsing ledger cli (https://www.ledger-cli.org/) input files.
Stars: ✭ 22 (-80.53%)
Mutual labels:  ledger
distributed-compliance-ledger
DCL is a public permissioned ledger framework for Zigbee compliance certification of device models. The ledger is based on Cosmos SDK and Tendermint.
Stars: ✭ 41 (-63.72%)
Mutual labels:  ledger
ripple-binary-codec
Convert between json and hex representations of transactions and ledger entries on the XRP Ledger. Moved to: https://github.com/XRPLF/xrpl.js/tree/develop/packages/ripple-binary-codec
Stars: ✭ 18 (-84.07%)
Mutual labels:  ledger
web3-provider-ledger
A web3 provider for Ledger hardware wallets
Stars: ✭ 15 (-86.73%)
Mutual labels:  ledger
nledger
.Net Ledger: Double-Entry Accounting System
Stars: ✭ 141 (+24.78%)
Mutual labels:  ledger
knut
knut is an efficient plain text accounting tool with support for multiple currencies and valuation.
Stars: ✭ 40 (-64.6%)
Mutual labels:  ledger
ledger-plots
R functions to plot data from your ledger
Stars: ✭ 24 (-78.76%)
Mutual labels:  ledger
Seedshift
Plausibly deniable steganographic encryption of BIP-39 mnemonic seed words with a date shift cipher
Stars: ✭ 21 (-81.42%)
Mutual labels:  ledger
pyledger
A simple ledger for smart contracts written in python
Stars: ✭ 18 (-84.07%)
Mutual labels:  ledger

Ledger SatStack

satstack logo

Ledger SatStack is a lightweight bridge to connect Ledger Live with your personal Bitcoin full node. It's designed to allow Ledger Live users use Bitcoin without compromising on privacy, or relying on Ledger's infrastructure.

Table of Contents

Background

Running a full node is the only way you can use Bitcoin in a completely trustless way. A full node downloads the entire blockchain, and checks it against Bitcoin's consensus rules, and contributes to the decentralization and economic strength of Bitcoin. However, a far more compelling reason to run your own node is privacy. ...read more.

Running a node can be difficult for some users, and has associated costs in terms of network bandwidth and disk usage. This is why Live connects to Bitcoin nodes running on Ledger's infrastucture, wrapped around by indexer and explorer services to ensure fast queries. While security and privacy is core to Ledger, one can make a theoretical case that Ledger can spy on transaction details, or even censor certain addresses from using Ledger's services.

SatStack aims to render Ledger's infrastructure dispensable, by allowing users to connect Ledger Live with their personal Bitcoin full node.

Architecture

Ledger SatStack is a standalone Go application, that acts as a bridge between the Ledger Live application and a Bitcoin Core full-node. It exposes a REST interface to the open-source C++ library libcore, embedded by Live, and communicates to the Bitcoin node over RPC. It utilizes the transport layer and data-structures of btcd.

Requirements

  • Bitcoin Core 0.20.0+.
  • Ledger Live (desktop) 2.18.0+.
  • txindex=1 in bitcoin.conf is not mandatory, but recommended.
  • Wallet should NOT be disabled (attn. Raspiblitz users).

Usage

Setup Ledger Live (recommended way)

The easiest way of getting started is to use the dedicated setup flow directly on Ledger Live. A detailed guide is available here.

Manual setup (for advanced users)

Retrieve descriptors from device

Simply follow these steps:

  1. Plug in your Ledger device via USB.
  2. Enter your PIN code on the device, and open the Bitcoin app.
  3. Run the scripts/getdescriptor script, as shown below.
$ cd scripts
$ python3 -m venv venv  # ensure Python 3.7+
$ source venv/bin/activate
(venv) $ pip install -r requirements.txt
(venv) $ ./getdescriptor --scheme native_segwit --chain main --account 3
External: wpkh([b91fb6c1/84'/0'/3']xpub6D1gvTP...VeMLtH6/0/*)
Internal: wpkh([b91fb6c1/84'/0'/3']xpub6D1gvTP...VeMLtH6/1/*)

Create configuration file

Create a config file lss.json in your home directory. You can use this sample config file as a template.

Optional account fields
  • depth: override the number of addresses to derive and import in the Bitcoin wallet. Defaults to 1000.

  • birthday: set the earliest known creation date (YYYY/MM/DD format), for faster account import. Defaults to 2013/09/10 (BIP0039 proposal date). Refer to the table below for a list of safe wallet birthdays to choose from.

    Event Date (YYYY/MM/DD)
    BIP0039 proposal created 2013/09/10 (default)
    First ever BIP39 compatible Ledger device (Nano) shipped 2014/11/24
    First ever Ledger Nano S shipped 2016/07/28

Launch Bitcoin full node

Make sure you've read the requirements first, and that your node is configured properly. Here's the recommended configuration for bitcoin.conf:

# Enable RPC server
server=1

# Enable indexes
txindex=1
blockfilterindex=1

# Set RPC credentials
rpcuser=<user>
rpcpassword=<password>

Then launch bitcoind like this:

$ bitcoind

Launch SatStack

Pre-built binaries are available for download on the releases page (Linux, Windows, MacOS). Extract the tarball, and launch it as:

$ ./lss

If you want to build lss yourself, just do the following:

(make sure you have mage installed first)

$ mage release  # or "mage build" for a development build

On startup, SatStack will wait for the Bitcoin node to be fully synced, and import your accounts. This can take a while.

Launch Ledger Live Desktop

$ EXPLORER=http://0.0.0.0:20000 <Ledger Live executable>

In the press

Title Source
🇬🇧 Personal sovereignty with Ledger SatStack blog.ledger.com
🇫🇷 Ledger SatStack: un pont entre Bitcoin Core et votre Ledger Wallet bitcoin.fr
🇫🇷 Votre propre coffre-fort à bitcoins… inviolable – Ledger annonce l’arrivée des full nodes Bitcoin Journal du Coin
🇫🇷 Il est désormais possible d’exécuter un full node Bitcoin sur Ledger Live beincrypto.com
🇪🇸 Ledger Live será compatible con nodos propios de Bitcoin CriptoNoticias
🇬🇧 Bitcoin Tech Talk #218: Curing Monetary Stockholm Syndrome (mention) Jimmy Song

Community

For feedback or support, please tag @onybose and @Ledger on Twitter. To report any bugs related to full node on Ledger Live, you can create issues on this repository.

Contributing

Contributions in the form of code improvements, documentation, tutorials, and feedback are most welcome.

For contributions to the code, we recommend these guidelines.

Call for Cowsay contributions

On startup, satstack will display a message about Bitcoin, randomly picked from a curated collection of interesting quotes, facts, email excerpts, etc. You are welcome to contribute by creating a pull request modifying this file (includes guidelines for editing the file). Here's an example of how it is rendered:

Cowsay ideas:

Please mention the source when you make a contribution, so we can attribute the original author(s) and include a copy of the license if required.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].