2021-08-09 14:10:58 +00:00
|
|
|
# Fluffy: The Nimbus Portal Network Client
|
2021-06-17 15:05:00 +00:00
|
|
|
|
2021-06-28 15:53:13 +00:00
|
|
|
[](https://github.com/status-im/nimbus-eth1/actions/workflows/fluffy.yml)
|
2021-06-17 15:05:00 +00:00
|
|
|
|
|
|
|
|
[](https://opensource.org/licenses/Apache-2.0)
|
|
|
|
|
[](https://opensource.org/licenses/MIT)
|
|
|
|
|
|
|
|
|
|
[](https://discord.gg/XRxWahP)
|
|
|
|
|
[](https://join.status.im/nimbus-general)
|
|
|
|
|
|
|
|
|
|
## Introduction
|
|
|
|
|
This folder holds the development of the Nimbus client implementation supporting
|
2021-08-09 14:10:58 +00:00
|
|
|
the Portal Network: fluffy. The Portal Network is a project still heavily in
|
|
|
|
|
research phase and fully in flux. This client is thus still highly experimental.
|
2021-06-17 15:05:00 +00:00
|
|
|
|
|
|
|
|
Current status of specifications can be found in the
|
|
|
|
|
[stateless-ethereum-specs repository](https://github.com/ethereum/stateless-ethereum-specs/blob/master/portal-network.md).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Development Updates
|
|
|
|
|
|
|
|
|
|
To keep up to date with changes and development progress, follow the
|
|
|
|
|
[Nimbus blog](https://our.status.im/tag/nimbus/).
|
|
|
|
|
|
|
|
|
|
## How to Build & Run
|
|
|
|
|
|
|
|
|
|
### Prerequisites
|
|
|
|
|
- GNU Make, Bash and the usual POSIX utilities. Git 2.9.4 or newer.
|
|
|
|
|
|
2021-06-28 15:53:13 +00:00
|
|
|
### Build fluffy client
|
2021-06-17 15:05:00 +00:00
|
|
|
```bash
|
|
|
|
|
git clone git@github.com:status-im/nimbus-eth1.git
|
|
|
|
|
cd nimbus-eth1
|
2021-06-28 15:53:13 +00:00
|
|
|
make fluffy
|
2021-06-17 15:05:00 +00:00
|
|
|
|
|
|
|
|
# See available command line options
|
2021-06-28 15:53:13 +00:00
|
|
|
./build/fluffy --help
|
2021-06-17 15:05:00 +00:00
|
|
|
|
|
|
|
|
# Example command: Run the client and connect to a bootnode.
|
2021-06-28 15:53:13 +00:00
|
|
|
./build/fluffy --log-level:debug --bootnode:enr:<base64 encoding of ENR>
|
2021-06-17 15:05:00 +00:00
|
|
|
```
|
|
|
|
|
|
2021-06-28 15:53:13 +00:00
|
|
|
### Update and rebuild fluffy client
|
2021-06-17 15:05:00 +00:00
|
|
|
```bash
|
|
|
|
|
# From the nimbus-eth1 repository
|
|
|
|
|
git pull
|
|
|
|
|
# To bring the git submodules up to date
|
|
|
|
|
make update
|
|
|
|
|
|
2021-06-28 15:53:13 +00:00
|
|
|
make fluffy
|
2021-06-17 15:05:00 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Windows support
|
|
|
|
|
|
2021-06-28 15:53:13 +00:00
|
|
|
Follow the steps outlined [here](../README.md#windows) to build fluffy on Windows.
|
2021-06-17 15:05:00 +00:00
|
|
|
|
|
|
|
|
|
|
|
|
|
## For Developers
|
|
|
|
|
|
|
|
|
|
When working on this repository, you can run the `env.sh` script to run a
|
|
|
|
|
command with the right environment variables set. This means the vendored
|
|
|
|
|
Nim and Nim modules will be used, just as when you use `make`.
|
|
|
|
|
|
|
|
|
|
E.g.:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
# start a new interactive shell with the right env vars set
|
|
|
|
|
./env.sh bash
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
More [development tips](../README.md#devel-tips)
|
|
|
|
|
can be found on the general nimbus-eth1 readme.
|
|
|
|
|
|
|
|
|
|
The code follows the
|
|
|
|
|
[Status Nim Style Guide](https://status-im.github.io/nim-style-guide/).
|
|
|
|
|
|
|
|
|
|
## License
|
|
|
|
|
|
|
|
|
|
Licensed and distributed under either of
|
|
|
|
|
|
2021-06-28 15:53:13 +00:00
|
|
|
* MIT license: [LICENSE-MIT](../LICENSE-MIT) or http://opensource.org/licenses/MIT
|
2021-06-17 15:05:00 +00:00
|
|
|
|
|
|
|
|
or
|
|
|
|
|
|
2021-06-28 15:53:13 +00:00
|
|
|
* Apache License, Version 2.0, ([LICENSE-APACHEv2](../LICENSE-APACHEv2) or http://www.apache.org/licenses/LICENSE-2.0)
|
2021-06-17 15:05:00 +00:00
|
|
|
|
|
|
|
|
at your option. These files may not be copied, modified, or distributed except according to those terms.
|
