HarborWallet / harbor

Ecash management tool
https://harbor.cash
MIT License
134 stars 17 forks source link
bitcoin ecash fedimint

Harbor

Harbor is an ecash desktop wallet for better bitcoin privacy. Use this tool to interact with ecash mints, moving money in and out using existing Bitcoin wallets. As you use mints, you may be able to increase the privacy of your money. Harbor also aims to demystify ecash mints for users and make them easier to use.

Highlights:

NOTE: This is alpha software that could rapidly change in feature set. There is risk of losing funds. Compile and run at your own risk.

Compatibility

Harbor is a desktop app built in Rust, using the iced framework, that runs on Mac, Windows, and Linux. It currently supports Fedimint, Bitcoin, and Lightning. (We see you, Cashu 👀)

Binaries will be available in the future. For now you need to compile it yourself following the instructions below.

Building

  1. Clone the HarborWallet/harbor repo and cd into it.
git clone <harbor git URL> harbor
cd harbor
  1. Install NixOS on your machine if you do not have it already.

⚠️ NOTE: Nix OS support on linux environments is still in progress, this may or may not work for you yet: https://github.com/HarborWallet/harbor/issues/7

curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install
// Follow any Nix installation instructions in the terminal, including post install steps.
  1. Everything is done in a nix develop shell for now:
nix develop
  1. Run the unit tests

    just test
  2. Build and Run

If you're on linux you may need to exit the nix shell to be able to run the program.

// debug build
just run
// release build
just release

NOTE: The first password you type in the box is saved as your password. There will be a proper onboarding workflow in the future.

Database Changes

Reset local DB (for init, schema generation, etc.)

just reset-db

Feedback & Support

A product like this is unique. We need all the feedback, help, and support we can get. We believe in building a tool like this out in the open as fully open-sourced MIT code that is freely available and does not depend on a centralized coordinator or single developer. However, we're unable to gain insights into how people use this tool, whether users like it or how many users even exist.

Therefore, we need your help. For one, we need feedback. Do you want to use a tool like this? What features are most important to you, and what do you want? Please use the discussion boards here on GitHub or the Harbor channel on our Discord. This will primarily drive the Harbor feature set.

Building free and open-source software is not free to us developers. While we believe in this tool's mission, we must rely on donations. We cannot profit from transactions for this service, and it must be fully open-sourced for this community to use it.

Visit our Geyser funding page. Any donations are greatly appreciated for funding development and signaling that it's a valuable tool to you.