Badgeholders (voters in RetroPGF) need to be able to discover and vote on nominated projects. A good voting experience is core to supporting the work of badgeholders and ensuring an accurate RetroPGF process. This build seeks to empower badgeholders to find projects of various disciplines that have produced meaningful impact in the ecosystem that deserve to be promoted with funding.
Popular front end tool, Scaffold-ETH 2 has been used for it's easily forkable components designed with interacting with onchain data in mind. Built using NextJS, RainbowKit, Hardhat, Wagmi, and Typescript. Scaffold-ETH 2 Repo
For all the data housing needs to make project discovery and list curation as seamless and friction-free as possible.
Before you begin, you need to install the following tools:
To get started with this project, follow the steps below:
git clone https://github.com/scaffold-eth/OP-RetroPGF3-Discovery-Voting.git
cd OP-RetroPGF3-Discovery-Voting
yarn install
Copy the .env.example file and change name to .env.local. Set the MONGO_URI to the database you are using.
In the terminal, start your the project:
yarn start
Visit your app on: http://localhost:3000
.
Hint: We recommend connecting your GitHub repo to Vercel (through the Vercel UI) so it gets automatically deployed when pushing to main
.
If you want to deploy directly from the CLI, run yarn vercel
and follow the steps to deploy to Vercel. Once you log in (email, github, etc), the default options should work. It'll give you a public URL.
If you want to redeploy to the same production URL you can run yarn vercel --prod
. If you omit the --prod
flag it will deploy it to a preview/test URL.
Make sure to check the values of your Scaffold Configuration before deploying your NextJS App.
You can configure different settings for your dapp at packages/nextjs/scaffold.config.ts
.
export type ScaffoldConfig = {
targetNetwork: chains.Chain;
pollingInterval: number;
alchemyApiKey: string;
walletConnectProjectId: string;
onlyLocalBurnerWallet: boolean;
walletAutoConnect: boolean;
// your dapp custom config, eg:
// tokenIcon : string;
};
The configuration parameters are described below, make sure to update the values according to your needs:
targetNetwork
Sets the blockchain network where your dapp is deployed. Use values from wagmi/chains
.
pollingInterval
The interval in milliseconds at which your front-end application polls the RPC servers for fresh data. Note that this setting does not affect the local network.
alchemyApiKey
Default Alchemy API key from Scaffold ETH 2 for local testing purposes.
It's recommended to obtain your own API key from the Alchemy Dashboard and store it in an environment variable: NEXT_PUBLIC_ALCHEMY_API_KEY
at \packages\nextjs\.env.local
file.
walletConnectProjectId
WalletConnect's default project ID from Scaffold ETH 2 for local testing purposes.
It's recommended to obtain your own project ID from the WalletConnect website and store it in an environment variable: NEXT_PUBLIC_WALLET_CONNECT_PROJECT_ID
at \packages\nextjs\.env.local
file.
onlyLocalBurnerWallet
Controls the networks where the Burner Wallet feature is available. This feature provides a lightweight wallet for users.
true
=> Use Burner Wallet only on hardhat network.false
=> Use Burner Wallet on all networks.walletAutoConnect
Set it to true
to activate automatic wallet connection behavior:
onlyLocalBurnerWallet
You can extend this configuration file, adding new parameters that you need to use across your dapp (make sure you update the above type ScaffoldConfig
):
tokenIcon: "💎",
To use the values from the ScaffoldConfig
in any other file of your application, you first need to import it in those files:
import scaffoldConfig from "~~/scaffold.config";
A multitude of more detailed information related to Scaffold-ETH 2 can be found at the Scaffold-ETH 2 Repo
We welcome contributions to OP-RetroPGF3-Discovery-Voting!
Please see CONTRIBUTING.MD for more information and guidelines for contributing to OP-RetroPGF3-Discovery-Voting.