Skip to main content

TimeChain Platform — Aphelion Craft

Enterprise-grade distributed system for verifiable, time-ordered data operations with CRDT-based conflict resolution, zero-knowledge proof verification, and post-quantum cryptography. This repository is the central documentation hub for the aphelion-craft organization. It covers platform architecture, protocol specifications, operational procedures, and cross-repo references for all 25 repositories.

Platform Overview

TimeChain integrates five core technologies into a unified, production-ready system:
TechnologyPurposeRepo
CRDT Conflict Resolution (ForkNode)Deterministic merging with LSEQ identifiers and order-preserving encryptionfork-node
Zero-Knowledge Proofs (Halo2)Client-side proof generation, server-side verification without data exposurefork-node
Verifiable Audit Ledger (VEST)Immutable cryptographic proof ledgers with RFC 6962 Merkle treesvest-node
Temporal Navigation Protocol (TNP)Fork/merge/navigate timelines with causal ordering and BFTtnp-node
Post-Quantum CryptographyDilithium signatures, Kyber-1024 encryption, M²-ORE searchable encryptionfork-node

Repository Map

Core Nodes

The protocol layer — consensus, conflict resolution, proofs, and networking.
RepoDescriptionKey Interfaces
fork-nodeCRDT merge engine with LSEQ identifiers and Halo2 ZK proofsProto: crypto/, protocols/
vest-nodeVerifiable audit ledger with RFC 6962 Merkle treesProto: crypto/, protocols/
tnp-nodeTemporal Navigation Protocol for timeline operationsProto: crypto/, protocols/
mesh-nodeWEAVE P2P mesh networking with multi-underlay transportProto: infra/
aegis-nodeZero-trust access control and authorization

Platform Services

Application-layer services that compose core nodes into a multi-tenant platform.
RepoDescriptionDepends On
gateway-serviceAPI gateway with routing, rate limiting, authmesh-node, aegis-node
admin-serviceAdministrative operations and system managementgateway-service
tenant-serviceMulti-tenant management with isolation and billingpersistence-service
persistence-serviceData persistence with storage abstractionfork-node, vest-node
enterprise-serviceCompliance automation, SLA management, auditvest-node
federation-serviceCross-region federation and cluster coordinationmesh-node, tnp-node
forknode-vest-serviceHybrid ForkNode + VEST integrationfork-node, vest-node

SDKs & Protocol

Client libraries and the Memory State Protocol for external integrators.
RepoDescription
timechain-sdkRust and TypeScript client bindings for the TimeChain API
mobile-sdkiOS (Swift) and Android (Kotlin) SDKs with WASM support
msp-protocolMemory State Protocol — event-derived deterministic state

Shared Libraries

RepoDescription
timechain-commonShared config, metrics, health checks, testing utilities, optimizer, benchmarks, backup/restore

Infrastructure

Deployment, orchestration, and observability configuration.
RepoDescriptionContents
terraform-infrastructureMulti-cloud IaC (AWS, GCP, Azure)Terraform modules and tfvars
kubernetes-manifestsK8s base + overlays, ArgoCD, Istio, Flagger, KarpenterKustomize, GitOps, service mesh
helm-chartsHelm charts and monitoring dashboardscharts/fork-node, Prometheus, Grafana
ci-cd-pipelinesDeployment automation and observability configsRust deployment crate, Jaeger, OTel

Documentation & Organization

RepoDescription
platform-docsThis repo — architecture docs, proto schemas, operational guides
.githubOrg profile, issue/PR templates, security policy

Templates

Scaffolds for creating new repositories in the org.
RepoStackUse Case
service-templateRust / AxumNew microservices
library-templateRust / CriterionNew shared libraries
frontend-templateNext.js / TypeScript / TailwindNew frontend apps

Architecture

                         ┌──────────────┐
                         │   Clients    │
                         │  (SDK/Mobile)│
                         └──────┬───────┘

                    ┌───────────▼───────────┐
                    │   gateway-service     │
                    │   (routing, auth,     │
                    │    rate limiting)      │
                    └───────────┬───────────┘

          ┌─────────────────────┼─────────────────────┐
          │                     │                     │
  ┌───────▼───────┐   ┌────────▼────────┐   ┌────────▼────────┐
  │ admin-service │   │ tenant-service  │   │enterprise-service│
  └───────┬───────┘   └────────┬────────┘   └────────┬────────┘
          │                     │                     │
  ┌───────▼─────────────────────▼─────────────────────▼───────┐
  │                    Core Nodes                              │
  │  ┌───────────┐  ┌───────────┐  ┌──────────┐  ┌─────────┐ │
  │  │ fork-node │  │ vest-node │  │ tnp-node │  │mesh-node│ │
  │  │ (CRDT+ZK) │  │ (Audit)   │  │ (Time)   │  │ (P2P)   │ │
  │  └───────────┘  └───────────┘  └──────────┘  └─────────┘ │
  │                                                           │
  │  ┌────────────────┐  ┌──────────────────┐  ┌───────────┐ │
  │  │ persistence-   │  │  federation-     │  │aegis-node │ │
  │  │ service        │  │  service         │  │ (AuthZ)   │ │
  │  └────────────────┘  └──────────────────┘  └───────────┘ │
  └───────────────────────────────────────────────────────────┘

                    ┌───────────▼───────────┐
                    │  timechain-common     │
                    │  (config, metrics,    │
                    │   health, testing)    │
                    └──────────────────────┘

Documentation in This Repo

docs/

DirectoryFilesContent
docs/cards/19Implementation flashcards covering architecture, cryptography, data structures, deployment, operations, proof systems, and security
docs/reports/13Verification reports — production readiness, protocol standardization status, gap analysis, project completion
docs/system/7System-level documents — protocol cheatsheets, ForkNode-VEST hybrid design, TimeChain standard, protocol automation
docs/tasksets/164Taskset deliverables — specifications, completion reports, RFCs, and guides spanning 20 tasksets (TASKSET 10–28)

proto-examples/

40 YAML example files across 10 protocol domains, showing correct message formats: crypto/ · enterprise/ · events/ · gtm/ · infra/ · integrations/ · protocols/ · sdk/ · testing/ · validation/

proto-schemas/

42 JSON Schema files across the same 10 domains, providing validation schemas for all protocol buffer message types.

Protocol Buffer Distribution

Proto definitions originate in this repo’s proto-schemas/ and proto-examples/ directories. Compiled .proto files are distributed to individual repos as follows:
Proto DomainTarget Repos
crypto/fork-node, tnp-node, vest-node
protocols/fork-node, tnp-node, vest-node, mesh-node
enterprise/enterprise-service
gtm/enterprise-service
infra/gateway-service, admin-service, mesh-node, persistence-service
integrations/gateway-service
sdk/timechain-sdk, mobile-sdk
events/msp-protocol, timechain-common
testing/timechain-common
validation/timechain-common

Quick Start by Role

Developers — Building on TimeChain

  1. Start with timechain-sdk for Rust/TypeScript or mobile-sdk for iOS/Android
  2. Review docs/tasksets/API_REFERENCE.md in this repo for the full API surface
  3. See proto-examples/sdk/ for request/response samples

Platform Engineers — Running the System

  1. kubernetes-manifests — base manifests + staging/production overlays
  2. helm-charts — Helm values and monitoring dashboards
  3. terraform-infrastructure — multi-cloud provisioning
  4. docs/tasksets/DEPLOYMENT_GUIDE.md for step-by-step instructions

Architects — Understanding the Design

  1. docs/system/The-TimeChain-Standard.md — top-level protocol specification
  2. docs/system/ForkNode-VEST-Hybrid.md — hybrid design rationale
  3. docs/cards/ — 19 flashcards covering every subsystem
  4. docs/reports/PROTOCOL_SPECIFICATIONS_INDEX.md — full protocol index

Security & Compliance

  1. docs/reports/PRODUCTION_READINESS.md — security posture assessment
  2. .github/SECURITY.md — vulnerability reporting policy
  3. aegis-node — zero-trust authorization implementation

Creating New Repos

Use the GitHub template repos to scaffold new projects:
# New Rust microservice
gh repo create aphelion-craft/my-service --template aphelion-craft/service-template

# New Rust library
gh repo create aphelion-craft/my-lib --template aphelion-craft/library-template

# New frontend app
gh repo create aphelion-craft/my-app --template aphelion-craft/frontend-template

Contributing

See the org-wide CONTRIBUTING.md and CODE_OF_CONDUCT.md.

License

Proprietary — Aphelion Craft