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.
21 Commits 1 Branch 0 Tags 88 KiB
CSS 75%
Rust 23.5%
Dockerfile 1.5%
Go to file
lza_menace 6420022616 fix minor typo in readme 2020-07-03 21:32:10 -07:00
src normalized images and flow on pages 2020-07-02 23:58:34 -07:00
static/css fixing tx pool/index and tightening up page content 2020-07-02 21:52:21 -07:00
templates fix tx fee on transaction page 2020-07-03 09:03:13 -07:00
.dockerignore adding the docker bits to get ready to serve it for real 2020-07-03 01:32:18 -07:00
.gitignore ignore data dir for traefik tls state 2020-07-03 21:30:43 -07:00
Cargo.lock rust and project meta 2020-07-01 01:10:12 -07:00
Cargo.toml streamlining container image builds with hacky dummy file 2020-07-03 21:00:30 -07:00
Dockerfile use a default cmd to start web server 2020-07-03 21:26:25 -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