Tutus blockchain - sovereign government blockchain
Go to file
Tutus Development aee2d44325 Complete Tutus rebranding - remove all Neo dependencies
External dependencies replaced:
- nspcc-dev/dbft -> tutus-one/tutus-consensus
- nspcc-dev/bbolt -> tutus-one/tutus-bolt
- nspcc-dev/go-ordered-json -> tutus-one/tutus-ordered-json
- nspcc-dev/rfc6979 -> tutus-one/tutus-rfc6979

Internal packages renamed:
- pkg/neotest -> pkg/tutustest
- pkg/neorpc -> pkg/tutusrpc
- pkg/interop/neogointernal -> pkg/interop/tutusinternal
- pkg/rpcclient/neo -> pkg/rpcclient/tutus

CLI branding updated to Tutus throughout.
2025-12-21 06:25:15 -05:00
.docker Fix Docker entrypoint CRLF line endings for Linux containers 2025-12-21 04:24:48 -05:00
.github Simplify CI to basic build workflow and add Claude Code acknowledgment 2025-12-21 05:16:25 -05:00
cli Complete Tutus rebranding - remove all Neo dependencies 2025-12-21 06:25:15 -05:00
config Add 6-node testnet with cross-chain Federation support 2025-12-21 02:01:46 -05:00
docs Update documentation for Tutus branding and professional README 2025-12-21 05:07:54 -05:00
examples Complete Tutus rebranding - remove all Neo dependencies 2025-12-21 06:25:15 -05:00
internal Complete Tutus rebranding - remove all Neo dependencies 2025-12-21 06:25:15 -05:00
pkg Complete Tutus rebranding - remove all Neo dependencies 2025-12-21 06:25:15 -05:00
scripts Normalize line endings in workflows, tests, and scripts 2025-12-21 04:35:42 -05:00
.dockerignore Initial Tutus chain fork from NeoGo 2025-12-19 14:23:04 +00:00
.gitignore Initial Tutus chain fork from NeoGo 2025-12-19 14:23:04 +00:00
.gitmodules Initial Tutus chain fork from NeoGo 2025-12-19 14:23:04 +00:00
CHANGELOG.md Update documentation for Tutus branding and professional README 2025-12-21 05:07:54 -05:00
CONTRIBUTING.md Update all imports from neo-go to tutus-chain 2025-12-19 14:28:17 +00:00
Dockerfile Add Docker support for Tutus 2025-12-19 15:02:00 +00:00
Dockerfile.wsc Initial Tutus chain fork from NeoGo 2025-12-19 14:23:04 +00:00
LICENSE.md Initial Tutus chain fork from NeoGo 2025-12-19 14:23:04 +00:00
Makefile Fix build: update branding and local interop module 2025-12-19 14:58:36 +00:00
README.md Simplify CI to basic build workflow and add Claude Code acknowledgment 2025-12-21 05:16:25 -05:00
ROADMAP.md Update documentation for Tutus branding and professional README 2025-12-21 05:07:54 -05:00
TESTNET.md Add 6-node testnet with cross-chain Federation support 2025-12-21 02:01:46 -05:00
codecov.yml Initial Tutus chain fork from NeoGo 2025-12-19 14:23:04 +00:00
devnotes.md Normalize line endings in security remediation files 2025-12-21 04:31:25 -05:00
docker-compose.yml Add 6-node testnet with cross-chain Federation support 2025-12-21 02:01:46 -05:00
go.mod Complete Tutus rebranding - remove all Neo dependencies 2025-12-21 06:25:15 -05:00
go.sum Complete Tutus rebranding - remove all Neo dependencies 2025-12-21 06:25:15 -05:00
tutus.service.template Initial Tutus chain fork from NeoGo 2025-12-19 14:23:04 +00:00

README.md

Tutus

Sovereign Blockchain Infrastructure for Government

Website | Quick Start | Documentation | License


Overview

Tutus is a high-performance blockchain platform engineered for sovereign government deployments. It provides the foundational infrastructure for digital identity, democratic governance, universal services, and transparent economics at national scale.

Key Features

  • Sovereign Architecture — Each government operates an independent blockchain instance with full data sovereignty
  • Sub-Second Finality — 1-second block times with deterministic Byzantine Fault Tolerant (dBFT) consensus
  • Zero-Cost Citizen Access — Native fee subsidization ensures universal access regardless of economic status
  • Constitutional Rights Framework — 14 immutable rights encoded directly into the protocol
  • Cross-Border Interoperability — Optional federation protocol for inter-government cooperation

Performance

Metric Value
Block Time 1 second
Finality Immediate (dBFT)
Throughput ~30,000 TPS
Validators Configurable (default: 7)

Native Contracts

Tutus includes purpose-built native contracts for government operations:

Contract Purpose
Vita Soul-bound identity token (one per person)
Annos Lifespan and age verification
Lex Constitutional rights and legal framework
Scire Universal education infrastructure
Salus Universal healthcare management
Sese Life planning and sabbaticals
Eligere Democratic voting and governance
VTS Government-backed stablecoin
Tribute Anti-hoarding economic policy
Collocatio Citizen investment opportunities
Federation Cross-chain identity coordination
Pons Inter-government bridge protocol
Palam Transparency and audit ledger

Quick Start

Prerequisites

  • Go 1.24 or higher
  • Make

Building

git clone https://github.com/tutus-one/tutus-chain.git
cd tutus-chain
make build

The compiled binary is located at bin/tutus.

Running a Node

# Development
./bin/tutus node --config-file ./config/protocol.tutus.testnet.yml

# Production
./bin/tutus node --config-file ./config/protocol.tutus.yml

Docker Deployment

# Build image
docker build -t tutus .

# Run node
docker run -d \
  --name tutus-node \
  -p 10333:10333 \
  -p 10332:10332 \
  -v tutus-data:/chains \
  tutus

# Multi-node testnet
docker-compose up -d

Documentation

Document Description
Node Configuration Full configuration reference
Consensus dBFT consensus protocol
RPC API JSON-RPC interface
CLI Reference Command-line interface
Smart Contracts Contract development
Oracle External data integration
Notary Multi-signature transactions

Architecture

┌─────────────────────────────────────────────────────────────┐
│                     Government Instance                      │
├─────────────────────────────────────────────────────────────┤
│  Citizens    │  Services    │  Governance   │  Economics    │
│  ─────────   │  ─────────   │  ───────────  │  ──────────   │
│  Vita        │  Scire       │  Eligere      │  VTS          │
│  Annos       │  Salus       │  Lex          │  Tribute      │
│              │  Sese        │               │  Collocatio   │
├─────────────────────────────────────────────────────────────┤
│                    Federation Layer (Optional)               │
│  ─────────────────────────────────────────────────────────  │
│  Federation (Cross-chain Vita) │ Pons (Inter-gov Bridge)    │
└─────────────────────────────────────────────────────────────┘

Configuration

Network configurations are located in ./config/:

Configuration Purpose
protocol.tutus.yml Production deployment
protocol.tutus.testnet.yml Public testnet
protocol.tutus.alpha.*.yml Alpha testnet instance
protocol.tutus.beta.*.yml Beta testnet instance

Security

Tutus implements comprehensive security measures:

  • Domain-Specific Committees — Separate authority for legal, health, education, economic, identity, and governance operations
  • Circuit Breakers — Automatic operation halting on anomaly detection
  • Formal Invariants — Runtime verification of critical protocol properties
  • Comprehensive Audit Logging — Full traceability of all operations

For security issues, contact: security@tutus.one

Contributing

We welcome contributions from the community. Please read our Contributing Guidelines before submitting pull requests.

About

Tutus is developed by MarketAlly as critical infrastructure for the future of digital governance.

Lead Architect: David H. Friedel Jr.

Acknowledgments

Tutus is built upon the foundation of the Neo blockchain's Go implementation. We gratefully acknowledge the Neo community's contributions to blockchain technology.

Development assisted by Claude Code from Anthropic.

License

Tutus is licensed under the Apache License 2.0.

Copyright 2024-2025 MarketAlly

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Built with purpose for humanity's digital future