# What is the new version of USDD? The new version of USDD is a fully decentralized stablecoin pegged to the US dollar, backed by crypto collateral. Unlike traditional stablecoins, it operates without a central authority, ensuring that its value remains stable while being governed by the community. USDD provides users with a secure and transparent digital asset, designed to maintain its 1:1 peg to the US dollar through a system of over-collateralization. USDD is tamper-proof and cannot be frozen, giving users full control over their assets. With its decentralized nature, USDD avoids the risks of centralization and provides a trustless solution for transactions within the decentralized finance (DeFi) ecosystem. It aims to bridge the gap between traditional finance and the growing world of DeFi, offering a stable and reliable currency for users to transact and invest. \ **Note:** Throughout this document, all references to "USDD" specifically refer to the new version of USDD. # What is USDDOLD? USDDOLD is an over-collateralized decentralized stablecoin that is issued by TRON DAO Reserve, who is also the custodian. USDDOLD is minted by the whitelisted institutions of the TRON DAO Reserve (TDR) through burning TRX. Its value is backed by the over-collateralization of highly liquid crypto assets under the TDR, including BTC, USDT, USDC, and TRX. The circulation and use of USDDOLD are free from the intervention of any centralized parties. Similar to BTC and ETH, USDDOLD grants its holders full ownership, meaning that no organization or individual has access to freeze users’ USDDOLD. # Why upgrade USDD? The upgrade to USDD aims to enhance its security, decentralization, and overall stability. By incorporating more robust mechanisms, such as secure liquidation processes, dynamic collateral ratio adjustments, and enhanced risk management protocols, the new version ensures that USDD can better withstand market fluctuations while maintaining its 1:1 peg to the US dollar. For instance, when the USDD price deviates, arbitrage opportunities encourage buying or selling to bring the price back in line. * Secure Liquidation Processes: These mechanisms swiftly handle under-collateralized positions, reducing systemic risk and maintaining the protocol’s stability. * Dynamic Collateral Ratios: These adjust in response to market conditions, ensuring adequate collateralization and reducing vulnerability during volatile periods. * Advanced Risk Management Tools: These include predictive analytics to monitor risks and prevent cascading liquidations during market stress. This upgrade also introduces more community-driven features, empowering users to actively participate in governance and decision-making, ensuring that the protocol evolves based on collective input. Additionally, the upgrade strengthens the system's transparency and efficiency, with improved collateral management and liquidity solutions. The new version of USDD is designed to provide users with a more secure and adaptable stablecoin, allowing for easier integration with decentralized finance (DeFi) platforms, and ensuring long-term growth and sustainability of the ecosystem. # Core Features USDD stands out as a next-generation stablecoin built on principles of decentralization, transparency, and user empowerment. Below are the core features that define its functionality and value: 1. **Decentralized Governance**\ USDD is governed by a transparent, community-driven process through decentralized proposals and on-chain voting mechanisms. 2. **Transparency and Auditability**\ All collateral and transactions supporting USDD are fully auditable and recorded on the blockchain. This open-source approach guarantees users can verify the system's integrity in real-time, fostering trust and security. 3. **Enhanced Security**\ With over-collateralized reserves, USDD ensures asset protection against market fluctuations. Decentralized governance mechanisms further safeguard the stability and security of the ecosystem. 4. **Seamless DeFi Integration**\ USDD integrates effortlessly into the broader DeFi ecosystem, enabling use cases like lending, borrowing, staking, and trading. This interoperability makes it a versatile tool for both individual users and institutions. 5. **Freeze-Free Transactions**\ USDD guarantees that no centralized authority can freeze user funds, providing users with full control of their assets at all times. 6. **Multichain**\ A fully decentralized stablecoin supporting TRON, Ethereum, BNB Chain. These core features make USDD a robust and adaptable stablecoin, designed to empower its users while maintaining the highest standards of stability, security, and decentralization. # Contract Addresses To ensure transparency and security, all collateral backing USDD is held in publicly verifiable smart contracts. Users can check the contract addresses on blockchain explorers to verify the funds at any time. This guarantees that the collateral remains untouched and fully secure. 🌐 Tron Network Collateral Contracts * USDD: [TCrEVahRbhDFB6uRXEWUg7wkptXvg47GKs](https://tronscan.org/#/address/TCrEVahRbhDFB6uRXEWUg7wkptXvg47GKs) * TRX-A: [TJ1VWPvFVq7sVsN7J7dWJVZz4SLT14qRUr](https://tronscan.org/#/contract/TJ1VWPvFVq7sVsN7J7dWJVZz4SLT14qRUr) * TRX-B: [TGQKnHDQNyc3QeHJ7YxH8wggdg89UVXyvX](https://tronscan.org/#/contract/TGQKnHDQNyc3QeHJ7YxH8wggdg89UVXyvX) * TRX-C: [TPUPPLTYLdbW4jxwD5g2T7ystxsR9HL2mt](https://tronscan.org/#/contract/TPUPPLTYLdbW4jxwD5g2T7ystxsR9HL2mt) * sTRX-A: [TKha7zcAXZMaaWzoVmUHtvVFqr9GeiChgJ](https://tronscan.org/#/contract/TKha7zcAXZMaaWzoVmUHtvVFqr9GeiChgJ) * USDT-A: [TDUkQbjrXs6xUbxGCLknWwJHxVTdysXBhy](https://tronscan.org/#/contract/TDUkQbjrXs6xUbxGCLknWwJHxVTdysXBhy) * PSM-USDT: [TSUYvQ5tdd3DijCD1uGunGLpftHuSZ12sQ](https://tronscan.org/#/contract/TSUYvQ5tdd3DijCD1uGunGLpftHuSZ12sQ) * SA001-A: [TXdYNjXaHn3c1whomRpzCkaFbjfCffMFGf](https://tronscan.org/#/contract/TXdYNjXaHn3c1whomRpzCkaFbjfCffMFGf) PSM Contracts * PSM-USDT: [TSUYvQ5tdd3DijCD1uGunGLpftHuSZ12sQ](https://tronscan.org/#/contract/TSUYvQ5tdd3DijCD1uGunGLpftHuSZ12sQ) * USDTJoin: [TBXW4hS5KYjjbJXDpnrPf4zhkLwrpUjbyz](https://tronscan.org/#/contract/TBXW4hS5KYjjbJXDpnrPf4zhkLwrpUjbyz) 🌐 Ethereum Network PSM Contracts * USDD: [0x4f8e5DE400DE08B164E7421B3EE387f461beCD1A](https://etherscan.io/address/0x4f8e5de400de08b164e7421b3ee387f461becd1a) * PSM-USDT: [0xce355440c00014a229bbec030a2b8f8eb45a2897](https://etherscan.io/address/0xce355440c00014a229bbec030a2b8f8eb45a2897) * USDTJoin: [0x217e42ceb2eae9ecb788fdf0e31c806c531760a3](https://etherscan.io/address/0x217e42ceb2eae9ecb788fdf0e31c806c531760a3) * PSM-USDC: [0x12d0351f68035a41d13fc8324562e2d51b7a3b93](https://etherscan.io/address/0x12d0351f68035a41d13fc8324562e2d51b7a3b93) * USDCJoin:[ 0x9a7e1b324060db7342aea08c0dc56f55ced6f519](https://etherscan.io/address/0x9a7e1b324060db7342aea08c0dc56f55ced6f519) USDD Savings * sUSDD: [0xC5d6A7B61d18AfA11435a889557b068BB9f29930](https://etherscan.io/token/0xc5d6a7b61d18afa11435a889557b068bb9f29930) 🌐 BNB Chain Network PSM Contracts * USDD: [0x45E51bc23D592EB2DBA86da3985299f7895d66Ba](https://bscscan.com/address/0x45e51bc23d592eb2dba86da3985299f7895d66ba) * PSM-USDT: [0x939d3FB56cd12d68CaA1125cc57a8d2391F7Ee29](https://bscscan.com/address/0x939d3fb56cd12d68caa1125cc57a8d2391f7ee29) * USDTJoin: [0xe229FdA620B8a9B98ef184830EE3063F0F86B790](https://bscscan.com/address/0xe229fda620b8a9b98ef184830ee3063f0f86b790) USDD Savings * sUSDD: [0x8bA9dA757d1D66c58b1ae7e2ED6c04087348A82d](https://bscscan.com/address/0x8ba9da757d1d66c58b1ae7e2ed6c04087348a82d) For real-time verification, visit the blockchain explorer and enter the contract address to check the fund balances. # Ecosystem Migration Progress As the transition to USDD 2.0 progresses, various ecosystem partners have successfully migrated from USDD 1.0. Below is a categorized list of platforms and projects that now support USDD 2.0: **🔹 Supported Chains** * **TRON** * **Ethereum** * **BNB Chain** * **BTTC** **🔹 Supported Exchanges & DeFi Platforms** * [**HTX**](https://www.htx.com/trade/usdd_usdt) * [**Bybit**](https://www.bybit.com/en/trade/spot/USDD/USDT) * [**Gate.io**](https://www.gate.io/zh/trade/USDD_USDT) * [**Poloniex**](https://poloniex.com/trade/USDD_USDT?type=spot) * [**JustLend DAO**](https://app.justlend.org/homeNew?) * [**SUN.io**](https://sunswap.com/#/home) * [**CoinW**](https://www.coinw.com/spot/usddusdt) * [**AscendEX**](https://ascendex.com/en-us/cashtrade-spottrading/usdt/usdd) * [**LBANK**](https://www.lbank.com/trade/usdd_usdt) * [**Mitmart**](https://www.bitmart.com/) * [**AEON**](https://aeon.xyz/) **🔹 Supported Wallets** * **TronLink** * **TokenPocket** * **imToken** * **Gate Web3 Wallet** This list will be continuously updated as more partners complete their migration. Please ensure that the platform or service you are using fully supports USDD 2.0. # System Architecture The USDD system architecture is designed to ensure stability, security, transparency, and scalability. It operates as a decentralized platform leveraging robust collateral mechanisms, efficient liquidation processes, and community-driven governance to maintain the stability of USDD and its integration within the DeFi ecosystem. ## Collateral Management USDD employs an over-collateralization model to safeguard its stability and reduce systemic risk. Users can lock eligible assets, such as TRX, and USDT, to mint USDD. Key aspects of collateral management include: * Over-Collateralization: Users are required to maintain a collateral ratio above the minimum threshold, varying by asset based on its volatility. * Multi-Collateral Support: Diversification of supported collateral types minimizes risk and promotes flexibility for users. * Real-Time Monitoring: The system continuously monitors collateral ratios, alerting users to potential risks and ensuring prompt responses. * Multichain：A fully decentralized stablecoin supporting TRON, Ethereum, and other major blockchains. ## Liquidation Mechanism The protocol incorporates a secure liquidation process to address under-collateralized positions and protect the system’s integrity: * Triggering Liquidation: When a vault’s collateral ratio falls below the minimum threshold, it becomes eligible for liquidation. * Keeper Incentives: Liquidators, or “keepers,” are incentivized with rewards to participate in the liquidation process. * Risk Containment: This mechanism ensures that under-collateralized positions do not threaten the overall stability of the system. ## Auction System The USDD platform utilizes an efficient auction system to optimize the management of liquidated collateral and system deficits: * Collateral Auctions: Liquidated collateral is auctioned to recover outstanding debt. Participants bid competitively, ensuring fair market pricing and efficient debt recovery. Collateral Auctions are conducted using a Dutch model, where prices decrease over time, encouraging timely participation and equitable pricing. * Debt Auctions: In the event of a protocol deficit, the system initiates debt auctions, selling governance tokens to recapitalize and maintain stability. ## Peg Stability Module (PSM) The PSM (Peg Stability Module) is designed to maintain the peg of stablecoins through a fixed 1:1 exchange rate (e.g., between USDD and USDT). Users can exchange one stablecoin (such as USDT and USDC) for USDD directly, with no slippage. This process involves: * Minting: When users exchange USDT for USDD, the system mints new USDD and sends it to the user while depositing the USDT into the reserve pool. * Redeeming: When users exchange USDD for USDT, the system burns the USDD and releases the corresponding USDT from the reserve pool. The Peg Stability Module (PSM) plays a critical role in maintaining USDD’s 1:1 peg to the US dollar by facilitating and hence reducing arbitrage through seamless stablecoin conversions: * Zero-Slippage Swaps: Users can exchange USDD for other stablecoins, such as USDT, at a 1:1 ratio without incurring slippage. * Gas-Only Transactions: The PSM allows for seamless swaps with no service fees, requiring users to pay only the gas fees. This approach fosters user trust and enhances liquidity. * Demand-Supply Balancing: By offering stablecoin swaps, the PSM mitigates price volatility during periods of heightened market activity. ## Governance and Risk Management USDD leverages a decentralized governance framework to ensure adaptive decision-making and effective risk mitigation. Further details will be shared soon—stay tuned! ## Transparency and Auditing Transparency is a cornerstone of the USDD protocol, fostering user trust and ensuring accountability: * On-Chain Auditing: All transactions, collateral reserves, and system metrics are recorded on the blockchain, enabling real-time verification. * Performance Dashboards: User-friendly dashboards display vital statistics, including total USDD minted, collateral locked, and liquidation activity. * Open-Source Integrity: The protocol’s codebase is fully open-source, allowing the community and security experts to audit and enhance its reliability. * Independent Third Party Auditing: The smart contracts have been thoroughly audited by independent third-party security firms to ensure safety and reliability. # Smart Allocator The USDD protocol is constantly evolving, and now we are taking a big step towards sustainable yield. We’re proud to introduce [**Smart Allocator**](https://usdd.io/data/3/SA001-A), USDD’s new fully on-chain, transparent, and risk-controlled investment strategy that brings self-sustaining yield to the USDD ecosystem. Built to be sustainable, transparent and rewarding for users, Smart Allocator allows the protocol to generate yield independently, and its final aim is to remove reliance on external subsidies and pave the way toward long-term economic viability. ## Why Smart Allocator? Until now, USDD’s yield has been funded by TRON DAO. While effective for growth, this approach must mature if we want to consider USDD’s long-term development. Incentives backed by centralized subsidies are not sustainable forever, and protocols that depend on them remain vulnerable. Smart Allocator changes this by enabling the USDD protocol itself to invest idle capital, earn yield, and redistribute those earnings to the community. All this is achieved without affecting peg stability, allowing users a low-risk way to earn yield without compromising stability and security. With Smart Allocator, USDD is more than just a stablecoin. It becomes a **self-sustaining financial system** that works in the long term. ## How Smart Allocator Works To fully understand how Smart Allocator enables sustainable, protocol-driven yield, let’s walk through each step of the process: **1. Capital is invested** Smart Allocator is a yield-sharing initiative where capital from USDD’s cash reserve is deployed into investment opportunities to earn returns in the form of interest and platform rewards. * The overall investment strategy is conservative and under the USDD team’s dynamic monitoring. * The chosen investment platforms such as Aave are selected by USDD and JUST DAO teams based on strict risk controls, prioritizing high liquidity and high reliability. * The investment cap is set at a certain amount. **2. Investment is regularly reviewed.** * Investments will be made in steps. * After the first investment is made, it will be carefully reviewed based on market conditions, liquidity amount, and amount of returns. * This review will determine the next investment amount and chosen platform(s). * This review process continues with each investment. **3. Returns are redistributed to users** As the investments earn yield, the protocol redistributes net returns back to users, excluding a small portion kept as a risk reserve. * Returns are regularly redistributed as staking rewards, allocated based on users’ contribution to the ecosystem. * The entire returns redistribution process is automated, on-chain, auditable, and fully transparent. Users can track each step of the [Smart Allocator](https://usdd.io/data/3/SA001-A) process and view various real-time metrics such as debt, invested amount, APY, etc. USDD smart contracts have also passed [Chainsecurity’s audit](https://www.chainsecurity.com/security-audit/usdd-rwa-smart-contracts), which found zero vulnerabilities outside of acceptable risks. ## Benefits of Smart Allocator Smart Allocator brings a range of benefits to both the USDD protocol and USDD users, enhancing user experience and system performance at the same time. Key benefits of Smart Allocator include: * **Creating sustainable yield** — Reducing dependence on external subsidies and allowing for long-term growth * **Rewarding users with investment returns** — Continuing to reward users by distributing regular yield from protocol-generated profits * **Improving USDD’s overall yield** — Turning idle capital into income-generating assets * **Optimizing capital efficiency** — Deploying surplus funds effectively without affecting user liquidity or redemption * **Diversifying systemic risks** — Spreading investments across multiple platforms and increasing the protocol’s resilience to market volatility and other vulnerabilities ## How Do I Participate in Smart Allocator? There is nothing you need to change or opt into. As a USDD user, you are ready to reap the benefits of Smart Allocator. Just continue staking USDD as you always have, and when the time comes, your share of the yield will flow back to you. With Smart Allocator, USDD enters a new era of growth, where yield is generated sustainably, risk is carefully managed, and rewards are fairly shared. **Sustainable, Secure, Shared Yields.** Let’s go! # sUSDD Mechanism **sUSDD** is the yield-bearing version of USDD. Its core mechanism is based on the **ERC-4626 tokenized vault standard.** When users deposit and stake USDD into the USDD Earn protocol, sUSDD is minted and distributed according to the current exchange rate. #### Core Mechanism & Value Accumulation The value growth of sUSDD stems from its unique redemption mechanism, which reflects the dynamic relationship between total USDD staked and accumulated rewards. The minting and valuation formulas are as follows:
**Dynamic value growth** * At any moment, the **sUSDD-to-USDD** value serves as the key metric for tracking cumulative yield performance. * As USDD continues to accrue returns via the **Smart Allocator** strategy, the value of sUSDD steadily increases over time. * This ensures that holders of sUSDD directly benefit from the yield strategy, reflected in the token’s appreciating value.
#### Liquidity & Redeemability * Each sUSDD is **fully redeemable** for USDD at any time. * USDD deposited is **never locked**, and withdrawals from sUSDD incur **no liquidity restrictions**. #### ERC-4626 Standard sUSDD is an ERC-4626-compliant **tokenized vault** designed for EVM-compatible blockchains. This standard enhances **DeFi composability and interoperability**. **Key Advantages of ERC-4626:** * **Standardized API** – Provides a unified interface for managing yield-bearing assets efficiently. * **Transparent & Efficient Yield Distribution** – Ensures fair and transparent allocation of returns to staked USDD holders. * **Simplified Integration** – Facilitates future integration of sUSDD with broader DeFi protocols, improving UX and security. #### sUSDD Yield Mechanism Operation sUSDD leverages an **ERC-4626 vault** to distribute yields. This standard ensures **transparent and efficient yield allocation** while providing a solid foundation for integration into broader DeFi applications. # Regarding the Dynamic APY Pricing Mechanism To ensure the long-term stability and sustainability of the protocol, the USDD team has adopted a "Dynamic APY Pricing Model" for interest rate evaluation and adjustment. The calculation of the Base APY primarily considers the following core factors: * Crypto Market Benchmark Reference: Continuously monitoring the 7-day moving average yield of mainstream, high-quality yield-bearing stablecoins in the crypto market to serve as the industry baseline. * Federal Reserve Rate Reference: Incorporating traditional finance risk-free rates (such as the US Federal Reserve target rate) into consideration, ensuring the Base APY remains above traditional market benchmarks to safeguard users' baseline returns. * Market Competitive Premium: Building upon the dual benchmarks mentioned above, maintaining a competitive premium to ensure the provision of market-competitive returns for users. * Underlying Yield and Healthy Balance: Taking into account the actual comprehensive return on investment of the protocol's underlying assets, maintaining the overall interest rate within a healthy range while safeguarding capital efficiency, thereby achieving long-term sustainability. # Getting Started If you believe in the long-term value of the collateral you've deposited and don't want to sell it, but still need liquidity for other purposes in life, USDD offers a secure and decentralized solution. By minting USDD using your collateral, you can maintain your investment while accessing the funds you need. ## Feature Overview ### Vault Management The Vault system allows you to manage your collateral and mint USDD securely and efficiently. * Open a Vault: Select your preferred collateral type, specify the amount of collateral you wish to deposit, and enter the amount of USDD you want to mint. Confirm the transaction with a wallet signature. * Payback: Repay the minted USDD along with the accrued stability fees to clear your debt and free up your collateral. * Withdraw: After repaying your debt or ensuring your Vault has sufficient collateral, you can withdraw the collateral you previously deposited. ### Peg Stability Module (PSM) The USDD PSM enables seamless, zero-fee conversions between USDD and other stablecoins like USDT. This feature plays a critical role in maintaining USDD's 1:1 peg to the US dollar, ensuring stability in all market conditions. * Convert USDD to USDT or vice versa instantly without slippage. * A user-friendly way to maintain liquidity and hedge against market volatility. ### Migrate Easily upgrade from the USDD(OLD) system to the latest version with enhanced features and stability. Migration ensures you can access all the benefits of the new USDD protocol while preserving your assets. ### Portfolio Management The portfolio dashboard provides a comprehensive view of your Vault activity and collateral health: * View all active Vaults associated with your wallet. * Check detailed transaction histories, including minting, payback, and withdrawals. * Monitor your collateral ratio to avoid liquidation risks. ### Liquidation Protect the system from under-collateralized positions. If a Vault's collateral ratio falls below the liquidation threshold, the collateral will be liquidated to recover the debt and maintain system stability. * How It Works: Liquidated Vaults sell collateral to repay debt and fees. * Stay informed about liquidation risks by checking your Vault regularly. * Always maintain a healthy collateral ratio to avoid liquidation. ### Auction The auction system helps redistribute liquidated collateral fairly and efficiently: * Bid on liquidated collateral to acquire assets at competitive prices. * View auction details such as Auction ID, debt amount, available collateral, and current bid price. * Participate in auctions to support system stability while potentially earning a profit. # Open a Vault 1. **Navigate to the Vault page** 2. **Connect Your TronLink Wallet** 1. Begin by linking your TronLink wallet to the platform. This wallet will serve as your interface for managing collateral and minting USDD. 2. Ensure your wallet has sufficient TRX to cover the gas fees for transactions.
3. **Select a Collateral Type** Choose the type of collateral you want to deposit from the available options. Each collateral type may have different stability fees and liquidation thresholds, so select the one that best suits your strategy.
4. **Input Collateral Amount** 1. Enter the amount of collateral you wish to deposit into the Vault. Make sure the amount does not exceed the balance available in your TronLink wallet. 2. Double-check your wallet balance to avoid transaction errors.
5. **Enter the Amount of USDD to Mint** 1. Specify the amount of USDD you’d like to mint. The system will automatically calculate the maximum mint amount based on your collateral and the current market conditions. 2. If the collateral you’re staking is not TRX, you may need to complete an approve transaction before proceeding. 3. Minting a smaller amount of USDD results in a higher collateral ratio, making your Vault safer from liquidation. 4. Minting a larger amount of USDD decreases your collateral ratio, increasing the risk of liquidation if the collateral value drops.
**Pro Tips for Managing Your Vault：** * Regularly monitor your collateral ratio to ensure it stays above the liquidation threshold. * Keep an eye on market prices for your collateral, as fluctuations could impact the safety of your Vault. * Use the platform’s portfolio tools to track your transactions and manage your positions efficiently. * If you’re new to the system, you’ll be prompted to create a proxy. Don’t worry—this process is straightforward, and step-by-step guidance will help you complete it in just a few clicks. # Manage a Vault If you’ve already **opened a Vault**, you can manage it through various actions to optimize its performance and mitigate risks. Below is a detailed guide for managing your Vault: 1. **Add Collateral** Adding more collateral to an existing Vault increases the Collateralization Ratio, reducing the risk of liquidation. * Enter the amount of collateral you wish to deposit. * The updated collateralization ratio and other key metrics will be displayed on the right side of the page, providing a clear view of how this action affects your Vault's stability.
**2. Mint More USDD** If you need additional liquidity, you can mint more USDD from your Vault. * Enter the desired amount of USDD to mint, staying within the allowable range to avoid errors. * Caution: Minting more USDD decreases the Collateralization Ratio, increasing the risk of liquidation. If the ratio falls below the Min. Collateral Ratio, your Vault may be liquidated to cover the debt.
**3. PayBack USDD** If you have surplus USDD, you can repay part or all of your Vault debt. * Reducing your debt increases the Collateralization Ratio, significantly lowering the risk of liquidation. * This is a useful option if you aim to stabilize your Vault or reduce exposure to potential market volatility.
**4. Withdraw Collateral** If your Vault is well-collateralized and not at risk of liquidation, you may withdraw a portion of your collateral. * Enter the amount you wish to withdraw. * Caution: Withdrawing collateral reduces the Collateralization Ratio, potentially bringing your Vault closer to the Min. Collateral Ratio. Monitor the updated metrics carefully before proceeding.
**Risk Management Tips:** * Always maintain a healthy **Collateralization Ratio (CR)** above the **Min. Collateral Ratio (MCR)** to avoid liquidation. Your position falls into one of four categories: * **Conservative:** Your CR is well above the MCR, providing a strong safety buffer. * **Moderate**: Your CR is above the MCR, but the buffer is smaller—monitor your position closely. * **Aggressive:** Your CR is near the MCR, putting your Vault at high risk of liquidation. Take immediate action to top up your collateral or reduce your debt. * **Liquidation**: Your CR has fallen below the MCR, and your Vault is being liquidated. To minimize risk, aim to stay within the Conservative or Moderate ranges, and avoid the Aggressive zone by actively managing your Vault. * Regularly review your Vault's status, especially during periods of market volatility. * Consider repaying USDD or adding more collateral if your Vault's ratio approaches the Min. Collateral Ratio. These management tools allow you to maintain flexibility while keeping your Vault secure and optimized for your financial goals. # Close a Vault 1. **Navigate to the Vault page** Go to the Vault section and locate the active Vault you wish to close. 2. **Connect Your Wallet** Connect your wallet to the platform. Ensure your wallet has enough TRX to cover the gas fees required for repayment and collateral withdrawal.
3. **Review Your Vault Status** Before closing your Vault, check: * The outstanding USDD debt * Your collateral balance * Your current collateral ratio Make sure you have enough USDD in your wallet to fully repay the debt.
4. **Repay all borrowed USDD** Navigate to the Payback & Withdraw tab
In the Payback field, click Payback All or enter the full debt amount.
5. **Withdraw all your collateral** In the Withdraw field, click Max or enter the full collateral amount.
6. **Confirm Transaction** Click Payback All & Withdraw, confirm the transaction in your wallet.
Once completed, your Vault debt will be zero, and all collateral will be returned to your wallet.
**Note:** If you don’t have enough USDD, you can: * Swap USDD via the PSM (Peg Stability Module) * Or purchase USDD from exchanges # Risk Alert Protecting your assets with real-time risk monitoring To help users better manage their collateralized positions, USDD has officially launched the Risk Alert feature. With Risk Alert, you’ll be notified the moment your position approaches the liquidation threshold, allowing you to take timely action and avoid unnecessary losses. **Key Features** * Dual-channel notifications: On-page alerts + Email notifications * Wallet signature verification: No gas fee required * Quick and easy email binding * Instant alerts for high-risk positions to help prevent liquidation **How to Enable Risk Alerts** Just 6 simple steps to enable email risk alerts: Step1: Visit and connect your wallet.
Step2: * Click the bell icon in the top right corner. 🔔 * Then, sign the smart contract to authorize access to the Risk Alert interface. This signature simply verifies ownership of your wallet address—no gas fees will be charged.
Step3: Connect and sign with your wallet * You’ll be prompted to sign a message with your wallet. * The signature is only used to verify ownership of the address—no gas fee will be charged. * After signing, you’ll proceed to the next step.
Step4: Turn on Risk Alert * Switch on the risk alert toggle to start receiving notifications.
Step5: Enter your email address * Use a frequently checked email to receive timely alerts. * Your email will only be used to send risk notifications.
Step6: Enter the verification code to complete the binding * A one-time code will be sent to your email. * Enter the code to finish binding your email to your wallet.
Once binding is complete, you can return to the same page anytime to turn email alerts on or off.
**Two Types of Risk Alerts** 1. On-Page Alerts (Always Active) Risk warnings will automatically appear at the top of the page based on your Vault’s Collateral Ratio: * **High Risk Alert**: Collateral Ratio is less than **5%** above the liquidation line * **Moderate Risk Alert**: Collateral Ratio is less than **10%** above the liquidation line No setup needed—alerts are always active and update in real time to keep you informed.\ \\ 2\. Email Alerts (Manually Toggle On/Off) * When enabled, the system will send an alert email whenever a risky position is detected.\ Perfect for users who are not always on the page—ensuring you receive important updates anytime, anywhere. * You can manage this feature anytime through the bell icon in the top right corner. * **High Risk Alert**: Collateral Ratio is less than **5%** above the liquidation line * **Moderate Risk Alert**: Collateral Ratio is less than **10%** above the liquidation line # Liquidation When a Vault's Collateralization Ratio falls below the Min. Collateral Ratio, it becomes eligible for liquidation. This process plays a critical role in maintaining the stability and efficiency of the USDD ecosystem. By participating in liquidations, users can earn rewards while contributing to the system's health. #### Steps to Participate in Liquidation 1. **Navigate to the Liquidation Page**\ Visit the Liquidation Page to view Vaults eligible for liquidation.
2. **Review Vault Details**\ Each Vault's detailed information, including its debt and collateral status, is available on the liquidation page. This helps users make informed decisions before initiating a liquidation.
3. **Earn Liquidation Rewards**\ Users who trigger a liquidation will receive a reward. Rewards are distributed based on the following formula: **Potential Net Profit = Liquidation Incentive (Relative) + Liquidation Incentive (Constant) - Transaction Fee** 1. Liquidation Incentive (Relative): This reward component is proportional to the debt of the liquidated Vault. 2. Liquidation Incentive (Constant): A fixed reward for successfully liquidating a Vault. 3. Transaction Fee: The estimated gas fee for completing the transaction. The actual fee can be verified later using a blockchain explorer.
4. Choose Reward Address: 1. Rewards can be sent to your currently connected wallet. 2. Alternatively, you can specify a different address to receive the rewards. 5. Withdraw Rewards： The rewards from liquidations are stored in the liquidation auction account. Users can withdraw these rewards to their wallets as part of the liquidation process. #### Key Benefits * Helps maintain system stability by resolving under-collateralized Vaults. * Provides users with tangible incentives for their participation. # Collateral Auction When a Vault is liquidated, its collateral is moved into an auction process. Users can bid on the collateral at auction prices, potentially securing profits. The auction uses a Dutch auction model, where the price gradually decreases over time until a buyer places a bid or the auction ends. #### Steps to Participate in an Auction 1. **Navigate to the Auction Page**\ Visit the Auction Page to explore ongoing auctions.
2. **View Auction Details** 1. Access the details of the Vault undergoing auction. 2. Review information about the collateral, debt, and current auction price. 3. **Stake USDD for Auction Participation** 1. To bid, you must first stake USDD, which will be used for purchasing collateral in the auction. 2. Staked USDD can be withdrawn anytime if not used for a bid. 4. **Place Your Bid** 1. Enter the amount of USDD you wish to bid. 2. The platform will automatically calculate: 1. Collateral Quantity: The amount of collateral you will receive, calculated as:\ **Collateral Quantity = Input USDD Amount / Auction Price** 2. Potential net Profit: The potential net profit you can earn if you sell the collateral at the current market price. Profit Calculation Formula:\ **Potential Net Profit = Input USDD Amount \* Market Price - Input USDD Amount \* Auction Price - Transaction fee**
5. **Monitor Auction Prices** 1. Since the auction follows the Dutch auction model, the price decreases over time. 2. The page displays the current auction price and the time remaining before it decreases further. 6. **Complete the Purchase** 1. If your bid is successful, you will acquire the collateral, which can be sold or used as desired. Any collateral obtained from auctions is stored in the liquidation auction account and can be withdrawn to the winning bidders’ wallet. 2. The actual profit will depend on the market price when you decide to sell the collateral. Participating in auctions is an excellent way to acquire assets at competitive prices and contribute to the USDD ecosystem. # PSM To perform stablecoin-to-USDD conversions, navigate to the PSM page.
PSM is USDD’s built-in fixed-rate swap feature that lets you convert between USDD and supported stablecoins at a predictable 1:1 rate. It’s designed to keep USDD stable while giving users a simple, transparent way to move in and out of USDD. #### How to Use the PSM 1. **Select the Stablecoin:** On the PSM page, choose the token you want to exchange for USDD or vice versa.
2. **Enter the Token Amount**: Input the amount of tokens you wish to swap. The transaction requires no service fees; however, ensure your wallet has enough TRX to cover the gas fees for the transaction.
3. **Check Availability:** The "Available" section displays the quantity of the target token currently available for exchange. Ensure your swap amount does not exceed the available limit. The PSM feature is designed for ease of use, offering fast and secure conversions without slippage, making it an essential tool for users seeking to maintain the 1:1 USDD peg while interacting with other stablecoins. # Migrate The Migration feature offers a seamless way for users holding USDDOLD to upgrade to the new USDD version. With no time constraints on migration, users can convert their tokens at any time that suits them. Steps to Migrate Your USDDOLD: 1. Navigate to the Migration Page:\ Visit the Migration Page to access the migration feature.
2. Enter the Migration Amount: * Specify the amount of USDDOLD you wish to convert to the new USDD. * Ensure that the entered amount does not exceed your wallet balance.
3. Confirm the Transaction: * Use your connected wallet to approve and confirm the migration. * Once confirmed, the equivalent amount of new USDD will be credited to your wallet.
4. No Fees, No Deadlines: * The migration process is gas-only transactions. * There is no deadline for migration, allowing you to upgrade at your convenience. Why Migrate to the New USDD? * Improved Stability: Enhanced mechanisms ensure the 1:1 peg to the US dollar. * Full Decentralization: Upgraded governance structure with greater community participation. * Better Integration: The new USDD supports seamless compatibility with DeFi platforms and tools. # USDD Savings This guide explains how to stake USDD to earn yield through sUSDD. By connecting your wallet, depositing USDD, and receiving sUSDD as proof of stake, you can start earning interest automatically. You can withdraw your funds at any time without a lock-up period. ### 1. Connect Your Wallet * On the Earn page, select the Ethereum/BNB Chain network.
* Click **Connect Wallet** in the top-right corner.
* Choose your wallet from the popup.
* Once connected, your wallet address will appear on the page.
### 2. Deposit USDD * Under Deposit, enter the amount of USDD you want to stake (cannot exceed your wallet balance).
* Click Approve/Deposit and confirm the transaction in your wallet.
* Once the transaction is confirmed: * You will see your sUSDD balance on the left side of the page. * The corresponding USDD value of your sUSDD will also be displayed.
* Over time, the USDD value of your sUSDD increases automatically, reflecting your earned yield. ### 3. Withdraw USDD * Under Withdraw, enter the amount of USDD you want to withdraw.
* Click Withdraw and confirm the transaction in your wallet.
* After confirmation, your sUSDD will be burned, and you will receive the corresponding amount of USDD in your wallet. * You can view all your actions in your transaction history.
### ✅ Notes * There is no lock-up period — you can withdraw anytime. * When withdrawing, you will receive your initial deposit plus the accumulated yield. # Glossary ## General * `wad`: some quantity of tokens, usually as a fixed point integer with 18 decimal places. * `ray`: a fixed point integer, with 27 decimal places. * `rad`: a fixed point integer, with 45 decimal places. * `file`: administer some configuration value * `auth`: check whether an address can call this method * `wards`: an address that is allowed to call authored methods * `rely`: allow an address to call authored methods * `deny`: disallow an address from calling authored methods * `Authority:` checks whether an address can call this method ## Vat * `hope`: enable wish for a pair of addresses. * `nope`: disable wish for a pair of addresses. * `init`: start stability fee collection for a particular collateral type * `slip`：modify a user's collateral balance. * `move`：transfer stablecoin between users. * `frob`：modify a Vault. * `grab`：liquidate a Vault. * `heal`：create / destroy equal quantities of stablecoin and system debt (vice). * `suck`：mint unbacked stablecoin (accounted for with vice). * `fold`：modify the debt multiplier, creating / destroying corresponding debt. * `ilk`：a collateral type. * `art`：total normalized stablecoin debt. * `rate`：stablecoin debt multiplier (accumulated stability fees). * `line`：the debt ceiling for a specific collateral type. * `dust`：the minimum possible debt of a Vault. ## Vow * `Sin`: the total amount of debt in the queue. * `Ash`: the total amount of on-auction debt. * `wait`: debt auction delay. * `sump`: debt auction bid size, i.e. the fixed debt quantity to be covered by any one debt auction * `dump`: debt auction lot size, i.e. the starting amount of MKR offered to cover the lot/sump * `bump`: surplus auction lot size, i.e. the fixed surplus quantity to be sold by any one surplus auction * `hump`: surplus buffer, must be exceeded before surplus auctions are possible ## Dog * `bark`: A vault’s all debt is taken when this liquidation function is called. * `ilk` * `chop`: Liquidation Penalty * `hole`: Max USDD needed to cover debt+fees of active auctions per ilk * `dirt`: Amt USDD needed to cover debt+fees of active auctions per ilk ## Clip * `buf`: Multiplicative factor to increase starting price * `tail`: Time elapsed before auction reset * `cusp`: Percentage drop before auction reset * `chip`: Percentage of tab to suck from vow to incentivize keepers * `tip`: Flat fee to suck from vow to incentivize keepers * `chost`: Cache the ilk dust times the ilk chop to prevent excessive SLOADs * `sale` * `pos`: Index in active array * `tab`:USDD to raise * `usr`: Liquidated CDP * `tic`: Auction start time * `top`: Starting price ## Jug * `duty`: Collateral-specific, per-second stability fee contribution * `rho`: Time of last drip ## Median * `orcl(usr: address)` : oracles whitelist of the prices (whitelisted via governance / the authorized parties). * `bud(usr: address):` readers whitelist. * `val:` the price (private) must be read with `read()` or `peek()` * `age`: the Block timestamp of last price `val` update. * `wat:` the price oracles type (ex: TRXUSD) / tells us what the type of asset is. * `bar`: the Minimum writers quorum for poke / min number of valid messages you need to have to update the price. ## OSM * `src` : address of DSValue that the OSM will read from * `hop` : time delay between poke calls (uint16); defaults to ONE\_HOUR * `cur` : Feed struct that holds the current price value * `nxt` : Feed struct that holds the next price value * `bud` : mapping from address to uint256; whitelists feed readers # Core Contracts # Vat ### **Purpose** The core accounting contract of the protocol, VAT tracks system-wide balances, including user Vaults, collateral types, and debt. It ensures that all collateral and debt are properly accounted for and enforces system solvency. ### Key Responsibilities * Tracks collateral and debt balances for all users and collateral types. * Ensures Vault operations (e.g., minting and repaying USDD) adhere to protocol parameters. * Integrates with other contracts to trigger auctions or manage liquidations. ### Key Methods * `slip(ilk, usr, wad)`\ Adjusts the balance of a specific collateral type (`ilk`) for a user (`usr`). * Example Use: Adding or removing collateral from a user's Vault. * `frob(ilk, u, v, w, dink, dart)`\ Adjusts collateral (`dink`) and debt (`dart`) for a Vault. * Example Use: Minting new USDD or repaying debt. * `grab(ilk, u, v, w, dink, dart)`\ Executes adjustments on collateral and debt during liquidation. * `fold(ilk, u, rate)`\ Increase the `Ilk.rate` with rate, and hence the debt balances of all Vaults collateralized with the specified Ilk are updated implicitly. * `file(what, data) / file(what, ilk, data)`\ Sets or updates system-wide parameters like debt ceilings, stability fees, or collateralization thresholds. * Example Use: Setting a collateral type’s maximum mintable USDD. # Dog ### **Purpose** The Dog contract oversees the liquidation process. It monitors Vaults for undercollateralization and triggers auctions to sell collateral when necessary. ### Key Responsibilities * Tracks undercollateralized Vaults. * Incentivizes keepers to liquidate risky positions. ### Key Methods * `bark(ilk, urn, kpr)`\ Initiates the liquidation process for a Vault (`urn`). Determines the amount of collateral to be auctioned and distributes liquidation rewards to keepers. hole: Maximum debt to liquidate per collateral type. * `digs(ilk, rad)`\ Adjusts internal debt balances after liquidation is completed. * `file(what, ilk, data)`\ Configures liquidation parameters, such as penalties and incentives. * Example Parameters: * `chop`: Liquidation penalty (e.g., 5% of the debt). * `hole`: Maximum debt to liquidate per collateral type. # Clip ### **Purpose** Handles collateral auctions, where liquidated collateral is sold to cover bad debt. CLIP ensures auctions operate fairly and efficiently using a Dutch auction mechanism. ### Key Responsibilities * Conducts auctions for liquidated collateral. * Ensures participants receive fair prices. ### Key Methods * `kick(tab, lot, usr, kpr)`\ Starts an auction with a debt amount (`tab`), collateral amount (`lot`), and Vault owner (`usr`). * Example Use: Kicking off an auction for a liquidated Vault. * `redo(id, kpr)`\ Allows keepers to reinitialize a stale auction, ensuring auction prices remain relevant. * `take(id, amt, max, who data)`\ Users can participate in an auction by calling this function.yank(id)\ Cancels an auction when debt is repaid or resolved through other means. * `file(what, data)`\ Configures auction parameters such as price decay rates or auction durations. * Example Parameters: * `tip`: Fixed incentive for starting an auction. * `cut`: Price decay factor per second. # Spot ### **Purpose** Ensures the protocol receives real-time, reliable price data for all collateral types. SPOT determines whether Vaults meet collateralization requirements. ### Key Responsibilities * Retrieves and updates collateral prices. * Enforces collateralization thresholds for system stability. ### Key Methods * `poke(ilk)`\ Updates the system with the latest price for a specific collateral type. * Example Use: Updating the TRX price when markets fluctuate. * `file(what, ilk, data)`\ Configures parameters such as the liquidation ratio (`mat`). * Example Use: Setting mat to 150%, requiring 1.5x collateral for every USDD minted. # Jug ### **Purpose** Calculates and accrues stability fees on minted USDD. These fees ensure protocol sustainability and discourage excessive borrowing. ### Key Responsibilities * Accumulate stability fees for particular collateral types . * Adjusts debt levels to reflect accrued interest. ### Key Methods * d`rip(ilk)`\ Performs stability fee collection for a specific collateral type when it is called. Calls `Vat.fold` to update the collateral's rate, total tracked debt, and Vow surplus; duty: Annualized stability fee rate. * `file(what, data) / file(what, ilk, data)`\ Configures global and per-collateral stability fee rates. * Example Parameters: * `duty`: Annualized stability fee rate. # Median ### **Purpose** It provides the protocol’s trusted reference price. ### Key Responsibilities * Maintains a whitelist of price feed contracts which are authorized to post price updates. * Computes and updates the stored value when a new list of prices is received. ### Key Methods * `poke()`\ Updates price from whitelisted providers. * `peek(what, data) / file(what, ilk, data)`\ Get the price and validity. # OSM ### **Purpose** It ensures that new price values propagated from the Oracles are not taken up by the system until a specified delay has passed. ### Key Responsibilities * Periodically feeds a delayed price into the system for a particular collateral type. ### Key Methods * `peek()`\ Returns the current feed value and a boolean indicating whether it is valid. * `read()`\ Returns the current feed value; reverts if it was not set by some valid mechanism. * `peep()`\ Returns the next feed value (i.e. the one that will become the current value upon the next `poke()` call), and a boolean indicating whether it is valid. # Proxy contract ### **Purpose** * The DSProxy contract allows users to execute code on their behalf using a persistent proxy address. * It simplifies complex multi-step operations by enabling atomic execution within the context of the proxy’s identity. * Ownership of the proxy is flexible and can be transferred, supporting dynamic models like multisignature wallets. ### Key Methods * `execute(bytes memory _code, bytes memory _data)` * If \_code corresponds to a cached contract, it is executed directly; otherwise, the contract is deployed and cached before execution. * \_data specifies the calldata to be sent to the contract. * Emits an Execute event upon successful execution. * `execute(address _target, bytes memory _data)` * Directly executes a specified contract (\_target) with provided calldata (\_data). * Requires the caller to have the necessary auth permissions. # PSM ### **Purpose** Maintains USDD’s price peg by facilitating 1:1 swaps with other stablecoins (e.g., USDT). ### Key Responsibilities * Reduces volatility during market imbalances. * Offers zero-slippage swaps with no fees. ### Key Methods * `sellGem(usr, wad)`\ Allows users to exchange a stablecoin (`gem`) for USDD. * `buyGem(usr, wad)`\ Enables users to swap USDD for another stablecoin. * `file(what, data)`\ Sets PSM parameters such as swap limits or supported stablecoins. # Migrate ### **Purpose** Enables seamless migration of USDDOLD to the new USDD version. This tool ensures users can upgrade at their convenience without deadlines. ### Key Responsibilities * Converts legacy USDD tokens into the upgraded version. * Simplifies the user transition process. ### Key Methods * `migrate(usr, wad)`\ Converts a specified amount of USDDOLD for a user. # Deployment Addresses ### Tron Mainnet
NameContract Address
USDDTCrEVahRbhDFB6uRXEWUg7wkptXvg47GKs
USDD JoinTUajR7CbXU6hX8n3XtNkitFAD25JvP99K6
VatTH5dhX7o39afSbfDT2e3c9k4itWjNKD4D9
JugTWttvCqVmiLip7PL8Aut2Hi37swqv7EmYd
DogTCwYKcDj8c5Te9hjj3UokcxhpY6skFoXnG
VowTXLfZmQtLtLxWYNL2fxhw34JNGHB2EKeSU
FlapTP2eYpkrgk7sLAts5tvzsFxHiDH8PmQcuH
FlopTX6CM8K1FgS2nnTEjLsKW6TAVSipFXHh5C
SpotTU8Z8CeUd7pnXSMHTNqRgK6Qxxxyzsba1n
EndTXhepqfva4WvcK6HapedmzwDjdZv8KoY6p
ESMTVKZKa1LDadTPm2AoAW7hp9BtdScK4gSk8
PauseTNq6E9XsQfrzqVwam67LApZQx1omsj8dyW
PauseProxyTE6RxGgQuD6J1faw9mZxtbHGDqcKh8DvKU
ProxyRegistryTHuVWkvAikvSqmoZXHMUQJAcocsgFr4wuk
CDP ManagerTDDWjmQaquEtUn1Pa8wCd8dfWFPdQLGPYL
ProxyActionsTEk9usYZsunkc5oYijyMte6sGurspik2Js
GovActionsProxyTXzhj9Xh8xfzerjinRyM5TfoBL7Cw5hk5d
PIP_TRXTVsQxikpttN15u7vcjXKeVrtYRWbrqgPbH
PIP_USDTTMhsJiXUrT5eueuH1cq6SdvQEBt4YjKLfx
JOIN_TRX_ATJ1VWPvFVq7sVsN7J7dWJVZz4SLT14qRUr
CLIP_TRX_ATK9Ng6QqNVvyhWcWAiEasZ1HqE7bxgNayA
JOIN_TRX_BTGQKnHDQNyc3QeHJ7YxH8wggdg89UVXyvX
CLIP_TRX_BTWmmZ44tN6UBAD4iEsoZo5qSAZ64E4HDZZ
JOIN_TRX_CTPUPPLTYLdbW4jxwD5g2T7ystxsR9HL2mt
CLIP_TRX_CTMZTbwpvs7VjTJ7qjwh4EMkB5ahZ5tUJeM
JOIN_USDT_ATDUkQbjrXs6xUbxGCLknWwJHxVTdysXBhy
CLIP_USDT_ATKvNF7aJtU2gUncR64MCdDoaWqrnHpriSL
JOIN_PSM_USDT_ATSUYvQ5tdd3DijCD1uGunGLpftHuSZ12sQ
CLIP_PSM_USDT_AT9yEgaPQT9Z6jsF1Rd2nisf1bpwpXNAFqE
MCD_PSM_USDT_ATBXW4hS5KYjjbJXDpnrPf4zhkLwrpUjbyz
USDD MigrationTQrq2p1aoAkNK94q3Q69ubJcv5nQ9y675R
### Ethereum Mainnet
Name Contract Address
USDD0x4f8e5de400de08b164e7421b3ee387f461becd1a
USDD Join0x983dfef6d71862d809e239845da5a959492f63b8
Vat0xff77f6209239deb2c076179499f2346b0032097f
Jug0xdb218163fe160fedf0c702c37124e8c194e99329
Dog0x9681604090395e835ff54187f638ded8dc983cbf
Vow0xf085edd75c1ab4fda0c3bd49b264a4a113d06f3b
Flap0x0b4adb8d896520eb3fd4789b73463614dcf71b03
Flop0xfb38af74eae1e315a45af5ae11a44ccd1da12bcb
Spot0x8c4c758152da3e04b95b5eaca75585d79013c6b0
End0xa9f0cd86e0a011d41693d1a748a8127877c8b054
ESM0xe4089b868f111ffaf9717d6df8d2c2fe6e698f55
Pause0xca277750ecd2b0707a7ccef2a78ec2f33b5fc7f7
PauseProxy0xf60cf7d4330f115f9e51ff0d56d23f95f0f10aee
ProxyRegistry0x8be6b814beb37e8028258777af0ec6648a2a908e
CDP Manager0xb5b08e58e804e5937f56b1e633cf85abbd269127
ProxyActions0xb80751ef88d07fa33ee4fc0c6f8b4b6c6c31e708
GovActionsProxy0x3dba111255d3888c723242320595588754cf493e
JOIN_PSM_USDT_A0x217e42ceb2eae9ecb788fdf0e31c806c531760a3
MCD_PSM_USDT_A0xce355440c00014a229bbec030a2b8f8eb45a2897
JOIN_PSM_USDC_A0x9a7e1b324060db7342aea08c0dc56f55ced6f519
MCD_PSM_USDC_A0x12d0351f68035a41d13fc8324562e2d51b7a3b93
### BNB Chain Mainnet
NameContract Address
USDD0x45e51bc23d592eb2dba86da3985299f7895d66ba
USDD Join0x6b00039d76795fd59baf17e0c9c6d87011e7edac
VatTH5dhX7o39afSbfDT2e3c9k4itWjNKD4D9
Jug0x12a2a264d6980fb22e5ebb090002bd8f5e618e0b
Dog0x6badab4336b17e8d0839fd0c046e21b41196280b
Vow0x1c9a9d6ee4b5bffdacdad6cfb396a337f311c5b7
Flap0x3f8656be9ef11192fb9ce270446976806fa121c5
Flop0xD6bd489DeDF05dBCcb680304B3AF2df73d1D7De0
Spot0xc1779812be28cd205e45098e079620a830b5ffce
End0x3366948fccf56152ad95d914072a80006b21f6f2
ESM0xf1a7b596763afaa8e51f0cf6a7a9b4c743d3b1c6
Pause0xc081f712e217672374a9c3db708c6f6c183c172e
PauseProxy0xdd5f51dc0d31823db86df41d46d037bc94c732dc
ProxyRegistry0x0144fcce201dc3957fcf75269c10c21cca41ba73
CDP Manager0xa4109496a660ebc8d74de991ac3b04c136c9ba09
ProxyActions0x777684f6425d095e9166f5f694f50e48a16bcb25
GovActionsProxy0x2662e860ea672e4d31df3438114c48511229e60f
JOIN_PSM_USDT_A0xe229fda620b8a9b98ef184830ee3063f0f86b790
MCD_PSM_USDT_A0x939d3fb56cd12d68caa1125cc57a8d2391f7ee29
# Liquidation & Auction Liquidation is a critical process in the USDD system that ensures the stability and solvency of the protocol. When a user's collateralized debt position (CDP) becomes undercollateralized (i.e., the value of collateral falls below the required threshold), the liquidation mechanism is triggered to maintain the integrity of the system. # Key Features of Liquidation **Trigger Mechanism** * The protocol continuously monitors CDPs to assess their collateralization ratio. * If the ratio falls below the minimum collateralization threshold, the liquidation process is initiated automatically. **Auction Process** * Liquidated collateral is put up for auction to a valid bidder. * Bidders, often known as Keepers, compete to purchase the collateral, ensuring market-driven pricing. **Liquidation Fee** * A liquidation fee is imposed on the user whose position is liquidated. * This liquidation fee is designed to discourage risky behavior and compensate the protocol for the added system risk. **Keeper Rewards** * Keepers are incentivized with rewards for participating in the liquidation process. * Rewards typically include a portion of the liquidation fee and opportunities to acquire discounted collateral. **Debt Repayment** * The proceeds from the auction are used to repay the outstanding USDD debt. * Any remaining collateral after repaying the debt and penalties is returned to the user. **Peg Stability Impact** * Liquidation ensures that excessive debt does not destabilize the peg of USDD. * By swiftly resolving undercollateralized positions, the protocol maintains its financial health. # Example Process 1. **Collateral Deposit and Minting**\ A user deposits collateral worth $1,500 and mints $1,000 USDD, maintaining a collateralization ratio of 150%. 2. **Market Downturn and Collateralization Ratio Drop**\ Due to a market downturn, the collateral value drops to $1,200, reducing the collateralization ratio to 120%, which is below the liquidation threshold of 130%. 3. **Liquidation Triggered**\ The system automatically flags the Vault for liquidation to protect the protocol from losses. 4. **Collateral Auction Begins** 1. The liquidation engine starts an auction for the $1,200 worth of collateral. 2. The auction follows a Dutch auction mechanism, where the price starts at a high initial value and gradually decreases over time until a bidder accepts the price or the auction ends. 5. **Keeper Participation** 1. Keepers, who are incentivized participants, place bids during the auction. 2. A Keeper bids an amount of USDD equal to the debt ($1,000) plus the liquidation penalty (10%), totaling $1,100. 3. The Keeper wins the auction by accepting the current auction price for the collateral. 6. **Collateral Settlement** 1. The protocol retains $1,100 worth of USDD to cover the debt and liquidation penalty. 2. Any remaining collateral value (after deducting the amount sold during the auction) is refunded to the user. 7. **Auction Outcome** 1. The Keeper receives the collateral at the auction price. For example, if the auction price is $0.95 per unit of collateral, the Keeper receives collateral valued at $1,157.89 ($1,100 ÷ $0.95). 2. The user retains any excess collateral that wasn't required to cover the debt and penalty. This process ensures the protocol remains solvent while providing opportunities for Keepers to acquire collateral at competitive prices and protecting users by refunding surplus collateral. \\ # Benefits * **Protects the Protocol Against Bad Debt**\ By swiftly addressing under-collateralized positions, the liquidation process safeguards the system from accumulating unmanageable debt, ensuring its financial health and sustainability. * **Maintains Trust in the System**\ Adhering to strict collateralization requirements reinforces user confidence in the stability and reliability of the USDD ecosystem. * **Stabilizes the USDD Peg**\ Liquidation and auction processes help maintain USDD’s 1:1 peg to the dollar by ensuring that collateral backing the stablecoin remains sufficient, even during market downturns. * **Enables Efficient Collateral Redistribution**\ Auctions redistribute liquidated collateral efficiently to market participants (Keepers) who value and purchase it, allowing for rapid system stabilization and collateral recirculation. * **Incentivizes Market Participation**\ Keepers are rewarded for participating in liquidations and auctions, creating an active ecosystem that enhances the protocol's responsiveness and liquidity. * **Strengthens System Resilience**\ The liquidation and auction mechanism enhances the protocol's ability to withstand extreme market volatility, ensuring decentralized, secure, and robust operations. This comprehensive process not only preserves the protocol’s integrity but also creates a self-sustaining loop of stability, transparency, and trust, which are critical to USDD’s long-term success in the DeFi ecosystem. \\ # Oracle An oracle module is deployed for each collateral type, feeding it the price data for a corresponding collateral type to the `Vat`. Every oracle module contains three main contracts: `Median, OSM, Spot`. ### Procedure 1. Median computes a price from a list of supported price feeds. 2. OSM updates the current price and the next price according to the price from Median. 3. Spot reads the current price from OSM and updates `ilk.spot` in `vat`. *USDD use Chainlink and WinkLink Data Feeds as its primary Oracles.* # APIs Public REST APIs for accessing USDD protocol data — no authentication required. **Base URL:** `https://openapi.usdd.io` *** ### Endpoints
MethodEndpointDescription
GET/totalSupplyTrue total supply of USDD: USDD in circulation + sUSDD
GET/circulatingSupplyTrue circulating supply of USDD: USDD in circulation + sUSDD
GET/api/v1/external/earn-apyUSDD saving yield across all chains
GET/api/v1/external/total-supply/usddUSDD circulating supply per chain
GET/api/v1/external/total-supply/susddsUSDD circulating supply per chain
*** ### GET USDD Total Supply Returns the true total supply of USDD across all chains as a plain numeric value. > When users stake USDD, they receive sUSDD — a yield-bearing token deployed in on-chain investment strategies. The staked USDD is no longer in circulation. This endpoint returns USDD in circulation + sUSDD, which is the correct figure for total supply tracking. ``` GET /totalSupply ``` **Parameters:** None **Response** Returns a single numeric value (no JSON wrapper). **Example Request** ```bash curl https://openapi.usdd.io/totalSupply ``` **Example Response** ``` 1010300157 ``` *** ### GET USDD Circulating Supply Returns the true circulating supply of USDD across all chains as a plain numeric value. Equals USDD in circulation + sUSDD. ``` GET /circulatingSupply ``` **Parameters:** None **Response** Returns a single numeric value (no JSON wrapper). **Example Request** ```bash curl https://openapi.usdd.io/circulatingSupply ``` **Example Response** ``` 1010300157 ``` *** ### GET Earn APY Returns the current USDD savings annual yield for each supported chain. ``` GET /api/v1/external/earn-apy ``` **Parameters:** None **Response Parameters**
FieldTypeDescription
tronApyStringAnnual yield on TRON, 4 decimal places
ethApyStringAnnual yield on Ethereum, 4 decimal places
bscApyStringAnnual yield on BNB Chain, 4 decimal places
**Example Request** ```bash curl "https://openapi.usdd.io/api/v1/external/earn-apy" ``` **Example Response** ```json { "code": 0, "data": { "tronApy": "0.0800", "ethApy": "0.1200", "bscApy": "0.1200" }, "message": "SUCCESS" } ``` **Error Codes** | Code | Description | | ----- | --------------------- | | `0` | Success | | `500` | Internal server error | *** ### GET USDD Supply Returns the current USDD supply in circulation across all chains, **excluding sUSDD**. Updated every **5 minutes**. > Note: When users stake USDD, they receive sUSDD — a yield-bearing token deployed in on-chain investment strategies. This endpoint only reflects USDD tokens currently in circulation, not the USDD value staked as sUSDD. To get the true total supply of USDD (including the portion staked as sUSDD), use `/totalSupply`. ``` GET /api/v1/external/total-supply/usdd ``` **Parameters:** None **Response Parameters**
FieldTypeDescription
symbolStringToken identifier, always "USDD"
totalSupplyNumberUSDD in circulation across all chains (excludes sUSDD)
tronNumberUSDD in circulation on TRON
ethNumberUSDD in circulation on Ethereum
bscNumberUSDD in circulation on BNB Chain
**Example Request** ```bash curl "https://openapi.usdd.io/api/v1/external/total-supply/usdd" ``` **Example Response** ```json { "code": 0, "data": { "symbol": "USDD", "totalSupply": 210785566.7, "tron": 48992362.03, "eth": 138316391.29, "bsc": 23476813.38 }, "message": "SUCCESS" } ``` **Error Codes** | Code | Description | | ----- | --------------------- | | `0` | Success | | `500` | Internal server error | *** ### GET sUSDD Supply Returns the current sUSDD circulating supply across all chains. Updated every **5 minutes**. > sUSDD is a yield-bearing token received when staking USDD. Its value grows over time as the underlying USDD is deployed in on-chain investment strategies. sUSDD can be redeemed for USDD at any time. ``` GET /api/v1/external/total-supply/susdd ``` **Parameters:** None **Response Parameters**
FieldTypeDescription
symbolStringToken identifier, always "sUSDD"
totalSupplyNumbersUSDD supply across all chains
tronNumbersUSDD supply on TRON
ethNumbersUSDD supply on Ethereum
bscNumbersUSDD supply on BNB Chain
**Example Request** ```bash curl "https://openapi.usdd.io/api/v1/external/total-supply/susdd" ``` **Example Response** ```json { "code": 0, "data": { "symbol": "sUSDD", "totalSupply": 1890027.46, "tron": 0, "eth": 1201916.02, "bsc": 688111.44 }, "message": "SUCCESS" } ``` **Error Codes** | Code | Description | | ----- | --------------------- | | `0` | Success | | `500` | Internal server error | *** ### Quick Start {% tabs %} {% tab title="JavaScript" %} ```js // Get USDD Total Supply const res = await fetch('https://openapi.usdd.io/api/v1/external/total-supply/usdd'); const { data } = await res.json(); console.log('Total Supply:', data.totalSupply); // → Total Supply: 210785566.7 ``` {% endtab %} {% tab title="Python" %} ```python import requests res = requests.get('https://openapi.usdd.io/api/v1/external/total-supply/usdd') data = res.json()['data'] print(f"Total Supply: {data['totalSupply']:,.2f}") # → Total Supply: 210,785,566.70 ``` {% endtab %} {% endtabs %} # MCP Server ### What It Is The USDD MCP Server is a [Model Context Protocol](https://modelcontextprotocol.io/) implementation that allows AI agents to interact with the **USDD decentralized stablecoin protocol** across **TRON, Ethereum, and BNB Smart Chain**. The server enables both core protocol operations — Vault/CDP, PSM, and Savings — and general-purpose chain utilities such as token balance queries and allowance management. **GitHub**: ### Key Capabilities **USDD Protocol** * **Vault / CDP**: Full vault lifecycle management — open vaults, deposit collateral, mint USDD, repay debt, withdraw, and close. Includes real-time oracle and liquidation configuration per collateral type. * **Vault Risk Monitoring**: AI-guided risk assessment with collateral ratio checks, liquidation threshold warnings, and vault health summaries. * **PSM (Peg Stability Module)**: Real-time fee and enablement status for each PSM. Swap supported stablecoins into USDD or redeem USDD back to the underlying gem. * **USDD Savings**: Inspect current savings rate, sUSDD metrics, and wallet share positions. Deposit and withdraw USDD through the savings module. * **Token Approvals**: Check allowances and approve token spending for USDD protocol interactions. **General Chain** * **Balances**: ERC20 / TRC20 token balances across TRON, Ethereum, and BNB Smart Chain * **Allowances**: Read token allowance for any spender, compare against a required amount for USDD protocol interactions * **Approvals**: Approve token spending for USDD protocol interactions * **Protocol Discovery**: Configured contract addresses, collateral types (ilks), PSM joins, and debt ceilings per network * **Wallet**: Configured signing address resolution per network * **Networks**: Supported network list with chain keys (`tron`, `eth`, `bsc`) ### Supported Networks
NetworkKeyNotes
TRONtronTRON-native vault and PSM support
EthereumethVault, PSM, USDD Savings
BNB Smart ChainbscMirrors ETH deployment structure
### Prerequisites * Node.js 20+ * Optional but recommended: * `TRONGRID_API_KEY` for more reliable TRON access * dedicated `ETH_RPC_URL` * dedicated `BSC_RPC_URL` ### Developer #### Installation ``` git clone https://github.com/decentralized-usd/mcp-server-usdd cd mcp-server-usdd npm install ``` #### Usage ``` npm start npm run start:http npm run dev ``` ### Configuration #### Wallet Setup (Automatic) The server uses [@bankofai/agent-wallet](https://github.com/BofAI/agent-wallet) for encrypted local wallet storage. On first startup it will automatically initialize `~/.agent-wallet/` and create a default wallet if none exists. If a wallet has already been created using **agent-wallet**, no new wallet will be generated during the next startup. On startup, the server will: 1. Check for existing wallets in `~/.agent-wallet/` 2. If none are found, auto-generate a new encrypted wallet 3. Display the derived TRON and EVM addresses in the console You can also manage wallets via **CLI** or **MCP tools**: **CLI (agent-wallet)** ``` # Import an existing private key or mnemonic npx agent-wallet add # Generate a new wallet npx agent-wallet generate # List all wallets npx agent-wallet list # Switch active wallet npx agent-wallet activate ``` **MCP Tools (runtime)**
ToolDescription
get_wallet_addressShows current address (auto-generates wallet if needed)
import_walletImport an existing private key (stored encrypted)
list_walletsList all wallets with IDs, types, addresses
set_active_walletSwitch active wallet by ID
#### Environment Variables ``` # Strongly recommended — avoids TronGrid 429 rate limiting on mainnet export TRONGRID_API_KEY="your_trongrid_api_key" ``` #### Client Configuration **Claude Desktop** Add the following config to: `~/Library/Application Support/Claude/claude_desktop_config.json` ``` { "mcpServers": { "mcp-server-usdd": { "type": "stdio", "command": "npx", "args": ["-y", "@usdd/mcp-server-usdd"], "env": { "TRONGRID_API_KEY": "your_trongrid_api_key" } } } } ``` **Claude Code** Create `.mcp.json` in the project root directory: ``` { "mcpServers": { "mcp-server-usdd": { "type": "stdio", "command": "npx", "args": ["-y", "@usdd/mcp-server-usdd"], "env": { "TRONGRID_API_KEY": "your_trongrid_api_key" } } } } ``` **Cursor** Add to .cursor/mcp.json: ``` { "mcpServers": { "mcp-server-usdd": { "type": "stdio", "command": "npx", "args": ["-y", "@usdd/mcp-server-usdd"], "env": { "TRONGRID_API_KEY": "your_trongrid_api_key" } } } } ``` ### Tools #### Common
ToolDescriptionWrite?
get_supported_networksList supported networksNo
get_protocol_overviewShow configured protocol addresses, ilks, PSMs, and ceilingsNo
get_supported_ilksList configured collateral types and PSM joinsNo
get_token_balanceRead ERC20/TRC20 balanceNo
check_allowanceRead ERC20/TRC20 allowance and compare against an optional amountNo
approve_tokenApprove token allowanceYes
#### Vault
ToolDescriptionWrite?
get_oracle_statusInspect oracle and liquidation configuration for an ilkNo
get_user_vaultsList vault IDs for a walletNo
get_vault_summaryShow collateral, debt, and liquidation metricsNo
analyze_vault_riskSummarize risk with warningsNo
open_vaultOpen a new vault via DSProxyYes
deposit_and_mintOpen-and-mint or add collateral and mintYes
mint_usddDraw more USDD from a vaultYes
repay_usddRepay vault debtYes
withdraw_collateralWithdraw collateral from a vaultYes
close_vaultWipe all debt and free collateralYes
#### PSM
ToolDescriptionWrite?
get_psm_statusInspect PSM fees and enablementNo
psm_swap_to_usddSwap gem into USDDYes
psm_swap_from_usddSwap USDD into gemYes
#### USDD Savings
ToolDescriptionWrite?
get_savings_statusShow USDD Savings metricsNo
deposit_savingsDeposit USDD into sUSDDYes
withdraw_savingsWithdraw USDD from sUSDDYes
### Prompts
PromptDescription
open_usdd_vaultOpen a vault and verify post-trade risk
manage_vault_lifecycleRun full vault lifecycle flows
use_psmUse PSM with fee checks
use_savingsUse USDD Savings with inspection and verification
review_vault_riskExplain risk for a vault
repay_and_close_vaultRepay and close with verification
### Architecture ``` mcp-server-usdd/ ├── src/ │ ├── core/ │ │ ├── chains.ts │ │ ├── abis.ts │ │ ├── tools.ts │ │ ├── prompts.ts │ │ ├── resources.ts │ │ └── services/ │ │ ├── clients.ts │ │ ├── contracts.ts │ │ ├── protocol.ts │ │ ├── vault.ts │ │ ├── psm.ts │ │ ├── savings.ts │ │ ├── tokens.ts │ │ ├── wallet.ts │ │ └── utils.ts │ ├── index.ts │ └── server/ │ ├── server.ts │ └── http-server.ts └── build/ ``` ### Notes * Vault writes assume the configured wallet can sign on the target chain. * ERC20/TRC20 flows often require `approve_token` first. * TRON, ETH, and BSC deployments have similar USDD protocol structure but different addresses and token decimals. * This version intentionally excludes migration and auction actions so we can iterate the Vault + PSM + Savings core first. ### Security Considerations * Private keys are encrypted and stored locally in `~/.agent-wallet/`. * Private keys are never returned by MCP tools. * The optional `AGENT_WALLET_PASSWORD` is intended for automation and CI environments. * Write operations should be treated as state-changing actions and reviewed carefully before execution. * Vault prompts include risk-review steps so borrowing decisions are checked against current collateral health. * Test on a safe environment or with small amounts before using mainnet-sized positions. * Be cautious with large or unlimited token approvals when using `approve_token`. * Never share local MCP client configuration files if they contain private keys or sensitive RPC credentials. ### Example Conversations * "What vault types are available on Ethereum?" -> AI calls `get_supported_ilks` with `network=eth` and summarizes the supported vault collateral types. * "Open a TRX-A vault on Tron and mint 500 USDD" -> AI uses `open_usdd_vault`: checks wallet, reviews oracle status, executes `deposit_and_mint`, then verifies the new vault risk. * "Am I close to liquidation on vault 123?" -> AI calls `get_vault_summary` and `analyze_vault_risk`, then explains the health factor and collateral buffer. * "Repay part of my vault debt on BSC" -> AI uses `manage_vault_lifecycle` with `action=repay`: checks USDD balance and allowance, calls `repay_usdd`, then verifies the updated vault state. * "Close my vault and withdraw the collateral" -> AI uses `repay_and_close_vault`: checks debt, balance, allowance, calls `close_vault`, then confirms the vault state after repayment. * "What are the current PSM fees on Ethereum?" -> AI calls `get_psm_status` with `network=eth` and reports fee-in, fee-out, and whether swaps are enabled. * "Swap 10,000 USDT into USDD through the PSM" -> AI uses `use_psm`: checks PSM status, then calls `psm_swap_to_usdd` and reports the transaction result. * "Swap 5,000 USDD back to USDC on BSC" -> AI calls `get_psm_status`, then executes `psm_swap_from_usdd` and reminds the user to re-check balances. * "What is my USDD balance on Tron?" -> AI calls `get_protocol_overview` to identify the USDD token address, then calls `get_token_balance`. * "Do I have enough allowance for the USDT PSM?" -> AI calls `check_allowance` with the token and PSM spender, then suggests `approve_token` only if needed. * "What is the current Savings status on Ethereum?" -> AI calls `get_savings_status` and summarizes `chi`, `dsr`, total assets, and wallet shares. * "Deposit 2,000 USDD into sUSDD" -> AI uses `use_savings`: checks savings status, calls `deposit_savings`, then re-checks savings metrics. * "Withdraw 500 USDD from sUSDD on BSC" -> AI calls `get_savings_status`, executes `withdraw_savings`, and confirms the updated share balance.

# AI / LLMs USDD provides machine-readable documentation endpoints optimized for LLMs and AI coding tools. Use these resources to give your AI assistant accurate, up-to-date context about the USDD protocol. ### Available Endpoints
FileDescription
llms.txtCurated index of key pages with one-line descriptions. Start here.
llms-full.txtComplete documentation in plain Markdown, organized by section. Use when your tool supports large context.
> **Note:** Each documentation page is also available as plain Markdown by appending `.md` to any URL. Example: `https://docs.usdd.io/user-guide/psm-peg-stability-module.md` ### Which File Should I Use?
Use CaseRecommended
Quick lookups, scoped questionsllms.txt
Full protocol understanding, complex integrationsllms-full.txt
Single-page deep dive[page-url].md
### Add to Your AI Tool #### Cursor 1. Navigate to **Cursor Settings > Features > Docs** 2. Select **Add new doc** and paste one of the following URLs: ``` https://docs.usdd.io/llms.txt ``` ``` https://docs.usdd.io/llms-full.txt ``` 3. Use `@docs → USDD` to reference the documentation in your chat. #### Claude Code Run in your terminal: ```bash claude --add-docs https://docs.usdd.io/llms.txt ``` Or for full context: ```bash claude --add-docs https://docs.usdd.io/llms-full.txt ``` #### Other Tools Any tool that supports custom documentation URLs can use: ``` https://docs.usdd.io/llms-full.txt ``` Or for a lighter-weight index: ``` https://docs.usdd.io/llms.txt ``` ### Coverage The documentation covers all USDD 2.0 modules across Tron, Ethereum, and BNB Chain: * **PSM** — 1:1 stablecoin swaps (Tron / Ethereum / BNB Chain) * **Vault** — Over-collateralized USDD minting (Tron only) * **Earn / sUSDD** — Yield-bearing savings (Tron / Ethereum / BNB Chain) * **Liquidation & Auction** — Keeper integration and auction mechanics * **Oracle** — Median → OSM → Spot price feed architecture * **Core Contracts** — Vat, Dog, Clip, Jug, PSM module specs * **Deployment Addresses** — All contract addresses across three chains # Overview The governance framework of the USDD ecosystem is designed to be community-driven and decentralized, ensuring inclusivity, transparency, and adaptability. Governance empowers stakeholders to make critical decisions regarding the protocol's future, stability, and growth. # Secure Framework The USDD protocol is designed with a robust security framework to ensure the safety and integrity of user assets and the overall ecosystem. Comprehensive risk assessment processes are employed to identify, mitigate, and monitor potential vulnerabilities. * **Over-Collateralization** * Ensures all minted USDD is backed by digital assets exceeding the value of the stablecoin. * Reduces the risk of insolvency during volatile market conditions. * **Real-Time Monitoring** * Continuous tracking of collateral ratios and system health. * Alerts are triggered for under-collateralized positions or unusual activities. * **Smart Contract Audits** * All smart contracts are thoroughly audited by independent third-party firms. * Ongoing testing ensures contracts are resistant to exploits and vulnerabilities. * **Liquidation Mechanisms** * Automatic liquidation of under-collateralized vaults to protect the protocol from bad debt. * Efficient auction systems to maximize recovery value. * **Peg Stability Module (PSM)** * Enables stable and zero-slippage swaps to maintain the USDD peg, even during market fluctuations. * Reduces systemic risks by balancing supply and demand effectively. * **Decentralized Governance** * Critical protocol changes are subject to community review and approval. * Governance minimizes the risk of unilateral decisions that could compromise security. By maintaining a proactive approach to risk assessment, the USDD protocol ensures its resilience and reliability in a dynamic blockchain environment. # Audits Security is our top priority. USDD's smart contracts have undergone rigorous security audits by leading blockchain security firms to ensure the safety and integrity of the protocol. These audits assess potential vulnerabilities and verify the robustness of our system. #### USDD v2 * Date: January 24, 2025 * Auditor: ChainSecurity * Network: Tron {% file src="" %} #### PSM * Date: January 24, 2025 * Auditor: ChainSecurity * Network: Tron {% file src="" %} #### Exchange * Date: January 24, 2025 * Auditor: ChainSecurity * Network: Tron {% file src="" %} #### USDD - Ethereum * Date: September 2, 2025 * Auditor: CertiK * Network: Ethereum {% file src="" %} #### USDD - Ethereum and BSC * Date: October 24, 2025 * Auditor: ChainSecurity * Network: Ethereum and BSC {% file src="" %} USDD continues to undergo regular security assessments to maintain the highest level of protection for users and assets. # Terms of Use (Last updated at 2025.01.04) Welcome to usdd.io, a website-hosted user interface (the “Interface” or “App”) provided by the USDD Team (“we”, “our”, or “us”). The Interface provides access to decentralized protocols on the blockchain that support the USDD ecosystem and enable users to interact with various functionalities, including deposit, mint, payback, withdraw and manage digital assets. This Terms of Service Agreement (the “Agreement”) explains the terms and conditions by which you may access and use the Interface. By accessing or using the Interface, you signify that you have read, understand, and agree to be bound by this Agreement in its entirety. If you do not agree, you are not authorized to access or use the Interface. *** #### 1. Modification of this Agreement We reserve the right, at our sole discretion, to modify this Agreement at any time. If we make any changes, we will update the "Last Modified" date at the beginning of the Agreement. Your continued use of the Interface after modifications constitutes your acceptance of the revised terms. If you disagree with any changes, you must stop accessing and using the Interface immediately. #### 2. Eligibility To access or use the Interface, you must be able to form a legally binding contract with us. By using the Interface, you represent that you are at least 18 years old and have the legal capacity to agree to this Agreement. You also confirm that your use of the Interface complies with all applicable laws, regulations, and restrictions. You may not use the Interface if: * You are located in, under the control of, or a national or resident of any country or region that is subject to economic sanctions. * Your use of the Interface would violate applicable laws or regulations. * You are a resident or citizen of restricted regions, including but not limited to Mainland China, Taiwan, Hong Kong, the United States, or Singapore. #### 3. Proprietary Rights The USDD Team owns all intellectual property and other rights in the Interface and its contents, including (but not limited to) software, text, images, trademarks, service marks, copyrights, patents, and designs. You are granted a limited, non-exclusive, non-transferable, and revocable license to access and use the Interface solely for its intended purposes. Unauthorized use of the Interface or its contents is strictly prohibited. #### 4. Privacy We value your privacy and strive to protect your personally identifiable information (“PII”). However, by using the Interface, you acknowledge and agree that we may collect, use, and disclose your PII as outlined in our Privacy Policy. While we take reasonable measures to secure your data, we cannot guarantee absolute protection against unauthorized access or misuse. You use the Interface at your own risk. #### 5. Prohibited Activities You agree not to engage in any prohibited activities, including but not limited to: * Intellectual Property Infringement: Violating copyrights, trademarks, or other proprietary rights. * Cyberattacks: Compromising the security or integrity of the Interface, including deploying viruses or conducting denial-of-service attacks. * Fraud: Providing false or misleading information. * Market Manipulation: Engaging in practices like spoofing or wash trading. * Illegal Conduct: Using the Interface to facilitate unlawful activities. #### 6. No Professional Advice The information provided on the Interface is for informational purposes only and should not be considered professional advice. Always consult with a qualified professional before making financial, legal, or other decisions involving the Interface. #### 7. No Warranties The Interface is provided “AS IS” and “AS AVAILABLE.” We disclaim all warranties, express or implied, including but not limited to warranties of merchantability, fitness for a particular purpose, and non-infringement. We do not guarantee that the Interface will be secure, error-free, or available without interruption. #### 8. Assumption of Risk By using the Interface, you acknowledge the inherent risks associated with blockchain technology and digital assets, including but not limited to: * Volatility in asset prices. * Risks of interacting with smart contracts. * Potential loss of assets due to technical errors, cyberattacks, or other unforeseen issues. You assume full responsibility for all risks associated with your use of the Interface. #### 9. Third-Party Resources The Interface may include links to third-party resources or promotions. We do not endorse or assume responsibility for third-party content or activities. Your interactions with third parties are at your own risk. #### 10. Indemnification You agree to indemnify and hold us harmless from any claims, damages, or expenses arising from: * Your use of the Interface. * Your violation of this Agreement or applicable laws. * Third-party actions facilitated by your use of the Interface. #### 11. Limitation of Liability To the maximum extent permitted by law, we are not liable for any direct, indirect, incidental, special, or consequential damages arising from your use of the Interface, including but not limited to loss of data, revenue, or assets. #### 12. Dispute Resolution We strive to resolve disputes amicably. If disputes cannot be resolved informally, they may be settled through arbitration as outlined in applicable laws. *** By accessing and using the Interface, you acknowledge that you have read, understood, and agreed to this Agreement. # Privacy Policy （Last updated at 2025.01.04) Welcome to usdd.io, a website-hosted user interface (the “Interface” or “App”) provided by the USDD Team (“we”, “our”, or “us”). The Interface provides access to decentralized protocols on the blockchain that support the USDD ecosystem and enable users to interact with various functionalities, including deposit, mint, payback, withdraw and manage digital assets. This Privacy Policy explains how we collect, use, and protect your information when you access and use the Interface. By using the Interface, you agree to the terms of this Privacy Policy. If you do not agree, you are not authorized to access or use the Interface. *** #### 1. Preface This Privacy Policy provides our privacy policy regarding the nature, purpose, use, and sharing of personal data or other information collected from the users of usdd.io and other related websites (the "Site"). We are committed to protecting and respecting your privacy. Please read this carefully as this Privacy Policy is legally binding when you use the Site. As used in this Privacy Policy, "we", "us" or "our" refers to the USDD Team, which actively manages the Site and supports the ecosystem. You can reach us with any request relating to this Privacy Policy via contact details provided below. #### 2. Information We Collect We may collect the following types of information: * Personal Information: Information that can identify you, such as wallet address, when you voluntarily provide it. * Usage Data: Information about how you interact with the Interface, including IP addresses, device information, and browsing activity. * Blockchain Data: Public blockchain data associated with your wallet address. We do not collect sensitive personal information, such as government-issued IDs or financial account details. #### 3. Use of Cookies and Similar Technologies The Interface uses cookies and similar technologies to enhance your experience. Cookies are small text files placed on your device that help us understand user behavior, improve our Interface, and analyze trends. Information collected from cookies may include: * Device information * Page views * Button clicks * Errors encountered We work with third-party service providers who may also use cookies or similar technologies to assist us in analyzing user behavior. You can manage your cookie preferences through your browser settings. Disabling cookies may limit certain features of the Interface. #### 4. How We Use Your Information We use the information we collect for the following purposes: * To provide and improve the Interface and its functionalities. * To communicate with you, including responding to your inquiries. * To comply with legal and regulatory requirements. * To prevent fraudulent or malicious activity and ensure the security of the Interface. #### 5. Sharing of Information We do not sell, rent, or share your personal information with third parties for their marketing purposes. However, we may share your information: * With service providers that assist us in operating the Interface. * If required by law or to comply with legal obligations. * To protect our rights, property, and users. * With your explicit consent. \ **6. Your Rights** Depending on your jurisdiction, you may have the right to: * Access, correct, or delete your personal information. * Restrict or object to the processing of your personal information. * Withdraw consent where processing is based on consent. * Lodge a complaint with a data protection authority. #### 7. International Transfers We may transfer your personal information to third parties in different jurisdictions to process data or provide services. These third parties are required to protect your information in accordance with applicable data protection laws. #### 8. Data Security We implement reasonable security measures to protect your information from unauthorized access, use, or disclosure. However, we cannot guarantee absolute security due to the inherent risks of transmitting data over the internet and the decentralized nature of blockchain. #### 9. Third-Party Links and Social Media The Interface may include links to third-party websites or social media plugins (e.g., GitHub, YouTube, Twitter). These third-party services operate under their own privacy policies, and we are not responsible for their practices. Please review their privacy policies before engaging with them. #### 10. Duration of Data Processing We will process your personal data only for the period necessary to achieve the purpose of the processing, or as required by applicable laws. After this period, your personal data will be deleted. #### 11. Changes to This Privacy Policy We reserve the right to modify this Privacy Policy at any time. If we make changes, we will update the "Last Modified" date at the beginning of the policy. Your continued use of the Interface after modifications constitutes acceptance of the revised terms.