LogoLogo
  • Inter Protocol User & System Docs
  • User How-to
    • Wallet Usage
      • Acquiring BLD Tokens
        • How to Deposit Assets to Osmosis
        • How to swap for BLD tokens from Osmosis and transfer to Agoric
        • How to swap for BLD on Crescent
        • Buying BLD from Huobi
      • Create your Agoric Account and Smart Wallet
      • Keplr Overview
    • Bridge External Tokens to Agoric
      • Bridge DAI, USDC or USDT to Agoric via Axelar Bridge
      • Bridge DAI, USDC or USDT to Agoric via Gravity Bridge
    • Minting IST
      • Minting IST - Vaults
        • Create a Vault
        • Adjust Vault
        • Close Vault
        • Depositing Assets to Agoric Chain (to use as Vaults collateral)
      • Minting IST - PSM
    • Bidding for Liquidated Collateral
    • IST Usage and Beyond
      • Deposit IST to Osmosis
      • Deposit IST to Crescent
      • Earn BLD by adding liquidity to IST/OSMO pool on Osmosis
      • Earn BLD + CRE rewards by adding liquidity to IST pools on Crescent
    • Supported Browsers
  • Inter Protocol System Documentation
    • Inter Protocol System Overview
    • Protocol & Chain Governance
    • Vaults
    • Liquidation
    • Liquidation Auction
    • Parity Stability Module
      • Supported Assets
    • BLD - Agoric's Governance Token
    • Fees
  • Frequently Asked Questions (FAQ)
  • DISCLAIMER
Powered by GitBook
On this page
  1. Inter Protocol System Documentation

Liquidation Auction

PreviousLiquidationNextParity Stability Module

Last updated 1 year ago

The auction code covers the execution of the collateral liquidation auction itself. See

The system employs a descending clock auction which starts at or above the current oracle price (as opposed to the locked price which triggers liquidation), and steps down in price filling bids as it goes. Its operation is based on a number of tunable parameters. Below is an example scenario demonstrating how the auction functions:

Assume the market price for collateral at the start of the auction is $10.

The auction’s first price step is set at $10.50, based on a 105% setting for its starting rate parameter

  • During this step, the auction fills any bids at or above $10.50 at its step price of $10.50, ordered by time the bid was received. “Bids by discount” are translated to priced bids based on the starting price of $10.00 and considered in this step

  • This step lasts for 180 seconds, based on the auction’s ClockStep parameter setting

The auction’s second step is set at a price of $10.00, based on its DiscountStep parameter setting of 5% (i.e., 5% of the starting price is $0.50)

  • During this step, the auction fills any bids at or above $10.00 at its step price of $10.00, ordered by time the bid was received. “Bids by discount” are translated to priced bids based on the starting price of $10.00 and considered in this step

  • This step lasts for 180 seconds, based on the auction’s ClockStep parameter setting

The auction proceeds by stepping down in the above manner. If it hasn’t reached its IST target amount or sold all its collateral, it continues stepping down until it completes its step at $6.50, based on its LowestRate parameter setting of 65%.

Most auctions will complete without reaching their final step. Bids that enter during the auction will be considered at any step where they are at or above the step price, however bids are filled in order of arrival.

The parameters governing the function of the auction may be set at launch. As written, the contracts grant the Economic Committee a temporary capacity to handle these parameters as the protocol stabilizes. Auction operational tuning is not part of the Economic Committee’s charter, and so an important topic of discussion may be how the community expects this capability to be used.

https://github.com/Agoric/agoric-sdk/tree/master/packages/inter-protocol/src/auction