PriceFeed Store
The PriceFeed Store (PFS) is a marketplace that links tokens with their approved price feeds, serving as the canonical registry that market curators draw from when configuring markets.
Purpose
Price feeds are critical infrastructure — a malicious or misconfigured feed can directly threaten user funds. The PFS exists to provide a vetted catalog of token-to-feed mappings, reducing the risk of both intentional attacks and accidental misconfiguration.
| Goal | How PFS Achieves It |
|---|---|
| Prevent malicious feeds | Only Instance Owners can add or update feed entries |
| Mitigate misconfiguration | Curators select from pre-approved options rather than supplying arbitrary addresses |
| Maintain neutrality | Instance Owners must remain impartial regarding price feed brands |
How It Works
Market curators do not interact with the PFS directly at runtime. Instead, they select assets and feeds from the PFS when composing a market configuration transaction. Once that transaction executes, the market's oracle references are set independently of the PFS.
Key Properties
- Snapshot, not live link — after a market configurator transaction executes, the market no longer relies on the PFS. Removing an asset or feed from the PFS will not affect any existing market.
- Instance Owner controlled — only the Instance Owner multisig can add, update, or remove entries. The DAO cannot modify PFS contents directly.
- Approval, not endorsement — Instance Owners approve feeds as valid (not malicious), but are not responsible for the correctness of the underlying price data.
Management
| Action | Who Can Perform It |
|---|---|
| Add a token/feed mapping | Instance Owner |
| Update an existing mapping | Instance Owner |
| Remove a mapping | Instance Owner |
| Use an approved feed in a market | Market Curator |
Fixed Address
The PFS has a deterministic, fixed address on every chain where Gearbox is deployed. The current registry of instances and their addresses is available at:
https://permissionless.gearbox.foundation/instances
Learn More
- Roles & Permissions — Full breakdown of Instance Owner authority and other governance roles
- Omni-EVM & Instances — How per-chain instances operate independently
- Treasury & Insurance — Fee collection and distribution mechanics