specd-status

This is a small PHP application designed to display status and information from the SPEC node daemon.

Table of Contents

1. Requirements
2. Getting Started
3. Contributing
4. Advanced Configuration Options
5. Licensing

Requirements

To run the application, you will need:

• A SPEC node with RPC enabled.
• A web-server with PHP installed.
• The PHP curl module - this is used to make RPC calls to the SPEC daemon.

PHP Support

This application has been tested with PHP 5.4, 5.5 and 5.6, as well as HHVM and Nightly PHP builds.

Getting Started

Simply download the contents of the above repo to your web directory of choice (Must be a public directory in order for others to veiw)

Copy/rename php/config.sample.php to php/config.php and configure your node's RPC credentials. The application will connect to your node via RPC and report statistics.

Change the contents of php/config.php to match your server ip/url and settings found in ~/.spec/spec.conf (If you did not use the 1 Click Node setup, you will need to make sure you have a specd / [coin_name]d, php5 & cURL installed)

To use Google Analytics, simply create a file called google_analytics.inc inside the php directory and paste your GA code within.

1 Click SPEC Node (Optional)

(Optional however a working [coin]d is required in order for the front end to work properly)

From SSH (Tested on Ubuntu 14.x)

wget -O specNode.sh https://raw.githubusercontent.com/SpecDevelopment/spec-wallet/master/AutoNode.sh ; sudo bash specNode.sh

The above ssh command was tested on an Ubuntu 14.10 machine. The AutoNode.sh script is meant to update the machine and install everything needed to run a specd from scratch, including auto start on reboot etc.

Also included in AutoNode.sh is cURL and php5 in anticipation of the user installing our optional "node status" frontend. (https://github.com/SpecDevelopment/specd-status)

Not guaranteed to work for your server setup.

Contributing

Contributions and testing reports are extremely welcome. Please submit a pull request or issue on GitHub, and make sure that your code conforms to the PEAR PHP coding standards (Travis CI will test your pull request when it's sent).

I accept tips via ChangeTip in any currency - if you would like to buy me a beer, please do!

Advanced Options

The config.php file also contains lots of options to control how the application behaves:

• debug (Boolean, default: false) - Enables debug mode. This prints the full $data array into the page's HTML output inside a comment.
• rpc_user(String, default: rpcuser) - Username for RPC calls.
• rpc_pass (String, default: rpcpass) - Password for RPC calls.
• rpc_host (String, default: localhost) - Which RPC host to connect to.
• rpc_port (String, default: 4320) - Port to use for the RPC connection.
• rpc_ssl (Boolean, default: false) - Should we use SSL for the RPC connection?
• rpc_ssl_ca (String, default: null) - The SSL CA chain file.
• cache_file (String, default: /tmp/bitcoind-status.cache) - File location to write to for cache.
• max_cache_time (Int, default: 300) - Expiry time for cache.
• nocache_whitelist (Array, default: array('127.0.0.1')) - The IP addresses that are allowed to bypass or clear cache.
• admin_email (String, default: admin@domain.net) - Email address to display on error
• display_donation_text (Boolean, default: true) - Display text to encourage donations.
• donation_address (String, default: not_set) - Bitcoin address to use for donations to support the node.
• donation_amount (String, default: 0.001) - Donation amount - not currently implemented.
• use_bitcoind_ip (Boolean, default: true) - Use the Bitcoin daemon to get the public IP, instead of $_SERVER
• intro_text (String, default: not_set) - Introductory text to display above the node statistics.
• display_peer_info (Boolean, default: false) - Display connected peers.
• display_peer_port (Boolean, default: false) - Display remote peer's port.
• geolocate_peer_ip (Boolean: default: false) - Attempt to Geolocate peer's IP addresses
• hide_dark_peers (Boolean: default: true) - Hides peers connected from "Dark" networks.
• display_free_disk_space (Boolean, default: false) - Displayfree disk space.
• display_ip (Boolean, default: false) - Display the server IP address.
• display_ip_location (Boolean, default: false) - Attempt geolocation of node IP.
• display_testnet (Boolean, default: false) - Display testnet status.
• display_version (Boolean, default: true) - Display node bitcoind version.
• display_github_ribbon (Boolean, default: true) - Displays the 'Fork me on GitHub vanity ribbon.
• display_bitcoind_uptime (Boolean, default: true) - Displays the uptime of the Bitcoin daemon.
• bitcoind_process_name (String, default specd) - Name to use when getting the bitcoin daemon process' uptime.
• display_max_height (Boolean, default: false) - Get the network's max height from the bitnodes.io API via CURL. Displays the node height as a percentage of network height.
• use_cache (Boolean, default: true) - Enable cache.
• date_format (String, default: 'H:i:s T, j F Y') - PHP date fuction format to use when outputting dates.
• stylesheet (String, default: v2-light.css) - CSS Stylesheet to use.

Important Note

• Do not disable cache unless you either have an alternative mechanism or your node is protected from potential DDoS attacks.

Licensing

• Copyright (C) 2015 Craig Watson
• Distributed under the terms of the Apache License v2.0 - see LICENSE file for details.
• EasyBitcoin-PHP library is reproduced under the terms of the MIT licence and is used from commit 670414e.