Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jcstein/node-app

A Celestia node macOS app.
https://github.com/jcstein/node-app

Last synced: 11 days ago
JSON representation

A Celestia node macOS app.

Awesome Lists containing this project

README

        

# pat - the fastest way to run a Celestia light node

pat is f.k.a. Quazar, f.k.a. Quasar

## quazar โœจ a Celestia light node macOS app

Introducing quazar โœจ [v0.3.0-alpha](https://github.com/jcstein/node-app/releases/tag/quazar_v0.3.0-alpha_CN-v0.11.0-rc10_Arabica),
a [Celestia light node](https://docs.celestia.org/nodes/light-node/) macOS app, written in Swift.

A quasar (quasi-stellar object) is a very luminous object in space,
powered by an active galactic nucleus (a light node).

## Features โš™๏ธ

v0.3.0-alpha of this app runs on the [Arabica devnet](https://docs.celestia.org/nodes/arabica-devnet/) (chain ID `arabica-10`) and has the following functions:

* `๐ŸŸฃ Initialize your Celestia light node`: this initializes a Celestia light node in the application's local storage
* `๐ŸŸข Start your node`: this starts the light node
* `๐Ÿ”ด Stop your node`: this stops the light node
* `๐Ÿช™ Check your balance`: this displays the node's balance in TIA to 6 decimal places
* `๐Ÿ“‹ Account address: copy to clipboard`: this is to make it easy to use the faucet and check your balance
* `๐Ÿ—‘๏ธ Delete your data store`: deletes the data store for the node (use with caution)
* `๐Ÿ” Delete your key store`: deletes the key store for the node, the account `my_celes_key` (use with caution)
* `๐Ÿ”ฅ Delete entire node store`: deletes both the data and key store (use with caution)
* `๐Ÿšฐ Faucet`: a direct link to an Arabica faucet
* `๐Ÿ”Ž Block explorer`: a direct link to a block explorer for Arabica

### DASer sampling statistics

* `๐Ÿงช Sampled chain head`: the head of the chain that the light node has sampled
* `๐ŸŽฃ Catchup head`: the head of the chain the node has synchronized
* `๐ŸŒ Network head height`: the head of chain of the network

## Installation ๐Ÿ—๏ธ

### macOS download ๐Ÿ’พ

The latest release with `quazar.dmg`
images for Mac can be found on the
[latest release](https://github.com/jcstein/node-app/releases/latest) page.

Download `quazar.dmg` to your computer and open it from your downloads folder.
Then, drag the "quazar" icon to the "Applications" folder.

Screenshot 2023-06-07 at 1 03 06 AM

### Video tutorial ๐Ÿ“บ

You can view the latest video tutorial [here](https://twitter.com/JoshCStein/status/1666328587400630272?s=20).

### Troubleshooting ๐Ÿ› ๏ธ

If you encounter a warning when you open the app, you will need to go to your
System Preferences > Privacy & Security > Security and select "App Store and identified developers".

Screenshot 2023-06-20 at 4 07 52 PM

## Prerequisites ๐Ÿงฑ

The current version requires:

* macOS 13.1 or higher
* Macs equipped with M1 or M2 chips (as the `celestia` binary is built specifically for ARM Macs in the
versions)

## Application dependencies โฌ‡๏ธ

* `celestia-node` ("CN") binary version: [v0.11.0-rc10](https://github.com/celestiaorg/celestia-node/releases/tag/v0.11.0-rc10)

## Xcode project ๐Ÿ”จ

The Xcode project can be found in [node-app](./node-app/).

### Developer dependencies ๐Ÿ‘ฉโ€๐Ÿ’ป

* Xcode

## App previews ๐Ÿ’ป

### Before starting a node ๐ŸŽฌ

Screenshot 2023-06-07 at 12 45 44 AM

### Initializing a node ๐ŸŸฃ

Screenshot 2023-06-07 at 12 46 18 AM

### Running a node ๐ŸŸข

Screenshot 2023-06-07 at 12 46 59 AM