mirror of
https://github.com/Such-Software/hash-wallet.git
synced 2026-10-19 05:58:50 +02:00
jwinterm
ac7830e181
CONTRIBUTING.md explains the fork relationship, branch model, generated- code workflow, and what changes we will and won't accept (no re-enabling Solana/Tron/Zano/Decred/Zcash, no Cake-domain endpoints, no Lightning yet, no telemetry). README.md: removed the stale ./scripts/prepare_zcash.sh reference (file doesn't exist) and added a link to CONTRIBUTING. .gitignore: untrack docs/UPSTREAM_SYNC.md (internal merge-strategy playbook, kept locally alongside docs/links.md).
86 lines
3.3 KiB
Markdown
86 lines
3.3 KiB
Markdown
# Hash Wallet
|
||
|
||
**Hash Wallet** (`#`) is an open-source, non-custodial, multi-currency crypto wallet for Android, iOS, macOS, Linux, and Windows. It is a fork of [Cake Wallet](https://github.com/cake-tech/cake_wallet) maintained by [Such Software LLC](https://github.com/Such-Software).
|
||
|
||
## Why a fork?
|
||
|
||
Cake Wallet ended Wownero support in early 2026. Hash Wallet exists to keep Wownero as a first-class mobile experience, run by the project's founder, while shipping a slimmer, more focused multi-coin wallet without the chains and integrations we don't want to maintain or recommend.
|
||
|
||
## Supported chains
|
||
|
||
* Monero (XMR)
|
||
* Wownero (WOW)
|
||
* Bitcoin (BTC)
|
||
* Litecoin (LTC), incl. MWEB
|
||
* Bitcoin Cash (BCH)
|
||
* Dogecoin (DOGE)
|
||
* Nano (XNO)
|
||
* Ethereum (ETH) + ERC-20s
|
||
* Polygon (POL)
|
||
* Base (BASE)
|
||
* Arbitrum (ARB)
|
||
* BNB Smart Chain (BSC)
|
||
|
||
Hardware wallet support: Ledger, Trezor, BitBox.
|
||
|
||
## What's different from Cake Wallet
|
||
|
||
**Removed:**
|
||
* Solana, Tron, Zano, Zcash, Decred (chain support disabled)
|
||
* Lightning Network (deferred — running Greenlight infra is out of scope for now)
|
||
* Cake Pay gift cards (Cake Labs–operated service)
|
||
* All direct swap-provider integrations except [Trocador](https://trocador.app), which already aggregates ChangeNow, FixedFloat, LetsExchange, Exolix, StealthEx, Quantex, and ~16 others under one privacy-friendly API
|
||
|
||
**Replaced or planned:**
|
||
* Default Monero/Wownero/BTC node lists augmented with community nodes (don't rely on Cake Labs–operated nodes alone)
|
||
* Fiat price API replacement (Cake's API → public source) — pending
|
||
* Tor / Arti integration improvements — pending
|
||
|
||
## Build instructions
|
||
|
||
The build system is unchanged from upstream Cake Wallet. See `docs/` for per-platform instructions:
|
||
|
||
* Android: `docs/build_android.md`
|
||
* iOS: `docs/build_ios.md`
|
||
* macOS: `docs/build_macos.md`
|
||
* Linux: `docs/build_linux.md`
|
||
* Windows: `docs/build_windows.md`
|
||
|
||
Required Flutter version is pinned in `Dockerfile` (currently 3.32.0) and `.tool-versions`. Newer Flutter SDKs (3.5+) drop the `_macros` pseudo-package that Cake's pinned `hive_generator` + `build_resolvers` transitively require — `flutter pub get` will fail until you switch to 3.32.0. If using `asdf` or `mise`, the version will be picked up automatically; otherwise:
|
||
|
||
```bash
|
||
git clone --depth 1 --branch 3.32.0 https://github.com/flutter/flutter.git ~/sdks/flutter/3.32.0
|
||
export PATH="$HOME/sdks/flutter/3.32.0/bin:$PATH"
|
||
flutter --version # confirm 3.32.0 / Dart 3.8.0
|
||
```
|
||
Before the first `flutter pub get`, you must run the prep scripts to clone external native dependencies:
|
||
|
||
```bash
|
||
./scripts/prepare_torch.sh
|
||
./scripts/prepare_moneroc.sh
|
||
./scripts/build_bitbox_flutter.sh
|
||
# Then fetch the prebuilt reown_flutter tarball (CI does this; reproduce locally
|
||
# with the URL in .github/workflows/build-linux.yml).
|
||
```
|
||
|
||
Then run the platform-specific configure script, e.g.:
|
||
|
||
```bash
|
||
APP_LINUX_TYPE=cakewallet ./configure_hash_wallet.sh linux
|
||
```
|
||
|
||
## Contributing
|
||
|
||
Issues and PRs welcome at https://github.com/Such-Software/hash-wallet. See [`CONTRIBUTING.md`](CONTRIBUTING.md) for ground rules.
|
||
|
||
## License
|
||
|
||
Hash Wallet is distributed under the [MIT License](LICENSE), inheriting from Cake Wallet.
|
||
|
||
```
|
||
Copyright (C) 2018–2023 Cake Labs LLC
|
||
Copyright (C) 2026 Such Software LLC
|
||
```
|
||
|
||
Cake Wallet, the Cake Wallet logo, and related marks are trademarks of Cake Labs LLC and are not used by Hash Wallet.
|