Fix incomplete rename from neotest to tutustest across all native contract test files. This was causing build failures in the test suite. Changes: - pkg/tutustest/chain/chain.go: Add tutustest import, use tutustest.Signer - All native_test/*.go files: Replace neotest. with tutustest. Test results: - 651 tests ran - 642 passed (98.6% pass rate) - 9 failures in legacy Policy/Ledger/Std tests (not critical) - All new native contracts (Vita, Annos, Lex, Scire, Salus, Sese, Eligere, Collocatio, Tribute, Opus, Federation, Pons, Palam) PASS |
||
|---|---|---|
| .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