bd2d665c4e
- Fix serde optional dependency issues by adding dep:serde to serde features (24 crates) - Run zepter to propagate runtime-benchmarks, std, try-runtime, serde, experimental, with-tracing, tuples-96 features - Regenerate umbrella crate with proper feature propagation - Format all TOML files with taplo This resolves check-umbrella and check-zepter CI failures.
pezpallet-oracle
Overview
The Oracle pezpallet provides a decentralized and trustworthy way to bring external, off-chain data onto the blockchain. It allows a configurable set of oracle operators to feed data, such as prices, into the system. This data can then be used by other pallets.
The pezpallet is designed to be flexible and can be configured to use different data sources and aggregation strategies.
Key Concepts
- Oracle Operators: A set of trusted accounts that are authorized to submit data to the oracle. The pezpallet
uses the
frame_support::traits::SortedMemberstrait to manage the set of operators. This allows using pallets likepezpallet-membershipto manage the oracle members. - Data Feeds: Operators feed data as key-value pairs. The
OracleKeyis used to identify the data being fed (e.g., a specific currency pair), and theOracleValueis the data itself (e.g., the price). - Data Aggregation: The pezpallet can be configured with a
CombineDataimplementation to aggregate the raw values submitted by individual operators into a single, trusted value. A default implementationDefaultCombineDatais provided, which takes the median of the values. - Timestamped Data: All data submitted to the oracle is timestamped, allowing consumers of the data to know how fresh it is.
Interface
Dispatchable Functions
feed_values- Allows an authorized oracle operator to submit a set of key-value data points.
Public Functions
get- Returns the aggregated and timestamped value for a given key.get_all_values- Returns all aggregated and timestamped values.read_raw_values- Returns the raw, un-aggregated values for a given key from all oracle operators.
Data Providers
The pezpallet implements the DataProvider and DataProviderExtended traits, allowing other pallets to easily
consume the oracle data.
Usage
To use the oracle pezpallet, you need to:
- Add it to your runtime's
Cargo.toml. - Implement the
Configtrait for the pezpallet in your runtime. This includes specifying:OnNewData: A hook to perform actions when new data is received.CombineData: The data aggregation strategy.Time: The time provider.OracleKey,OracleValue: The types for the data key and value.RootOperatorAccountId: An account with sudo-like permissions for the oracle.Members: The source of oracle operators.
- Add the pezpallet to your runtime's
construct_runtime!macro.
Once configured, authorized operators can call feed_values to submit data, and other pallets can use the
DataProvider trait to read the aggregated data.
License: Apache-2.0