This repository contains contracts to run a Gitcoin grants round on Lens protocol. This module allows Lens users to apply to a Gitcoin grants round with their publication and receive contributions from any dapp that supports Lens protocol.
This module is an experiment while playing with Kevin Owocki's idea of a quadratic funding social network posted here. Be sure to check out the discussion as it contains useful information on how this package works.
Please install Foundry / Foundryup:
- This will install
forge,cast, andanvil - You can test you've installed them right by running
forge --versionand get an output like:forge 0.2.0 (f016135 2022-07-04T00:15:02.930499Z) - To get the latest of each, just run
foundryup
And you probably already have make installed... but if not try looking here.
git clone https://github.com/izziaraffaele/grants-collect-module
cd grants-collect-module
yarn install # This install some of the project's dependencies managed with yarn
make # This installs the project's dependencies managed with Foundry.
make testmake test
or
forge test
Deploying to a network uses the foundry scripting system, where you write your deploy scripts in solidity!
We'll demo using the Mumai testnet. (Go here for testnet mumbai MATIC.)
You'll need to add the following variables to a .env file:
MUMBAI_RPC_URL: A URL to connect to the blockchain. You can get one for free from Infura accountPRIVATE_KEY: A private key from your wallet. You can get a private key from a new Metamask account- Optional
ETHERSCAN_API_KEY: If you want to verify on etherscan
make deploy-all network=<sandbox|testnet|mainnet>
This will deploy all the contracts in this repository on a specific network. It will also deploy and configure a Gitcoin Round. You'll find deployed contract addresses in addresses.json.
Alternatively you can use the following commands to deploy only the contracts in this repo.
make deploy-contracts network=<sandbox|testnet|mainnet>
To deploy only a specific contract use the following command
make deploy-testnet contract=<CONTRACT_NAME>
For example:
make deploy-testnet contract=GitcoinCollectModule
These commands pull from the files in the script folder.
Foundry comes with local network anvil baked in, and allows us to deploy to our local network for quick testing locally.
To start a local network run:
make anvil
This will spin up a local blockchain with a determined private key, so you can use the same private key each time. It creates a fork of the mumbai testnet so the MUMBAI_RPC_URL env variable is required to run this command.
Then, you can deploy to it with:
make deploy-anvil contract=<CONTRACT_NAME>
Similar to deploy-testnet
To deploy on Polygon mainnet, you can just use deploy-mainnet similar to deploy-testnet;
If all the contracts are deployed correctly you can simply run the following command to create a quadratic funding lens round
make create-round network=<sandbox|testnet|mainnet>
You are ready to post your publication on Lens!
Contributions are always welcome! Open a PR or an issue!