Top Related Projects

BlueWallet

3,238

Bitcoin wallet for iOS & Android. Built with React Native

Quick Overview

Zeus is an open-source, non-custodial Bitcoin Lightning wallet for Android and iOS. It allows users to manage their Lightning Network nodes and make Bitcoin transactions directly from their mobile devices, providing a user-friendly interface for interacting with the Lightning Network.

Pros

User-friendly mobile interface for managing Lightning Network nodes
Supports multiple node implementations (LND, c-lightning, Eclair)
Non-custodial, giving users full control over their funds
Open-source, allowing for community contributions and audits

Cons

Requires users to run their own Lightning Network node
May be complex for beginners unfamiliar with Lightning Network concepts
Limited support for advanced Lightning Network features
Dependent on the stability and security of the user's node setup

Getting Started

To get started with Zeus:

Set up a Lightning Network node (LND, c-lightning, or Eclair)
Download the Zeus app from the App Store (iOS) or Google Play Store (Android)
Open the app and select "Connect to your node"
Choose your node implementation and enter your node's connection details
Follow the on-screen instructions to complete the setup

Note: Detailed instructions for setting up different node implementations can be found in the project's documentation on GitHub.

Competitor Comparisons

BlueWallet

3,238

Bitcoin wallet for iOS & Android. Built with React Native

Pros of BlueWallet

More comprehensive feature set, including support for multiple wallets and cryptocurrencies
User-friendly interface with a focus on ease of use for beginners
Active development with frequent updates and new features

Cons of BlueWallet

Less focused on Lightning Network functionality compared to Zeus
Larger codebase may lead to increased complexity and potential security risks
Some advanced features may be overwhelming for users primarily interested in Bitcoin

Code Comparison

Zeus (React Native):

import { createStackNavigator } from 'react-navigation-stack';
import Overview from './Overview';
import Send from './Send';

const AppNavigator = createStackNavigator({
  Overview: { screen: Overview },
  Send: { screen: Send },
});

BlueWallet (React Native):

import { createStackNavigator } from '@react-navigation/stack';
import WalletsList from './screen/wallets/list';
import AddWallet from './screen/wallets/add';

const Stack = createStackNavigator();

function WalletsNavigator() {
  return (
    <Stack.Navigator>
      <Stack.Screen name="WalletsList" component={WalletsList} />
      <Stack.Screen name="AddWallet" component={AddWallet} />
    </Stack.Navigator>
  );
}

Both projects use React Native for mobile app development, but BlueWallet's navigation structure appears more complex, reflecting its broader feature set. Zeus focuses primarily on Lightning Network functionality, resulting in a simpler navigation setup.

Convert designs to code with AI

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot

README

ZEUS

screenshots3

ZEUS is a mobile Bitcoin/Lightning wallet and remote node manager for LND and Core Lightning. â¡ï¸

ZEUS is built on TypeScript and React Native. It runs on both Android and iOS.

App Store links

Get in touch with us

Come chat with us on Telegram
Join our developer Slack
Keep up with us on Twitter and Nostr
Open a channel with our node

Features

Connecting ZEUS to your node

You can connect ZEUS to a remote Bitcoin Lightning node running Lightning Network Daemon (lnd) or Core Lightning.

You 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 here. 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.

Tor Connection Guides

ZEUS 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.

Integrations

ZEUS is proud to be integrated on the following platforms:

Full node solutions

Payment platforms

Starting development

Don't trust, verify the code with your own two eyes. Then when ready proceed to the steps below based on your platform.

Prerequisites

Node.js (minimum version: 18.18)

Android

install and setup react-native and its related dependencies under "Building Projects with Native Code" on react-native's Getting Started page
if using your phone, enable Developer mode and USB Debugging , then make sure it is connected to your computer by running adb devices
install node dependencies with yarn
open up your Android simulator or connect your phone and run npx react-native start
open a new tab and run npx react-native run-android

iOS

install and setup react-native and its related dependencies under "Building Projects with Native Code" on react-native's Getting Started page
install node dependencies with yarn
cd ios && pod install
open ios/zeus.xcworkspace in Xcode and hit Run.

Contributing

Please 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

If you are making cosmetic changes please test on both Android and iOS as things don't render exactly the same on both platforms.

If you're looking for a quick way to get a lightning development environment running, check out Polar.

NOTE: 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.

Reproducible builds

Read our docs on reproducible builds here.

Translations

Do 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 and request a role on the language you'd like to contribute to.

Release + Commit Verification

All 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 and on the ZeusLN.com website.

Past Keys

989CC718EBA8BB68 (January 24, 2020 - October 19, 2021)

Donations

If 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, via Lightning Address (tips@pay.zeusln.app), or via PayNym (+holymorning7d1). You can also become a community sponsor and have your Twitter or Nostr avatar displayed on our website and in-app.

Thank you.

License

Distributed under the GNU Affero General Public License (AGPL v3). See LICENSE file.

Top Related Projects

BlueWallet

3,238

Bitcoin wallet for iOS & Android. Built with React Native

Convert designs to code with AI

Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.

Try Visual Copilot