SolBurn Engine

What SolBurn Engine Does

SolBurn Engine is a program that automatically destroys (burns) your Solana token on a schedule. Burning tokens permanently removes them from circulation, reducing the total supply over time.

It runs 24/7 in the background on a Linux machine — like a Raspberry Pi or a VPS. Set it up once and it handles everything automatically.

Before You Start

Get everything on this list ready before you begin. It will save you time.

• A Linux machine — Raspberry Pi 4, a VPS ($4/month on DigitalOcean or Vultr), or any Linux server
• Your token's mint address — find it on solscan.io or dexscreener.com
• A Solana wallet keypair file (.json) — dedicated burn wallet, not your main wallet
• At least 0.1 SOL in that wallet to cover fees and Phase 2 cycles
• A free Helius RPC endpoint — sign up at helius.dev
• Access to the private GitHub repo (contact @ABase9719 on X to be added)

Getting your Helius RPC URL

Go to helius.dev, create a free account, click Create API Key, and copy the RPC URL. It looks like:

https://mainnet.helius-rpc.com/?api-key=YOUR-KEY-HERE

Getting your wallet keypair file

If you created your wallet with the Solana CLI, it is at ~/.config/solana/id.json by default. To create a fresh wallet just for burning:

solana-keygen new --outfile ~/burn-wallet.json

Step 01 — Connect to the Machine

# Replace with your machine's IP address
ssh pi@YOUR.PI.IP.ADDRESS

# For a VPS it might look like:
ssh root@192.168.1.100

Step 02 — Install Node.js

node --version

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

# Confirm:
node --version

Step 03 — Clone the Repository

git clone https://github.com/sampsonc37-hub/solburn-engine.git
cd solburn-engine
npm install

Step 04 — Add Your Wallet File

# Replace path and IP with your own
scp ~/burn-wallet.json pi@YOUR.PI.IP.ADDRESS:/home/pi/burn-wallet.json

Step 05 — Configure

cp config.example.json config.json
nano config.json

Step 06 — Test Run

node index.js

[ENGINE] Config loaded
[ENGINE] Token: cHJThV7z...
[ENGINE] Wallet: 4keacT9C...
[ENGINE] Dashboard running at http://localhost:3333
[ENGINE] Phase 1 starting — checking wallet balance...
[ENGINE] Found 500,000 tokens — burning...
[ENGINE] BURNED ✓ TX: pvaoVN6Z...

Step 07 — Run as a Service

sudo nano /etc/systemd/system/solburn.service

[Unit]
Description=SolBurn Engine
After=network.target

[Service]
Type=simple
User=pi
WorkingDirectory=/home/pi/solburn-engine
ExecStart=/usr/bin/node /home/pi/solburn-engine/index.js
Restart=on-failure
RestartSec=10
StandardOutput=journal
StandardError=journal

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable solburn
sudo systemctl start solburn

# Confirm it is running:
sudo systemctl status solburn

The Dashboard

Once the service is running, open a browser and go to:

# From the machine itself:
http://localhost:3333

# From another device on the same network:
http://YOUR.PI.IP.ADDRESS:3333

Run hostname -I on the machine to find its IP address.

The dashboard shows burn count, total tokens burned, SOL spent, recent transactions, and a manual burn trigger.

Phase 2 — Buy and Burn

Phase 2 activates automatically when the wallet runs out of tokens. The engine buys via Jupiter V6, falls back to PumpPortal if needed, waits for settlement, then burns immediately.

Live Stats on Your Website

SolBurn Engine can push burn stats to a Cloudflare Worker so your website shows live burn counts. Add this to config.json:

"cloudflare": {
  "enabled": true,
  "workerUrl": "https://your-worker.workers.dev/burn_stats",
  "pushIntervalMs": 60000
}

Troubleshooting

Quick Reference

# Check if service is running
sudo systemctl status solburn

# View live logs
sudo journalctl -u solburn -f

# Restart the service
sudo systemctl restart solburn

# Stop / start
sudo systemctl stop solburn
sudo systemctl start solburn

# Check wallet SOL balance
solana balance /home/pi/burn-wallet.json