An open API service indexing awesome lists of open source software.

https://github.com/smilewithkhushi/token-tap

Tap that button. Get free tokens, straight to your wallet. Built on Base - Ethereum's L2.
https://github.com/smilewithkhushi/token-tap

base decentralized-application ethereum faucets hardhat nextjs onchain-kit shadcn smart-contracts solidity tailwind-css

Last synced: 2 months ago
JSON representation

Tap that button. Get free tokens, straight to your wallet. Built on Base - Ethereum's L2.

Awesome Lists containing this project

README

          

# Token Tap 🚰

**One click and get tokens in your wallet**

A streamlined Web3 application built on Base that enables users to claim tokens with a single click directly to their wallet.

## 🌟 Features

- **One-Click Token Claims**: Simplified token distribution process
- **Base Network Integration**: Built on Coinbase's Base L2 for fast and cheap transactions
- **Wallet Connection**: Seamless integration with popular Web3 wallets
- **User-Friendly Interface**: Clean and intuitive design for all users
- **Gas Optimized**: Efficient smart contracts to minimize transaction costs

## 🚀 Getting Started

### Prerequisites

- Web3 wallet (MetaMask, Coinbase Wallet, etc.)
- Base network added to your wallet
- Some ETH on Base for gas fees

## 🖼️ Screenshots

| Here is your | Preview |
|------------|-------------|
| **Smart Contract Deployment** | **dApp Overview** |
| ![Deployed Smart Contract](./screenshots/1-sc-deployed.png) | ![dApp Overview](./screenshots/2-frontend.png) |
| **Claim Faucet** | **Confirm Transaction** |
| ![Claim Faucet](./screenshots/3-claim-faucet.png) | ![Confirm Transaction](./screenshots/4-confirm-transaction.png) |
| **Success - Faucet Claimed** | **Transaction Successful** |
| ![Claimed Faucet](./screenshots/5-faucet-success.png) | ![Transaction Successful](./screenshots/5-trans-success.png) |
| **Transaction on BaseScan** | |
| ![BaseScan Activity](./screenshots/6-sepolia-basescan.png) | |

## 🔧 Technology Stack

- **Frontend**: Next.js
- **Blockchain**: Base (Ethereum L2)
- **Smart Contracts**: Solidity, Hardhat
- **Web3 Integration**: Mini-kit
- **Styling**: Tailwind CSS, Shadcn

## 📱 Usage

1. **Connect Wallet**: Click "Connect Wallet" and select your preferred wallet
2. **Switch to Base**: Ensure you're connected to the Base network
3. **Claim Tokens**: Click "Claim Tokens" to receive tokens instantly
4. **View Balance**: Check your wallet to see the received tokens

## 🌐 Links

- **Base Scan**: [Faucet Claim - Transaction Successful](https://sepolia.basescan.org/tx/0x6e1fd1400c235e13d413c1043be8f6217269a4eb2ac61e7985b7082336e03399)

### Installation

1. Clone the repository
```bash
git clone https://github.com/smilewithkhushi/token-tap.git
cd token-tap
```

2. Install dependencies
```bash
npm install
```

3. Set up environment variables
```bash
cp .env.example .env
# Add your configuration
```

4. Run the development server
```bash
npm run dev
```

## 🤝 Contributing

1. Fork the repository
2. Create your feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

---

**Built with ❤️ on Base**