Architecture¶

Humanoid Network is a multi-layer platform connecting mobile data capture, cloud processing, blockchain incentives, and developer APIs.

System Overview¶

┌─────────────────────────────────────────────────┐
│                  CAPTURE LAYER                   │
│         Mecka iOS App (Swift, ARKit)             │
└──────────────────────┬──────────────────────────┘
                       │
                       v
┌─────────────────────────────────────────────────┐
│                 INGESTION LAYER                  │
│      API Gateway (Node.js, Express, Prisma)      │
│      Auth (Privy), Upload (S3-compatible)        │
└──────────────────────┬──────────────────────────┘
                       │
              ┌────────┴────────┐
              v                 v
┌──────────────────┐  ┌──────────────────┐
│   DATA PIPELINE  │  │   BLOCKCHAIN     │
│  Python, Ray     │  │   Base L2        │
│  QA, Scoring     │  │   $HAN, veHAN    │
│  ROBO Tagging    │  │   Rewards        │
└────────┬─────────┘  └──────────────────┘
         │
         v
┌─────────────────────────────────────────────────┐
│                  ACCESS LAYER                    │
│     HAN SDK (REST API, filtered dataset access)  │
│     Dashboard (React, Vite, contributor UI)      │
└─────────────────────────────────────────────────┘

Layers¶

Capture Layer¶

The Mecka iOS app uses ARKit for depth sensing and pose estimation. Recordings include RGB video, depth maps, 3D hand poses (21 keypoints per hand), and ambient audio.

Ingestion Layer¶

The API gateway handles authentication, upload management, and submission tracking. Built on Node.js with Express and Prisma ORM backed by PostgreSQL.

Data Pipeline¶

A Python-based processing pipeline powered by Ray for parallel execution. Handles quality validation, ROBO category classification, pose extraction, and diversity scoring.

Blockchain Layer¶

Solidity smart contracts on Base handle token distribution, veHAN staking, Merkle-based reward claims, and governance voting.

Access Layer¶

The HAN SDK provides programmatic access to curated datasets. The contributor dashboard offers a web interface for tracking quests, earnings, and staking.

Security¶

Auth: Privy handles wallet creation and social login with MPC key management
Data: Recordings encrypted at rest and in transit (TLS 1.3)
Contracts: Audited by third-party security firms before mainnet deployment
Privacy: Optional face blurring, no biometric storage, GDPR-compliant data handling