Skip to content

DevAryanPro/ZER-Faucet

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 

Repository files navigation

ZER Faucet Ƶ

A complete web-based cryptocurrency faucet system built with PHP and MySQL that allows users to claim free ZER tokens at regular intervals. The system features a modern, responsive design with a comprehensive admin panel for complete management.

PHP MySQL License

✨ Features

🌐 User Features

  • 🆓 Free Token Claims - Claim 0.001 ZER tokens every 24 hours
  • 🔐 No Registration - Direct claiming using wallet addresses
  • 📊 Real-time Statistics - Live stats showing total claims and distributions
  • 📱 Responsive Design - Works perfectly on all devices
  • 🔒 Secure Transactions - Integrated with ZeroChain API
  • 👛 Wallet Integration - Direct links to create ZER wallets

👨‍💼 Admin Features

  • 🎯 Complete Dashboard - Real-time statistics and overview
  • 📋 Claim Management - View and monitor all user claims
  • 🚫 Address Management - Block/unblock wallet addresses
  • ⚙️ System Settings - Configure brand, amounts, and timing
  • 🔑 API Configuration - Set up private keys and API keys
  • 🛠️ Maintenance Mode - Temporarily disable the faucet

🚀 Quick Start

Prerequisites

  • PHP 7.4 or higher
  • MySQL 5.7+ or MariaDB
  • cURL extension enabled
  • Web server (Apache/Nginx)

Installation Steps

Upload Files 📁

Upload all files to your web server

Run Installer 🛠️

Navigate to: yourdomain.com/install.php

Configure Settings ⚙️

  • Enter database credentials
  • Set up admin account
  • Configure basic settings

API Setup 🔑

  • Get API key from ZeroChain
  • Configure in admin panel → Faucet Settings

Start Distributing 🎉

Your faucet is ready to use!

⚠️ Security Note: Delete install.php for security

📁 File Structure

ZER-Faucet/
├── 📄 index.php              # Main faucet page
├── ⚙️ config.php             # Database configuration
├── 🛠️ install.php            # Installation script
├── 👨‍💼 admin/
│   ├── 🔐 login.php          # Admin login
│   ├── 🎯 dashboard.php      # Admin panel
│   └── 🚪 logout.php         # Logout script
├── 📊 database/
│   └── 🗃️ zer_faucet.sql     # Database schema
└── 📚 README.md              # This file

🎯 Usage

For Users 👥

  1. Visit the faucet website
  2. Enter your ZER wallet address (starts with t1)
  3. Click "Claim" to receive 0.001 ZER
  4. Return every 24 hours for more tokens

For Admins 👨‍💼

  1. Access /admin/login.php
  2. Use your admin credentials
  3. Manage claims, settings, and blocked addresses
  4. Monitor statistics and performance

🔧 Configuration

Basic Settings

  • Brand Name: Customize your faucet name
  • Claim Amount: Set ZER amount per claim (default: 0.001)
  • Claim Duration: Time between claims (default: 1440 minutes/24 hours)

API Settings

  • Private Key: Your ZER wallet private key
  • API Key: From ZeroChain API
  • Transaction Fee: Network fee per transaction
  • Memo: Transaction description

🐛 Troubleshooting

Common Issues

  • Database Connection Error: Check credentials in config.php
  • API Not Working: Verify private key and API key
  • Installation Fails: Check PHP version and extensions

Get Help

🤝 Contributing

We welcome contributions! 🎉

How to Contribute

  1. 🍴 Fork the repository
  2. 🌿 Create a feature branch
  3. 💻 Make your changes
  4. ✅ Test thoroughly
  5. 🔀 Submit a pull request

Areas for Contribution

  • 🔧 Bug fixes
  • 🎨 UI/UX improvements
  • 🚀 New features
  • 📚 Documentation
  • 🔒 Security enhancements

📄 License

This project is FREE TO USE 🎉 under an open-source license. You can:

  • ✅ Use commercially
  • ✅ Modify and distribute
  • ✅ Use privately
  • ✅ Use without attribution

🔒 Security

  • 🔐 Passwords are securely hashed
  • 🛡️ SQL injection protected
  • 🔒 API keys stored securely
  • 🚫 Input validation on all forms

📊 Database Schema

-- Main tables include:
- settings: Faucet configuration
- admin_users: Admin accounts
- claims: User claim history
- blocked_addresses: Blocked wallets
- visitors: Site traffic analytics

🌐 API Integration

The faucet integrates with ZeroChain API:

https://zerochain.info/api/rawtxbuild/pkey/toaddress/amount/fees/send/api-key

📞 Support

🚀 Future Enhancements

  • 🔔 Email notifications
  • 📱 Mobile app
  • 🌐 Multi-language support
  • 💰 Multiple cryptocurrency support
  • 📈 Advanced analytics
  • 🔐 Two-factor authentication

⭐ Show Your Support

If you find this project useful, please give it a star! ⭐

📝 Changelog

v1.0.0

  • ✅ Initial release
  • ✅ Complete faucet system
  • ✅ Admin panel
  • ✅ ZeroChain API integration

Built with ❤️ for the ZER community

💙 Happy fauceting! 💙

About

ZER Faucet is a complete web-based cryptocurrency faucet system built with PHP and MySQL that allows users to claim free ZER tokens at regular intervals. The system features a modern, responsive design with a comprehensive admin panel for complete management.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages