Search for a command to run...
I'm Vedant! I'm a software developer who loves to create awesome web3 and blockchain projects. When I'm not coding, you can find me writing technical articles or exploring new technologies. I'm always up for a chat about the latest tech trends, so feel free to drop me a message!
No comments yet. Be the first to comment.
Batch payouts are a common requirement in payroll systems, treasury tools, creator payouts, and automated on-chain settlement pipelines. Instead of sending multiple independent ERC-20 transfers which is slow, expensive, Request Network provides a sin...
Private keys and seed phrases are core to how we secure assets and verify identity on blockchains. Almost everyone in Web3 uses them, but few actually look under the hood to understand what makes them work or what risks they might carry. Are private ...
A Technical Exploration of the ao computer
Imagine you're on a treasure hunt with a map that leads you to a hidden box. The map doesn't tell you the exact location, but it gives you clues about where to dig. You follow the instructions, carefully measuring distances and angles, until finally,...
Zero-knowledge proofs (ZK-Proofs) have revolutionized the field of cryptography and secure computing, offering solutions to real-world problems. In essence, a zero-knowledge proof allows for the validation of a statement without disclosing the statem...
Crowdfunding is the practice of using modest sums of money from a large number of people to finance a new business endeavor.
Let's say I want to open a modest tea shop, but I lack the resources or cash to do so. What then can I do? Either I can get a loan from a friend, my family, or the bank, or I may ask someone to give me money and work with me on a project. Crowdfunding will be used if the project is too large for a single investor to invest in. I will solicit money from anyone in exchange for shares of my business, and each investment will possess a part in the business.
Look at this illustration of the structure we plan to build first.
Entire File -
PREREQUISITE
First, we specify our license and the Solidity version we intend to use. The version we are working on is indicated by pragma solidity; take note that our compiler version must match for there to be no error signs.
Version 0.8.7 will be used in this article.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.7;
To help the contract call the transfer and transferFrom functions from the ERC-20 Token Contract, we will now construct an Interface for our ERC-20 Tokens.
interface IERC20 {
function transfer(address, uint) external returns (bool);
function transferFrom(
address,
address,
uint
) external returns (bool);
}
We now declare some state variables to begin our smart contract.
struct for storing data on the campaign's creator, aim, start time, end time, and the pledged tokens.mapping that connects campaigns to their IDmapping to link the user's address and the number of tokens they pledged, and another mapping to link the campaign id.struct Campaign {
address creator;
uint goal;
uint pledged;
uint startAt;
uint endAt;
bool claimed;
}
IERC20 public immutable token;
uint public count;
uint public maxDuration;
mapping(uint => Campaign) public campaigns;
mapping(uint => mapping(address => uint)) public pledgedAmount;
Next, we designate some actions as events that will occur if a campaign is started, a token is pledged or unpledged, a campaign is cancelled, or a token is claimed or withdrawn.
event Launch(
uint id,
address indexed creator,
uint goal,
uint32 startAt,
uint32 endAt
);
event Cancel(uint id);
event Pledge(uint indexed id, address indexed caller, uint amount);
event Unpledge(uint indexed id, address indexed caller, uint amount);
event Claim(uint id);
event Refund(uint id, address indexed caller, uint amount);
Next, we set up our contract's constructor, which requires the address of the ERC-20 token and the maximum time a campaign can be hosted, as its two inputs.
constructor(address _token, uint _maxDuration) {
token = IERC20(_token);
maxDuration = _maxDuration;
}
Our first function, "launch," which accepts the campaign's goal, the start timestamp, and the end timestamp, is now defined.
Before starting the campaign, we first perform some checks.
After that, we raise our count variable. The campaign information is then stored in the campaigns mapping, with the count variable serving as the key and a struct as the value.
And finally emit the Launch event
function launch(uint _goal, uint32 _startAt, uint32 _endAt) external {
require(_startAt >= block.timestamp,"Start time is less than current Block Timestamp");
require(_endAt > _startAt,"End time is less than Start time");
require(_endAt <= block.timestamp + maxDuration, "End time exceeds the maximum Duration");
count += 1;
campaigns[count] = Campaign({
creator: msg.sender,
goal: _goal,
pledged: 0,
startAt: _startAt,
endAt: _endAt,
claimed: false
});
emit Launch(count,msg.sender,_goal,_startAt,_endAt);
}
Next, we define a function called cancel, which allows the campaign's creator to end the campaign provided that they are the campaign's creator and that the campaign has not yet begun.
function cancel(uint _id) external {
Campaign memory campaign = campaigns[_id];
require(campaign.creator == msg.sender, "You did not create this Campaign");
require(block.timestamp < campaign.startAt, "Campaign has already started");
delete campaigns[_id];
emit Cancel(_id);
}
We have now developed our pledge feature, which asks for the campaign id and the number of tokens that need to be pledged.
In order to transfer tokens from the user to the smart contract, we first run basic tests, such as determining whether the campaign has begun or concluded. Next, we use the token variable, which corresponds to the IERC interface and call the transferFrom function to transfer tokens from the user to the smart contract.
By increasing the amount of tokens offered by the campaign and storing the number of tokens pledged by the user, we modify the state variables of the contract.
And then we emit the Pledge event.
function pledge(uint _id, uint _amount) external {
Campaign storage campaign = campaigns[_id];
require(block.timestamp >= campaign.startAt, "Campaign has not Started yet");
require(block.timestamp <= campaign.endAt, "Campaign has already ended");
campaign.pledged += _amount;
pledgedAmount[_id][msg.sender] += _amount;
token.transferFrom(msg.sender, address(this), _amount);
emit Pledge(_id, msg.sender, _amount);
}
We provide a function called unpledge that removes the tokens that a user has pledged, just as the pledge function.
function unPledge(uint _id,uint _amount) external {
Campaign storage campaign = campaigns[_id];
require(block.timestamp >= campaign.startAt, "Campaign has not Started yet");
require(block.timestamp <= campaign.endAt, "Campaign has already ended");
require(pledgedAmount[_id][msg.sender] >= _amount,"You do not have enough tokens Pledged to withraw");
campaign.pledged -= _amount;
pledgedAmount[_id][msg.sender] -= _amount;
token.transfer(msg.sender, _amount);
emit Unpledge(_id, msg.sender, _amount);
}
The creator can claim all of the tokens raised for the campaign with the help of a claim function that we define next if the following criteria are met.
function claim(uint _id) external {
Campaign storage campaign = campaigns[_id];
require(campaign.creator == msg.sender, "You did not create this Campaign");
require(block.timestamp > campaign.endAt, "Campaign has not ended");
require(campaign.pledged >= campaign.goal, "Campaign did not succed");
require(!campaign.claimed, "claimed");
campaign.claimed = true;
token.transfer(campaign.creator, campaign.pledged);
emit Claim(_id);
}
In the event that the campaign is unsuccessful, we create a refund function that allows users to withdraw their tokens from the contract.
function refund(uint _id) external {
Campaign memory campaign = campaigns[_id];
require(block.timestamp > campaign.endAt, "not ended");
require(campaign.pledged < campaign.goal, "You cannot Withdraw, Campaign has succeeded");
uint bal = pledgedAmount[_id][msg.sender];
pledgedAmount[_id][msg.sender] = 0;
token.transfer(msg.sender, bal);
emit Refund(_id, msg.sender, bal);
}
This is how a crowd funding contract is created, allowing users to establish campaigns and donate tokens to various projects.
Full code -