Smart contracts used within the Defi.Money protocol.
Core protocol based on Curve Finance's crvUSD.
contracts/base/: Shared libraries and abstract bases, and the core protocol ownership logic.contracts/bridge/: Contracts related to cross-chain functionality (powered by LayerZero).contracts/cdp/: Core protocol functionality, based on Curve Finance's crvUSD.contracts/periphery/: Periphery contracts such as hooks, zaps and combined views.contracts/testing/: Contracts used for unit testing. Not a part of the protocol.
deployments/config: Configuration files for deploying to different networks.deployments/logs: Log files containing addresses of completed deployments.
scripts/deploy/local.py: Script for deploying on a local hardhat network.scripts/deploy/mainnet.py: Script for deploying to a production network (or forked environment).
tests/brownie: Brownie test suite.tests/titanoboa: Titanoboa test suite.
- python version 3.10 or later,
python3-venv,python3-dev - npm version 7 or later
-
Install the node.js dependencies ( Hardhat and LayerZero contracts ). This should be done in the
dfm-contractsroot directory.npm install
-
Within the
dfm-contractsroot directory, create avenvand install the python dependencies:python3 -m venv venv source venv/bin/activate pip install -r requirements.txt -
Initialize the virtual environment to interact with the project. This must be done at the start of each new terminal session.
source venv/bin/activate
To run scripts/deploy/local.py and deploy all contracts on a local hardhat network:
brownie run deploy/local -iThe brownie console will open once deployment has finished. The hardhat session will persist as long as brownie remains open.
Mainnet deployment configurations are handled by YAML files within deployments/config. Common settings are first loaded from default.yaml, and then network-specific settings are loaded over top. Each network's configuration filename is the same as it's brownie network name, e.g. for Fantom the filename would be ftm-main.yaml.
Before the actual deployment it is recommended to do a test run on a forked mainnet. If you deploy to a network ending in -fork, the related mainnet deploy config is used.
To run scripts/deploy/mainnet.py:
brownie run deploy/mainnet --network [network name] -iThe brownie console will open once deployment has finished.
Addresses of the core smart contracts will be written to a YAML file within deployments/logs. If this is the final deployment, remember to commit this log file to git.
Note that the script does not verify source codes with Etherscan (API source verification is not supported for Vyper). You must manually verify once deployment is finished.
Unit testing is done with a mix of brownie and titanoboa.
To run the brownie tests:
brownie testTo run the titanoboa tests:
pytest tests/titanoboaNote that brownie and titanoboa do not play nicely together - attempting to run all tests at once will result in unexpected failures.
Components of this codebase have undergone multiple audits by different firms. Audit reports are published on our Github audit repo as they are completed.
contracts/cdp/: audited by ChainSecurity, June 2024 - view reportcontracts/cdp/: audited by MixBytes, June 2024 - view reportcontracts/cdp/oracles/ChainlinkEMA.sol: audited by Bail Security, June 2024 - view reportcontracts/fees/: audited by Bail Security, September 2024 - view reportcontracts/periphery/zaps/FlashLoanZap.sol: audited by Bail Security, July 2024 - view report
Unless otherwise noted, code in this repository is copyrighted (c) by Curve.Fi, 2020-2024 - All rights reserved. Used by Defi.Money with permission.