Skip to content

docs: note fillTimeBlocks (V3) is consumed by the RFQ circuit breaker - #684

Open
codyborn wants to merge 2 commits into
mainfrom
codyborn/note-filltimeblocks-rfq-circuit-breaker
Open

docs: note fillTimeBlocks (V3) is consumed by the RFQ circuit breaker#684
codyborn wants to merge 2 commits into
mainfrom
codyborn/note-filltimeblocks-rfq-circuit-breaker

Conversation

@codyborn

Copy link
Copy Markdown
Collaborator

What

Adds a comment in check-order-status/service.ts flagging that the V3 fillTimeBlocks calculation is now a load-bearing input to a downstream consumer.

Why

x-parameterization-api's fade-rate cron (the RFQ circuit breaker) was extended to count Dutch_V3 fades. Because V3 decays by block rather than time, it keys fade detection off archived_orders.fillTimeBlocks, which is computed here for V3 as:

fillTimeBlocks = fillBlock - order.cosignerData.decayStartBlock

So fillTimeBlocks >= 0 (filled on/after decayStartBlock) ⟹ the price had begun decaying ⟹ fade. This was chosen over decayStartBlock/startBlock directly because that field isn't loaded into the analytics tables, whereas fillTimeBlocks is.

This PR is comment-only — no behavior change. It just warns future editors that altering the V3 fillTimeBlocks computation affects filler fade scoring in the circuit breaker.

Related

🤖 Generated with Claude Code

codyborn and others added 2 commits June 16, 2026 15:50
x-parameterization-api's fade-rate cron now keys V3 fade detection off
archived_orders.fillTimeBlocks (fillTimeBlocks >= 0 => filled on/after
decayStartBlock => fade). Add a comment so this calculation isn't changed
without considering the downstream circuit-breaker impact.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@alanhwu
alanhwu self-requested a review July 8, 2026 20:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants