XPRNetwork/xmd

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)