blocktrail / simple-block-explorer
A simple Bitcoin block explorer built on Laravel with Blocktrail API
Installs: 6
Dependents: 0
Suggesters: 0
Security: 0
Stars: 21
Watchers: 8
Forks: 16
Open Issues: 2
Type:project
Requires
- php: ~5.5.0
- ext-bcmath: *
- blocktrail/blocktrail-sdk: 1.2.*
- laravel/framework: 4.2.*
This package is not auto-updated.
Last update: 2024-11-05 16:50:29 UTC
README
This a simple example of a personal Bitcoin wallet, built using the Blocktrail Bitcoin API and Laravel framework.. You can use it to get started on integrating Bitcoin data in your own php applications.
###Requirements On Linux you need to install the following packages:
sudo apt-get install php5-bcmath php5-intl php5-gmp php5-mcrypt
sudo php5enmod mcrypt
On Windows you need to enable the following extensions in your php.ini
if not already done:
extension=php_intl.dll
extension=php_gmp.dll
You will also need composer for package management in the backend.
###Getting Started
#####1. Copy the code
First clone this repository and copy the env.example.php
to a file called env.php
. This contains certain environment specific variables used in the app, including datbase connection settings and API keys.
Now run composer update
to download all the required packages.
#####2. Get your API keys
Go to www.blocktrail.com and sign up for a free API account.
Create an API key, and then add this with the corresponding secret to the env.php
file.
For email functionality we use Mailgun. Sign up for an api key and then also add these to the env.php
file. You can skip this step if you don't want to use the email feature.
(note that the .env.php file has been added to the .gitignore. You should always keep your API details secret)
#####3. Set up the server
run php artisan serve
to quickly setup a nice little local server serve the app. Alternatively you can set up Laravel Homestead, the pre-packaged Vagrant virtual machine that provides you with a quick and easy local web server environment.
#####4. Run the migrations and seed the database
If you've set up homestead then all the database config is ready for you to run migrations and database seeding. If not, then you need to set up your database and add the details to the env.php
. When done you can run php artisan migrate --seed
on homestead/locally to create the database tables and run the table seeders.
#####5. You're good to go
With the server up and running now, simply navigate to http://localhost:8000 (or your homestead server) to see the simple wallet and block explorer at work.
A user and initial wallet has been created through the table seeders. You can log in with email: test@test.com
password: test
.
#####6. Things to know
For webhooks to be created and used your server needs to be accessible via a public domain. When developing you can achieve this easily through the use of a tunnel.
ngrok allows you to easily set up a tunnel between your local environment and an external domain (either controlled by you, or a free subdomain on their domain).
If you set up a tunnel to your local server, go into the env.php
file and set the 'APP_URL'
setting to be the public URL. You'll need to do this before you run the database seeder, so that the initial wallet and webhook is created with the correct url.
Windows Developers
A note for windows developers: you may encounter an issue in php with cURL and SSL certificates, where cURL is unable to verify a server's cert with a CA ((error 60)[http://curl.haxx.se/libcurl/c/libcurl-errors.html]).
Too often the suggested solution is to disable ssl cert verification in cURL, but this completely defeats the point of using SSL. Instead you should take two very simple steps to solve the issue permanently:
- download
cacert.pem
from the curl website. This is a bundle of trusted CA root certs extracted from mozilla.org. Save it in a folder within your php installation. - open your
php.ini
and add/edit the following line (use an absolute path to where you placed the cert bundle):
curl.cainfo = C:\php\certs\cacert.pem
###Need Help? Get in contact with us at devs@blocktrail.com and we'll be happy to help you in any way we can.
A tutorial will be coming soon describing the steps to creating this personal Bitcoin wallet with Laravel.