Adapters Overview

Mocktioneer runs on multiple edge platforms through the adapter pattern. Each adapter translates platform-specific request/response formats to the common EdgeZero interface.

Available Adapters

Adapter	Platform	Use Case
Axum	Native Rust	Local development, integration testing
Fastly	Fastly Compute	Production edge deployment
Cloudflare	Cloudflare Workers	Production edge deployment

How Adapters Work

All adapters share the same core logic from mocktioneer-core. The adapter layer handles:

1. Request translation - Convert platform-specific requests to EdgeZero format
2. Response translation - Convert EdgeZero responses to platform format
3. Runtime initialization - Set up logging, configuration
4. Platform features - Access platform-specific APIs (KV stores, etc.)

┌─────────────────────────────────────────────────────┐
│                   mocktioneer-core                   │
│  (routes, openrtb, aps, auction, render, etc.)      │
└─────────────────────────────────────────────────────┘
                          │
          ┌───────────────┼───────────────┐
          │               │               │
          ▼               ▼               ▼
    ┌──────────┐   ┌──────────┐   ┌──────────┐
    │   Axum   │   │  Fastly  │   │Cloudflare│
    │ Adapter  │   │ Adapter  │   │ Adapter  │
    └──────────┘   └──────────┘   └──────────┘
          │               │               │
          ▼               ▼               ▼
    ┌──────────┐   ┌──────────┐   ┌──────────┐
    │  Native  │   │  Fastly  │   │  Workers │
    │  Binary  │   │  Compute │   │  Runtime │
    └──────────┘   └──────────┘   └──────────┘

Choosing an Adapter

For Development

Use the Axum adapter:

• Fastest compile times (native target)
• Standard Rust debugging
• No platform CLI required

cargo run -p mocktioneer-adapter-axum

For Production

Choose based on your infrastructure:

• Fastly Compute - If you're already using Fastly or need their edge network
• Cloudflare Workers - If you're already using Cloudflare or prefer their platform

Both provide:

• Global edge deployment
• Low latency
• Automatic scaling

EdgeZero CLI

The EdgeZero CLI provides a unified interface for all adapters. It's maintained in the EdgeZero repository and isn't vendored here, so install it separately if you want to use it.

# Install (requires access to EdgeZero repo)
cargo install --git ssh://git@github.com/stackpop/edgezero.git edgezero-cli --features cli

# Serve any adapter
edgezero-cli serve --adapter axum
edgezero-cli serve --adapter fastly
edgezero-cli serve --adapter cloudflare

# Build any adapter
edgezero-cli build --adapter fastly

The CLI reads edgezero.toml and executes the appropriate commands for each adapter. If you don't have edgezero-cli, use the direct adapter commands on the pages below.

Common Configuration

All adapters read from the same edgezero.toml:

• Routes are identical across platforms
• Middleware is applied consistently
• Logging levels are configurable per-adapter

See Configuration for details.