Files
hash-wallet/README.md
T
jwinterm 784a082f15 Legal + release-readiness pass for Hash Bags launch
Legal (aligned with the hosted hash.boats Terms & Privacy):
- Rewrite in-app Terms (assets/text/Terms_of_Use.txt): drop the false 'No Fiat
  Operations'/'No Embedded Applications' clauses; add MoonPay (optional, where
  available), Trocador swaps + ~1% fee disclosure, WalletConnect, sanctions/18+,
  Apple EULA rider, and PA + class/jury-waiver dispute terms.
- Reconcile PRIVACY.md with the canonical hosted policy.
- Add THIRD_PARTY_LICENSES.md; correct the blanket 'MIT' claim in README (app
  code MIT; bundles BSD-3/Apache-2.0/LGPL-3.0); fix README build-doc + LICENSE.md
  links and copyright year.
- Standardize in-app legal naming to 'Terms of Service'; add in-app links to
  hash.boats/terms and /privacy.

Release fixes:
- Align URL scheme hashwallet:// -> hashbags:// (matches registered scheme) so
  WalletConnect/Trezor/quick-action deep links work.
- Store-review gating: hide Buy action until a provider is available; hide the
  empty 'Apps' tab.
- Exclude removed chains (SOL/TRX/ZEC/DCR/ZANO + tokens) from swap pickers.
- Residual Cake branding: macOS CFBundleDisplayName and Windows Runner.rc
  (Hash Wallet -> Hash Bags); remove Android cakewallet://y.at leftover.
- Genericize internal-infra comments in CI workflows.
2026-07-02 14:07:24 -04:00

86 lines
3.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Hash Bags
**Hash Bags** (`#`) 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 Bags 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/builds/ANDROID.md`
* iOS: `docs/builds/IOS.md`
* macOS: `docs/builds/MACOS.md`
* Linux: `docs/builds/LINUX.md`
* Windows: `docs/builds/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 Bags' own application code is distributed under the [MIT License](LICENSE.md), inherited from Cake Wallet. It also bundles third-party open-source components under their own licenses — including the Monero and Wownero wallet cores (BSD-3-Clause) and additional components under Apache-2.0 and LGPL-3.0 — so the app as a whole is not solely MIT-licensed. See the `LICENSE` files in the repository.
```
Copyright (C) 2018–2025 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 Bags.