https://github.com/makerdao/dss-test

https://github.com/makerdao/dss-test

Last synced: 3 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/makerdao/dss-test
• Owner: makerdao
• License: agpl-3.0
• Created: 2022-01-11T20:16:57.000Z (over 2 years ago)
• Default Branch: master
• Last Pushed: 2024-01-17T14:42:40.000Z (5 months ago)
• Last Synced: 2024-01-22T06:43:40.907Z (5 months ago)
• Language: Solidity
• Size: 96.7 KB
• Stars: 4
• Watchers: 7
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-smart-contract-development - DssTest

README

        
# dss-test

Modern test framework for Maker repositories to get up and running with MCD faster. Extends `forge-std`.

## Getting Started

First do `forge install makerdao/dss-test` (or dapp equivalent) in your newly setup repository.

Look at `src/tests/IntegrationTest.t.sol` for a bunch of examples.

There is a special `GodMode` library which provides useful functions such as giving `auth` access to an arbitrary contract or setting token balances to any amount.

### MCD

A `DssInstance` is mostly just for keeping a bundle of references to all the common mcd contracts. If you are doing integration testing this can be loaded from the chainlog automatically with `MCD.loadFromChainlog()`. `MCD` also provides some high level functions:

 * `initIlk(...)` - This will deploy a new ilk to the `DssInstance` along with standard liquidation and oracle components.

### MCDUser

`MCDUser` instances can be used to interact with `MCD`. They represent the end users and can perform any number of actions. Usually what you will want to do is inherit this contract and extend the functionality to whatever library you are building. `MCDUser` provides some high level functions:

 * `createAuction(address join, uint256 amount)` - Kicks off a new auction for the specified `join` adapter for the `amount` of collateral specified.