Foundry is a fast toolkit for application development written in Rust equipped with a testing framework, as well as utilities for interacting with smart contracts and getting chain data.

The template repository contains submodules and remappings for ds-test assertions for testing, solmate building blocks for contracts, and forge-std to layer on top of EVM cheat codes to improve UX.


You must have the following installed:

You should also have an address on the Filecoin Calibration testnet. See the MetaMask setup page for information on how to get an address. You also need test tFIL in your wallet.


  1. Clone the xBalbinus/fevm-foundry-kit repository and move into the fevm-foundry-kit directory:

git clone
cd fevm-foundry-kit
  1. Install the project dependencies with Yarn:

yarn install
  1. Export your private key from MetaMask. See the MetaMask documentation to find out how to export your private key.

  2. In your .env.example, create an environment variable called PRIVATE_KEY and paste in the private key from MetaMask. Also, do the same for the HYPERSPACE_RPC_URL. Then rename the file to .env:

  1. Inside the src folder in a contract called SimpleCoin.sol. Deploy this contract using Foundry:

forge build
forge script script/SimpleCoin.s.sol:MyScript --rpc-url --broadcast --verify -vvvv

# ...
# Script ran successfully.
# Gas used: 234642
  1. Alternatively, you can do the same using the forge create command:

forge build

forge create --rpc-url --private-key $PRIVATE_KEY src/SimpleCoin.sol:SimpleCoin
  1. You can now interact with your contract using the contract address given by Foundry.

Done! For more information, see the Foundry book.

Last updated