status-im / nimbus-eth1

# Nimbus: ultra-light Ethereum execution layer client
## Introduction
This repository contains development work on an execution-layer client to pair with our consensus-layer client. This client focuses on efficiency and security and strives to be as light-weight as possible in terms of resources used.
This repository is also home to:
- Nimbus Portal client, a
Portal Network
light client.
- Nimbus Verified Proxy
All consensus-layer client development is happening in parallel in the
nimbus-eth2 repository.
## Development Updates
For more detailed write-ups on the development progress, follow the
Nimbus blog.
## Building & Testing
### Prerequisites
* GNU Make, Bash and the usual POSIX utilities. Git 2.9.4 or newer.
#### Obtaining the prerequisites through the Nix package manager
*Experimental*
Users of the Nix package manager can install all prerequisites simply by running:
 [code] 
### Build & Develop
#### POSIX-compatible OS
 [code] 
To run a command that might use binaries from the Status Nim fork:
 [code] 
#### Windows
_(Experimental support!)_
Install Mingw-w64 for your architecture using the "MinGW-W64 Online
Installer" (first link
under the directory listing). Run it and select your architecture in the setup
menu ("i686" on 32-bit, "x86\_64" on 64-bit), set the threads to "win32" and
the exceptions to "dwarf" on 32-bit and "seh" on 64-bit. Change the
installation directory to "C:\mingw-w64" and add it to your system PATH in "My
Computer"/"This PC" -> Properties -> Advanced system settings -> Environment
Variables -> Path -> Edit -> New -> C:\mingw-w64\mingw64\bin (it's "C:\mingw-w64\mingw32\bin" on 32-bit)
Install Git for Windows and use it to clone Nimbus.
Install cmake.
After adding the Git bin directory to your path open a "Git Bash" shell:
 [code] 
After installing Mingw-w64 and adding it to your path you should have the `mingw32-make` tool available. Next create a link from `make` to `mingw32-make`:
 [code] 
You can now follow those instructions in the previous section. For example:
 [code] 
#### Raspberry PI
*Experimental* The code can be compiled on a Raspberry PI:
* Raspberry Pi 4+
* 64GB SD Card (less might work too, but the default recommended 4-8GB will probably be too small)
* Rasbian Buster Lite - Lite version is enough to get going and will save some disk space!
Assuming you're working with a freshly written image:
 [code] 
#### Android
*Experimental* Code can be compiled and run on Android devices
##### Environment setup
* Install the Termux app from FDroid or the Google Play store
* Install a PRoot of your choice following the instructions for your preferred distribution.
Note, the Ubuntu PRoot is known to contain all Nimbus prerequisites compiled on Arm64 architecture (common architecture for Android devices). Depending on the distribution, it may require effort beyond the scope of this guide to get all prerequisites.
*Assuming Ubuntu PRoot is used*
 [code] 
### Experimental make variables
Apart from standard Make flags (see