ArthurTh0mas / Benson

Benson Box built on Substrate for a world UNcorporated.

Benson Box

Benson Box built on Substrate. For getting started and technical guides, please refer to the Benson Wiki.

Contributing

All PRs are welcome! Please follow our contributing guidelines here.

---

Community

Join our official Benson Discord server 🤗

• Get Benson technical support 🛠
• Meet startups and DApp developers 👯‍♂️
• Learn more about Benson and blockchain 🙌
• Get updates on Benson bounties and grants 💰
• Hear about the latest hackathons, meetups and more 👩‍💻

Join the Discord server by clicking on the badge below!

Run with Docker

Use the latest Benson docker image to get started quickly

# Start a local validator on a development chain
$ docker run \
    -p 9933:9933 -p 9944:9944 \
    ng8eke/benson:latest \
    --dev \
    --unsafe-ws-external \
    --unsafe-rpc-external

Run from Source

Follow the steps to build and run a Benson Box from the source code.

1) Set up build environment

For Linux (the example below is for Debian-based machines):

$ sudo apt install -y build-essential clang cmake gcc git libclang-dev libssl-dev pkg-config

For MacOS (via Homebrew):

$ brew install openssl cmake llvm

2) Install Rust

Install Rust on your machine through here, and the following rust version and toolchains.

$ cargo --version
$ rustup install nightly
$ rustup target add --toolchain=nightly wasm32-unknown-unknown

3) Build and Run

Clone the repo, build the binary and run it.

$ git clone https://github.com/ng8eke/benson.git
$ cd benson
$ cargo build --release # or remove  '--release' for quick debug build
$ ./target/release/benson --help

# start a validator node for development
$ ./target/release/benson --dev

Build Docker Image

Prepare your docker engine, and make sure it is running.

# To use the default image name and tag
$ make 

# To custom your image name and tag
$ IMAGE_NAME='benson' IMAGE_TAG='v1.5.1' DOCKER_BUILD_ARGS='--no-cache --quiet' make build

# Without using make
$ docker build --no-cache -t benson:v1.5.1 .