Skip to content

docs(fee): document effective base-fee floor vs minBaseFee - #372

Open
kutluhaneth46 wants to merge 1 commit into
circlefin:mainfrom
kutluhaneth46:cursor/docs-fee-effective-floor-88c1
Open

docs(fee): document effective base-fee floor vs minBaseFee#372
kutluhaneth46 wants to merge 1 commit into
circlefin:mainfrom
kutluhaneth46:cursor/docs-fee-effective-floor-88c1

Conversation

@kutluhaneth46

Copy link
Copy Markdown
Contributor

Summary

  • Documents the effective empty-block floor max(minBaseFee, 10000/kRate) in ADR-0004 (decrease-path integer truncation).
  • Notes that assets/testnet/config.json fee params are historical vs live testnet.
  • Adds a unit test pinning early-testnet-like kRate=1250 resting at 7 wei.

Deliberately does not add a ProtocolConfig require(minBaseFee * kRate >= 10000) — that would break regenerating historical testnet genesis (kRate: 25, minBaseFee: 1). Happy to follow up if maintainers want that guard only on updateFeeParams.

Addresses #367.

Test plan

Pin the empty-block truncation floor (kRate=1250 → 7 wei) with a unit
test and record the max(minBaseFee, 10000/kRate) interaction in ADR-0004.
Leaves ProtocolConfig requires alone so historical testnet genesis still
regenerates. Addresses circlefin#367.
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.

1 participant