Skip to content

[VPD-1107]: Replace Token Converter docs with Phase 2 TokenBuyback#345

Open
Debugger022 wants to merge 2 commits intomainfrom
feat/VPD-1107
Open

[VPD-1107]: Replace Token Converter docs with Phase 2 TokenBuyback#345
Debugger022 wants to merge 2 commits intomainfrom
feat/VPD-1107

Conversation

@Debugger022
Copy link
Copy Markdown
Contributor

Summary

Replaces the whats-new/token-converter.md page with updated documentation for Token Converter Phase 2: TokenBuyback.

The original page described the community-driven converter system. Phase 2 retires that system in favour of a single, lightweight TokenBuyback contract class deployed per (destination, base asset) pair, with conversions executed by an ACM-authorized finance-team cron job via DEX aggregators at market rate.

Changes

  • Removes the original overview, rationale, and architecture diagram section
  • Documents the problem with the original system (idle tokens, 50% premium, no cadence guarantee)
  • Describes the TokenBuyback solution and its key design decisions
  • Lists all key functions: updateAssetsState, executeBuyback, forwardBaseAsset, setAllowedRouter, sweepToken
  • Adds events table
  • Adds BSC before/after tables (8 old contracts → 10 TokenBuyback instances)
  • Documents RiskFundV2 changes included in the migration
  • Documents the single-VIP migration process (Pre-VIP / VIP / Post-VIP)
  • Adds impact summary table comparing key metrics before and after

References

@Debugger022 Debugger022 self-assigned this Apr 23, 2026
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 23, 2026

- Fix line count (~170 → ~275) in Impact Summary to match
  the deployed TokenBuyback.sol
- Say "5 contract classes across 8 deployed instances" so the
  intro stays consistent with the "Before (8)" table below
- Describe forwardBaseAsset's `amount` parameter and its
  per-pool partitioning role instead of framing it as a
  generic no-swap forward
- Disambiguate "Retired (burns)" → "Retired (was burn path)"
  so readers don't think WBNBBurnConverter still burns
@Debugger022 Debugger022 marked this pull request as ready for review April 24, 2026 10:36
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