{"id":13721530,"url":"https://github.com/ZeusLN/zeus","last_synced_at":"2025-05-07T13:33:37.398Z","repository":{"id":37587504,"uuid":"171051201","full_name":"ZeusLN/zeus","owner":"ZeusLN","description":"A mobile Bitcoin wallet fit for the gods. ⚡️ Est. 563345","archived":false,"fork":false,"pushed_at":"2024-11-11T17:25:46.000Z","size":70489,"stargazers_count":1026,"open_issues_count":219,"forks_count":146,"subscribers_count":27,"default_branch":"master","last_synced_at":"2024-11-11T18:27:26.898Z","etag":null,"topics":["android","bitcoin","c-lightning","core-lightning","cryptocurrency","ios","lightning","lightning-network","lnd","lndhub","micropayments","nostr","payments","react-native","self-custody","typescript"],"latest_commit_sha":null,"homepage":"https://ZeusLN.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ZeusLN.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"kaloudis","custom":"https://zeusln.com/sponsor"}},"created_at":"2019-02-16T20:58:09.000Z","updated_at":"2024-11-11T17:25:57.000Z","dependencies_parsed_at":"2022-08-08T21:00:38.212Z","dependency_job_id":"6a39e4f8-5fb5-40f5-89ac-8ced476df212","html_url":"https://github.com/ZeusLN/zeus","commit_stats":null,"previous_names":[],"tags_count":139,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZeusLN%2Fzeus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZeusLN%2Fzeus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZeusLN%2Fzeus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZeusLN%2Fzeus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ZeusLN","download_url":"https://codeload.github.com/ZeusLN/zeus/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224605045,"owners_count":17339252,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","bitcoin","c-lightning","core-lightning","cryptocurrency","ios","lightning","lightning-network","lnd","lndhub","micropayments","nostr","payments","react-native","self-custody","typescript"],"created_at":"2024-08-03T01:01:18.288Z","updated_at":"2025-05-07T13:33:37.391Z","avatar_url":"https://github.com/ZeusLN.png","language":"JavaScript","funding_links":["https://github.com/sponsors/kaloudis","https://zeusln.com/sponsor"],"categories":["Wallets- On-Chain/Lightning Wallets","Lightning","NIP-57 Zaps compatible wallets and solutions","TypeScript"],"sub_categories":["Wallets","Client reviews and/or comparisons"],"readme":"# ZEUS\n\u003cp align=\"center\"\u003e\u003cimg src=\"https://github-production-user-asset-6210df.s3.amazonaws.com/1878621/282360800-579c1156-1fc6-45b6-86f2-7b3424502160.png\"\u003e\u003c/p\u003e\n\n![ZEUS screenshots](https://github.com/user-attachments/assets/337e6549-26e2-4319-9fc1-0937a81bb15d)\n\nZEUS is a mobile Bitcoin/Lightning wallet and remote node manager for LND and Core Lightning. ⚡️\n\nZEUS is built on TypeScript and React Native. It runs on both Android and iOS.\n\nRead more on our [documentation site](https://docs.zeusln.app/).\n\n### App Store links\n* [Google Play](https://play.google.com/store/apps/details?id=app.zeusln.zeus)\n* [Apple App Store](https://apps.apple.com/us/app/zeus-ln/id1456038895)\n* [F-Droid](https://zeusln.com/download)\n\n### Get in touch with us\n* Come chat with us on\n[Telegram](https://t.me/zeusLN)\n* Join our\n[developer Slack](https://zeusln.slack.com/join/shared_invite/zt-qw205nqa-o4VJJC0zPI7HiSfToZGoVw#/)\n* Keep up with us on\n[Twitter](https://twitter.com/ZeusLN)\nand\n[Nostr](https://iris.to/npub1xnf02f60r9v0e5kty33a404dm79zr7z2eepyrk5gsq3m7pwvsz2sazlpr5)\n* Open a channel with\n[our node](https://amboss.space/node/031b301307574bbe9b9ac7b79cbe1700e31e544513eae0b5d7497483083f99e581)\n\n## Features\n\n- [x] Bitcoin only wallet\n- [x] Self-custodial\n- [x] No KYC\n- [x] Fully open source (AGPLv3)\n- [x] [Connect to LND or Core Lightning remote node](https://docs.zeusln.app/category/remote-connections)\n- [x] Manage multiple lightning nodes at once\n- [x] Connect via LNDHub instances\n- [x] Lightning accounts\n- [x] On-chain accounts\n- [x] Easy to use activity menu\n- [x] NFC payments and requests\n- [x] PIN or passphrase encryption\n- [x] Connect over Tor\n- [x] Privacy mode - hide your sensitive data\n- [x] Lightning address send\n- [x] Full LNURL support (pay, withdraw, auth, channel)\n- [x] Lightning channel management\n- [x] Detailed routing reports\n- [x] Set and manage routing fees\n- [x] MPP/AMP support\n- [x] Keysend support\n- [x] SegWit support \n- [x] Sign \u0026 verify messages\n- [x] Fiat currency integrations\n- [x] [Various language support](https://app.transifex.com/ZeusLN/zeus/)\n- [x] Multi-theme\n- [x] On-chain coin control \n- [x] External signer support\n- [x] Watch-only accounts\n- [x] Contact list for easier payments\n- [x] Nostr contact import\n- [x] Point of Sale (Standalone and Square integration)\n- [x] Lightning address receive\n- [x] Taproot support \n- [ ] Connect a watchtower\n- [ ] Advanced security center\n- [x] Batch on-chain transactions\n- [x] Batch channel opens\n- [ ] PayJoin\n- [x] [Lightning Node Connect](https://docs.lightning.engineering/lightning-network-tools/lightning-terminal/lightning-node-connect)\n- [x] [Self-custodial lightning address (ZEUS Pay)](https://docs.zeusln.app/lightning-address/intro)\n\n## Connecting ZEUS to your node\n\nYou can connect ZEUS to a remote Bitcoin Lightning node running [Lightning Network Daemon (lnd)](https://github.com/LightningNetwork/lnd) or [Core Lightning](https://github.com/ElementsProject/lightning).\n\nYou must provide ZEUS with your node's hostname, port number, and the macaroon you choose to use in **hex format**. If you need help converting your macaroon to hex format we wrote up a Node.js script that can use\n[here](https://github.com/ZeusLN/lnd-hex-macaroon-generator/). Alternatively, if you're running a Unix-based operating system (eg. macOS, Linux) you can run `xxd -ps -u -c 1000 /path/to/admin.macaroon` to generate your macaroon in hex format.\n\n### Tor Connection Guides\n\nZEUS has support for connecting to you node entirely over the Tor network. You can refer to these guides to set up a Tor hidden service on your lnd node. The instructions are generally interchangeable and typically only require you to change your Tor path.\n\n* [ZEUS over Tor guides for StartOS](https://docs.start9.com/0.3.5.x/service-guides/lightning/index)\n* [ZEUS over Tor guide for RaspiBolt](https://raspibolt.org/guide/lightning/mobile-app.html)\n* [ZEUS over Tor guide for FreeNAS by Seth586](https://github.com/seth586/guides/blob/master/FreeNAS/wallets/zeusln.md)\n* [ZEUS over Tor guide for RaspiBlitz by openoms](https://github.com/openoms/bitcoin-tutorials/blob/master/Zeus_to_RaspiBlitz_through_Tor.md)\n* [Tor-Only Bitcoin \u0026 Lightning Guide by Lopp](https://blog.lopp.net/tor-only-bitcoin-lightning-guide/)\n\n## Integrations\n\nZEUS is proud to be integrated on the following platforms:\n\n### Full node solutions\n* [StartOS](https://www.start9.com/), [Guides](https://docs.start9.com/0.3.5.x/service-guides/lightning/index)\n* [nodl](https://www.nodl.it/)\n* [myNode](https://mynodebtc.com/) ([Standard guide](https://mynodebtc.com/guide/zeus), [Tor guide](https://mynodebtc.com/guide/zeus_tor))\n* [RaspiBlitz](https://github.com/rootzoll/raspiblitz)\n* [Umbrel](https://getumbrel.com/)\n\n### Payment platforms\n* [BTCPay Server](https://btcpayserver.org/)\n* [LNBits](https://lnbits.com/)\n\n## Starting development\n\n**Don't trust, verify** the code with your own two eyes. Then when ready proceed to the steps below based on your platform.\n\n### Prerequisites\n- Node.js (minimum version: 18.18)\n\n### Android\n1. install and setup react-native and its related dependencies under **\"Building Projects with Native Code\"** on\n[react-native's Getting Started page](https://reactnative.dev/docs/environment-setup)\n2. if using your phone,\n[enable Developer mode and USB Debugging](https://developer.android.com/studio/debug/dev-options)\n, then make sure it is connected to your computer by running `adb devices`\n3. install node dependencies with `yarn`\n4. open up your Android simulator or connect your phone and run `npx react-native start`\n5. open a new tab and run `npx react-native run-android`\n\n### iOS\n1. install and setup react-native and its related dependencies under **\"Building Projects with Native Code\"** on\n[react-native's Getting Started page](https://reactnative.dev/docs/environment-setup)\n2. install node dependencies with `yarn`\n3. `cd ios \u0026\u0026 pod install`\n4. open `ios/zeus.xcworkspace` in Xcode and hit Run.\n\n## Contributing\n\nPlease be sure to run `yarn run tsc` to check for type errors, `yarn run test` to run all tests, and `yarn run prettier` to run the prettier\n\nIf you are making cosmetic changes please test on both Android and iOS as things don't render exactly the same on both platforms.\n\nIf you're looking for a quick way to get a lightning development environment running, check out [Polar](https://github.com/jamaljsr/polar).\n\nNOTE: When configuring a new node on Android in dev, the `Host` field must be `10.0.2.2` - `127.0.0.1` or `localhost` won't work.\n\n## Reproducible builds\n\nRead our docs on reproducible builds [here](https://github.com/ZeusLN/zeus/blob/master/docs/ReproducibleBuilds.md).\n\n## Translations\n\nDo not directly modify the files in `/locales` unless you are adding new copy to the app in English. Instead, translators and reviewers should visit out [Transifex page](https://app.transifex.com/ZeusLN/zeus/) and request a role on the language you'd like to contribute to.\n\n## Release + Commit Verification\n\nAll releases and all maintainer commits as of October 20, 2021 are signed by key `AAC48DE8AB8DEE84` (zeusln@tutanota.com). The key can be found [in this repo](https://github.com/ZeusLN/zeus/blob/master/PGP.txt) and [on the ZeusLN.com website](https://zeusln.com/PGP.txt).\n\n\n### Past Keys\n`989CC718EBA8BB68` (January 24, 2020 - October 19, 2021)\n\n## Donations\n\nIf you'd like to help us with the cost of running Zeus project (iOS developer account, Google Play developer account, hosting) you can send a payment to us via our [BTCPayServer portal](https://pay.zeusln.app/), via Lightning Address (tips@pay.zeusln.app), or via PayNym ([+holymorning7d1](http://my.paynym.is/+holymorning7d1)). You can also become a [community sponsor](https://zeusln.com/about#communitySponsors) and have your Twitter or Nostr avatar displayed on our website and in-app.\n\nThank you.\n\n## License\n\nDistributed under the GNU Affero General Public License (AGPL v3). See [LICENSE file](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZeusLN%2Fzeus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FZeusLN%2Fzeus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FZeusLN%2Fzeus/lists"}