Bitcoin Forum

Bitcoin => Project Development => Topic started by: tuaris on April 23, 2014, 05:13:24 AM



Title: MultiFaucet - Crypto Coin Dispenser [current version 0.8.3]
Post by: tuaris on April 23, 2014, 05:13:24 AM
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 (http://doges.org/index.php?topic=4847.0).  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


Title: Re: MultiFaucet - Crypto Coin Dispenser (PHP script)
Post by: tuaris on April 23, 2014, 05:13:40 AM
Donators of at least 500 ZET, 6500 SUN, or 0.05 BTC will be allowed to remove the "powered by" link.  


Title: Re: MultiFaucet - Crypto Coin Dispenser [UPDATED version 0.8.1]
Post by: gunawanviram on May 28, 2014, 08:44:29 PM
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.


Title: Re: MultiFaucet - Crypto Coin Dispenser [UPDATED version 0.8.1]
Post by: tuaris on May 29, 2014, 02:17:56 AM
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.


Title: Re: MultiFaucet - Crypto Coin Dispenser [UPDATED version 0.8.2]
Post by: tuaris on June 17, 2014, 09:41:37 PM
Version 0.8.2 fixes the issue with number formatting on the "total payouts" field and improves stats performance.


Title: Re: MultiFaucet - Crypto Coin Dispenser [UPDATED version 0.8.2]
Post by: tuaris on July 04, 2014, 06:07:41 AM
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.


Title: Re: MultiFaucet - Crypto Coin Dispenser [UPDATED version 0.8.2]
Post by: bassdude on November 22, 2014, 01:01:18 AM
i cant seem to get this to connect to my blockchain wallet.


Title: Re: MultiFaucet - Crypto Coin Dispenser [UPDATED version 0.8.2]
Post by: tuaris on November 22, 2014, 09:04:14 PM
i cant seem to get this to connect to my blockchain wallet.

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


Title: Re: MultiFaucet - Crypto Coin Dispenser [UPDATED version 0.8.2]
Post by: bassdude on December 04, 2014, 05:56:18 AM
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


Title: Re: MultiFaucet - Crypto Coin Dispenser [UPDATED version 0.8.2]
Post by: tuaris on December 20, 2014, 10:20:34 PM
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.


Title: Re: MultiFaucet - Crypto Coin Dispenser [UPDATED version 0.8.2]
Post by: bassdude on December 22, 2014, 07:25:11 AM
ok thanks for the info mate. its a great little script


Title: Re: MultiFaucet - Crypto Coin Dispenser [UPDATED version 0.8.2]
Post by: AgoraLive on December 25, 2014, 08:16:52 PM
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 :(


Title: Re: MultiFaucet - Crypto Coin Dispenser [UPDATED version 0.8.2]
Post by: tuaris on December 26, 2014, 01:57:13 AM
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

Quote
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.


Title: Re: MultiFaucet - Crypto Coin Dispenser [current version 0.8.3]
Post by: hoop on February 11, 2015, 07:10:06 PM
please,how to setup this script and working with Electrum


Title: Re: MultiFaucet - Crypto Coin Dispenser [current version 0.8.3]
Post by: tuaris on February 12, 2015, 02:30:24 AM
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.


Title: Re: MultiFaucet - Crypto Coin Dispenser [current version 0.8.3]
Post by: vhaleandra on July 07, 2015, 12:40:36 PM
How to set up cold wallet and RPC ?
Because, i not understand cold wallet and RPC about


Title: Re: MultiFaucet - Crypto Coin Dispenser [current version 0.8.3]
Post by: tuaris on July 08, 2015, 07:25:54 PM
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


Title: Re: MultiFaucet - Crypto Coin Dispenser [current version 0.8.3]
Post by: meadefreling on July 14, 2015, 12:52:51 PM
I love your multifaucet script please check for more back door otherwise it is really an amazing creations.


Title: Re: MultiFaucet - Crypto Coin Dispenser (PHP script)
Post by: melisande on July 14, 2015, 03:06:23 PM
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.


Title: Re: MultiFaucet - Crypto Coin Dispenser [current version 0.8.3]
Post by: trickyriky on December 31, 2015, 01:55:04 PM
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 (http://doges.org/index.php?topic=4847.0).  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?