Skip to content

Web status page for Litecoin (and similar) full nodes

License

Notifications You must be signed in to change notification settings

xblau/node-interface

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

43 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Litecoin Node Interface

This is a basic web status page for Litecoin1 full nodes. It's not pretty, but it works. If you want to see how it looks, a demo is available here.

You can use it to check thing like:

  • Node uptime (but only on very recent versions of Litecoin Core).
  • Sync status (by looking at the number of blocks/headers).
  • Network usage: How much data your node has sent/received (since daemon start).
  • Connected peers: Info about inbound ant outbound connections to your node.

If you have any problems or suggestions, feel free to open an issue or pull request.

1: While I did it with Litecoin in mind, it should work with bitcoin or any of its forks without problems.

I think this is secure, but that doesn't mean there's not a security hole somewhere. If you find one, please contact me.

Before doing anything, consider reviewing the source code (or ask someone you trust to do it) to check that it's not doing anything malicious.

There's not any type of authentication mechanism built in. If you want to restrict access, use the features provided by your web server to do so.

WARNING: if your full node has a wallet enabled, this software has access to it. It no longer prevents you to run it if a wallet is found, but please do not use this if your node has a non-zero balance.

To run this you need a web server (like Apache) with a recent version of PHP with curl support. The web server can be installed on a different machine, but you will need to allow RPC calls from it.

On Debian and derivates (Ubuntu, etc) you can install everything with

# apt-get install apache2 libapache2-mod-php php-curl

For other distros, there are a lot of awesome tutorials online you can check.

First thing you need to do is add an username/password to the node configuration. Add the following lines to your litecoin.conf file:

rpcuser=someusername
rpcpassword=somethingsecret

Once you do it, restart the daemon:

$ litecoin-cli stop
$ litecoind -daemon

After that, clone this repository in an empty, publicly accessible directory:

$ git clone https://github.com/xblau/node-interface.git .

Now, copy (not rename) the example config file to config.php:

$ cp config-example.php config.php

Using your favorite editor, edit config.php and replace the default username and password with the ones specified on your config file.

After you do that, open your browser and go to the webpage. If your node is running, everything should be working.

Simply run git pull. This should get any new commits and apply them to your local copy.

This project is free software, licensed under the terms of the MIT License. See the LICENSE file on this repository or opensource.org/licenses/mit.

If you liked or found this useful, starring this repo on GitHub or sending an email (even if it's just a "Hey, I'm using your project") helps a lot! Also, in case you want to send a tip: LXBLauKyugeQGY2m8JZSMQJzc9rR1yNXgR.

About

Web status page for Litecoin (and similar) full nodes

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published