Giters

alexastrum / moonbeam-hardhat-dao-tutorial

A tutorial on using Hardhat to deploy a DAO to Moonbeam

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Build and Deploy a DAO on Moonbeam with Hardhat

This repository contains instructions for deploying a test DAO project to a local Moonbeam node using Hardhat.

We start with scaffold-eth, a very complete Ethereum project template, and modify it to work with Moonbeam. Then we deploy its sample "PowDAO" project and explore it.

This is inspired by Drnutsu's tutorial on a similar topic.

Prerequisites

It is assumed that you have the following prerequisites installed. These are the same as found in scaffold-eth with the addition of Docker to help us run Moonbeam without worrying about our OS environment.

Tutorial

  • Clone scaffold-eth's simple-DAO-proposals branch:

     # this repo uses different branches for different projects
 # so if you want to explore it, look at the different branches
 # we use '--single-branch' to reduce the download/disk usage impact
 git clone https://github.com/scaffold-eth/scaffold-eth -b simple-DAO-proposals --single-branch

 cd scaffold-eth
 yarn install

  • Prepare Moonbeam

    This can take some time to download, so we'll kick that off now (e.g. in a new terminal).

     docker pull purestake/moonbeam:v0.29.0

  • edit Hardhat conf (packages/hardhat/hardhat.config.js)

    • See Hardhat's Config documentation for more details

    • Add local moonbeam node as network in hardhat config

       // our local moonbeam node
 localMoonbeam: {
 	url: "http://127.0.0.1:9933",
 	gasPrice: 10000000000, // 10 gwei (10 billion)
 	chainId: 1281,
 	accounts: {
 		mnemonic: mnemonic(),
 	},
 },

    • set const defaultNetwork = "localMoonbeam"; (line 28)

    • set DEBUG = true (we want it to print out the deployer address) (line 311)

    • set const mnemonic = "bottom drive obey lake curtain smoke basket hold race lonely fit walk"; (line 388) This causes Hardhat to use the same accounts as the ones that are pre-funded in a Moonbeam dev node. TODO: find a proper way to integrate these accounts

  • Generate privkey

     # run yarn generate to generate mnemonic for deployer. note that this is the "generate" task found in hardhat.config.js
 export NODE_OPTIONS=--openssl-legacy-provider # may need
 yarn generate
 # ensure that printed account matches Alith, or copy account if using different mnemonic

  • Run Moonbeam Moonbeam can easily be run on Linux, but we use Docker to make it painless to run cross-platform.

    Full documentation: https://docs.moonbeam.network/builders/get-started/networks/moonbeam-dev/

     # Linux via Docker:
 docker run --rm --name moonbeam_development --network host \
 purestake/moonbeam:v0.29.0 \
 --dev

 # Linux via raw binary:
 ./moonbeam --dev

 # MacOS:
 docker run --rm --name moonbeam_development -p 9944:9944 -p 9933:9933 \
 purestake/moonbeam:v0.29.0 \
 --dev --ws-external --rpc-external

 # Windows:
 docker run --rm --name moonbeam_development -p 9944:9944 -p 9933:9933 ^
 purestake/moonbeam:v0.29.0 ^
 --dev --ws-external --rpc-external

  • Edit packages/hardhat/contracts/PowDAO.sol

    • Add one or more keys from Moonbeam prefunded accounts
    • Replace addresses in const members = [..] (line 8)
    • E.g.:
     const members = [
 	"0xf24FF3a9CF04c71Dbc94D0b566f7A27B94566cac", // Alith
 	"0x3Cd0A705a2DC65e5b1E1205896BaA2be8A07c6e0", // Baltathar
 ];

  • Deploy

     # chain needs to be running, so either:
 # have moonbeam node running (see above)
 # or we can run `yarn chain` in another terminal to run Hardhat's built in Ethereum node

 export NODE_OPTIONS=--openssl-legacy-provider # may need
 yarn deploy

  • Modify MetaMask to Add Network and Import Dev Accounts

    • Add Dev Network :warning: Matamask will complain if it can't connect to the RPC you specify, so you will need Moonbeam running


      \

    • Add Dev Accounts

      \

  • Interact

    At this point, we have our Moonbeam node running with a dev chain deployed. We also have the PowDAO contract deployed with Alith and Baltithar as initial members, and we have these accounts in MetaMask. Now we will deploy the frontend.

    Change port used for RPC (Moonbeam defaults to port 9933 rather than 8545):

     # replace 8545 with 9933 in packages/react-app/src/constants.js

 # kicks off the web UI
 yarn start

    Challenges:

    • Test membership
    • Add member
    • Process Proposal
    • Kick member
    • Request and receive a payout

References

About

A tutorial on using Hardhat to deploy a DAO to Moonbeam