Skip to content

Oval smart contracts, enabling protocols to auction off their OEV and receive a kickback.

License

Notifications You must be signed in to change notification settings

UMAprotocol/oval-contracts

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Jun 18, 2024
56b4279 · Jun 18, 2024

History

21 Commits
May 20, 2024
May 20, 2024
Jun 17, 2024
Jun 18, 2024
Jun 18, 2024
May 20, 2024
May 20, 2024
Jan 23, 2024
May 10, 2024
Dec 12, 2023
May 20, 2024

Repository files navigation

Oval Contracts

UMA Logo

Oval is an MEV capture mechanism that lets protocols reclaim Oracle Extractable Value(OEV) by auctioning oracle updates. It leveraged Flashbot's MEV-share OFA system by running auctions for the right to backrun an oracle update.

For more information on how Oval works and how to integrate with it see the docs.

Repo contents

This repository contains the main smart contracts for Oval. It uses Foundry. For spesific information on contracts, see the Contract Architecture section of the docs.

This repo also consists of a set of scripts used to profile the Oval gas usage. See README that shows how to run these and this docs page that outlines the gas profiling finding.

Installing Foundry

Tests in this repo work up to Nightly (2024-03-02) Foundry version, so make sure to use it when installing:

foundryup -v nightly-de33b6af53005037b463318d2628b5cfcaf39916

Building Contracts

forge build

Running tests

This repository uses foundry fork tests. You will need to run the fork tests as follows:

export RPC_MAINNET=[your ethereum mainnet archive node url]
forge test

License

All code in this repository is licensed under BUSL-1.1 unless specified differently in the file. Individual exceptions to this license can be made by Risk Labs, which holds the rights to this software and design. If you are interested in using the code or designs in a derivative work, feel free to reach out to licensing@risklabs.foundation.