Skip to main content

PC2 Network Architecture

PC2's decentralized infrastructure enables global access without centralized servers.

Architecture Overview

┌────────────────────────────────────────────────────────────────────────┐
│ SUPER NODES │
│ │
│ ┌─────────────────────┐ ┌─────────────────────┐ │
│ │ Primary (InterServer)│ │ Secondary (Contabo) │ │
│ │ 198.51.100.1 │ │ 198.51.100.2 │ │
│ │ │ │ │ │
│ │ Web Gateway :443 │ │ Failover gateway │ │
│ │ Boson DHT :39001 │<------->│ DHT replication │ │
│ │ Active Proxy:8090 │ │ Proxy backup │ │
│ └─────────┬───────────┘ └─────────┬────────────┘ │
│ │ │ │
└─────────────┼───────────────────────────────┼───────────────────────────┘
│ │
v v
┌─────────────────────────────────────────────────────────────────────────┐
│ PC2 USER NODES │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Alice │ │ Bob │ │ Carol │ │
│ │ (VPS/Public)│ │ (Home/NAT) │ │ (Office/NAT)│ │
│ │ │ │ │ │ │ │
│ │ Direct HTTP │ │ Via Proxy │ │ Via Proxy │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘

Components

Super Nodes

Infrastructure nodes that provide three services:

ServicePortPurpose
Web Gateway443HTTPS termination, subdomain routing
Boson DHT39001/UDPDistributed hash table, peer discovery
Active Proxy8090/TCPNAT traversal relay

User Nodes

Your PC2 installation that provides personal cloud storage, WASM execution, AI chat, and file management.

Connection Methods

Direct (Public IP)

VPS and servers with public IPs connect directly:

User Browser -> DNS (*.ela.city) -> Super Node -> Direct to PC2 Node

Proxied (Behind NAT)

Home and office nodes behind NAT use Active Proxy:

User Browser -> DNS -> Super Node -> Active Proxy -> Tunnel -> PC2 Node

The Active Proxy handles NAT traversal automatically -- no port forwarding required. For the protocol details, see NAT Traversal.

Live Infrastructure

Primary Super Node (InterServer)

  • IP: 198.51.100.1
  • Location: Dallas, TX, USA
  • DNS: *.ela.city
  • Status: Production

Secondary Super Node (Contabo)

  • IP: 198.51.100.2
  • Location: EU
  • Purpose: Failover, load distribution

DNS Configuration

RecordTypeValue
ela.cityAMain website
*.ela.cityA198.51.100.1 (Super Node)
alice.ela.cityRoutingAlice's PC2 Node
bob.ela.cityRoutingBob's PC2 Node

Subdomains are registered dynamically via the gateway API.

Protocol Stack

LayerTechnology
TransportHTTPS (Let's Encrypt wildcard)
RoutingSubdomain to node mapping
IdentityBoson DHT (Ed25519)
NAT TraversalActive Proxy
EncryptionTLS 1.3 + CryptoBox

Boson Network Integration

PC2 integrates with the Boson Network for decentralized identity and connectivity:

  • Distributed Hash Table (DHT) -- peer discovery without central servers
  • Ed25519 Cryptography -- strong identity and signing
  • Active Proxy -- NAT traversal for unreachable nodes
  • DID -- decentralized identifiers (did:boson:<nodeId>)

For the detailed Boson service breakdown, see Boson Integration.

Security Layers

LayerTechnology
TransportTLS 1.3 (HTTPS via Let's Encrypt)
SessionCryptoBox (curve25519-xsalsa20-poly1305)
IdentityEd25519 signatures
StorageWallet-scoped isolation

Learn More