Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

Per-fill trade history and the get_my_trades query: persist each fill individually in stable memory and expose a caller’s trades newest-first — a per-order ByOrder feed and an account-wide ByAccount feed — built on realized per-order quote/fee scalars, shared composite-id/sequence machinery, and a dedicated trade store (#171, #192, #193, #179, #186, #180)

BREAKING (pre-launch persisted state only): the trade-history work changes the stable-memory / event-log encoding — order ids now encode as a bare CBOR u64 instead of a 1-element array, OrderBookSnapshot gains a non-Option next_fill field, and the settling event carries a lean per-fill record — so a canister upgraded from state persisted before this release cannot decode it. Acceptable because the canister is pre-launch with no deployed state to migrate; the Candid/public API is unchanged (#192, #179)
Extract a dedicated settlement module and harden the fill-persistence tests, with a get_my_trades account-wide pagination benchmark (#195, #196)
Render prices and amounts as human-readable floats (#182)

Fill-or-kill (FOK) orders: a time-in-force on order submission with an Expired order status, enforced as a matching gate and through execution (#164, #169)

BREAKING: rework the error types returned by the user-facing endpoints into a disposition contract — each error is categorized as a request error (client-side, do not retry), a temporary error (safe to retry), or an internal canister error; get_my_orders no longer traps and returns distinct InvalidOrderId and OrderNotFound errors. Impacted endpoints: add_limit_order, cancel_limit_order, deposit, withdraw, get_balances, get_fee_balances, get_my_orders, get_order_book_ticker, get_order_book_depth (#158, #168, #172)

Limit orders: submit and query order status, with validation on submission (#11, #19); cancel orders (#76, #77)
Order matching: order book with a timer-driven matching engine, plus a configurable execution policy and chunked execution of pending orders (#15, #18, #90, #89)
Deposit and withdrawal flows (#17, #45)
Balances: per-user free/reserved balances, reserved on order placement and updated on settlement, with get_balances and list_supported_tokens queries (#27, #28, #30, #99, #98)
Trading pairs: add_trading_pair and get_trading_pairs, with token metadata (#22, #21, #32)
Per-pair maker/taker fees: configuration and pair plumbing, per-token fee pools, deduction at fill time, and fee visibility — including the per-pair rates in get_trading_pairs and the dashboard (#107, #108, #109, #105, #153)
Order history and queries: order-lifecycle history, a per-user order index with submission timestamps, and a get_my_orders query; order-book ticker and depth queries (#41, #110, #111, #115, #74)
Audit and event log for state replay, with deposit, withdrawal, trading-pair, limit-order, and matching/settlement events (#38, #42, #44, #47, #66, #68)
Trading halts: global and per-pair halt, on a permission layer (#125, #126, #127)
State persistence: order history and balances persisted in stable memory and restored across upgrades (#62, #63, #64)
Observability: operation logging, canister metrics, and a dashboard with trading-pair details (#23, #52, #79, #80)

Settlement exactness: enforce the tick·lot settlement invariant, settle fills in quote units per whole base token, and widen price and tick size to u128 (#119, #121, #122)
Add a min/max notional filter per trading pair (#131)
Expand order records with partial-fill information (#133)
Rename the project from DEX to OISY TRADE (#138)

Apply order-status transitions atomically with matching, fixing a cancel-order trap on fully-filled orders (#92)
Guard concurrent deposits and withdrawals per (caller, token) (#78)
Surface trading-pair fee rates in get_events (#134)