MultiFaucet - Crypto Coin Dispenser [current version 0.8.3]

[tuaris]

MutiFaucet is an easy to setup crypto currency faucet script that supports many different currencies. It was loosely derived from the Simple Faucet script by Dogenes.  The project is hosted on GitHub and you can download it from https://github.com/tuaris/multifaucet/archive/master.zip.

Fully detailed installation instructions and usage can be found at: http://www.unibia.net/crypto-faucet
GitHub Project: https://github.com/tuaris/multifaucet

Features

• Web installer that makes it easy to setup, just extract and go.
• Automatic locale and translation into any language.
• Support for either Hot or Cold crypto wallets.
• Themes.
• Simple Captcha, re-CAPTCHA, or Solve Media.
• SpammerSlapper Anti-Proxy Abuse.
• Remote Management via JSON-RPC.
• Muti-site capable (premium add-on).

Note: The "SpammerSlapper" feature is not yet 100% effective and could generate false positives which may annoy your users. Additionally, the service is still very much in it's alpha stages and could slow down your faucet while it's scans the visitor's IP address.  You should really only enable this feature after you determine there is abuse. To use the service you will need to get a free API key: http://api.spammerslapper.com.

A live example with the multi-site feature running off a single code base and cold wallet can be seen at: http://faucet.securepayment.cc.

Installation

1) Create a MySQL database and user that will be used for the faucet.
2) Download the archive and extract into any folder or root folder on your web server.  
3) Allow write permissions to the "config" folder
4) Open the website in your browser to start the web based installer.   
5) Delete or rename install.php after the installation is complete.
6) Remove write permissions from configuration files and folder.

If you want to re-configure any settings in the future simply (restore install.php if needed) and re-run the installation script or manually edit the config files.  If you are using the cold wallet it's recommended that you place the data file outside your web directory.

Change Log
Version 0.8.1: Added SpammerSlapper support, various bug fixes/code cleanup and improvements.
Version 0.8.2: Improved stats performance, fixed number formatting bug on total payouts.
Version 0.8.3: Fixed issue with floating point values.

Extra
The FaucetRPC project may be useful for those using the cold storage feature.  
This is a very simple reference implementation of a remote payout script.
https://github.com/tuaris/FaucetRPC

Feel free to report bugs, send new translations, and send some tips:

BTC: 1B6eyXVRPxdEitW5vWrUnzzXUy6o38P9wN
ZET: ZK6kdE5H5q7H6QRNRAuqLF6RrVD4cFbiNX
SUN: SgNyqiKYrQJVquYNKLrSXv5AEi6Xt5KX4k

[tuaris]

Donators of at least 500 ZET, 6500 SUN, or 0.05 BTC will be allowed to remove the "powered by" link.  

[gunawanviram]

can you provide some step by step tutorial? i have tried n http://www.gamingdormitory.com/faucet/index.php it can be funded, is it mandatory to install wallet in the hosting? tq.

[tuaris]

can you provide some step by step tutorial? i have tried n http://www.gamingdormitory.com/faucet/index.php it can be funded, is it mandatory to install wallet in the hosting? tq.

There is a tutorial here:
http://www.unibia.net/crypto-faucet

It's not required to run a wallet on the hosting.  See the link for a simple script that can use a remote wallet.
Let me know if you need something more detailed.

[tuaris]

Version 0.8.2 fixes the issue with number formatting on the "total payouts" field and improves stats performance.

[tuaris]

I published a basic RPC payout and refill script:

https://github.com/tuaris/FaucetRPC

It should be taken as more a reference implementation at this point.  Although it's fully functional.

[bassdude]

i cant seem to get this to connect to my blockchain wallet.

[tuaris]

i cant seem to get this to connect to my blockchain wallet.

Can you provide more details on how your trying to connect?

[bassdude]

i cant seem to get this to connect to my blockchain wallet.

Can you provide more details on how your trying to connect?

hi mate thanks for the response i managed to get it working now i had to forward the rpc ports on my wallet server now i can connect.

but i am having another problem sometimes the payouts have an error and dont payout ([04-Dec-2014 05:12:47 UTC] PHP Notice:  Undefined index: error in /home/cryptohydrant/public_html/modules/faucet/faucet.lib.php on line 168)

im no php coder so i dont no what it means on that line.]

here is my faucet www.cryptohydrant.com

[tuaris]

i cant seem to get this to connect to my blockchain wallet.

Can you provide more details on how your trying to connect?

hi mate thanks for the response i managed to get it working now i had to forward the rpc ports on my wallet server now i can connect.

but i am having another problem sometimes the payouts have an error and dont payout ([04-Dec-2014 05:12:47 UTC] PHP Notice:  Undefined index: error in /home/cryptohydrant/public_html/modules/faucet/faucet.lib.php on line 168)

im no php coder so i don't no what it means on that line.]

here is my faucet www.cryptohydrant.com

I think the problem is that with BTC the payments are so small that they may not get accepted.  I am currently working on some changes to the MultiFaucet that will allow you to 'collect' up to a minimum amount so that you can use this for high value coins such as BTC.

For the moment as a work around you should setup the cold wallet and create a RPC payment script that would use the 'send many' function so that you can send small amounts of BTC to several people at once.   This way, you won't SPAM the blockchain so much and you'll save on transaction fees.

If I have a free moment, I may throw something together. However right now I am fully focused on getting the improvements done to MultiFaucet.  So I can't make any promises.

[bassdude]

ok thanks for the info mate. its a great little script

[AgoraLive]

Nice and great script, allthough I can't seem to get the cold storage solution to work  

Does anybody have a tutorial for this part? I "just" need the actual part where it connects to the DB and Wallet and sends the pending payouts....

Using this script I'm able to send to many, but my php knowledge is not good enough to make the complete the entire situation.

<?php
   require_once 'jsonRPCClient.php';

   $to = array("1WRq2kF7F5b1F3pJx7mi7Prsr2TtEDKaD"=>0.5,
               "13JKRWkSfHEfknoFiAzzpTFBYUzcLhLZVd"=>0.01,
               "1KUZWoMjNJWLPn3UKQ9kRZZQjpZVi6qTC5"=>0.01,
               "1CQUqNHSfhY173KEFNeNC2ZgcMPc9r2bV3"=>0.01,
               "1vHT13Zk2gP9tuoSJ6Gr5J1FDLvwVTWF1"=>0.01
              );


   $Crypto_Coin_Client = new jsonRPCClient('http://username:password@127.0.0.1:8333/');
   $TXid = $Crypto_Coin_Client->sendmany("accountname", $to);

   echo $TXid;
?>

I would love to see something more "precise", as I'm paying more in fee's than the faucet is paying people

[tuaris]

The reference implementation of the RPC payout script has been updated to include a 'grouped' payment feature using the RPC function 'sendmany'.
https://github.com/tuaris/FaucetRPC

Minumim Payout/Transaction Grouping

Transaction grouping allows you send send all pending payments in a single transaction thus allowing you to reduce transaction fees.

When enabled, if the sum of pending payments is less than 'FAUCET_MIN_PAYOUT', payments will not be sent in the current run. Set 'FAUCET_MIN_PAYOUT' to '0' to disable this feature and always use individual transactions.

[hoop]

please,how to setup this script and working with Electrum

[tuaris]

please,how to setup this script and working with Electrum

In theory, you can use this with Electrum without modifications to the MultiFaucet script. 
The only requirement being that you will need to use the cold wallet option.  Then write a new RPC client that is compatible with the Electrum wallet to perform the payouts.

[vhaleandra]

How to set up cold wallet and RPC ?
Because, i not understand cold wallet and RPC about

[tuaris]

How to set up cold wallet and RPC ?
Because, i not understand cold wallet and RPC about

I hope to get proper instructions written up soon.  For now, here is something that may help
https://github.com/tuaris/FaucetRPC

[meadefreling]

I love your multifaucet script please check for more back door otherwise it is really an amazing creations.

[melisande]

Donators of at least 500 ZET, 6500 SUN, or 0.05 BTC will be allowed to remove the "powered by" link.  

The script is very nice and cool but the price to remove powered by is around $20, I feel that is enough to buy the script.

[trickyriky]

MutiFaucet is an easy to setup crypto currency faucet script that supports many different currencies. It was loosely derived from the Simple Faucet script by Dogenes.  The project is hosted on GitHub and you can download it from https://github.com/tuaris/multifaucet/archive/master.zip.

Fully detailed installation instructions and usage can be found at: http://www.unibia.net/crypto-faucet
GitHub Project: https://github.com/tuaris/multifaucet

Features

• Web installer that makes it easy to setup, just extract and go.
• Automatic locale and translation into any language.
• Support for either Hot or Cold crypto wallets.
• Themes.
• Simple Captcha, re-CAPTCHA, or Solve Media.
• SpammerSlapper Anti-Proxy Abuse.
• Remote Management via JSON-RPC.
• Muti-site capable (premium add-on).

Note: The "SpammerSlapper" feature is not yet 100% effective and could generate false positives which may annoy your users. Additionally, the service is still very much in it's alpha stages and could slow down your faucet while it's scans the visitor's IP address.  You should really only enable this feature after you determine there is abuse. To use the service you will need to get a free API key: http://api.spammerslapper.com.

A live example with the multi-site feature running off a single code base and cold wallet can be seen at: http://faucet.securepayment.cc.

Installation

1) Create a MySQL database and user that will be used for the faucet.
2) Download the archive and extract into any folder or root folder on your web server.  
3) Allow write permissions to the "config" folder
4) Open the website in your browser to start the web based installer.   
5) Delete or rename install.php after the installation is complete.
6) Remove write permissions from configuration files and folder.

If you want to re-configure any settings in the future simply (restore install.php if needed) and re-run the installation script or manually edit the config files.  If you are using the cold wallet it's recommended that you place the data file outside your web directory.

Change Log
Version 0.8.1: Added SpammerSlapper support, various bug fixes/code cleanup and improvements.
Version 0.8.2: Improved stats performance, fixed number formatting bug on total payouts.
Version 0.8.3: Fixed issue with floating point values.

Extra
The FaucetRPC project may be useful for those using the cold storage feature.  
This is a very simple reference implementation of a remote payout script.
https://github.com/tuaris/FaucetRPC

Feel free to report bugs, send new translations, and send some tips:

BTC: 1B6eyXVRPxdEitW5vWrUnzzXUy6o38P9wN
ZET: ZK6kdE5H5q7H6QRNRAuqLF6RrVD4cFbiNX
SUN: SgNyqiKYrQJVquYNKLrSXv5AEi6Xt5KX4k

hi trying to setup a cold storage wallet, but im strugling with the install, in a nutshell, where do i get the datafile.dat (is this the wallet.dat?) or do i create my own, if i have to create my own, what content does it require please?