Skip to content

nervosnetwork/neuron

Folders and files

NameName
Last commit message
Last commit date

Latest commit

f7324c7 · Feb 15, 2025
Jan 9, 2025
Jul 7, 2023
Jun 6, 2023
Feb 14, 2025
Aug 11, 2024
Nov 29, 2024
Jan 24, 2025
Oct 12, 2022
Feb 20, 2019
Jun 29, 2023
May 16, 2023
Feb 5, 2023
Feb 14, 2025
Feb 10, 2024
Aug 14, 2024
Aug 2, 2024
Feb 15, 2025
Aug 8, 2019
Feb 14, 2025
Aug 4, 2019
Feb 14, 2025
Dec 19, 2023
Dec 19, 2023
Feb 11, 2025

Repository files navigation

Neuron

Nervos CKB Full-Node Desktop Wallet

Unit Tests Discord


Quick Start

Prerequisites

You will need node >= 18.12.0 and yarn >= 1.14 to build and run Neuron.

Lerna

This project uses lerna for package management.

$ yarn global add lerna # install lerna globally

Install Dependencies

Notes:

  1. Please set proxy if you are using a proxy locally and find the downloading is halted
  2. Please set CDN if the downloading is slow

After lerna has been installed, run this to install and link dependencies:

$ yarn
$ lerna run rebuild:nativemodules

Add CKB Indexer

CKB Indexer is a service to create cell and transaction indexes.

Download CKB Indexer and move the binary into packages/neuron-wallet/bin/{win/linux/mac}/.

Start Neuron

As of v0.26.0, Neuron bundles a CKB binary and starts it for Mainnet automatically. If you prefer to run a local CKB node yourself instead, please follow the Nervos CKB doc to get it up and running before launching Neuron.

Note: If you run CKB node on Windows but it fails to start, you may need to download and install the latest Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017 and 2019.

Start Neuron in Development Mode

$ ./scripts/download-ckb.sh # Download CKB binary for your platform. Neuron will starts it automatically.
$ yarn start

This command starts neuron-ui, the React UI layer and neuron-wallet, the core wallet layer.

You can also start them independently:

# start neuron-ui at `http://localhost:3000`
$ yarn start:ui
# start neuron-wallet
$ yarn start:wallet

If you want to develop with devnet, replace the testnet script with the dev script in the packages/neuron-wallet/.env file.

Here is a script env example, it is constructed by network、script name and filed name.

TESTNET_SUDT_DEP_TXHASH=0xe12877ebd2c3c364dc46c5c992bcfaf4fee33fa13eebdf82c591fc9825aab769
TESTNET_SUDT_DEP_INDEX=0
TESTNET_SUDT_DEP_TYPE=code
TESTNET_SUDT_SCRIPT_CODEHASH=0xc5e5dcf215925f7ef4dfaf5f4b4f105bc321c02776d6e7d52a1db3fcd9d011a4
TESTNET_SUDT_SCRIPT_HASHTYPE=type

Test

$ yarn test

Download Neuron Binary

If you don't want to bother building from source, you can download a binary from releases. We offer pre-built binaries for Windows, Linux and macOS.

License

Neuron is released under the terms of the MIT license. See COPYING for more information or see https://opensource.org/licenses/MIT.