First part of a series of tutorials on how to use the StarkNet Hardhat Plugin for Cairo smart contract development.
Hello frens! 👋
Welcome to the first part of a series of tutorials on how to use the StarkNet Hardhat Plugin for Cairo smart contract development!
In this tutorial we will deliberately use links to other resources, because StarkNet is in alpha version at the time of writing, so expect things will change and break… And the resources linked will likely change as well to reflect the evolution 🧬
First things first, so please refer to the project's repository for instructions on how to install and set up everything:
Note: After installing hardhat, and running npx hardhat - setting up a project should look something like this:
Note: After successfully installing everything, make sure you have docker running as well, or if you have cairo-lang installed locally, set up venv in your hardhat config file - like so!
Now we have arrived to the fun part! 👻 First, copy the contract found here, and paste it in your project under the contracts folder inside your hardhat project.
Note: you can delete the Solidity (.sol) contract if it was generated with your project.
You can call the contract hello.cairo ! At the time of writing, the contract looks like this:
We are going to show you how to compile, deploy and interact with your contract by using the Hardhat StarkNet commands. But first, let’s configure our hardhat.config.ts file, find it or place it at the root of our project and follow the instructions below.
In the console, write this command:
After successful compilation you should see these .json files in your project:
Now we would like to deploy our contract!
But, unlike the previous StarkNet versions, to do so, we will use an account that is already deployed and funded.
You can learn more about this here.
That’s what we’ll be doing on the next few steps.
1. Let’s add a new file to our project, under the /scripts folder and name it deploy-account.ts.
2. To create an account on testnet, we could run the following script in our project. Copy the following code to deploy-account.ts
3. Run the following command in the console:
Note: make sure you save your address, private and public keys shown in the console
4. Funding the account
When the script pauses execution, you should add funds to the generated address - the command createAccount(), will output an account address which we then will use to fund through a faucet!
You should give it a few minutes for the transaction to be accepted.
Note: The account is not yet deployed, so you will not be able to see it on Starkscan!
5. Deploying the account.
Once we make sure funding is successful (by checking if tokens were transferred), we can proceed - hit enter!.
After deploying the account, the transaction hash of the account will be output. To verify that the contract is accepted on the network, copy the address and paste it into the search field of Voyager or Starkscan.
Note that due to high network traffic, there may be no result at first, so it is best to wait a few minutes before checking again.
Ok. Now, we've deployed an account that will deploy our contract. We can proceed to deploying the hello.cairo contract.
Create a new script, call it deploy-contract.ts and place it in the /scripts folder.
Note: Be sure to add the address and private key from previous steps in the getOZAccount() function.
Note: The getContractFactory() method fetches a compiled contract by name.
Now in the console, run:
Note: You will have to wait for some time for the contract to actually get deployed on testnet. This can vary depending on the traffic. You can check the status of the transaction on: https://testnet.starkscan.co/ . Also be sure you are checking the testnet, and not the mainnet!
Final result in the console:
And that’s it!
Also be sure to check out the hardhat-example repository for more examples on features and usage!
You may have noticed that doing this on the testnet can be slow 😞 But don't worry - in the next tutorial, we will see how to do the same operations, but on a local instance of the starknet network, called the devnet. Therefore make sure you follow our blog and Twitter.
*This article is also available on SpaceShard Medium.