eth-dapp-starter

Warning

This starter kit is running on Next 15+, which presumably not working well with Web3 protocols.
Legacy branch of nextjs-14 will be released soon.

Getting Started 🚀

Important

Install Bun before proceeding.
curl -fsSL https://bun.sh/install | bash

1. bun install to install all necessary dependencies.

2. Start the development server for Next.js:

   bun run dev

3. In a new terminal, compile and test the smart contracts:

   bun run test

Structure 🌴

.
├── contracts                    # Solidity smart contracts
│   └── SampleContract.sol
├── next-app
│   ├── public                     # Public assets
│   └── src                        # Next.js source
├── scripts
│   └── contracts.ts               # List of contracts to deploy
└── test                         # Contract tests using Hardhat
    └── SampleContractTest.ts

Deployment 🌐

1. Make a copy of .env.example and rename it to .env.

2. Fill in the necessary environment variables.

   For local deployment, not all fields are required.

3. Specify the contracts to deploy in scripts/contracts.ts.

Warning

Ensure your .env file is configured correctly. Do not commit sensitive information.

Deploying to Testnet

1. bun run deploy to deploy on testnet.

Deploying Locally

1. Start a local node with bun run local.

2. bun run deploy:local to deploy locally.

Additional Resources 📃

• Bun Documentation
• Hardhat Documentation