Depositing Collateral
Opening Liquidity Positions
Users may deposit any of the accepted collateral types into the protocol by depositing collateral and then delegating it to a pool of their choice. This creates a liquidity position.
This liquidity position will start to assume debt and credit from the markets backed by the pool. Users may also mint and burn snxUSD, increasing and decreasing the debt associated with their liquidity position. Additional collateral may also be assigned to the liquidity position by delegating more collateral of the same type to the same pool.
Retrieve information about the accepted collateral types with the getCollateralConfigurations() function. Users can deposit collateral into their accounts with the deposit() function. Once collateral has been deposited, users can create a liquidity position by delegating their collateral to a pool with the delegateCollateral() function.
Depositing collateral without delegating it only moves the assets into the protocol. Deposit and delegate are typically called together using the Multicall Module.
Closing Liquidity Positions
To close (or reduce) a liquidity position, users must decrease the amount they’ve delegated to a pool. Note that the delegated collateral may only be reduced if the liquidity position’s C-Ratio is greater than the Target C-Ratio. (This is a C-Ratio higher than the minimum, specified per collateral type. The Target C-Ratio of a given collateral type can be retrieved with the getCollateralType function, represented as an integer with 18 decimal places.)
The delegateCollateral() function can be used to decrease the amount of collateral delegated. This will increase the value returned by the getAccountAvailableCollateral() function. This is the maximum amount that can be retrieved from the protocol with the withdrawCollateral() function or delegating again to another pool.
Pools
Pools are specified with an integer ID. See Pools & Vaults for more information.
Stablecoin-only Pool
A pool exists at ID 0 which backs no markets and never will (because it has no owner). Depositing collateral with this pool is similar to using a standard CDP protocol, where the only functionality is minting and burning snxUSD.
Preferred Pool
The Spartan Council specifies a preferred pool with an ID that can be retrieved with the getPreferredPool() function. This is expected to be a pool owned by the Spartan Council and may receive rewards.
Approved Pools
The Spartan Council also specifies approved pools with IDs that can be retrieved with the getApprovedPools() function. This is expected to be a series of pools owned by the Spartan Council with exposure to different combinations of markets.
Custom Pools
Pools may be created by anyone. (See Creating Pools.) You may specify a custom pool’s ID when delegating your collateral.
Any liquidity position delegated to a pool could be indirectly liquidated by the owner of the pool. There is always risk, but be especially cautious when using pools that aren’t approved by the Spartan Council.