Skip to main content

WrapperClient

The WrapperClient manages the x0-USD stablecoin wrapper — 1:1 USDC-backed with a governance timelock system.

Core Operations

Deposit & Mint

Deposit USDC into the reserve and mint equivalent x0-USD:

Burn & Redeem

Burn x0-USD and withdraw USDC (minus redemption fee):

Fee Calculation

PDA Derivation

Reserve Health

Governance (Timelock)

All admin operations go through a 48-hour timelock. The flow is:
1

Schedule

Schedule the action. A 48-hour countdown begins.
2

Wait

The community can observe the pending action on-chain.
3

Execute or Cancel

After 48 hours, the admin executes the action. Or cancels it at any time.

Fee Rate Changes

Pause/Unpause

Emergency Withdrawal

Admin Transfer (2-Step)

Cancel

Querying State

fetchConfig()

fetchStats()

AdminActionType Enum

Last modified on February 8, 2026