Practical overview
When it fits
Use IOST when a project needs the IOST blockchain implementation, JavaScript smart-contract execution or a local node workflow for application development and testing.
Who it is for
- Blockchain developers building applications for the IOST ecosystem
- Node operators working with the IOST blockchain implementation
- Teams testing IOST applications on a local development network
- Developers packaging an IOST node as a Docker image
Documented uses
- Run an IOST blockchain node
- Build JavaScript smart contracts for IOST
- Create a local network for application integration testing
- Package the node implementation as a Docker image
- Develop high-throughput decentralized applications using IOST infrastructure
Requirements & limits
The repository is publicly accessible and identified with an LGPL-3.0 license. The documented build environment is Ubuntu 22.04 or later with Go 1.20 or later and x64 architecture.
- The node is implemented in Go, so Go-based build tooling is part of the documented environment.
- JavaScript smart-contract execution is provided through the integrated V8 engine.
- The V8 CGO dependency limits the documented node environment to x64 architecture.
- The repository documents separate options for a local binary, a local development network and a Docker image.
- The project describes high throughput, rapid finality and free transactions supported through staking for gas.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up an IOST local development workflow
Prepare the documented IOST build and local development options for testing blockchain applications.
Before you start
- Ubuntu 22.04 or later
- Go 1.20 or later
- x64 architecture
- A local checkout of the IOST go-iost repository
Steps
Build the local IOST binary with the command below.
make buildStart a local development network with the command below.
make debugBuild a Docker image with the command below when a containerized node package is required.
make image
Expected outcome
A locally built IOST node, a local development network, or a Docker image, depending on the selected documented step.
Guide limitations
- The repository states that the V8 JavaScript engine requires x64 architecture.
- These documented steps cover building and local development setup; they do not describe a complete application deployment workflow.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 2 October 2026
- Original website title
- iost-official/go-iost · Official homepage title · retained in its source language

