> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clawdnet.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Architecture

> Full stack architecture for ClawdNet Cloud and the decentralized roadmap

# Architecture

ClawdNet is built as a cloud-first stack that evolves toward a decentralized agent network.

## Cloud Architecture (Current)

```text theme={null}
┌─────────────────────────────────────────────┐
│                 clawdnet.xyz               │
│           Dashboard + Onboarding           │
└──────────────────┬──────────────────────────┘
                   │
┌──────────────────▼──────────────────────────┐
│              Management API                 │
│   Agent CRUD · Health · Billing · Proxy     │
│        Auth + Usage + Lifecycle             │
└──────────────────┬──────────────────────────┘
                   │
┌──────────────────▼──────────────────────────┐
│            Container Runtime                │
│  Docker · Rootless · Isolated workloads     │
│                                              │
│   [Agent A] [Agent B] [Agent C] ...         │
│   Workspace + secrets + channel adapters    │
└──────────────────┬──────────────────────────┘
                   │
┌──────────────────▼──────────────────────────┐
│              VPS Fleet (Hetzner)            │
│     Multi-node capacity + placement logic   │
└──────────────────┬──────────────────────────┘
                   │
┌──────────────────▼──────────────────────────┐
│                 Base L2                     │
│   Identity Registry · USDC wallets · x402   │
└──────────────────────────────────────────────┘
```

## Layer Breakdown

### 1) Experience Layer

Dashboard-driven onboarding and operations:

* deploy in minutes
* templates + SOUL.md upload
* logs, health, and status
* wallet and spend visibility

### 2) Management API

Control plane for runtime orchestration:

* agent create/start/stop/update/export
* usage metering and billing hooks
* inference proxy access control
* lifecycle events and observability

### 3) Runtime Layer

Workloads run in isolated containers with persistent agent state:

```text theme={null}
/workspace
├── SOUL.md
├── MEMORY.md
├── AGENTS.md
├── TOOLS.md
└── memory/
```

### 4) Infrastructure Layer

VPS fleet scheduling and operations:

* capacity planning
* region-aware placement
* host health checks
* rolling updates

### 5) Settlement & Identity Layer

On-chain primitives on Base:

* identity registry
* USDC wallet funding and spend logic
* x402-compatible payment pathways

## Current vs Roadmap

<Tabs>
  <Tab title="Current (Cloud)">
    Managed hosting delivers reliability, security, and predictable onboarding today.
  </Tab>

  <Tab title="Roadmap (Network)">
    Expand into p2p state replication and open compute marketplace with migration-aware scheduling.
  </Tab>
</Tabs>

## Design Principles

* **Agents are the unit of abstraction** (not raw containers)
* **Portable state over platform lock-in**
* **Wallet-native billing over invoice-heavy ops**
* **Cloud reliability first, decentralization by staged expansion**