xmd

Metal Dollar (XMD) stablecoin — mint, redeem, supply analytics, collateral reserves, oracle prices

## Metal Dollar (XMD)

You have tools to interact with XMD, XPR Network's native stablecoin. XMD is a multi-collateral stablecoin pegged to $1 USD, minted and redeemed through the `xmd.treasury` contract.

### How XMD Works

- **Mint:** Send a supported stablecoin (e.g. XUSDC) to `xmd.treasury` with memo `mint` → receive equivalent XMD at oracle price
- **Redeem:** Send XMD to `xmd.treasury` with memo `redeem,SYMBOL` (e.g. `redeem,XUSDC`) → receive equivalent stablecoin back
- **1:1 peg:** Oracle-priced at $1, backed by stablecoin reserves in the treasury
- **Zero fees:** Currently 0% mint and redemption fees on all collateral types

### Supported Collateral

| Token | Contract | Oracle Feed | Max Treasury % | Status |
|-------|----------|-------------|----------------|--------|
| XUSDC | xtokens | USDC/USD | 60% | Mint + Redeem |
| XPAX | xtokens | PAX/USD | 15% | Mint + Redeem |
| XPYUSD | xtokens | PYUSD/USD | 15% | Mint + Redeem |
| MPD | mpd.token | MPD/USD | 2% | Mint + Redeem |

### Contracts

- `xmd.token` — XMD token contract (precision 6, issuer = xmd.treasury)
- `xmd.treasury` — Mint/redeem logic, collateral management, oracle integration
- `oracles` — On-chain price feeds from multiple providers

### Read-Only Tools (safe, no signing)

- `xmd_get_config` — treasury config: paused state, fee account, minimum oracle price threshold
- `xmd_list_collateral` — all supported collateral tokens with fees, limits, oracle prices, mint/redeem volumes
- `xmd_get_supply` — XMD total circulating supply
- `xmd_get_balance` — check any account's XMD balance
- `xmd_get_treasury_reserves` — current stablecoin reserves backing XMD, with USD valuations and collateralization ratio
- `xmd_get_oracle_price` — current oracle price for any collateral token (with individual provider data)

### Write Tools (require `confirmed: true`)

- `xmd_mint` — mint XMD by depositing a supported stablecoin
- `xmd_redeem` — redeem XMD for a supported stablecoin

### Safety Rules

- Oracle price must be >= 0.995 (`minOraclePrice`) for mint/redeem to proceed
- Each collateral has a `maxTreasuryPercent` cap — if the treasury already holds too much of one stablecoin, minting with it is blocked
- Check `isMintEnabled` / `isRedeemEnabled` before attempting operations
- The treasury can be paused by admins (`isPaused`) — check config first
- XMD has precision 6 — all amounts use 6 decimal places (e.g. `1.000000 XMD`)