https://github.com/morpho-org/morpho-utils
Repository gathering useful libraries and contracts.
https://github.com/morpho-org/morpho-utils
Last synced: about 1 year ago
JSON representation
Repository gathering useful libraries and contracts.
- Host: GitHub
- URL: https://github.com/morpho-org/morpho-utils
- Owner: morpho-org
- License: agpl-3.0
- Created: 2022-07-11T09:50:54.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-08-13T07:04:24.000Z (almost 3 years ago)
- Last Synced: 2025-03-25T00:40:43.792Z (about 1 year ago)
- Language: Solidity
- Homepage:
- Size: 559 KB
- Stars: 64
- Watchers: 10
- Forks: 1
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Morpho Utils
[](https://github.com/morpho-dao/morpho-utils/actions/workflows/foundry-gas-diff.yml)
[](https://github.com/morpho-dao/morpho-utils/actions/workflows/certora.yml)
Repository gathering useful libraries and contracts.
## Getting started
Install this repository as a forge dependency:
```bash
forge install morpho-dao/morpho-utils
```
Then add a remapping to your `remappings.txt`:
```txt
@morpho-utils/=lib/morpho-utils/src/
```
You're good to go! Just import libraries with `@morpho-utils/math/Math.sol` for example.
---
## Known Issues
Please be aware that some [known issues](./ISSUES.md) are inherent to the way some libraries work in this repository.
---
## Development
After cloning this repository, run:
```bash
git submodule update --init --recursive
```
Configure your VSCode to automatically format a file on save, using `forge fmt`:
- Install [emeraldwalk.runonsave](https://marketplace.visualstudio.com/items?itemName=emeraldwalk.RunOnSave)
- Update your `settings.json`:
```json
{
"[solidity]": {
"editor.formatOnSave": false
},
"emeraldwalk.runonsave": {
"commands": [
{
"match": ".sol",
"isAsync": true,
"cmd": "forge fmt ${file}"
}
]
}
}
```
---
## Testing
For testing, run:
```bash
forge test
```
---
## Formal verification
To run the Certora prover, run (with a CERTORAKEY in your environment):
```bash
./certora/scripts/verifyAll.sh
```
---
## External contributors
We thank the MEP team for their help on code optimization:
- [@AtomicAzzaz](https://github.com/AtomicAzzaz)
- [@ewile](https://github.com/wile)
- [@makcandrov](https://github.com/makcandrov)
---
## Acknowledgements
This repository is inspired by several sources:
- [OpenZeppelin](https://github.com/OpenZeppelin/openzeppelin-contracts)
- [Compound](https://github.com/compound-finance/compound-protocol)
- [Aave V2](https://github.com/aave/protocol-v2)
- [Aave V3](https://github.com/aave/aave-v3-core)