someguy123 / -coin

+Coin is a web interface in PHP for Bitcoin based daemons released under the public domain (UNLICENSE)

What is +Coin?

+Coin is a Web Interface built to run on any PHP web server, it works with any coin based on Bitcoin including Litecoin, Namecoin, and many others.

Bitcointalk Thread

Preview

Licensing

+Coin is released under UNLICENSE (Public Domain), this allows you to use it, edit and claim it as your own, and even sell it or use it commercially. NOTE: Bootstrap is under the Apache v2 license, and the JSON-RPC class used by +Coin is released under the GPL v3. So please be aware of the restrictions if you do want to use +Coin in any way that may break the GPL v3 or Apache v2 licensing.

Installing and configuring

Installation is done by downloading this repo, and placing it on a PHP web server.

WARNING: +Coin does not have its own authentication security system, so I recommend that you secure it with an Apache .htaccess or whatever web server specific security you can use.

You should be able to simply place your RPC Information for the daemon you are using in config.php.

$wallets['wallet 1'] = array(
	"user" => "bitcoinrpc",
	"pass" => "password",
	"host" => "hostname",
	"port" => 8332,
	"protocol" => "https"
);

You can obtain the RPC Information from:

Windows

• %appdata%\Bitcoin\bitcoin.conf
• %appdata%\Litecoin\litecoin.conf
• %appdata%\Namecoin\bitcoin.conf

Linux

• ~/.bitcoin/bitcoin.conf
• ~/.litecoin/litecoin.conf
• ~/.namecoin/bitcoin.conf

OSX

• ~/Library/Application Support/Bitcoin/bitcoin.conf
• ~/Library/Application Support/Litecoin/litecoin.conf
• ~/Library/Application Support/Namecoin/bitcoin.conf

Note: Start the RPC server: open Bitcoin-Qt.app --args -server

DONATIONS

Donations for first developer Someguy123 are accepted:

• BTC: 1SoMGuYknDgyYypJPVVKE2teHBN4HDAh3
• LTC: LSomguyTSwcw3hZKFts4P453sPfn4Y5Jzv

-coin's Issues

500 Code Sent Back From Daemon

With PHP 5.6 and Bitcoin 0.10.0, +Coin is sending incorrect headers to bitcoind resulting in an 500 response. I beleive this may be down to recent changes in PHP 5.6 which means that cookies are being sent with fopen by default now. I could be wrong but I don't know much about the bitcoind RPC spec.

Support for signing massages

I added support for signing text messages with an address from the address book, via page address.php.
Before adding the feature, I reverted the full codebase to commit 7c092ca as later commits introduced bugs both in JS and PHP.
So far all performs well and I found no bugs.

My repo: https://github.com/davidebaldini/-Coin

Debugging Messages and Address Book errors

+Coin needs to be cleaned up a little, e.g. fix some of the random PHP errors on some of the pages. Errors should really be turned off by default.

It also looks like the most recent commit which added address books brought along a bunch of bugs, e.g. the .csv is not automatically created, so the PHP errors cause the addressbook dependent pages to spew errors, messing up the design. Not even sure how functional the address book system is.

Rename Repo

-Coin makes it extremely difficult using standard command line tools on Linux and OSX if you clone the repo directly in to a directory "-Coin". Is there significance to having the dash?

Authentication System

+Coin needs some form of authentication. Maybe start using an SQLite database to store some things such as the address book ( PLEASE, if you're going to add this yourself, USE PDO) , as well as user isolation ( restricting a user to certain accounts/addresses on the daemon ) to help with public facing +Coin's

Random bugs

I obtain frequently errors like :Failed to retrieve data from the daemon, please check your configuration, and ensure that your coin daemon is running:
exception 'Exception' with message 'Unable to connect to http://bitcoinrpc:password@localhost:1234' in /var/www/jsonRPCClient.php:140 Stack trace: #0 /var/www/header.php(19): jsonRPCClient->__call('getinfo', Array) #1 /var/www/header.php(19): jsonRPCClient->getinfo() #2 /var/www/index.php(10): include('/var/www/header...') #3 {main}
The app has working fine some hours with one wallet, and failed when adding a second. Now it dosent work with only the original account.
When I test with curl, the daemons are responding fine.

No option to initiate transactions

Installed today. Works well after manually creating the address book file (#3).
However, the UI offers no options to initiate transactions. Maybe this is because the backend bitcoind is still synching?

Error 500 while reading daemon's response

From jsonRPCClient.php, line 132:

                if ($fp = fopen($this->url, 'r', false, $context)) {                                                                           
                        $response = '';                                                                                                        
                        while($row = fgets($fp)) {                                                                                             
                                $response.= trim($row)."\n";                                                                                   
                        }                                                                                                                      
                        $this->debug && $this->debug.='***** Server response *****'."\n".$response.'***** End of server response *****'."\n";  
                        $response = json_decode($response,true);                                                                               
                } else {                                                                                                                       
                        throw new Exception('Unable to connect to '.$this->url);                                                               
                } 

the exception is thrown by simply invoking $ php5 index.php from the console.
The output I get is;

$ php5  index.php
PHP Warning:  fopen(http://...@localhost:8332): failed to open stream: HTTP request failed! HTTP/1.1 500 Internal Server Error
 in /var/www/pluscoin/jsonRPCClient.php on line 132
<!DOCTYPE html>
<html lang='en'>
<head>
        <meta charset='utf-8'>
... /* etcetera */

The credentials are set and the daemon is running. Fore reference, with curl I get:

$ curl http://...@localhost:8332
{"result":null,"error":{"code":-32700,"message":"Parse error"},"id":null}

The getbalance lines from index.php are modified as suggested here.