tutus-chain/README.md

<p align="center">
  <h1 align="center">Tutus</h1>
  <p align="center">
    <strong>Sovereign Blockchain Infrastructure for Government</strong>
  </p>
  <p align="center">
    <a href="https://tutus.one">Website</a> |
    <a href="#quick-start">Quick Start</a> |
    <a href="#documentation">Documentation</a> |
    <a href="#license">License</a>
  </p>
</p>

---

## 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

```bash
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

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

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

### Docker Deployment

```bash
# 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](docs/node-configuration.md) | Full configuration reference |
| [Consensus](docs/consensus.md) | dBFT consensus protocol |
| [RPC API](docs/rpc.md) | JSON-RPC interface |
| [CLI Reference](docs/cli.md) | Command-line interface |
| [Smart Contracts](docs/compiler.md) | Contract development |
| [Oracle](docs/oracle.md) | External data integration |
| [Notary](docs/notary.md) | 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](CONTRIBUTING.md) 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](https://neo.org) blockchain's Go implementation. We gratefully acknowledge the Neo community's contributions to blockchain technology.

Development assisted by [Claude Code](https://claude.ai/code) from Anthropic.

## License

Tutus is licensed under the [Apache License 2.0](LICENSE.md).

```
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.
```

---

<p align="center">
  <sub>Built with purpose for humanity's digital future</sub>
</p>