nerodev
/
wownero-explorer
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Chain explorer for looking up transactions and info for Wownero
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
32 Commits
1 Branch
0 Tags
90 KiB
CSS 75%
Rust 23.5%
Dockerfile 1.5%
 
 
 
master
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'master'
${ noResults }
Go to file
lza_menace d9b7629931 clean up code, add prove sending page and form 4 years ago
src clean up code, add prove sending page and form 4 years ago
static/css clean up code, add prove sending page and form 4 years ago
templates clean up code, add prove sending page and form 4 years ago
.dockerignore adding the docker bits to get ready to serve it for real 5 years ago
.gitignore clean up code, add prove sending page and form 4 years ago
Cargo.lock bump rocket to latest 4 years ago
Cargo.toml bump rocket to latest 4 years ago
Dockerfile update final atomic unit in templates and upgrade dockerfile os 4 years ago
README.md fix minor typo in readme 5 years ago
docker-compose.example.yml adding the docker bits to get ready to serve it for real 5 years ago
docker-compose.yml updating compose file with full traefik config for dev 5 years ago
dummy.rs streamlining container image builds with hacky dummy file 5 years ago

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