# ostracon

**Repository Path**: mirrors_line/ostracon

## Basic Information

- **Project Name**: ostracon
- **Description**: Ostracon, a consensus algorithm, is forked from Tendermint Core. We have added VRF to Tendermint BFT. It adds randomness to PoS Validator elections and improves security.
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-07-08
- **Last Updated**: 2026-03-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Ostracon

![example workflow](https://github.com/Finschia/ostracon/actions/workflows/build.yml/badge.svg)
![example workflow](https://github.com/Finschia/ostracon/actions/workflows/coverage.yml/badge.svg)

[Ostracon](docs/en/01-overview.md "Ostracon: A Fast, Secure Consensus Layer for The Blockchain of New Token Economy")
is forked from Tendermint Core [v0.34.8](https://github.com/tendermint/tendermint/tree/v0.34.8) on 2021-03-15.
And we synced up with Tendermint-[v0.34.24](https://github.com/tendermint/tendermint/tree/v0.34.24) on 2023-07-24.

**Node**: Requires [Go 1.22+](https://golang.org/dl/)

**Warnings**: Initial development is in progress, but there has not yet been a stable.

[](docs/en/01-overview.md)

# Quick Start

## git clone
```shell
git clone https://github.com/Finschia/ostracon.git
# or
git clone git@github.com:Finschia/ostracon.git
```

## Local Standalone
**Build**
 ```sh
 make build     # go help build
 make install   # go help install
 ```

**Run**
 ```sh
 ostracon init
 ostracon node --proxy_app=kvstore                # Run a node
 ```

Before running it, don't forget to cleanup the old files:
 ```sh
 # Clear the build folder
 rm -rf ~/.ostracon
 ```

**Visit with your browser**
* Node: http://localhost:26657/

## Localnet(4 nodes) with Docker
**Build Docker Image**

(optionally) Build the linux binary for localnode in ./build
 ```sh
 make build-localnode
 ```
(optionally) Build ostracon/localnode image
 ```sh
 make build-localnode-docker
 ```

**Run localnet**

To start 4 nodes
 ```sh
 make localnet-start
 ```

Before running it, don't forget to cleanup the old files
 ```sh
 rm -rf ./build/node*
 ```

**Visit with your browser**
* Node: http://localhost:26657/

## Linux Docker
**Build Docker Image**

Build the linux binary
 ```sh
 make build-linux-docker
 ```

**Run a linux docker node**

To start a linux node
 ```sh
 make standalone-linux-docker
 ```

**Visit with your browser**
* Node: http://localhost:26657/