Welcome to the official documentation of Federation Core — the engine powering the Tellium network. This compendium is designed for three audiences:
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.
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
| Component | Role | Status |
|---|---|---|
Tela | Neural routing & P2P fabric | Live |
Nous | Federated intelligence & tactics | Live |
Credentia | Reputation & trust graph | Live |
Meritum | Economic token & mint engine | Alpha |
DAO | Governance & proposals | Soon |
Vision & Manifesto
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
Censorship is unnatural. Every attempt to block information creates pressure that finds new pathways.
But without the tyranny of the majority. Nous Federis emerges from millions of interactions.
Credentia is non-transferable. It is the living fabric of social trust, grown through honest behaviour.
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:
| Biological | Tellium |
|---|---|
| Cells | Individual nodes |
| Nervous system | Tela (neural routing) |
| Consciousness | Nous Federis |
| Immune system | Credentia (Byzantine isolation) |
| Metabolism | Meritum (economic incentives) |
Quick Start
Ubuntu 22.04+, root access, open ports 80, 443, 9000. Minimum 2 vCPU / 4GB RAM.
bashCopycurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source $HOME/.cargo/env
bashCopygit clone https://github.com/vkazak-max/Federation-Core
cd federation-core
cargo build --release
bashCopy./target/release/federation-node node
Node will start listening on 0.0.0.0:9000
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
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 — The Cognitive Fabric
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:
| Dimension | Description | Range |
|---|---|---|
latency_ms | Round-trip time in milliseconds | 0 – ∞ |
bandwidth_mbps | Available throughput | 0 – ∞ |
reliability | Packet delivery success rate | 0.0 – 1.0 |
trust_weight | Credentia-derived trust score | 0.0 – 1.0 |
energy_joules | Energy cost per packet | 0 – ∞ |
Neural Routing
Route selection uses Shannon entropy to evaluate path health. Routes with high entropy (unpredictable, diverse) are preferred for censorship resistance.
rustpub 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
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:
| Tactic | Description | Best Against |
|---|---|---|
AikiReflection | Mirror censor's traffic patterns to exhaust resources | DPI systems |
CumulativeStrike | Coordinated packet bursts from multiple nodes | Rate limiting |
StandoffDecoy | Generate decoy traffic to exhaust censor analysis | ML classifiers |
Hybrid | Adaptive combination based on Swarm Memory | All threats |
Federated Learning
Nodes train local models, then exchange model weights — never raw data. This allows collective learning without privacy violations.
Credentia — Trust & Reputation
Credentia (Latin: credere — to trust) is the non-transferable reputation system of Tellium.
Credentia cannot be bought, sold, or transferred. It can only be earned through honest behaviour and lost through violations.
Credentia Formula
rustfn 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
| Role | Credentia | Rights |
|---|---|---|
| Founding Father | Genesis | Veto on critical updates |
| Elder | > 100 | Advisory council |
| Citizen | > 10 | Full voting rights |
| Ghost | < 10 | Limited participation |
Meritum — Economic Token
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:
rustfn 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
| Property | Value |
|---|---|
| Transferable | Yes |
| Emission | Proof-of-Bypass |
| Halving | Every N bypass blocks |
| Burn mechanism | 30% of market fees |
| Governance weight | Stake-based |
Running a Node
Requirements
| Resource | Minimum | Recommended |
|---|---|---|
| CPU | 2 vCPU | 4 vCPU |
| RAM | 4 GB | 8 GB |
| Disk | 40 GB SSD | 80 GB NVMe |
| Network | 100 Mbps | 1 Gbps |
| OS | Ubuntu 22.04 | Ubuntu 22.04 |
Required Ports
| Port | Protocol | Purpose |
|---|---|---|
80 | TCP | HTTP → HTTPS redirect |
443 | TCP | HTTPS / Nginx proxy |
9000 | UDP | Federation P2P |
9001 | TCP | Federation 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
bashfederation-node <command>
Production
| Command | Description |
|---|---|
node | Start live P2P node on port 9000 |
Phase Demos
| Command | Description | Status |
|---|---|---|
phase1 | Neural routing & SSAU tensors | Done |
phase2 | Cryptographic core (ZKP, Vault, Noise) | Done |
phase3 | Ethics layer & device rights | Done |
phase4 | DAO governance & proposals | Done |
phase5 | Credits & eco economy | Done |
phase6 | Reputation & trust graph | Done |
phase7 | Mint engine & tokenomics | Done |
phase8 | Treasury pools & insurance | Done |
phase9 | ChaCha20-Poly1305 AEAD | Done |
phase10 | Live CLI dashboard | Done |
phase11 | War simulation (VeilBreaker) | Done |
API Reference
API is under active development. Endpoints may change between versions.
Node Status
httpGET /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
httpGET /v1/peers
Route
httpPOST /v1/route
Content-Type: application/json
{
"destination": "node_tokyo",
"payload_size": 1024,
"priority": "high"
}
Tokenomics
Meritum vs Credentia
| Aspect | Credentia | Meritum |
|---|---|---|
| Nature | Reputation | Currency |
| Transferable | ❌ No | ✅ Yes |
| Earned by | Honest behaviour | Bypass work |
| Purpose | Trust | Incentives |
| Governance weight | rep^0.7 | Stake 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
Governance is neither democracy nor plutocracy — it is meritocracy through Credentia × Meritum.
Voting Weight
formulaVote Weight = (Credentia ^ 0.7) × Meritum_stake
The ^0.7 exponent is non-linear — it prevents plutocracy while still rewarding large stakeholders.
Proposal Types
| Type | Requires |
|---|---|
| EthicsRule | Credentia only |
| ReputationAdjustment | Credentia only |
| NetworkUpgrade | Credentia + Meritum stake |
| TreasuryAllocation | Credentia + Meritum stake |
| FirmwareUpdate | + Founding Fathers veto |
| ConstitutionChange | + Founding Fathers veto |
Troubleshooting
Node won't start
bashjournalctl -u federation-core -n 50 --no-pager
Port 9000 not accessible
ufw status | grep 9000console.hetzner.com → Server → Firewalls → Add inbound rule TCP/UDP 9000
ss -tlnp | grep 9000SSL 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
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
| Severity | Reward |
|---|---|
| Critical | 1000–5000 Meritum |
| High | 500–1000 Meritum |
| Medium | 100–500 Meritum |
| Low | 10–100 Meritum |
Community & Links
Related Projects
| Project | Relation |
|---|---|
| Tor Project | Inspiration for onion routing |
| I2P | Anonymous network layer reference |
| Freenet | Decentralized storage concepts |