Changelog

Use this page to track operator-facing contract changes only.

What belongs here

• new operator API endpoints
• removed or deprecated operator API endpoints
• new webhook event types
• payload shape changes
• wallet adapter contract changes
• status or error-code changes

What does not belong here

• internal refactors with no contract impact
• infrastructure-only deploy notes
• design-only content edits with no integration impact

Entry template

## YYYY-MM-DD

### Added
- item

### Changed
- item

### Deprecated
- item

### Removed
- item

### Operator action
- required migration or "none"

2026-07-11

Added

• GET /api/operator/trades/{marketId}/{externalUserId} for operator-scoped market/user trade-history HTML
• GET /api/operator/redemptions in the documented Operator API and Playground catalog
• required wallet mutation metadata matrices for buy, sell, compensation, and redemption flows

Changed

• ambiguous primary wallet mutations now require manual review instead of remote lookup or automatic replay
• buy compensation includes marketId and may retry only with its original idempotency key
• full-contract wallet testing keeps balance and mutation coverage without operation-lookup steps

Removed

• REST v1 operation-lookup configuration and runtime APIs
• staging simulator operation-lookup route

Operator action

• continue durable same-key mutation deduplication and stop implementing or calling lookup-by-key
• persist marketId from all trade mutation metadata
• use Balance Ops, operator wallet logs, remote_reference, and UTC timestamps for ambiguous reconciliation
• never replay the same business action with a new idempotency key

Initial release

2026-06-20

Added

• operator documentation app initial structure
• operator API reference
• wallet adapter reference
• webhook reference

Operator action

• use current pages as source of truth for v1 integration