Mocktioneer

Deterministic OpenRTB banner bidder for edge platforms. Test client integrations (Prebid.js, Prebid Server, custom SDKs) without depending on third-party bidders or origin backends.

Features

• Multi-platform - Runs on Fastly Compute, Cloudflare Workers, and native Axum from a single codebase
• Deterministic - Same input always produces the same output
• OpenRTB 2.x & APS TAM - Full banner support with predictable pricing
• Zero dependencies - All routes render from embedded assets

Quick Start

# Clone
git clone https://github.com/stackpop/mocktioneer.git
cd mocktioneer

# Create your local app config from the template (mocktioneer.toml is gitignored)
cp mocktioneer.toml.example mocktioneer.toml

# Seed the typed app config once (the auction/APS endpoints read bid_cpm from it
# via the fail-loud AppConfig extractor and error until it is pushed).
cargo run -p mocktioneer-cli -- config push --adapter axum --yes

# Run locally
cargo run -p mocktioneer-adapter-axum

# Test the auction endpoint
curl -X POST http://127.0.0.1:8787/openrtb2/auction \
  -H 'Content-Type: application/json' \
  -d '{"id":"test","imp":[{"id":"1","banner":{"w":300,"h":250}}]}'

Documentation

Full documentation is available at stackpop.github.io/mocktioneer

• Getting Started - Installation and setup
• API Reference - Endpoint documentation
• Configuration - edgezero.toml options
• Integrations - Prebid.js and Prebid Server

Endpoints

Path	Description
POST /openrtb2/auction	OpenRTB 2.x bid request
POST /e/dtb/bid	APS TAM bid request
GET /static/creatives/{size}.html	Creative wrapper
GET /_/sizes	Supported sizes
GET /_mocktioneer/{manifest,config,routes}	Introspection (manifest / config / route table)

See the full API reference for all endpoints.

Development

cargo test                              # Run tests
cargo run -p mocktioneer-adapter-axum   # Local server (Axum) on :8787

# Serve other adapters via the in-repo CLI (or the external edgezero-cli):
cargo run -p mocktioneer-cli -- serve --adapter cloudflare # Cloudflare on :8787
cargo run -p mocktioneer-cli -- serve --adapter fastly     # Fastly on :7676

# Typed app config (validate / diff / push bid_cpm as a blob envelope).
# Auction + APS endpoints require a one-time `config push` per deploy.
cargo run -p mocktioneer-cli -- config validate --strict
cargo run -p mocktioneer-cli -- config diff --adapter axum
cargo run -p mocktioneer-cli -- config push --adapter axum --yes

License

Apache License 2.0. See LICENSE for details.