Morphex is a decentralized exchange (DEX) project aimed at enabling developers to create their own DEX similar to Uniswap v1. It leverages Scaffold-ETH 2, an open-source toolkit designed to make it easier for developers to build decentralized applications (dApps) on the Ethereum blockchain.
⚙️ Built using NextJS, RainbowKit, Hardhat, Wagmi, Viem, and Typescript.
- ✅ Contract Hot Reload: Your frontend auto-adapts to your smart contract as you edit it.
- 🪝 Custom hooks: Collection of React hooks wrapper around wagmi to simplify interactions with smart contracts with typescript autocompletion.
- 🧱 Components: Collection of common web3 components to quickly build your frontend.
- 🔥 Burner Wallet & Local Faucet: Quickly test your application with a burner wallet and local faucet.
- 🔐 Integration with Wallet Providers: Connect to different wallet providers and interact with the Ethereum network.
Before you begin, you need to install the following tools:
- Node (>= v18.17)
- Yarn (v1 or v2+)
- Git
To get started with Scaffold-ETH 2, follow the steps below:
- Clone this repo & install dependencies
git clone https://github.com/<your-username>/Morphex.git
cd Morphex
yarn install
- Run a local network in the first terminal:
yarn chain
This command starts a local Ethereum network using Hardhat. The network runs on your local machine and can be used for testing and development. You can customize the network configuration in hardhat.config.ts.
- On a second terminal, deploy the test contract:
yarn deploy
This command deploys a test smart contract to the local network. The contract is located in packages/hardhat/contracts and can be modified to suit your needs. The yarn deploy command uses the deploy script located in packages/hardhat/deploy to deploy the contract to the network. You can also customize the deploy script.
- On a third terminal, start your NextJS app:
yarn start
Visit app on: http://localhost:3000. You can interact with the smart contracts using the Debug Contracts page. You can tweak the app config in packages/nextjs/scaffold.config.ts.
What's next:
- Edit smart contracts
Token.solandExchange.solinpackages/hardhat/contracts - Edit the frontend homepage at
packages/nextjs/app/page.tsx. For guidance on routing and configuring pages/layouts checkout the Next.js documentation. - Edit deployment scripts in
packages/hardhat/deploy - Edit smart contract test in:
packages/hardhat/test. To run test useyarn hardhat:test
This project is licensed under the MIT License.
Contributions are welcome! If you have ideas for improvements, new features, or bug fixes, please open an issue or submit a pull request.