Create pluggable storage abstraction for government blockchain deployments: pkg/storage/ - storage.go: Core Provider, BlockStorage, StateStorage interfaces - config.go: Configuration for NeoFS, Local, S3 backends - errors.go: Common storage error types - doc.go: Package documentation with compliance guidance pkg/storage/neofs/ - Adapter implementing Provider interface (placeholder for NeoFS SDK) pkg/storage/local/ - Full implementation for local filesystem storage - Content-addressed storage with SHA256 IDs - Metadata JSON sidecar files docs/storage.md: Comprehensive documentation covering: - Data sovereignty compliance (GDPR, China CSL, etc.) - Provider configuration examples - Interface reference - Security considerations This enables nations to choose compliant storage backends while maintaining a consistent API for block and state storage. |
||
|---|---|---|
| .docker | ||
| .github | ||
| cli | ||
| config | ||
| docs | ||
| examples | ||
| internal | ||
| pkg | ||
| scripts | ||
| .dockerignore | ||
| .gitignore | ||
| .gitmodules | ||
| CHANGELOG.md | ||
| CONTRIBUTING.md | ||
| Dockerfile | ||
| Dockerfile.wsc | ||
| LICENSE.md | ||
| Makefile | ||
| README.md | ||
| ROADMAP.md | ||
| TESTNET.md | ||
| codecov.yml | ||
| devnotes.md | ||
| docker-compose.yml | ||
| go.mod | ||
| go.sum | ||
| tutus.service.template | ||
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