VIZ.World - home for web blockchain developers and dapps (steem-based)
Clone or download
Pull request Compare This branch is 1004 commits ahead, 2892 commits behind steemit:master.
Latest commit e973d63 Nov 1, 2018

README.md

Introducing VIZ

Build Status

VIZ is an DPOS blockchain with an unproven consensus algorithm.

No Support & No Warranty

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Code is Documentation

Rather than attempt to describe the rules of the blockchain, it is up to each individual to inspect the code to understand the consensus rules.

Quickstart

Just want to get up and running quickly? Try deploying a prebuilt dockerized container. Both common binary types are included.

Dockerized p2p Node

To run a p2p node (ca. 2GB of memory is required at the moment):

docker run \
    -d -p 2001:2001 -p 8090:8090 --name viz-default \
    viz-world/viz-world

docker logs -f viz-default  # follow along

Dockerized Full Node

To run a node with all the data (e.g. for supporting a content website) that uses ca. 14GB of memory and growing:

docker run \
    --env USE_WAY_TOO_MUCH_RAM=1 \
    -d -p 2001:2001 -p 8090:8090 --name viz-full \
    viz-world/viz-world

docker logs -f viz-full

Seed Nodes

A list of some seed nodes to get you started can be found in documentation/seednodes.

This same file is baked into the docker images and can be overridden by setting VIZD_SEED_NODES in the container environment at docker run time to a whitespace delimited list of seed nodes (with port).

How to produce blocks

The produce blocks algorithm used by VIZ requires the owner to have access to the private key used by the account.

./vizd --witness="accountname" --seed-node="95.85.13.229:2225"

Building

See documentation/building.md for detailed build instructions, including compile-time options, and specific commands for Linux (Ubuntu LTS) or macOS X.

Testing

See documentation/testing.md for test build targets and info on how to use lcov to check code test coverage.