d0s3t3ch
/
wownero-explorer
mirror of https://git.wownero.com/lza_menace/wownero-explorer.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Web interface for searching the Wownero blockchain.
32 Commits 1 Branch 0 Tags 88 KiB
CSS 75%
Rust 23.5%
Dockerfile 1.5%
Go to file
lza_menace d9b7629931 clean up code, add prove sending page and form 2021-06-12 10:13:05 -07:00
src clean up code, add prove sending page and form 2021-06-12 10:13:05 -07:00
static/css clean up code, add prove sending page and form 2021-06-12 10:13:05 -07:00
templates clean up code, add prove sending page and form 2021-06-12 10:13:05 -07:00
.dockerignore adding the docker bits to get ready to serve it for real 2020-07-03 01:32:18 -07:00
.gitignore clean up code, add prove sending page and form 2021-06-12 10:13:05 -07:00
Cargo.lock bump rocket to latest 2021-06-11 22:35:17 -07:00
Cargo.toml bump rocket to latest 2021-06-11 22:35:17 -07:00
Dockerfile update final atomic unit in templates and upgrade dockerfile os 2021-04-01 13:54:56 -07:00
README.md fix minor typo in readme 2020-07-03 21:32:10 -07:00
docker-compose.example.yml adding the docker bits to get ready to serve it for real 2020-07-03 01:32:18 -07:00
docker-compose.yml updating compose file with full traefik config for dev 2020-07-03 21:29:38 -07:00
dummy.rs streamlining container image builds with hacky dummy file 2020-07-03 21:00:30 -07:00

README.md

Wownero Explorer

A simple web interface for searching the Wownero blockchain.

Quick-Start

Docker

The fastest way to get it up and running to test it locally is to use the pre-made Docker container:

export DAEMON_URI=http://so.wow.candy.surf:34568
docker run -d \
    --name wownero-explorer \
    --rm \
    -p 80:8000 \
    -e DAEMON_URI=$DAEMON_URI \
    lalanza808/wownero-explorer:latest

You could also just use docker-compose, though it will download a reverse proxy image:

export DAEMON_URI=http://so.wow.candy.surf:34568
docker-compose up -d

Navigate to http://localhost/ to browse the explorer.

Rust

Alternatively, if you'd like to build/run using native Rust tools, follow these steps:

  1. Install Rust: https://www.rust-lang.org/tools/install
  2. Clone this repo: git clone https://git.wownero.com/lza_menace/wownero-explorer && cd wownero-explorer
  3. Pin the nightly version of rust to the local directory: rustup override set nightly
  4. Pick a Wownero node if you don't have one and apply the DAEMON_URI environment variable: export DAEMON_URI=http://so.wow.candy.surf:34568
  5. Run the application: cargo run
  6. Navigate to http://localhost:8000/

Full Installation

I'm using Traefik as a reverse proxy in order to handle automatic TLS certification with Let's Encrypt and to avoid manage Nginx configs. If you want to run the full installation you will need a registered domain and control of DNS records.

I don't feel like paying for a cluster for this simple app so I'm using docker-compose on a single box that I can recreate easily and often to avoid config drift.

  1. Create new file, docker-compose.prod.yml as a copy of docker-compose.yml
  2. Uncomment labels under wownero-explorer service
  3. Change labels to match external DNS name
  4. Set ${ACME_EMAIL} either as hardcoded string or pass as environment variable
  5. Run docker-compose -f docker-compose.prod.yml up -d

Questions?

Ask around in IRC: https://webchat.freenode.net/?room=#wownero