AdventureCoin Explorer

A full-featured, modern blockchain explorer for the AdventureCoin cryptocurrency.

AdventureCoin Explorer

---

🌟 Features

• Real-time blockchain data sync
• Block and transaction views
• Wallet address history and balances
• Rich list of top holders
• Mempool viewer
• Mining/network statistics
• Mobile-friendly UI
• Dark/light theme toggle

---

⚙️ Prerequisites

• Ubuntu 20.04+
• Node.js 18+ (LTS)
• MongoDB 7.0+
• AdventureCoin Daemon (adventurecoind) running with RPC enabled

---

🛠️ Installation Guide

1. Install Node.js using NVM

sudo apt update
sudo apt install curl
curl https://raw.githubusercontent.com/creationix/nvm/master/install.sh | bash
source ~/.profile
nvm install --lts

2. Install MongoDB 7.0

• Install one line at a time

sudo apt-get install gnupg curl

curl -fsSL https://pgp.mongodb.com/server-7.0.asc | sudo gpg -o /usr/share/keyrings/mongodb-server-7.0.gpg --dearmor

echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-7.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

sudo apt-get update

sudo apt-get install -y mongodb-org

3. Clone the Repository

git clone https://github.com/CryptoDevelopmentServices/adventurecoin-block-explorer.git

4. Install Project Dependencies

cd adventurecoin-block-explorer

npm install --legacy-peer-deps

5. Configure Environment Variables

nano .env

• Paste the following in .env: (Replace your_rpc_username and your_rpc_password with your actual daemon credentials.)

  # MongoDB Configuration
  MONGODB_URI=mongodb://localhost:27017/explorerdb
  MONGODB_DB=explorerdb
  
  # AdventureCoin RPC Configuration
  RPC_HOST=localhost
  RPC_PORT=9982
  RPC_USER=your_rpc_username
  RPC_PASS=your_rpc_password
  
  # Sync interval in milliseconds
  SYNC_INTERVAL=60000

6. Sync Blockchain Data

npm install -g pm2

pm2 start scripts/sync-blockchain.js --name adventurecoin-sync

• Check logs / monitor initial sync:

pm2 logs adventurecoin-sync

7. Build and Run the Explorer

npm run build

pm2 start npm --name adventurecoin-explorer -- start

pm2 startup

• Follow the terminal instructions (copy/paste one-time command shown), then:

pm2 save

🌐 Accessing the Explorer

Visit:

http://your_server_ip:3000

🌍 Optional: Nginx Reverse Proxy

1. Install Nginx

sudo apt install nginx

2. Configure Nginx

sudo nano /etc/nginx/sites-available/adventurecoin-explorer

• Paste this config:

server {
    listen 80;
    server_name explorer.yourdomain.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_cache_bypass $http_upgrade;
    }
}

• Enable the site:

sudo ln -s /etc/nginx/sites-available/adventurecoin-explorer /etc/nginx/sites-enabled/

• Test config

sudo nginx -t

• If all is okay, restart Nginx:

sudo systemctl restart nginx

🔐 Optional: Enable HTTPS with Let's Encrypt

1. Install Certbot

sudo apt install certbot python3-certbot-nginx

2. Ensure your domain points to your server DNS with A record.

• See here if you need more information on how to do this.

3. Request SSL certs

sudo certbot --nginx -d explorer.yourdomain.com

🔄 Updating the Explorer

cd adventurecoin-block-explorer
git pull
npm install --legacy-peer-deps
npm run build
pm2 restart all

📄 License

This project is under the MIT License. See the LICENSE file for details.

Support

For support inquiries open an issue on GitHub or contact the adventurecoin team through mail or discord.