Skip to main content

Migration from the retired USDC protocol

This is a breaking replacement, not an on-chain upgrade. Existing v1 objects remain on Sui but the repository no longer builds clients or interfaces for them. Applications that still need historical v1 behavior must pin their old code and treat it as unsupported.

Retired surfaceCurrent replacement
USDC-only amount helpersCoin base-unit bigint plus CoinMetadata display
AdminConfig currency/fee policyAssetRegistry allowlist; protocol fee is 0
Direct payment creationMerchant Product → merchant-created Order → exact Coin payment
No on-chain refundBounded Payment<T> escrow and payer-requested refund
Old payment/merchant/admin SDK modulesassets, merchants, catalog, orders, payments, subscriptions
v1 package/object environment IDsFresh packageId and assetRegistryId from a future approved deployment

Do not reuse the retired Package, AdminConfig, or capability IDs. There is no state migration script and no compatibility shim.