Oracle
The Oracle Contract exposes an interface for accessing the latest reported price for mAssets. Price quotes are kept up-to-date by oracle feeders that are tasked with periodically fetching exchange rates from reputable sources and reporting them to the Oracle contract.
Prices are only considered valid for 60 seconds. If no new prices are published after the data has expired, Mirror will disable CDP operations (mint, burn, deposit, withdraw) until the price feed resumes.
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]pub struct InitMsg {pub owner: HumanAddr,pub base_asset: String,}
Key | Type | Description |
| HumanAddr | Address of the owner who can register new assets |
| String | Asset in which prices will be denominated (default TerraUSD) |
This function can only be issued by the active owner of the Oracle contract.
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]#[serde(rename_all = "snake_case")]pub enum HandleMsg {UpdateConfig {owner: Option<HumanAddr>,}}
{"update_config": {"owner": "terra1..."}}
Key | Type | Description |
| HumanAddr | Address of new owner |
* = optional
Registers a new asset with the oracle, enabling a price feed for the asset. The feeder account responsible for reporting the price is assigned at this step. Can also be used to update an existing asset.
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]#[serde(rename_all = "snake_case")]pub enum HandleMsg {RegisterAsset {asset_token: HumanAddr,feeder: HumanAddr,}}
{"register_asset": {"asset_token": "terra1...","feeder": "terra1..."}}
Key | Type | Description |
| HumanAddr | Contract address of asset token |
| HumanAddr | Address of Oracle Feeder for the asset |
Publish a price for one or multiple assets. Caller should be the designated oracle feeder for each of the assets for which price information is provided.
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]#[serde(rename_all = "snake_case")]pub enum HandleMsg {FeedPrice {prices: Vec<(HumanAddr, Decimal)>,}}
{"feed_price": {"prices": [["terra1...", "123.456789"],["terra1...", "123.456789"]]}}
Key | Type | Description |
| Vec<(HumanAddr, Decimal)> | Price information for assets |
Get the Mirror Oracle contract configuration.
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]#[serde(rename_all = "snake_case")]pub enum QueryMsg {Config {}}
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]pub struct ConfigResponse {pub owner: HumanAddr,pub base_asset: String,}
Key | Type | Description |
| HumanAddr | Owner address |
| String/ | Asset in which prices will be denominated (default TerraUSD) |
Get asset token details, such as designated oracle feeder.
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]#[serde(rename_all = "snake_case")]pub enum QueryMsg {Feeder {asset_token: HumanAddr,}}
Key | Type | Description |
| HumanAddr | Contract address of asset token to query |
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]pub struct FeederResponse {pub asset_token: HumanAddr,pub feeder: HumanAddr,}
Key | Type | Description |
| HumanAddr | Contract address of asset token to query |
| HumanAddr | Terra address of price feeder |
{"asset": {"asset_token": "terra1..."}}
Key | Type | Description |
| HumanAddr | Contract address of asset token to query |
{"feeder_response": {"asset_token": "terra1...","feeder": "terra1..."}}
Key | Type | Description |
| HumanAddr | Contract address of asset token to query |
| HumanAddr | Terra address of price feeder |
Get price information for the specified mAsset.
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]#[serde(rename_all = "snake_case")]pub enum QueryMsg {Price {base_asset: String,quote_asset: String}}
Key | Type | Description |
| HumanAddr | Asset for which to get price |
| HumanAddr / | Asset in which price will be denominated |
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]pub struct PriceResponse {pub rate: Decimal,pub last_updated_base: u64,pub last_updated_quote: u64,}
Key | Type | Description |
| HumanAddr | Asset for which to get price |
| u64 | Block height which the |
| u64 | Block height which the |
{"price": {"base_asset": "terra1...","quote_asset": "uusd"}}
Key | Type | Description |
| HumanAddr | Asset for which to get price |
| HumanAddr / | Asset in which price will be denominated |
{"price_response": {"rate": "123.456789","last_updated_base": 10"last_updated_quote": 10}}
Key | Type | Description |
| HumanAddr | Asset for which to get price |
| u64 | Block height which the |
| u64 | Block height which the |
Get price information for all registered mAssets.
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]#[serde(rename_all = "snake_case")]pub enum QueryMsg {Prices {start_after: Option<HumanAddr>,limit: Option<u32>}}
Key | Type | Description |
| HumanAddr | Contract address to start query from |
| u32 | Max number of results to report |
#[derive(Serialize, Deserialize, Clone, Debug, PartialEq, JsonSchema)]pub struct PricesResponseElem {pub asset_token: HumanAddr,pub price: Decimal,pub last_updated_time: u64,}
Key | Type | Description |
| HumanAddr | Contract address to start query from |
| Decimal | Current price of the |
| u64 | Block height which the |
{"prices": {"start_after": "terra1...","limit": 8}}
Key | Type | Description |
| HumanAddr | Contract address to start query from |
| u32 | Max number of results to report |
{"prices_response": {"asset_token": "terra1...","price": "123.456789","last_updated_time": 10,}...}
Key | Type | Description |
| HumanAddr | Contract address to start query from |
| Decimal | Current price of the |
| u64 | Block height which the |
