USDS 백서

bitpro가 원문에서 글자만 모은 내용이에요. 표·그림·수식은 빠지거나 깨질 수 있어요. 전체 15쪽 중 1쪽

Sky Ecosystem Important Links Section titled “Important Links” GitHub: https://github.com/sky-ecosystem Chainlog: https://chainlog.sky.money/ Portal: https://sky.money/ Voting: https://vote.sky.money/ Info Dashboard: https://info.sky.money Released into the public domain (CC0 1.0 Universal) – trademarks remain with their owners; no warranty. See full license . ## /quick-start/protocol-navigator Protocol Navigator Released into the public domain (CC0 1.0 Universal) – trademarks remain with their owners; no warranty. See full license . ## /quick-start/protocol-token-routes Protocol Token Routes A bi-directional arrow (↔) indicates that tokens can move in both directions. A single directional arrow (→) signifies one-way routes. Each route in this section corresponds to a specific network deployment, denoted by the ‘@’ symbol. USDS ↔ USDC Section titled “USDS ↔ USDC” Routes: LitePSMWrapper-USDS-USDC @ Ethereum DAI ↔ USDS Section titled “DAI ↔ USDS” USDS is linked to the same issuance source as DAI, ensuring that USDS maintains parity with DAI. The converter contract allows holders of DAI or USDS to convert between these ERC20 tokens at any time, with no liquidity restrictions. Routes: DAI USDS Converter @ Ethereum DAI ↔ USDC Section titled “DAI ↔ USDC” DAI to USDC conversions are currently supported by the LitePSM. LitePSM is a newly deployed codebase with a backward-compatible smart contract interface, designed to replace the widely used PSM and reduce gas costs for end-users. For more information about LitePSM, please refer to this user guide . Routes: LitePSM-DAI-USDC @ Ethereum MKR ↔ SKY Section titled “MKR ↔ SKY” The conversion rate between MKR and SKY is fixed at 1:24,000. Routes: MKR SKY Converter @ Ethereum USDS ↔ sUSDS Section titled “USDS ↔ sUSDS” Savings USDS (sUSDS) offers yield to USDS holders through an ERC-4626 vault compatible interface. Please note that sUSDS and sDAI are not exchangeable on a 1:1 basis, as they have different face values, and have accumulated varying amounts of yield since their respective launches. Routes: sUSDS Token and Vault @ Ethereum Released into the public domain (CC0 1.0 Universal) – trademarks remain with their owners; no warranty. See full license . ## /guides/psm/litepsm LitePSM Level: Beginner Estimated Time: 15 minutes Last Updated : 2025-07-15 LitePSMs stabilize the USDS and DAI stablecoins against their pegged value by enabling users to trade USDS or DAI with other stablecoins like USDC (referred to as “gems”) at fixed exchange ratios and fees. LitePSM’s primary goal is to minimize gas costs for users. To achieve this, Sky Ecosystem and its keeper ecosystem will absorb some of the gas expenses for all swaps by performing background bookkeeping tasks. This reduction in total gas costs benefits users swapping between USDS or DAI and USDC, whether directly or through DEX aggregators like CoWSwap, 1inch, or Uniswap. Learning objectives Section titled “Learning objectives” Using the LitePSM Migrate your integration from PSM to LitePSM Pre-requisites Section titled “Pre-requisites” Familiarity with USDS, DAI, and USDC ERC20 tokens. Guide Section titled “Guide” LitePSM Deployments Section titled “LitePSM Deployments” Ethereum Mainnet LitePSMWrapper-USDS-USDC: 0xA188EEC8F81263234dA3622A406892F3D630f98c LitePSM-DAI-USDC: 0xf6e72Db5454dd049d0788e411b06CfAF16853042 Available PSMs Section titled “Available PSMs” LitePSMWrapper-USDS-USDC is designed as a wrapper which routes all USDS to USDC and USDC to USDS swaps to the LitePSM-DAI-USDC by converting USDS to DAI internally. This allows Sky Protocol to share USDC liquidity among both USDS and DAI and avoid fragmentation. LitePSMWrapper-USDS-USDC Usage Section titled “LitePSMWrapper-USDS-USDC Usage” Public All users will have access to the following functions: sellGem : Sell USDC and receive USDS buyGem : Buy USDC with USDS sellGem function accepts two inputs: usr : Address of the USDS recipient gemAmt : Amount of USDC being sold The gemAmt is denominated in 6 decimals because “Gem” refers to USDC in a LitePSMWrapper-USDS-USDC deployment, which uses 6 decimals instead of the more common 18 decimals. After a successful swap, this amount of USDC is transferred from msg.sender to the LitePSMWrapper-USDS-USDC. The function returns a value denominated in 18 decimals, representing the USDS amount the user receives. The usr address then receives the USDS ERC20 balance from the LitePSMWrapper-USDS-USDC. buyGem function accepts two inputs: usr : Address of the USDC recipient gemAmt : Amount of USDC being bought The gemAmt is denominated in 6 decimals because “Gem” refers to USDC in a LitePSMWrapper-USDS-USDC deployment, which uses 6 decimals instead of the more common 18 decimals. After a successful swap, this amount of USDC is transferred to the usr address. The function returns a value denominated in 18 decimals, representing the USDS amount that msg.sender transfers from their address to the LitePSMWrapper-USDS-USDC. The usr address then receives the USDC balance from the LitePSMWrapper-USDS-USDC. LitePSM-DAI-USDC Usage Section titled “LitePSM-DAI-USDC Usage” Public All users will have access to the following functions: sellGem : Sell USDC and receive DAI buyGem : Buy USDC with DAI sellGem function accepts two inputs: usr : Address of the DAI recipient gemAmt : Amount of USDC being sold The gemAmt is denominated in 6 decimals because “Gem” refers to USDC in a LitePSM-DAI-USDC deployment, which uses 6 decimals instead of the more common 18 decimals. After a successful swap, this amount of USDC is transferred from msg.sender to the LitePSM-DAI-USDC. The function returns a value denominated in 18 decimals, representing the DAI amount the user receives. The usr address then receives the DAI ERC20 balance from the LitePSM-DAI-USDC. buyGem function accepts two inputs: usr : Address of the USDC recipient gemAmt : Amount of USDC being bought The gemAmt is denominated in 6 decimals because “Gem” refers to USDC in a LitePSM-DAI-USDC deployment, which uses 6 decimals instead of the more common 18 decimals. After a successful swap, this amount of USDC is transferred to the usr address. The function returns a value denominated in 18 decimals, representing the DAI amount that msg.sender transfers from their address to the LitePSM-DAI-USDC. The usr address then receives the USDC balance from the LitePSM-DAI-USDC. Authorized Users Authorized users have access to two additional functions: sellGemNoFee and buyGemNoFee , which allow them to execute swaps without paying additional PSM fees. Authorized users will still need to pay the gas fees for their transactions. Governance must add an authorized user to an access list on the LitePSM-DAI-USDC to allow them access to these additional functions. sellGemNoFee and buyGemNoFee accept the same inputs and return the same values as sellGem and buyGem , respectively. Maximum Swap Size All users, both public and authorized, can only swap up to the DAI and USDC balances held by LitePSM-DAI-USDC. DAI balance is held by LitePSM-DAI-USDC in its own contract address. USDC balance is held in a separate Pocket contract whose address can be read from litepsm.pocket() . Please note that other LitePSM-DAI-USDC swap transactions included in a block could affect the available DAI and USDC amounts. The USDC balance held by LitePSM-DAI-USDC is determined by external usage and periodic liquidity management by Sky Ecosystem actors. The DAI balance held by LitePSM-DAI-USDC is determined by internal protocol bookkeeping activities. The maximum DAI balance held by LitePSM-DAI-USDC at any time is dictated by the buf value set by Sky Ecosystem governance. Sky Ecosystem keepers periodically execute a set of public functions: fill , trim , and chug to keep the DAI balance of the LitePSM-DAI-USDC in line with the buf parameter. These functions are not restricted, and any address can execute them. The Maximum Swap Size limit restricts a single sellGem transaction. As integrators, you can handle swaps beyond this limit by constructing an atomic batch of transactions. This batch can interleave any number of psm.sellGem() transactions to swap up to the currently available DAI balance with psm.fill() transactions to refill the DAI balance in the LitePSM. This approach allows you to complete a large USDC to DAI swap transaction atomically for your users. Fees Section titled “Fees” Public The tin fee is assessed on all sellGem transactions, and the tout fee is assessed on all buyGem transactions. Both tin and tout values are set by Sky Ecosystem governance. Governance can set either tin or tout to the value of type(uint256).max , halting sellGem and buyGem transactions respectively on the LitePSM. Transactions would be halted for both public and authorized users. Fees are represented as fixed decimal-point numbers with 18 decimals. Fee values will always be equal to or less than a WAD , which is (10^{ 18 }). Some examples are: A tin value of 1, represented as a WAD, would assess a 100% fee on a sellGem transaction. This should never happen in practice. A tin value of 0.01, represented as WAD/100, would assess a fee of 1% (100 basis points) on a sellGem transaction. A tout value of 0.001, represented as WAD/10000, would assess a fee of 0.01% (^1 basis point) on a buyGem transaction. Authorized Users Authorized users are not assessed the tin and tout fees when they execute the sellGemNoFee and buyGemNoFee functions. However, they will be assessed fees like public users when they execute the regular sellGem and buyGem functions instead of the NoFee variants. Authorized users can check their authorization status with the bud() function. The bud function accepts the address of the authorized user. It returns a value of 1 when the address is authorized to execute both sellGemNoFee and buyGemNoFee , and a value of 0 when the address is not authorized to execute these functions. Gas Costs Section titled “Gas Costs” Transaction Type Gas Limit BuyGem (DAI to USDC) - LitePSM (Public User) 78,867 BuyGem (DAI to USDC) - LitePSM (Authorized User) _ SellGem (USDC to DAI) - LitePSM (Public User) 93,742 SellGem (USDC to DAI) - LitePSM (Authorized User) _ Stats Section titled “Stats” Please refer to LitePSM Dashboard for current LitePSM-DAI-USDC stats after launch. Troubleshooting Section titled “Troubleshooting” Potential Issues Section titled “Potential Issues” Swaps will fail if the LitePSM has zero DAI balance. Swaps will fail if other transactions have consumed the DAI balance of the LitePSM in the same block before your transaction. LitePSM offers no slippage protection, and fees could change within the same block if a pending governance action goes live in a transaction before yours. Refill Dai Buffer Section titled “Refill Dai Buffer” Steps to refill the DAI Balance of LitePSM-DAI-USDC: Call the rush function to check whether the DAI balance of LitePSM-DAI-USDC can be increased. If rush returns a value greater than zero, you can execute fill to increase the DAI balance of LitePSM-DAI-USDC up to the limit set by the buf parameter. LitePSM Halt Status Section titled “LitePSM Halt Status” You can check whether sellGem and sellGemNoFee are halted by verifying if the tin value is set to uint.max . You can check whether buyGem and buyGemNoFee are halted by verifying if the tout value is set to uint.max . Next steps Section titled “Next steps” N/A Resources Section titled “Resources” LitePSMWrapper Codebase LitePSM Codebase LitePSM Technical Docs and Architecture Released into the public domain (CC0 1.0 Universal) – trademarks remain with their owners; no warranty. See full license . ## /guides/skylink/usds-ethereum-solana-bridge USDS Ethereum–Solana Bridge The current USDS Ethereum–Solana bridge will be down on Nov 17 starting at 14:00 UTC (2 PM GMT, 9 AM EST, 6 AM PST, 10 PM CST/GMT+8) for a scheduled migration for approx. 31 hours, until approx. Nov 18 21:00 UTC. Downtime could be extended depending on the number of pending bridge transfers. Users holding USDS on Solana or Ethereum who are not using the bridge are not affected; they need not take any action before, during, or after the downtime. Key Points Section titled “Key Points” Sky Ecosystem is performing a planned migration of its USDS Ethereum–Solana bridge. The migration is managed by Sky Ecosystem Governance and is scheduled to start on or around Nov 17 at 14:00 UTC (09:00 EST), with an expected downtime of approx. 31 hours, until the migration is complete and the new LayerZero bridge is fully activated. During this downtime, all USDS bridge transfers between Ethereum and Solana will be paused. Any pending transfers on the current Wormhole bridge will be finalized during the downtime and will not be cancelled. Bridge contract addresses and the functions you currently use to bridge USDS will change after the new bridge infrastructure goes live. The USDS token address on Solana (and on Ethereum) will remain the same. All USDS balances on Solana will continue to function during the downtime and can be used with the new bridge once the migration is complete. USDS balances held by the Wormhole bridge on Ethereum will be migrated to LayerZero infrastructure as part of this migration. USDS on Solana will continue to be backed 1:1 by USDS on Ethereum in the new bridge infrastructure. Important Addresses Section titled “Important Addresses” Tokens Section titled “Tokens” Not affected by downtime and token transfers will work normally. USDS Token on Ethereum: 0xdC035D45d973E3EC169d2276DDab16f1e407384F USDS Token on Solana: USDSwr9ApdHk5bvJKMjzff41FfuX8bSxdKcR81vTwcA Current Bridge (Wormhole, pre-migration) Section titled “Current Bridge (Wormhole, pre-migration)” Deactivated pre-migration. Only pending bridge transfers can be completed during downtime. Sky Wormhole Bridge (NTT Manager) on Ethereum: 0x7d4958454a3f520bDA8be764d06591B054B0bf33 Sky Wormhole Bridge (NTT Manager) on Solana: STTUVCMPuNbk21y1J6nqEGXSQ8HKvFmFBKnCvKHTrWn New Bridge (LayerZero, post-migration) Section titled “New Bridge (LayerZero, post-migration)” Activated post-migration. Not available during downtime. Sky LayerZero Bridge (OFT Adapter) on Ethereum: 0x1e1D42781FC170EF9da004Fb735f56F0276d01B8 Sky LayerZero Bridge (OFT Program) on Solana: SKYTAiJRkgexqQqFoqhXdCANyfziwrVrzjhBaCzdbKW Migration Timeline Section titled “Migration Timeline” Starting Thu Nov 13 Section titled “Starting Thu Nov 13” First governance spell is introduced to Sky Ecosystem Governance and voting begins. Wormhole bridge is active for all USDS bridge transfers. After 3 Days Section titled “After 3 Days” First spell governance security delay of 24 hours before the governance spell can be executed. Office hours alignment: execution after the governance security delay can only occur Mon–Fri between 14:00 UTC (09:00 EST) and 21:00 UTC (16:00 EST). Mon Nov 17 @ 14:00 UTC (09:00 EST) Section titled “Mon Nov 17 @ 14:00 UTC (09:00 EST)” First spell executed. Downtime begins. Wormhole bridge is deactivated for initiating new USDS bridge transfers. Wormhole bridge continues to be active to process all pending USDS bridge transfers that were initiated before downtime began. We strongly advise against doing this, but the USDS LayerZero bridge can be used to initiate new transfers from this point onward. These USDS LayerZero bridge transfers cannot be finalized on the destination chain or completed until the new LayerZero bridge infrastructure is fully activated by Governance. Approx. 3 to 7 hours after spell execution Section titled “Approx. 3 to 7 hours after spell execution” Technical checks are completed by various teams. All previously initiated (before downtime began) and pending bridge transfers on the USDS Wormhole bridge can be finalized by users. Downtime could extend beyond 7 hours if there are pending USDS Wormhole bridge transfers that have not been finalized. Approx. on Mon Nov 17 @ 21:00 UTC (16:00 EST) Section titled “Approx. on Mon Nov 17 @ 21:00 UTC (16:00 EST)” This timing is provided as approximate reference: It could be earlier if the pending bridge transfer queue is finalized early, but it could be later as well. Second governance spell is introduced to Sky Ecosystem Governance and voting begins. All USDS Wormhole pending bridge transfers would have been completed at this point with nothing pending. After 24 hours Section titled “After 24 hours” Second spell governance security delay of 24 hours before the governance spell can be executed. Approx. Tue Nov 18 @ 21:00 UTC (16:00 EST) Section titled “Approx. Tue Nov 18 @ 21:00 UTC (16:00 EST)” Second governance spell executed. Downtime ends. Downtime may end early if the technical checks are complete and the pending bridge transfer queue is finalized earlier. If checks complete early, the new USDS LayerZero bridge will be fully activated as early as Tue Nov 18 17:00 UTC (12:00 EST) — approx. 27 hours downtime. If checks are delayed up to 7 hours, the USDS LayerZero bridge will be fully activated on Tue Nov 18 @ 21:00 UTC (16:00 EST) — approx. 31 hours downtime. If checks are delayed beyond approx. 7 hours, due to office hours alignment on execution, the USDS LayerZero bridge will be fully activated on Wed Nov 19 @ 14:00 UTC — approx. 48 hours downtime. If unforeseen issues occur, downtime can extend beyond 48 hours. USDS Wormhole bridge is fully deprecated. USDS LayerZero bridge is fully activated and available for USDS bridge transfers. FAQs Section titled “FAQs” What happens if you initiate new bridge transfers on the Wormhole bridge after it is deprecated (when downtime begins)? All new bridge transfers initiated on Wormhole during the downtime or after will fail, and USDS will not be debited from your wallet or account. What happens to your pending USDS bridge transfers through Wormhole after it gets deprecated and downtime begins? You can continue to complete your pending bridge transfers (those initiated before the downtime began) normally during the downtime on both Ethereum and Solana, depending on the destination. Will the Wormhole bridge be re-enabled during or after the downtime? Once the downtime begins and Wormhole is deprecated, the Wormhole bridge will not be re-enabled. Prepare to start using the new LayerZero bridge infrastructure for USDS after the downtime ends. When can the new LayerZero bridge be used for USDS bridge transfers? Please wait until the downtime ends and an announcement is made before using the new LayerZero bridge infrastructure for USDS. Note that initiating USDS transfers using LayerZero during the downtime will be possible, but those transfers will remain pending and cannot be finalized on the destination chain until the new bridge infrastructure is fully activated. Will sUSDS be available on the new bridge? No. sUSDS will be available at a later time; initially, only USDS will be supported on the new bridge. Using the USDS LayerZero Bridge after activation Section titled “Using the USDS LayerZero Bridge after activation” Ethereum (Mainnet) — OFT Adapter (USDS): 0x1e1D42781FC170EF9da004Fb735f56F0276d01B8 The adapter wraps the existing ERC-20 USDS on Ethereum to participate in OFT transfers. It expects an allowance to pull USDS when you send from Ethereum. Solana (Mainnet) — OFT Program (USDS side): SKYTAiJRkgexqQqFoqhXdCANyfziwrVrzjhBaCzdbKW This is the Solana OFT program (OApp) that mints/burns the Solana representation of USDS on messages from/to Ethereum. Endpoint IDs (EIDs) used by this deployment: Ethereum Mainnet EID: 30101 Solana Mainnet EID: 30168 Use EIDs in all quote / send calls and peer wiring. Do not use EV
프로젝트로 돌아가기