Test using, forge test --mp test/<challenge-name>/<ChallengeName>.t.sol
Lazy? Okay, wait..!!,
- Unstoppable:
forge test --mp test/unstoppable/Unstoppable.t.sol
- Naive receiver:
forge test --mp test/naive-receiver/NaiveReceiver.t.sol
- Truster:
forge test --mp test/truster/Truster.t.sol
- Side Entrance:
forge test --mp test/side-entrance/SideEntrance.t.sol
- The Rewarder:
forge test --mp test/the-rewarder/TheRewarder.t.sol
- Selfie:
forge test --mp test/selfie/Selfie.t.sol
- Compromised:
forge test --mp test/compromised/Compromised.t.sol
- Puppet:
forge test --mp test/puppet/Puppet.t.sol
- Puppet V2:
forge test --mp test/puppet-v2/PuppetV2.t.sol
- Free Rider:
forge test --mp test/free-rider/FreeRider.t.sol
- Backdoor:
forge test --mp test/backdoor/Backdoor.t.sol
- Climber:
forge test --mp test/climber/Climber.t.sol
- Wallet Mining:
forge test --mp test/wallet-mining/WalletMining.t.sol
- Puppet V3:
forge test --mp test/puppet-v3/PuppetV3.t.sol
- ABI Smuggling:
forge test --mp test/abi-smuggling/ABISmuggling.t.sol
- Shards:
forge test --mp test/shards/Shards.t.sol
- Curvy Puppet:
forge test --mp test/curvy-puppet/CurvyPuppet.t.sol
- Withdrawal:
forge test --mp test/withdrawal/Withdrawal.t.sol
Damn Vulnerable DeFi is the smart contract security playground for developers, security researchers and educators.
Perhaps the most sophisticated vulnerable set of Solidity smart contracts ever witnessed, it features flashloans, price oracles, governance, NFTs, DEXs, lending pools, smart contract wallets, timelocks, vaults, meta-transactions, token distributions, upgradeability and more.
Use Damn Vulnerable DeFi to:
- Sharpen your auditing and bug-hunting skills.
- Learn how to detect, test and fix flaws in realistic scenarios to become a security-minded developer.
- Benchmark smart contract security tooling.
- Create educational content on smart contract security with articles, tutorials, talks, courses, workshops, trainings, CTFs, etc.
- Clone the repository.
- Checkout the latest release (for example,
git checkout v4.0.0
) - Rename the
.env.sample
file to.env
and add a valid RPC URL. This is only needed for the challenges that fork mainnet state. - Either install Foundry, or use the provided devcontainer (In VSCode, open the repository as a devcontainer with the command "Devcontainer: Open Folder in Container...")
- Run
forge build
to initialize the project.
Each challenge is made up of:
- A prompt located in
src/<challenge-name>/README.md
. - A set of contracts located in
src/<challenge-name>/
. - A Foundry test located in
test/<challenge-name>/<ChallengeName>.t.sol
.
To solve a challenge:
- Read the challenge's prompt.
- Uncover the flaw(s) in the challenge's smart contracts.
- Code your solution in the corresponding test file.
- Try your solution with
forge test --mp test/<challenge-name>/<ChallengeName>.t.sol
. If the test passes, you've solved the challenge!
Challenges may have more than one possible solution.
- You must always use the
player
account. - You must not modify the challenges' initial nor final conditions.
- You can code and deploy your own smart contracts.
- You can use Foundry's cheatcodes to advance time when necessary.
- You can import external libraries that aren't installed, although it shouldn't be necessary.
You can ask the community for help in the discussions section.
All code, practices and patterns in this repository are DAMN VULNERABLE and for educational purposes only.
DO NOT USE IN PRODUCTION.