Practical overview
When it fits
Use it when you want a small, self-hosted Go example for exploring node startup, peer joining, HTTP control and block propagation.
Who it is for
- Developers learning how a basic blockchain node and peer-to-peer block propagation work
- Prototypers exploring local multi-node networks, peer joining and HTTP control of nodes
Documented uses
- Build and start local blockchain node processes
- Connect one node to a peer using its address
- Create a block through an HTTP request
- Inspect chain data on connected nodes to observe propagation
Requirements & limits
The repository is public and identified as open source; no license is specified in the supplied project evidence.
- The documented node uses separate HTTP control and TCP peer-to-peer ports.
- The README provides a command-line build and curl-based examples for joining, creating and viewing blocks.
- The demonstrated chain includes a default genesis block and a simple block model.
- The examples cover a basic two-node workflow rather than a broader production deployment.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Build and connect two local nodes
Start two nodes, connect one as a peer, create a block and inspect the chain shown by each node.
Before you start
- Go build environment and command-line access
- Two node processes with separate HTTP control and TCP peer ports
- A reachable peer IP address for the join request
- curl for the documented HTTP requests
Steps
Build the repository with the command below.
go buildStart two node processes with distinct
-serverand-p2pports, as in the README example.Send a POST request to
/blockchain/joinon the first node with the second node’s TCP address aspeer_addr.Use
/blockchain/createto publish a block, then POST to/blockchain/showon both nodes to inspect their chains.
Expected outcome
The README’s example shows the created block appearing in both nodes’ chain output after peer connection and propagation.
Guide limitations
- The steps reflect the repository README; they are not execution-tested here.
- The README demonstrates two connected nodes and a basic chain, not production deployment or broader network operation.
- The repository evidence identifies no license.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 18 October 2026
- Original website title
- Blockchain-CN/blockchain · Official homepage title · retained in its source language

