Skip to main content

Introduction

Tashi Vertex is an embedded Byzantine fault-tolerant consensus engine that provides fast, reliable consensus through the Hashgraph algorithm. This Rust SDK provides safe, ergonomic bindings to build distributed consensus applications.

What is Tashi Vertex?

Tashi Vertex uses a DAG (Directed Acyclic Graph) of cryptographically signed events and virtual voting to achieve consensus finality in under 100 milliseconds — without exchanging explicit vote messages. For a detailed explanation of the consensus protocol, see the Vertex whitepaper.

Key features

Fast BFT consensus

Sub-100ms finality with tolerance up to f = ⌊(n-1)/3⌋ Byzantine participants

Async-first design

Socket binding and message receiving are Future-based, integrating seamlessly with Tokio

Zero runtime dependencies

Only links dynamically to the tashi-vertex C library

Safe FFI

Opaque pointer wrappers with automatic cleanup via Drop

Highly configurable

15+ tunable engine parameters for heartbeat, latency thresholds, epoch sizing, and more

Base58 utilities

Built-in encode/decode for keys and binary data

Core API types

The SDK provides the following core types:
TypeDescription
EngineStarts and drives the consensus engine — send transactions and receive ordered messages
ContextRuntime context managing async operations and resources
SocketAsync network socket bound to a local address
OptionsEngine configuration (heartbeat, latency, epoch size, threading, etc.)
MessageReceived message — either an Event or a SyncPoint
EventA finalized event carrying consensus-ordered transactions
TransactionAllocated buffer for submitting data to the network
KeySecretEd25519 secret key for signing (Base58/DER serializable)
KeyPublicEd25519 public key for verification (Base58/DER serializable)
PeersSet of network participants with addresses and capabilities
SyncPointSession management decision from the consensus layer
base58Base58 encoding/decoding utilities

Next steps

Installation

Install the SDK and set up your development environment

Quickstart

Build your first consensus network in minutes

Build docs developers (and LLMs) love