Ethereum Multi-sig Wallet

See it live here

Prerequisites

1. Follow this guide to create an Ethereum wallet and switch to the Rinkeby Test Network
2. Send yourself some test ETH here

Overview

This is an open-source implementation of an Ethereum multi-sig wallet with a React-based UI. A multi-sig wallet is a cryptocurrency wallet that requires two or more private keys to sign and send a transaction. The purpose of this project is to encourage new Solidity developers to get started with open-source development.

Getting started

1. Clone the repository: git clone https://github.com/SpencerMiller23/Ethereum-MultiSigWallet.git
2. Install dependencies: npm install
3. Compile the contracts: npx hardhat compile

TO-DO

• Add alerts for errors
• Add loading indicators
• Add redux for handling global state
• Integrate database for storing off-chain data about wallets
• List wallets in drawer that have the connected user as an owner
• Implement wallet page
• Add ability to receive other ERC20 tokens
• Add automated checks for rejected transactions
• Improve test coverage

Useful links

• Solidity
• Hardhat
• Ethers.js
• Waffle
• Next.js
• Prisma
• Redux Toolkit
• MaterialUI

Deploy locally

Prerequisites

• Browser-based Ethereum wallet (ex: MetaMask)
• PostgreSQL database on Heroku (see this guide)

Deployment

1. Update DATABASE_URL in the .env file
2. Open a terminal window and run npx prisma db push
3. Run npx hardhat node
4. Create a new wallet by importing the secret key from one of the Hardhat accounts
5. Open a second terminal window and run npx hardhat run scripts/deploy.js --network localhost
6. Change networks in Metamask to Localhost8545
7. Copy the address of the deployed factory contract and update the value stored in config.js
8. Open a third terminal window and run npm run dev

Testing

• Run npx hardhat test

Hardhat

This project demonstrates an advanced Hardhat use case, integrating other tools commonly used alongside Hardhat in the ecosystem.

The project comes with a sample contract, a test for that contract, a sample script that deploys that contract, and an example of a task implementation, which simply lists the available accounts. It also comes with a variety of other tools, preconfigured to work with the project code.

Try running some of the following tasks:

npx hardhat accounts
npx hardhat compile
npx hardhat clean
npx hardhat test
npx hardhat node
npx hardhat help
REPORT_GAS=true npx hardhat test
npx hardhat coverage
npx hardhat run scripts/deploy.js
node scripts/deploy.js
npx eslint '**/*.js'
npx eslint '**/*.js' --fix
npx prettier '**/*.{json,sol,md}' --check
npx prettier '**/*.{json,sol,md}' --write
npx solhint 'contracts/**/*.sol'
npx solhint 'contracts/**/*.sol' --fix

Etherscan verification

To try out Etherscan verification, you first need to deploy a contract to an Ethereum network that's supported by Etherscan, such as Ropsten.

In this project, copy the .env.example file to a file named .env, and then edit it to fill in the details. Enter your Etherscan API key, your Ropsten node URL (eg from Alchemy), and the private key of the account which will send the deployment transaction. With a valid .env file in place, first deploy your contract:

hardhat run --network ropsten scripts/deploy.js

Then, copy the deployment address and paste it in to replace DEPLOYED_CONTRACT_ADDRESS in this command:

npx hardhat verify --network ropsten DEPLOYED_CONTRACT_ADDRESS "Hello, Hardhat!"

This is a Next.js project bootstrapped with create-next-app.

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.

License

MIT