Skip to content

docs(changelog): clarify B20 Asset multiplier behavior - #212

Merged
rayyan224 merged 17 commits into
mainfrom
docs/clarify-b20asset-multiplier
Aug 26, 2026
Merged

docs(changelog): clarify B20 Asset multiplier behavior#212
rayyan224 merged 17 commits into
mainfrom
docs/clarify-b20asset-multiplier

Conversation

@rayyan224

Copy link
Copy Markdown
Collaborator

Summary

  • expand the Cobalt B20 Asset multiplier specification with ERC-8056 context and interface details
  • clarify scheduling, maturation, cancellation, emergency override, precision, and storage behavior
  • present key design choices as named decisions with their rationale

Test plan

  • Run git diff --check
  • Confirm the PR contains only the B20 Asset multiplier changelog
  • Review the rendered Markdown and Mermaid diagrams

Made with Cursor

Expand the Cobalt specification so operators and integrators can understand scheduling, maturation, emergency overrides, and storage implications.

Co-authored-by: Cursor <cursoragent@cursor.com>
@github-actions

Copy link
Copy Markdown

Interface Coverage

✅ All interface functions have test coverage.

@github-actions

github-actions Bot commented Aug 26, 2026

Copy link
Copy Markdown

📊 Forge Coverage (src/lib/)

🟡 ≥95% across all metrics — some metrics below 99%.

File Lines Stmts Branches Funcs
🟡 B20FactoryLib.sol 97.70% 98.00% 100.00% 95.00%
🔴 test/lib/ForceFeeder.sol 0.00% 0.00% 100.00% 0.00%
🔴 test/lib/PrecompileProbe.sol 0.00% 0.00% 0.00% 0.00%
🟢 MockActivationRegistry.sol 100.00% 100.00% 100.00% 100.00%
🟢 MockActivationRegistryStorage.sol 100.00% 100.00% 100.00% 100.00%
🟢 MockB20.sol 100.00% 100.00% 100.00% 100.00%
🟢 MockB20Asset.sol 100.00% 100.00% 100.00% 100.00%
🟡 MockB20Factory.sol 98.96% 99.10% 100.00% 100.00%
🟢 MockB20Stablecoin.sol 100.00% 100.00% 100.00% 100.00%
🟢 MockB20Storage.sol 100.00% 100.00% 100.00% 100.00%
🟡 MockPolicyRegistry.sol 100.00% 99.54% 97.67% 100.00%
🟢 MockPolicyRegistryStorage.sol 100.00% 100.00% 100.00% 100.00%
Total 97.07% 97.52% 98.16% 97.00%

Full report: download artifact. To browse locally: make coverage (runs forge coverage + genhtml + opens the HTML report).

rayyan224 and others added 2 commits August 26, 2026 10:15
Explain how off-chain integrators should process scheduled, matured, cancelled, and instant multiplier updates without double-counting events.

Co-authored-by: Cursor <cursoragent@cursor.com>
@github-actions

github-actions Bot commented Aug 26, 2026

Copy link
Copy Markdown

✅ Fork tests: all 721 passed

base/base is fully in sync with the base-std spec.

rayyan224 and others added 14 commits August 26, 2026 10:20
Keep the summary focused on user-visible behavior while leaving API details to the specification sections.

Co-authored-by: Cursor <cursoragent@cursor.com>
Connect ERC-8056 scheduling to predictable activation without requiring a transaction at the effective time.

Co-authored-by: Cursor <cursoragent@cursor.com>
Keep the background focused on multiplier behavior without an unnecessary asset-type list.

Co-authored-by: Cursor <cursoragent@cursor.com>
Present raw-balance stability, scheduled UI activation, and integrator preparation as one cohesive summary.

Co-authored-by: Cursor <cursoragent@cursor.com>
Explain how shared multiplier views remain separate from ERC-20 balances and transfer amounts.

Co-authored-by: Cursor <cursoragent@cursor.com>
Link ERC-8056 in Motivation and fold OPERATOR_ROLE into the New Behavior opener.

Co-authored-by: Cursor <cursoragent@cursor.com>
Make integrator-facing UI view behavior easier to scan as discrete points.

Co-authored-by: Cursor <cursoragent@cursor.com>
Show schedule and cancel events in the sequence diagrams and consolidate integrator event handling under Migration Steps.

Co-authored-by: Cursor <cursoragent@cursor.com>
Acknowledge joint authorship on the scheduled multiplier changelog entry.

Co-authored-by: Cursor <cursoragent@cursor.com>
Call out effectiveAt edge cases as discrete notes under the scheduled update lifecycle.

Co-authored-by: Cursor <cursoragent@cursor.com>
Separate each paragraph by intent so the problem is fully stated before UNION/INTERSECT are introduced.

Co-authored-by: Cursor <cursoragent@cursor.com>
Show flattening as a listen-and-propagate path, keep authorization details as invariants, and open migration with compatibility in full sentences.

Co-authored-by: Cursor <cursoragent@cursor.com>
Give each remaining section one paragraph intent so create/update behavior, authorization details, design alternatives, and migration read as connected prose rather than labeled fragments.

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@rayyan224
rayyan224 requested a review from stephancill August 26, 2026 16:16
@rayyan224
rayyan224 merged commit db537f3 into main Aug 26, 2026
4 checks passed
@rayyan224
rayyan224 deleted the docs/clarify-b20asset-multiplier branch August 26, 2026 16:17
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