Node Types

⚙ Registry Server Infrastructure

The cluster coordinator. Handles node discovery, model manifest distribution, verification ticket queuing, fraud proof tracking, and payment settlements. Analogous to a mining pool's stratum server.

python -m network.registry_server \
  --port 50050 \
  --cluster-config cluster_config.json

The cluster config JSON defines the cluster identity, default economics (pricing, staking minimums, slash fractions), and optional on-chain escrow contract addresses.

⛓ Chain Daemon Infrastructure

The share-chain node, analogous to Monero's monerod. Accepts compute shares from nodes, produces blocks, persists them to SQLite, and gossips blocks to other daemon peers. Implements the EIP-1559-style fee oracle.

export UNFED_STAKE_EVM_PRIVATE_KEY_FILE=~/.unfed/daemon_stake.key
python -m network.daemon_node \
  --port 50070 \
  --registry localhost:50050 \
  --eth-address 0xYourDaemonAddress \
  --db ~/.unfed/chain.db

⚡ Compute Node GPU Required

The workhorse of the network. Loads a text transformer shard, serves Forward() RPCs, manages KV caches per session, and submits compute shares to the daemon. Supports multiple model architectures via the generic runtime (v2 manifests).

export UNFED_STAKE_EVM_PRIVATE_KEY_FILE=~/.unfed/node_stake.key
python -m node.server \
  --shard-index 1 \
  --port 50052 \
  --model-type smolvlm \
  --shards-dir shards_smolvlm \
  --registry localhost:50050 \
  --eth-address 0xYourAddress

📷 Vision Node GPU Required

Processes images through the vision encoder (ViT) for multimodal models. Produces image embeddings that are merged with text tokens at shard 0. Auto-detects model type (SmolVLM or Qwen2-VL) from the manifest.

export UNFED_STAKE_EVM_PRIVATE_KEY_FILE=~/.unfed/vision_stake.key
python -m node.server \
  --shard-index 0 \
  --port 50060 \
  --model-type smolvlm_vision \
  --shards-dir shards_smolvlm \
  --registry localhost:50050 \
  --eth-address 0xYourAddress

🔒 MPC Node (A + B) GPU Required Privacy-Critical

A pair of nodes that replaces shard 0 with privacy-preserving computation. Token IDs are secret-shared between Node A (entry point) and Node B (peer). Neither can reconstruct the original text. Both A and B now register and can advertise MPC capabilities for input and output-stage 2PC roles.

export UNFED_STAKE_EVM_PRIVATE_KEY_FILE=~/.unfed/mpcb_stake.key
python -m network.mpc_shard0 \
  --role B \
  --port 50063 \
  --peer localhost:50061 \
  --shards-dir shards_smolvlm \
  --eth-address 0xYourPeerAddress

export UNFED_STAKE_EVM_PRIVATE_KEY_FILE=~/.unfed/mpca_stake.key
python -m network.mpc_shard0 \
  --role A \
  --port 50061 \
  --peer localhost:50063 \
  --registry localhost:50050 \
  --shards-dir shards_smolvlm \
  --eth-address 0xYourAddress