In this article, we will be deploy our own crowdfunding campaign contract where users can create campaigns and / or donate to other campaigns.Before diving into the fun part, make sure you follow BuildBear on <a href="https://twitter.com/_BuildBear">Twitter</a> and <a href="https://www.linkedin.com/company/82323007/">LinkedIn</a> and do not forget to join the <a href="https://t.me/+6mjOnBFUR9xjN2U1">Telegram group</a> so you don’t miss any updates.<h1 style="margin-left:0px;">1. Create a project and install dependencies</h1>1.1: Use the following commands on your CLI to initialize your project.<pre><code class="language-plaintext">mkdir crowdfund-campaign-with-buildbear &amp;&amp; cd crowdfund-campaign-with-buildbear</code></pre>1.2: Run the command <code>npx hardhat</code> on your CLI and choose <code>Create a Javascript Object</code>; choose <code>yes</code> for all the options.Once you have successfully executed the above and if you were to open this repo in VS Code, you should have a directory structure, similar to the following:<figure class="image image_resized" style="width:310.993px;"><img src="https://miro.medium.com/v2/resize:fit:261/1*aGHJ8kSjwFgh_RTOvyciyw.png" alt="" loading="lazy"></figure><h1 style="margin-left:0px;">2. Coding the Crowdfund Campaign Smart Contract</h1>2.1: Create a file named <code>Campaign.sol</code> in the <code>contracts</code> folder.2.2: We will start with defining the Solidity Version (this will determine the Solidity Compiler, which we will also use in our <code>hardhat.confing.js</code> file).<pre><code class="language-plaintext">// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;contract Campaign {</code></pre>2.3 Inside our Campaign contract, we need to have some attributes that we are going to use in the future. So let us define them and understand each of them one by one<pre><code class="language-plaintext">mapping (address =&gt; uint256) public contributers;
 string public title;
 uint256 public requiredAmount;
 string public story;
 address payable public owner;
 uint256 public receivedAmount;
 bool public acceptingDonation = true;
 uint256 public deadline;</code></pre>2.3.1 Here,<ul><li>contributers is a mapped variable where the amount of contribution done by a user will be stored by its address. This way we can keep a track of all the contributors who have contributed to the campaign.</li><li>title will store the title of the campaign that will be created</li><li>the amount required by the campaign will be stored by requiredAmount</li><li>any additional data can be written inside story</li><li>owner will store the address of the deployer or we can say the owner of the campaign. We need to store the owner to make sure that only the owner will be able to withdraw the funds.</li><li>receivedAmount will be used to keep a track of funds received and to make sure once the campaign amount is achieved, no one could donate to the campaign.</li><li>acceptingDonation will store a boolean value which will be true by default and once the donation amount is received, its value will become false and then no additional donation will be done.</li><li>lastly, we have a uint variable for the deadline so that after a deadline time is achieved, no more donations can take place</li></ul>2.4 Now, we will define the constructor for our contract. Constructor will store all the parameters that will be required to initialise the campaign.Thus, to start a campaign, we will require a campaign title, the amount that has to be raised, additional data about the campaign, owner of the campaign and the deadline of the contract.Your constructor code should look similar to this<pre><code class="language-plaintext">constructor (
 string memory campaignTitle,
 uint256 requiredCampaignAmount,
 string memory storyURI,
 address campaignOwner,
 uint256 campaignDeadline
 ) {
 title = campaignTitle;
 requiredAmount = requiredCampaignAmount;
 story = storyURI;
 owner = payable(campaignOwner);
 deadline = campaignDeadline;
 }</code></pre>Then lastly, we are going to write 3 functions for our contract:<ul><li>donate(): Donate function will be used to perform the donation for the campaign. Anyone can contribute to the campaign if the deadline time is not achieved and the donation amount is not yet achieved.</li></ul><pre><code class="language-plaintext">function donate() public payable {
 require(acceptingDonation);
 require(block.timestamp &lt; deadline, "Deadline has Ended!");
 require(msg.value &gt; 0, "Msg.value = 0");
 if (msg.value &gt; requiredAmount - receivedAmount)
 revert TooHighDonation({
 message: "Donation room left",
 donationRemaining: requiredAmount - receivedAmount
 });
 receivedAmount += msg.value;
 contributers[msg.sender] += msg.value;
 if (receivedAmount &gt;= requiredAmount) {
 acceptingDonation = false;
 }
 emit donated(msg.sender, msg.value, block.timestamp);
 }</code></pre>Make sure that your function is payable.<ul><li>withdraw(): Withdraw function will be used once the campaign amount is achieved, then only the owner can withdraw the fund by calling this function.</li></ul><pre><code class="language-plaintext">function withdraw() public {
 require(msg.sender == owner, "Only the owner can withdraw");
 require(!acceptingDonation, "Campaign still not over");
 owner.transfer(receivedAmount);
 emit withdrawn(receivedAmount);
 }</code></pre><ul><li>refund(): Refund function, as the same suggests, will return back all the contributions back to the contributors if the requested amount is not achieved by the <a href="http://campaign.it/">campaign</a>.It will automatically transfer the contribution back to the contributor.</li></ul><pre><code class="language-plaintext">function refund() public {
 require(block.timestamp &gt; deadline &amp;&amp; receivedAmount &lt; requiredAmount);
 require(contributers[msg.sender] &gt; 0, "Not eligible for refund");
 address payable user = payable(msg.sender);
 contributers[msg.sender] = 0;
 user.transfer(contributers[msg.sender]);
 }</code></pre>2.5 Lastly, we will add the fallback function.A fallback function is an unnamed external function without any input or output parameters. The EVM executes the fallback function on a contract if none of the other functions matches the intended function calls.<pre><code class="language-plaintext">fallback() external payable {
 donate();
} receive() external payable {
 donate();
}</code></pre>2.6 We will also add the events for:<ul><li>donation that will be triggered once the donate function is used. It will require the address of the donor, the amount of donation to be done, and the timestamp at which the donation is done</li><li>withdrawn will only require the amount of donation done by the contributor</li><li>And an error message to be triggered if the donation amount is more than the required amount</li></ul><pre><code class="language-plaintext">event donated (
 address indexed donar,
 uint256 indexed amount,
 uint256 indexed timestamp
 );event withdrawn(uint256 amount);error TooHighDonation(string message, uint256 donationRemaining);</code></pre>And that’s all, our campaign smart contract is ready!Your final contract should look similar to this<figure class="image image_resized" style="width:679.985px;"><img src="https://miro.medium.com/v2/resize:fit:588/1*M38-HqP16y2lr3Gm7VfTlA.png" alt="" loading="lazy"></figure><h1 style="margin-left:0px;">3. Deployment to a blockchain, calling smart contract functions and inviting your friends / audience to participate with you in your testing</h1>3.1: Creating a Private Testnet on BuildBear 🐻‍❄️ *(why BuildBear, you ask? Have a look over here: **<a href="https://medium.com/p/492f1038883d">Where Localhost Fails</a> and *<a href="https://medium.com/p/e67656093f9d">Win Web3 Hackathons, using BuildBear Testnet’s analytics</a>)3.1.1: Visit the <a href="https://home.buildbear.io/">BuildBear App</a>. Once you login with your Github account, you will see a page similar to the image added below<figure class="image image_resized" style="width:679.985px;"><img src="https://miro.medium.com/v2/resize:fit:588/1*RaeTJw7AUR5V1GMKaaKtcg.png" alt="" loading="lazy"></figure>Here we have to create a simple node for our staking application so we will click on the create an endpoint button and then we will be redirected to the node configuration page, where we have the forking options, hardhat options and EVM options.But for this article, we will be using the default configuration for our smart contract.So we will simply click on the submit button as shown below.<figure class="image image_resized" style="width:679.985px;"><img src="https://miro.medium.com/v2/resize:fit:588/1*TDme9DX2bMMS-se4C1rTkA.png" alt="" loading="lazy"></figure>Congratulations! You have created your first node!Your node may look similar to this<figure class="image image_resized" style="width:679.985px;"><img src="https://miro.medium.com/v2/resize:fit:588/1*j641uffK-b5zatLbfj5EYw.png" alt="" loading="lazy"></figure>BuildBear provides you with a custom RPC URL, Explorer, Faucet and other additional features.In order to perform transactions, we need fund from faucet.Don’t worry! We don’t have to find random faucets to get test ether.Click on the Open Faucet option and add your choose your account.<figure class="image image_resized" style="width:679.985px;"><img src="https://miro.medium.com/v2/resize:fit:588/1*EKthYJ1urK-fjHnlEtg-6g.png" alt="" loading="lazy"></figure>After that, click on the Add to Metamask option in the right corner of the faucet page.Your metamask would be provided with 1000 BB ETH immediately.<figure class="image image_resized" style="width:359.989px;"><img src="https://miro.medium.com/v2/resize:fit:302/1*s8J6C36yDOOGhdCVSG0aMQ.png" alt="" loading="lazy"></figure>Your <code>hardhat.config.js</code> file should look similar to this<figure class="image image_resized" style="width:679.985px;"><img src="https://miro.medium.com/v2/resize:fit:588/1*_hsUO805n2GmG6ACufLLMg.png" alt="" loading="lazy"></figure>In the networks, we have created a network called buildbear and added our RPC URL there and then added the private key of the metamask account.If you have any doubt regarding any of the steps provided above, please DM us on Twitter or Linkedin.Now our config is ready! Let’s write our smart contract.<h1 style="margin-left:0px;">4. Deploy the campaign contract on private testnet</h1>4.1: Use the following script to deploy your staking contract:<pre><code class="language-plaintext">const hre = require('hardhat');async function main() { const Campaign = await hre.ethers.getContractFactory("Campaign")
 const campaignContract = await Campaign.deploy("Campaign for Dogs", 10000000000000, "This campaign will help all the stray dogs by providing them food and shelter", "0xD5142501AE71b570024938370ef197623AF055A1", 1663755818); await campaignContract.deployed(); console.log("Factory deployed to:", campaignContract.address);
} main()
 .then(() =&gt; process.exit(0))
 .catch((error) =&gt; {
 console.log(error);
 process.exit(1);
 });</code></pre>4.1.1Here in the deploy script, we have provided:<ul><li>the title name for the campaign</li><li>the amount to be raised, in wei</li><li>information about the campaign</li><li>the owner of the campaign and</li><li>lastly, we have added a deadline in UNIX timestamp</li></ul>4.2 To deploy this contract on buildbear, use the following command in your terminal<pre><code class="language-plaintext">npx hardhat run scripts/deploy.js --network buildbear</code></pre><h1 style="margin-left:0px;">5. Executing transactions on our contract</h1>5.1 To see your contract deployed, open BuildBear and click on the “view on explorer” option.And paste the contract address provided in the terminal in the BuildBear explorer.<figure class="image image_resized" style="width:679.985px;"><img src="https://miro.medium.com/v2/resize:fit:588/1*k6F3K4UsA3tD79o2n6h19g.png" alt="" loading="lazy"></figure>To interact with our contract, let us first submit the contract ABI to the node container.Open BuildBear and click on the advanced button and drop your contracts folder there.Once you’ll submit the ABI, click on the contract option adjacent to transactionsYou will be automatically redirected to the read contract page.You will be able to see all our functions listed there.<figure class="image image_resized" style="width:679.985px;"><img src="https://miro.medium.com/v2/resize:fit:588/1*6lxVFbMJT2fIUlT4CclcTQ.png" alt="" loading="lazy"></figure>5.2 In order to donate to this campaign, click on the write contract option<figure class="image image_resized" style="width:679.985px;"><img src="https://miro.medium.com/v2/resize:fit:588/1*hxzgWXepfVjlzpJm-2MAsg.png" alt="" loading="lazy"></figure>Connect to the web3 account and then simply add the amount to be contributed in ethers.<figure class="image image_resized" style="width:679.985px;"><img src="https://miro.medium.com/v2/resize:fit:588/1*1afBqkSscnTJdiasNybeew.png" alt="" loading="lazy"></figure>Here is an example to test the donate function. We have simply provided the amount of contribution and then approved the transaction with the help of Metamask wallet.If you’ll check the trace of the transaction hash, you will be able to see that donation of amount 1000000000000 has been done<figure class="image image_resized" style="width:679.985px;"><img src="https://miro.medium.com/v2/resize:fit:588/1*POjN-4FyDO4YM077N7S4_g.png" alt="" loading="lazy"></figure>And the receivedAmount will show you the contribution done by the contributor.<figure class="image image_resized" style="width:679.985px;"><img src="https://miro.medium.com/v2/resize:fit:588/1*gDWl_FT_S2J-zWbvVNr6Fg.png" alt="" loading="lazy"></figure><blockquote>You can even ask your friends to contribute to your campaign.</blockquote>5.3 Now once the required amount is achieved and the contributors will not be able to contribute to the campaign. Let us try that out.<figure class="image image_resized" style="width:679.985px;"><img src="https://miro.medium.com/v2/resize:fit:588/1*IHov7cpzRJRTEq1joI1Vlw.png" alt="" loading="lazy"></figure>Now again we tried to donate to the campaign, but this time we got a failed transaction since the required amount was already achieved.If you will click on the transaction hash, you will see the information of the failed transaction.<figure class="image image_resized" style="width:679.985px;"><img src="https://miro.medium.com/v2/resize:fit:588/1*3iKGHqvWG_p5LYJ0M4Cv-g.png" alt="" loading="lazy"></figure>Now the owner will be able to withdraw the amount and can receive the campaign fund.<figure class="image image_resized" style="width:679.985px;"><img src="https://miro.medium.com/v2/resize:fit:588/1*_jE1gciEi7i4ZX9JvnXZ8g.png" alt="" loading="lazy"></figure><figure class="image image_resized" style="width:365.997px;"><img src="https://miro.medium.com/v2/resize:fit:307/1*QSk0wa2Pj_RcKsq2Uu0Fhg.png" alt="" loading="lazy"></figure>This way you can ask your friends to contribute to your campaign 😃<blockquote>You give you a better hands-on experience with the smart contract, I have created my private testnet and the campaign contract is available over <a href="https://explorer.buildbear.io/node/affectionate-fermat-d1d223/address/0x2af1243Df9A536Bf022e1d5dD257d760285eb390/">here.</a>You can get the Faucet for the testnet over <a href="https://faucet.buildbear.io/affectionate-fermat-d1d223">here.</a></blockquote>Get the above Github code from <a href="https://github.com/BuildBearLabs/Tutorials/tree/main/Crowdfunding-with-BuildBear">here.</a>This is how we can write a crowdfunding smart contract and can play around with it with the help of BuildBear.To learn more about BuildBear, read this <a href="https://docs.buildbear.io/docs/intro">docs</a>Make sure you follow us on <a href="https://twitter.com/_BuildBear">Twitter</a> and <a href="https://t.me/+6mjOnBFUR9xjN2U1">Join the Telegram</a> group if you haven’t done yet.Author:Pari Tomar (<a href="https://twitter.com/tomarpari90">Twitter</a> || <a href="https://www.linkedin.com/in/pari-tomar-8b1370187/">LinkedIn</a>), always open to feedback and learning.BTW, if you would know anyone who would be keen to working with BuildBear. Please have a look over <a href="https://bit.ly/buildbear-careers">here</a>!!!Author: <a href="https://twitter.com/chandan1_">chandan</a>

Template for Tutorials.png

In this article, we will be deploy our own crowdfunding campaign contract where users can create campaigns and / or donate to other campaigns.

Creating a Crowdfunding Campaign with BuildBear

BUILDBEAR // TUTORIALS

Creating a Crowdfunding Campaign with BuildBear

Let’s get started then, Shall we?

Let’s get started then, Shall we?

Test DApps at Scale.