Skip to main content

Overview

You can easily set up your own local DATA Network using docker compose, consisting of one boot node and four validator nodes. With this local network, you can test the consensus layer of the DATA Network or deploy your application using the precompiled primitive, the IP graph, to conduct various tests. Additionally, you can reset the network at any time as needed.

Run a Local DATA Network

For more detailed information for running the DATA Foundation local network, please refer the repository: https://github.com/piplabs/story-localnet

Prerequisite

To set up a local network, Docker is required.

Step 1 - Start Docker

Please run Docker.

Step 2 - Clone Repository

You need to clone three repositories: story, story-geth, and story-localnet.
Make sure all three repositories are located within the same subfolder.

Step 3 - Start Nodes

Navigate to story-localnet project and start the local network.

Step 4 - Terminate Nodes

If you want to stop the DATA Foundation local network, you can do so by executing the script below.

How to Allocate Token to Your Account From Genesis

You may need to allocate DATA tokens to your account for testing in the local network.
To allocate tokens to your account in the genesis block, follow these steps:
  1. Add your account information to the alloc section in config/story/genesis-geth.json:
  1. Run the update-genesis-hash.sh script to update the genesis block hash:

How to Interact With the DATA Foundation Local Network

By default, the DATA Foundation local network has the following ports open for interaction.

Monitoring Systems

This setup includes a monitoring stack to provide centralized metrics and logs
visualization for the blockchain network. Tools include Prometheus, Loki, Promtail, and Grafana, all integrated through Docker Compose.

Components and Access Information