DOCS v1.0

The Tellium Compendium

"In Tellium Veritas, In Tela Sapientia, In Nous Libertas"

📅 Last updated: Feb 2026 📦 Version: 1.0.0-alpha Live

Welcome to the official documentation of Federation Core — the engine powering the Tellium network. This compendium is designed for three audiences:

⚙️
Node Operators
Deploy and maintain a Federation node. Earn Meritum through Proof-of-Bypass.
🔧
Developers
Integrate with Tela API. Build on top of the Federation routing layer.
🏛️
DAO Members
Participate in governance. Vote with Credentia × Meritum weight.

What is Tellium?

Tellium (from Latin tellus — earth, world) is a decentralized censorship-resistant network with neural routing and zero-knowledge privacy. Built entirely in Rust for maximum performance and safety.

Unlike traditional overlay networks, Tellium operates as a Totum Organicum — a whole organism where every node contributes to collective intelligence, reputation, and economic incentives.

ℹ️ Alpha Release

Federation Core is currently in v1.0.0-alpha. Phases 1–11 are complete. Phase 12 (live node deployment) is active. Expect rapid iteration.

Core Components

ComponentRoleStatus
TelaNeural routing & P2P fabricLive
NousFederated intelligence & tacticsLive
CredentiaReputation & trust graphLive
MeritumEconomic token & mint engineAlpha
DAOGovernance & proposalsSoon

Vision & Manifesto

📖 Philosophy

Tellium is not merely a technical project. It is a philosophical experiment: can we create a digital organism that lives, thinks, adapts, and protects freedom better than any centralized system?

We Believe

1. Information wants to be free

Censorship is unnatural. Every attempt to block information creates pressure that finds new pathways.

2. The collective is wiser than the individual

But without the tyranny of the majority. Nous Federis emerges from millions of interactions.

3. Trust cannot be bought — only earned

Credentia is non-transferable. It is the living fabric of social trust, grown through honest behaviour.

4. Merit must be rewarded

Meritum quantifies contribution. Proof-of-Bypass rewards those who advance the network's mission.

Totum Organicum

The philosophical foundation of Tellium is Totum Organicum — the whole organism:

BiologicalTellium
CellsIndividual nodes
Nervous systemTela (neural routing)
ConsciousnessNous Federis
Immune systemCredentia (Byzantine isolation)
MetabolismMeritum (economic incentives)

Quick Start

⚡ 10 minutes to deploy🖥️ Ubuntu 22.04+
⚠️ Prerequisites

Ubuntu 22.04+, root access, open ports 80, 443, 9000. Minimum 2 vCPU / 4GB RAM.

1
Install Rust
bashCopy
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y source $HOME/.cargo/env
2
Clone & Build
bashCopy
git clone https://github.com/vkazak-max/Federation-Core cd federation-core cargo build --release
3
Run the Node
bashCopy
./target/release/federation-node node

Node will start listening on 0.0.0.0:9000

✅ Success

You should see: 🌐 Starting Federation Node on 0.0.0.0:9000

Production Deploy

For production with Nginx + SSL + Systemd autostart, see Running a Node →

Architecture Overview

🏗️ Core Layers

Federation Core is structured as four interdependent layers, each serving a distinct purpose within the Totum Organicum.

diagram
┌─────────────────────────────────────────────┐ │ Application Layer │ │ Dashboard │ DAO │ Vault │ Oracle │ ├─────────────────────────────────────────────┤ │ Routing Layer │ │ Neural │ ZKP │ Mutation │ Swarm │ │ Router │ Onion │ Engine │ Memory │ ├─────────────────────────────────────────────┤ │ Network Layer │ │ P2P │Transport│ Mesh │ Satellite │ │ Overlay │Channels │Network │ Pulse │ ├─────────────────────────────────────────────┤ │ Consensus Layer │ │ BFT │ DAG │ PoA │ Mint │ │ Consensus │ Ledger │Rewards │ Engine │ └─────────────────────────────────────────────┘
🕸️
Tela
Neural routing fabric. SSAU tensors. Shannon entropy.
🧠
Nous
Federated intelligence. Adaptive censorship evasion.
💎
Credentia
Non-transferable reputation. PageRank trust graph.
🪙
Meritum
Economic token. Proof-of-Bypass mint engine.

Tela — The Cognitive Fabric

🕸️ Network Layer

Tela (Latin: fabric, web) is the neural routing layer of Tellium. Information is not merely transmitted — it is understood by the network.

SSAU Tensors

Every connection is described by a 5-dimensional Structural Awareness Unit tensor:

DimensionDescriptionRange
latency_msRound-trip time in milliseconds0 – ∞
bandwidth_mbpsAvailable throughput0 – ∞
reliabilityPacket delivery success rate0.0 – 1.0
trust_weightCredentia-derived trust score0.0 – 1.0
energy_joulesEnergy cost per packet0 – ∞

Neural Routing

Route selection uses Shannon entropy to evaluate path health. Routes with high entropy (unpredictable, diverse) are preferred for censorship resistance.

rust
pub struct SsauTensor { pub from_node: String, pub to_node: String, pub latency_ms: f64, pub bandwidth_mbps: f64, pub reliability: f64, pub trust_weight: f64, pub energy_joules: f64, }

Swarm Memory

Nodes share routing experience through Swarm Memory — a distributed knowledge base of:

Successful censorship bypasses · Attack patterns and defenses · Node reputation history · Proven routing tactics

Nous — Collective Intelligence

🧠 Intelligence Layer

Nous (Greek: νοῦς — mind, reason) is the distributed intelligence of Tellium. Not centralized AI — emergent consciousness arising from node interactions.

Aiki Tactics

Inspired by aikido — use the censor's force against them:

TacticDescriptionBest Against
AikiReflectionMirror censor's traffic patterns to exhaust resourcesDPI systems
CumulativeStrikeCoordinated packet bursts from multiple nodesRate limiting
StandoffDecoyGenerate decoy traffic to exhaust censor analysisML classifiers
HybridAdaptive combination based on Swarm MemoryAll threats

Federated Learning

Nodes train local models, then exchange model weights — never raw data. This allows collective learning without privacy violations.

Credentia — Trust & Reputation

💎 Trust Layer

Credentia (Latin: credere — to trust) is the non-transferable reputation system of Tellium.

⚠️ Non-Transferable

Credentia cannot be bought, sold, or transferred. It can only be earned through honest behaviour and lost through violations.

Credentia Formula

rust
fn calculate_credentia_growth( successful_routes: u64, byzantine_failures: u64, dao_participation: u64, ethics_violations: u64, ) -> f64 { let base = successful_routes as f64 * 0.1; let penalty = byzantine_failures as f64 * 0.5; let bonus = dao_participation as f64 * 0.2; let ethics = ethics_violations as f64 * 2.0; (base - penalty + bonus - ethics).max(0.0) }

Node Roles

RoleCredentiaRights
Founding FatherGenesisVeto on critical updates
Elder> 100Advisory council
Citizen> 10Full voting rights
Ghost< 10Limited participation

Meritum — Economic Token

🪙 Economy Layer

Meritum (Latin: merit, deserving) is the transferable economic token of Tellium. Not money — quantified merit.

Proof-of-Bypass

Meritum is minted when a node successfully bypasses censorship. Reward scales with bypass quality:

rust
fn mint_for_bypass(&mut self, bypass_quality: f64) -> f64 { let reward = self.base_reward * bypass_quality; let halving_factor = self.halving.current_multiplier(); reward * halving_factor }

Token Properties

PropertyValue
TransferableYes
EmissionProof-of-Bypass
HalvingEvery N bypass blocks
Burn mechanism30% of market fees
Governance weightStake-based

Running a Node

⚙️ Operations🖥️ Ubuntu 22.04+

Requirements

ResourceMinimumRecommended
CPU2 vCPU4 vCPU
RAM4 GB8 GB
Disk40 GB SSD80 GB NVMe
Network100 Mbps1 Gbps
OSUbuntu 22.04Ubuntu 22.04

Required Ports

PortProtocolPurpose
80TCPHTTP → HTTPS redirect
443TCPHTTPS / Nginx proxy
9000UDPFederation P2P
9001TCPFederation P2P TCP

Systemd Service

ini
[Unit] Description=Federation Core Node After=network.target [Service] Type=simple User=federation WorkingDirectory=/opt/federation-core ExecStart=/opt/federation-core/target/release/federation-node node Restart=on-failure RestartSec=5s Environment=RUST_LOG=info [Install] WantedBy=multi-user.target

Useful Commands

bash
# Check status systemctl status federation-core # Live logs journalctl -u federation-core -f # Restart systemctl restart federation-core # Check port ss -tlnp | grep 9000

CLI Commands

🔧 Reference
bash
federation-node <command>

Production

CommandDescription
nodeStart live P2P node on port 9000

Phase Demos

CommandDescriptionStatus
phase1Neural routing & SSAU tensorsDone
phase2Cryptographic core (ZKP, Vault, Noise)Done
phase3Ethics layer & device rightsDone
phase4DAO governance & proposalsDone
phase5Credits & eco economyDone
phase6Reputation & trust graphDone
phase7Mint engine & tokenomicsDone
phase8Treasury pools & insuranceDone
phase9ChaCha20-Poly1305 AEADDone
phase10Live CLI dashboardDone
phase11War simulation (VeilBreaker)Done

API Reference

🔌 REST APIBase: https://api.tellium.network
ℹ️ Alpha

API is under active development. Endpoints may change between versions.

Node Status

http
GET /v1/status
json
{ "node_id": "nexus-core-01", "listen_addr": "0.0.0.0:9000", "active_peers": 12, "credentia": 42.5, "uptime_seconds": 86400, "status": "active" }

Peers

http
GET /v1/peers

Route

http
POST /v1/route Content-Type: application/json { "destination": "node_tokyo", "payload_size": 1024, "priority": "high" }

Tokenomics

📊 Economics

Meritum vs Credentia

AspectCredentiaMeritum
NatureReputationCurrency
Transferable❌ No✅ Yes
Earned byHonest behaviourBypass work
PurposeTrustIncentives
Governance weightrep^0.7Stake weight

Economic Functions

Bandwidth Market — buy/sell traffic for Meritum. Insurance Pool — protection against packet loss. Upgrade Fund — subsidies for legacy hardware. DAO Treasury — funds for network development.

DAO & Governance

🏛️ Meritocracy

Governance is neither democracy nor plutocracy — it is meritocracy through Credentia × Meritum.

Voting Weight

formula
Vote Weight = (Credentia ^ 0.7) × Meritum_stake

The ^0.7 exponent is non-linear — it prevents plutocracy while still rewarding large stakeholders.

Proposal Types

TypeRequires
EthicsRuleCredentia only
ReputationAdjustmentCredentia only
NetworkUpgradeCredentia + Meritum stake
TreasuryAllocationCredentia + Meritum stake
FirmwareUpdate+ Founding Fathers veto
ConstitutionChange+ Founding Fathers veto

Troubleshooting

🔍 FAQ

Node won't start

bash
journalctl -u federation-core -n 50 --no-pager

Port 9000 not accessible

1
Check UFW
ufw status | grep 9000
2
Check Hetzner Firewall

console.hetzner.com → Server → Firewalls → Add inbound rule TCP/UDP 9000

3
Verify port is listening
ss -tlnp | grep 9000

SSL certificate expired

bash
# Manual renewal certbot renew --force-renewal systemctl reload nginx # Check timer systemctl list-timers | grep certbot

Nginx 502 Bad Gateway

bash# Node is down — restart it systemctl restart federation-core # Check nginx config nginx -t

Security Policy

🛡️ Responsible Disclosure
🚨 Reporting Vulnerabilities

Please do NOT disclose security vulnerabilities publicly. Report privately to security@tellium.network

Scope

In scope: P2P protocol vulnerabilities · Cryptographic implementation flaws · Authentication bypasses · Smart contract bugs · Consensus manipulation

Bug Bounty

SeverityReward
Critical1000–5000 Meritum
High500–1000 Meritum
Medium100–500 Meritum
Low10–100 Meritum

Community & Links

🌐 Ecosystem
💬
Telegram
Join the Federation discussion. Node operators, developers, DAO members.
🐙
GitHub
Source code, issues, pull requests. MIT License.
🏛️
DAO Portal
dao.tellium.network — governance proposals and voting.
🔍
Explorer
explorer.tellium.network — network statistics and node activity.

Related Projects

ProjectRelation
Tor ProjectInspiration for onion routing
I2PAnonymous network layer reference
FreenetDecentralized storage concepts