Skip to content

docs: ShortBlockWindow is 40 blocks, not 20 - #456

Open
pucedoteth wants to merge 1 commit into
dydxprotocol:mainfrom
pucedoteth:fix/short-block-window-40
Open

pucedoteth wants to merge 1 commit into
dydxprotocol:mainfrom
pucedoteth:fix/short-block-window-40

Conversation

@pucedoteth

Copy link
Copy Markdown

Summary

ShortBlockWindow has been 40 since adf3ad4c (v4-chain #3226, 2025-11-25), but three docs pages still say 20. A reader sizing a short-term order's goodTilBlock from the docs gets half the real window.

Current value on main:

// protocol/x/clob/types/constants.go:9
const ShortBlockWindow uint32 = 40

What changed

file occurrences
docs/pages/concepts/trading/orders.mdx 4
docs/pages/concepts/onboarding-faqs/index.mdx 3
docs/pages/interaction/trading/index.mdx 1

Also repointed the two pinned constants.go permalinks in orders.mdx from 4eb219b1 to a1fb6ab4. The old commit renders const ShortBlockWindow uint32 = 20, which would have contradicted the corrected prose sitting right beside it. Both constants are still on lines 9 and 17 at the new commit, so #L9 / #L17 are unchanged.

What I deliberately did not change

StatefulOrderTimeWindow is still correct. I checked it in the same file — 95 * 24 * time.Hour — so the "95 days" in the table stands.

I left "or about 30 seconds" alone. That figure depends on block time, which I could not verify against a source. It is plausibly still right: #3226's stated reason for raising the window was decreased block times, so the wall-clock duration was roughly preserved rather than doubled. But since I could only verify the block count, that is the only thing I changed. Happy to update the seconds figure if you have the current target block time.

docs/pages/nodes/resources.mdx is untouched. Its "short block window parameter adjustments" line describes the v9.5.0 release that carried this change — it is a changelog entry, not a stale value.

Verification

  • Current value read from protocol/x/clob/types/constants.go at a1fb6ab46038b028fae60d48bb554e8216a0695d (v4-chain main at time of writing).
  • Change traced to its commit: adf3ad4c diff is -const ShortBlockWindow uint32 = 20 / +const ShortBlockWindow uint32 = 40. (Note that commit's message says "to 30" while the diff is 40 — the code is authoritative.)
  • grep -rn "20 blocks" docs/ returns nothing after the change.

🤖 Generated with Claude Code

v4-chain raised ShortBlockWindow from 20 to 40 in adf3ad4c (#3226,
2025-11-25) and the docs still state the old value in three pages, so a
short-term order's maximum GTB reads as half its real window.

Also repoint the two pinned constants.go permalinks from 4eb219b1 to
a1fb6ab4, since the old commit renders `= 20` next to prose now saying
40. Both constants are still on lines 9 and 17 there, so the anchors are
unchanged, and StatefulOrderTimeWindow is still 95 days.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@pucedoteth
pucedoteth requested review from a team as code owners September 9, 2026 16:19
@vercel

vercel Bot commented Sep 9, 2026

Copy link
Copy Markdown

@pucedoteth is attempting to deploy a commit to the dYdX Trading Team on Vercel.

A member of the Team first needs to authorize it.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant