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 and run locally
git clone https://github.com/stackpop/mocktioneer.git
cd mocktioneer
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 with pricing

See the full API reference for all endpoints.

Development

cargo test                              # Run tests
cargo run -p mocktioneer-adapter-axum   # Local server (Axum) on :8787
edgezero-cli serve --adapter cloudflare # Local server (Cloudflare) on :8787
edgezero-cli serve --adapter fastly     # Local server (Fastly) on :7676

License

Apache License 2.0. See LICENSE for details.