Skip to content

feat(widget): add USDH sunset migration widget#63

Merged
sumfxn merged 3 commits into
mainfrom
feat/usdh-migration
May 16, 2026
Merged

feat(widget): add USDH sunset migration widget#63
sumfxn merged 3 commits into
mainfrom
feat/usdh-migration

Conversation

@Yaugourt
Copy link
Copy Markdown
Collaborator

@Yaugourt Yaugourt commented May 15, 2026

Summary

  • Reposition usdh-kit as a USDH sunset/migration kit, not as a generic USDC or spot SDK.
  • Add USDHMigration, the primary widget for moving remaining HyperCore USDH balances back to USDC.
  • Keep USDHSwap and bridge/acquisition flows available only as legacy compatibility surfaces.
  • Update README/docs/demo/registry so the public story is migration + archive/showcase.

Widget / API

  • Export USDHMigration and USDHMigrationResultPayload from @usdh-kit/widget.
  • Use strict USDH/USDC discovery for the pre-wallet read-only quote.
  • Do not fall back to pairs[0] for migration.
  • Do not show a fake 1:1 receive estimate when the live quote is unavailable.
  • Return spentUsdh, receivedUsdc, price, and slippageBps through onMigrationComplete.
  • Keep the existing USDHSwap public callback/API unchanged.

Package Boundaries

  • No generic USDC SDK pivot in this PR.
  • No public HIP-4 UI package in this repo.
  • No release, publish, or merge is implied without explicit approval.

Tests

  • npx pnpm@10.33.2 verify
  • git diff --check
  • GitHub CI green
  • Browser QA desktop/mobile: /, /components, /components/usdh-migration, /components/usdh-widget
  • Copy button smoke on /components/usdh-migration

Add USDHMigration, a HyperCore-only exit widget that converts a USDH
balance back to USDC ahead of the USDH sunset. It mirrors USDHSwap in
reverse: sell side, no bridging, no source-chain toggle.

- new packages/widget/src/usdh-migration.tsx + USDHMigrationProps
- generalize PayCard/ReceiveCard/ResultPanel/ActionButton with optional
  ticker props (defaults keep USDHSwap rendering identical)
- demo registry entry + preview for the migration widget
- usdh-migration.test.tsx (8 tests)
@Yaugourt Yaugourt requested a review from sumfxn as a code owner May 15, 2026 21:12
@sumfxn sumfxn changed the title feat(widget): add usdh-to-usdc migration widget feat(widget): add USDH sunset migration widget May 16, 2026
@sumfxn sumfxn merged commit 66ec15f into main May 16, 2026
4 checks passed
@sumfxn sumfxn deleted the feat/usdh-migration branch May 16, 2026 02:46
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