49 lines
1.5 KiB
Markdown
49 lines
1.5 KiB
Markdown
# nim-status
|
|
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
|
|
![Stability: experimental](https://img.shields.io/badge/Stability-experimental-orange.svg)
|
|
[![Tests (GitHub Actions)](https://github.com/status-im/nim-status/workflows/Tests/badge.svg?branch=master)](https://github.com/status-im/nim-status/actions?query=workflow%3ATests+branch%3Amaster)
|
|
|
|
Nim implementation of the Status protocol: https://github.com/status-im/specs
|
|
|
|
Corresponds roughly to status-go: https://github.com/status-im/status-go which is consumed by status-react: https://github.com/status-im/status-react/
|
|
|
|
### Requirements
|
|
* Go - (used to build status-go)
|
|
```
|
|
# Linux
|
|
<TODO>
|
|
|
|
# macOS
|
|
brew install go
|
|
```
|
|
|
|
### Installation
|
|
```
|
|
git clone https://github.com/status-im/nim-status
|
|
cd nim-status
|
|
make update
|
|
make
|
|
```
|
|
|
|
For more output use `make V=1 ...`.
|
|
|
|
Use 4 CPU cores with `make -j4 ...`.
|
|
|
|
### Usage
|
|
- Include `build/nim_status.a`, `build/nim_status.h` in your project
|
|
- Before any of the API calls are done, NimMain() needs to be run.
|
|
|
|
|
|
### Troubleshooting
|
|
|
|
If the `make` command fails due to already installed Homebrew packages, such as:
|
|
|
|
```
|
|
Error: protobuf 3.11.4 is already installed
|
|
To upgrade to 3.11.4_1, run `brew upgrade protobuf`.
|
|
make[1]: *** [install-os-dependencies] Error 1
|
|
make: *** [vendor/status-go/build/bin/libstatus.a] Error 2
|
|
```
|
|
|
|
This can be fixed by uninstalling the package e.g. `brew uninstall protobuf` followed by rerunning `make`.
|