[ANN] Microwallet.org - API + free faucet script, start your own faucet!

[Land of Bitcoin]

I would like to announce Microwallet.org. This is a Bitcoin micropayment cache designed for faucets.

Firstly, try out our example faucet which is using the Microwallet API:
http://microfaucet.microwallet.org/

So as a user:
- You don't have to do anything, you can use your Bitcoin address.
- When you receive bitcoins from a faucet, it stored temporarily in your Microwallet.org account (your account created automatically).
- Your stored bitcoins sent out *automatically* to your Bitcoin address as soon as you reach the withdrawal limit which is 0.00005800 BTC.
- You can't deposit or transfer, withdrawals are automatic and you can't stop them.

Information for faucet owners, we have a free API and a free faucet script:
https://www.microwallet.org/api

Basically, you can have your own faucet in minutes.

[1715056170]

1715056170

[Land of Bitcoin]

New version of the free faucet script uploaded with Solve Media captcha support:
http://www.microwallet.org/api

[poordeveloper]

How do faucet owners fund their account, then?

[moderate]

New version of the free faucet script uploaded with Solve Media captcha support:
http://www.microwallet.org/api

Am I misreading it or are you really using http just like that ? The good is that nothing can go wrong because nobody will be using this, or so I hope.

[Land of Bitcoin]

TLS/SSL support added and forced for users.

And for the API calls it gives back an error instead of a lame redirect:
http://www.microwallet.org/api/v1/balance

(Also this will never store more than like 50 USD total balance of all users anyways, it's called cache and micro for a reason.)

[minifrij]

How do faucet owners fund their account, then?

I would also like to know this. I am interested in making a website using this, but I have no idea how to fund my account on it.

[Land of Bitcoin]

How do faucet owners fund their account, then?

I would also like to know this. I am interested in making a website using this, but I have no idea how to fund my account on it.

Faucet owners need to register an account and request API key/API access.

After the API access granted to you, you will have a deposit Bitcoin address which allow you to deposit limited amount to refill your balance. The amount credited automatically after 2 confirmations.

[bmoconno]

WARNING!

There is currently an exploit in the script that is allowing users to get rewards without waiting the set duration (60 minutes in my case).



It appears that this issue has been resolved!  Thanks Land Of Bitcoin!

For those that have the faucet installed, you might want to consider downloading the newest version of the script to protect yourself from the same attack.

[Land of Bitcoin]

For those that have the faucet installed, you might want to consider downloading the newest version of the script to protect yourself from the same attack.

It was resolved for everyone because the API keys were removed which means faucets can't transfer and the owner of the faucet must login and read the message about the new version of the script and then can generate a new API key.

[bmoconno]

I don't know if anyone is interested, but I modified the base script to allow for weighted rewards.

For the creation of the rewards array, I replaced:

Code:

// List of rewards in satoshi, 1 satoshi = 0.00000001 BTC.
     $rewards = array(
          300,
	  200,
	  100,
	  75,
	  50,
	  25,
	  10
     };

With:

Code:

// Each reward entry is in the follwing format: array_fill(0,WEIGHT,REWARD) where WEIGHT is how frequently you want the REWARD to occur.
     $rewards = array_merge(array_fill(0,1,500), array_fill(0,10,200), array_fill(0,100,150), array_fill(0,100,100), array_fill(0,50,75), array_fill(0,50,50), array_fill(0,25,25), array_fill(0,20,10));

For outputting the rewards array, I replaced:
   

Code:

     <?php foreach ($rewards as $reward): ?>
          <h5 class="text-center"><?php echo htmlspecialchars($reward); ?> satoshi</h5>
     <?php endforeach; ?>

With:
          

Code:

     <h5 class="text-center">
          <?php            
		$weightCount = 1;
		$weightArray = array();
		$percentage = 0.0;
		
		foreach ($rewards as $reward) {
			if($rewardAmount != $reward) {
				if($rewardAmount) {
					$percentage = ($weightCount/count($rewards)) * 100;
					echo number_format($percentage, 2, '.', ','), "%<br />\n";
				}
				$rewardAmount = $reward;
							
				echo "$reward satoshi: ";
							
				$weightArray[$reward] = $weightCount;
				$weightCount = 1;
			} else {
				$weightCount++;
				$weightArray[$reward] = $weightCount;
			}
							
		}
		$percentage = ($weightCount/count($rewards)) * 100;
		echo number_format($percentage, 2, '.', ','), "%<br />\n";
          ?>
     </h5>

           
Which outputs the following, using the above example for the rewards array:

     500 satoshi: 0.28%
     200 satoshi: 2.81%
     150 satoshi: 28.09%
     100 satoshi: 28.09%
     75 satoshi: 14.04%
     50 satoshi: 14.04%
     25 satoshi: 7.02%
     10 satoshi: 5.62%

I hope this helps anyone interested in doing the same thing.  There might be a more elegant way to do this, if you think of one, please let me know.

Thanks!

[robattfield]

Hi there,

I came across the script via Google and have downloaded it.

When I'm logged into MicroWallet (to try and get an API key), I get the following message:

Request API key
You must be a registered user. Logout and register.

When I'm not logged in, I see the following message:

Request API key
Register and login first.

From seeing those messages, I take it you're not giving our API keys for people now? I'm really interested in using the script for a new faucet, but can't unless I get the API key.

Cheers .

[poordeveloper]

Hi there,

I came across the script via Google and have downloaded it.

When I'm logged into MicroWallet (to try and get an API key), I get the following message:

Request API key
You must be a registered user. Logout and register.

When I'm not logged in, I see the following message:

Request API key
Register and login first.

From seeing those messages, I take it you're not giving our API keys for people now? I'm really interested in using the script for a new faucet, but can't unless I get the API key.

Cheers .

When you're logged in, are you using a username or just your bitcoin address?

[Land of Bitcoin]

When I'm logged into MicroWallet (to try and get an API key), I get the following message:

Request API key
You must be a registered user. Logout and register.

When I'm not logged in, I see the following message:

Request API key
Register and login first.

From seeing those messages, I take it you're not giving our API keys for people now? I'm really interested in using the script for a new faucet, but can't unless I get the API key.

You must be a registered user to request API key. If you login on the main page with your Bitcoin address without password you are not a registered user. If you login with your username or email and a password you are a registered user. You can register here:
https://www.microwallet.org/index/register

[robattfield]

Thanks for the suggestions etc, I've managed to verify my email and have sent an API request . In terms of usability, I think there should be a navigation to all the important pages (not just 'settings', 'logout', etc), as I got a little lost...

[patriotek]

If I could make a suggestion from a faucet USER's viewpoint:

Make it so that if I have a registered email or username with BTC address, I can EITHER enter the BTC address OR the email/username (or maybe any one of the 3), and it all goes to the same account.

Because of the fact that there are so many badly coded faucets out there that do NOT disclose in great enough detail how their payout is handled until after address is entered, I find that even though I have my BTC addy reg'd with my email, I still end up with 2 separate balances that I need to get up over the minimum payout, and it becomes difficult to track...

I do, eventually, plan on having my own faucet running, and am considering your backend for it.  Until this is fixed however, I'm up in the air...

[robattfield]

With the faucet script, how am I able to display the current faucet balance?

[poordeveloper]

With the faucet script, how am I able to display the current faucet balance?

Open "index.php" and change

Code:

// Display the faucet balance or hide it? true or false
$displayFaucetBalance = false;

To:

Code:

// Display the faucet balance or hide it? true or false
$displayFaucetBalance = true;

[Land of Bitcoin]

Make it so that if I have a registered email or username with BTC address, I can EITHER enter the BTC address OR the email/username (or maybe any one of the 3), and it all goes to the same account.

Well, this is not possible to do.

Bitcoin address is unique across the unregistered users. But it's not unique across the registered users. Verifying the ownership of a Bitcoin address is not possible without user interaction so it can't be unique for the registered users easily. Making it unique without verifiying could lead to problems, for example:
- Someone else registering with your Bitcoin address
- You are registering with your own address, forget the password and then you can't register again using the same Bitcoin address

But this will be solved in the future by displaying your unregistered balance too (if any) in your registered account and it will send the sum of both balances at once.

[robattfield]

With the faucet script, how am I able to display the current faucet balance?

Open "index.php" and change

Code:

// Display the faucet balance or hide it? true or false
$displayFaucetBalance = false;

To:

Code:

// Display the faucet balance or hide it? true or false
$displayFaucetBalance = true;

Oops I should have looked harder before asking - thanks for prompting me though...

[bmoconno]

Land of Bitcoin,

Would it be possible to add a time/date stamp to the deposit section of the Microwallet.org website?

Thanks!