Recently, while writing some frontend tooling for dapps (stay tuned), I encountered the need to quickly test that my library would work with real Solidity contracts. While I always recommend dapp makers to start with a Truffle project, sometimes you need something a little more lightweight. For example, instead of having to run migrations, maybe you just want to compile a smart contract and test right-away. No worries, the Truffle suite of tools has got you covered! In this tutorial, I will show you how to setup minimal smart contract testing with Ganache and Jest. If you don’t need a step-by-step explanation, the example repo is right here: _🚀 Minimal Solidity contract testing with Ganache and Jest - adrianmcli/ganache-jest-example_github.com adrianmcli/ganache-jest-example Just three steps In essence, there are only three things you need to do: Compile the Solidity contract Spawn a test “blockchain” Deploy the contract. Sounds daunting right? But thanks to Truffle and the community at large, this is actually all a lot simpler than you might think. Our Contract Before we get started, let’s create our contract, : SimpleStorage.sol This contract is very simple, it allows you to get and set an integer, that’s it. Compiling the contract We’re going to be using to compile our Solidity contract. This means we will have to conform to their way of doing things and this might get a little funky so let’s create a new file for that. solc-js Start a new file called and paste in the following: compile.js We are exporting a function that will take in a filename and look for it in the same folder. We pass the options object (i.e. ) in the way that it wants and it spits out a JSON that we can extract our artifact from. compile solc input Do note that I also have a version of the repo using instead of . There are pros and cons to either one, feel free to make your own judgement call. truffle-compile solc Spawning a test blockchain with Ganache For this part and the next, I’ll be explaining the concepts first and then I’ll show you the whole file where it all comes together. So please pay attention, I promise it’ll pay off! Spawning a test blockchain is way simpler than I could have ever hoped for. Literally the only thing you need to do is: // import Ganacheconst Ganache = require("ganache-core"); // spawn the test "blockchain" providerconst provider = Ganache.provider(); // use it like how you would normally use a providerconst web3 = new Web3(provider);const accounts = await web3.eth.getAccounts(); The one-liner essentially does all the heavy lifting for you. It basically spawns a blockchain in-memory and gives you the object to interact with it. Ganache.provider() provider From the provider, we can easily get the instance and subsequently the array that we will need in the next step. web3 accounts Deploy your contract Now that we have web3 as well as the contract artifact, we can deploy it onto our test blockchain. const instance = new web3.eth.Contract(SimpleStorage.abi); const deployedInstance = await instance.deploy({data: SimpleStorage.evm.bytecode.object}).send({from: accounts[0],gas: 150000}); This is standard usage of the Web3.js API (v1.0). We first create our contract instance by passing in the ABI from our artifact . And then we deploy it by calling with the bytecode from our contract artifact, and finally from our account with a specified gas amount to make sure it goes through. SimpleStorage.abi .deploy() send() Putting it all together Now that we understand what we need to do, we can make a new file called and start writing our test. Most of what we talked about is setting up the environment for our tests, so it will go under the hook from Jest. test.js beforeAll() At this point, I am going to show you the entirety of this file: Note that the , , , and variables are declared outside of the hook so that we can use those them in our tests. provider web3 accounts contractInstance beforeAll() We also have an hook where we call on the provider to prevent memory leaks. afterAll() stop() Finally, the actual example test demonstrates setting and getting a value. Some thoughts Of course, this might get a little un-wieldy if you have many different contracts and they inherit from each other. For those use-cases, I would highly recommend a traditional Truffle project. However, if you have something simple to test, or if you want to test out your frontend separately from your Truffle project, this is a great option that allows you to do so. Do keep in mind that spawning a Ganache provider does take a couple seconds, so try not to do it all-over the place. If you start having to do that, it may be another sign that you should consider converting your project to a full-on Truffle project instead. This format may not be for everyone, so do check out the example repo that you can clone and run for yourself! _🚀 Minimal Solidity contract testing with Ganache and Jest - adrianmcli/ganache-jest-example_github.com adrianmcli/ganache-jest-example If you liked this article, please give me a few claps!
