NotificationsYou must be signed in to change notification settings
Fork2
Star12

BeamPay is a self-hosted payment gateway for seamless Beam blockchain transactions. It provides:

You must be signed in to change notification settings

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 23 Commits
assets		assets
dapps		dapps
lib		lib
templates		templates
.env.example		.env.example
.gitignore		.gitignore
README.md		README.md
admin_panel.py		admin_panel.py
api.py		api.py
auth.py		auth.py
ca_assets_updates.json		ca_assets_updates.json
config.py		config.py
db.py		db.py
process_payments.py		process_payments.py
requirements.txt		requirements.txt
telegram_bot.py		telegram_bot.py
webhook_worker.py		webhook_worker.py

Repository files navigation

🚀 BeamPay - Simplified Payments for Users & Businesses

BeamPay is a self-hosted payment gateway for seamlessBeam blockchain transactions. It provides:

Automated balance tracking by scanning the blockchain.
Secure API for merchant integrations.
Webhook notifications for deposits & withdrawals.
Telegram monitoring (if enabled).
Admin Dashboard for transaction tracking.
Auto-recovery of services using systems.

Project Structure

BeamPay/│── api.py# FastAPI service for managing addresses, deposits, withdrawals│── process_payments.py# Background job for tracking blockchain transactions│── lib/beam.py# BEAM API Wrapper│── config.py# Configuration settings (loads .env variables)│── db.py# MongoDB connection│── .env.example# Example environment file│── requirements.txt# Python dependencies│── README.md# Project documentation

🚀 Project Progress & TODO List

✅Completed Tasks

✅Core Payment Processing - Track transactions, update balances
✅API Development - Secure FastAPI for deposits, withdrawals
✅Database Sync - Sync addresses, transactions, and assets in MongoDB
✅Webhook Integration - Notify services of deposits & withdrawals
✅Telegram Alerts - Notify users & admins about transfers
✅Admin Dashboard - Statistics & balance verification

🔄In Progress

🚧Transaction History - User-friendly logs & filters
🚧Security Enhancements - API Key Authentication & IP Whitelisting

🛠️ Upcoming Features

📝TBA

🛠️Installation Guide

1️⃣ Install Dependencies

🔹 Install MongoDB

sudo apt updatesudo apt install -y mongodbsudo systemctlenable mongod --now

Check if MongoDB is running:

sudo systemctl status mongod

🔹 Install Python & Virtual Environment

sudo apt install -y python3 python3-pip python3-venv

Create a virtual environment & activate it

python3 -m venv venvsource venv/bin/activate

Install required Python packages

pip install -r requirements.txt

🔧Configuration

2️⃣ Setup Environment Variables

Copy the.env.example file and update the values:

cp .env.example .envnano .env

.env Configuration

MONGO_URI=mongodb://localhost:27017/beampayBEAM_API_RPC=http://127.0.0.1:10000TELEGRAM_BOT_TOKEN=your_bot_token_hereWEBHOOK_URL=https://yourserver.com/webhook

🚀Running BeamPay Services

3️⃣ Start API & Payment Processor

Using Systemd (Recommended)

Create a systemd service for API

sudo nano /etc/systemd/system/beampay-api.service

Add the following:

[Unit]Description=BeamPay API ServiceAfter=network.target[Service]User=rootWorkingDirectory=/path/to/BeamPayExecStart=/path/to/BeamPay/venv/bin/uvicorn api:app --host 0.0.0.0 --port 8000Restart=on-failureRestartSec=5[Install]WantedBy=multi-user.target

Create a systemd service for Payment Scanner

sudo nano /etc/systemd/system/beampay-payments.service

Add the following:

[Unit]Description=BeamPay Payment ProcessorAfter=network.target[Service]User=rootWorkingDirectory=/path/to/BeamPayExecStart=/path/to/BeamPay/venv/bin/python process_payments.pyRestart=on-failureRestartSec=5[Install]WantedBy=multi-user.target

Enable & Start Services

sudo systemctl daemon-reloadsudo systemctlenable beampay-apisudo systemctlenable beampay-paymentssudo systemctl start beampay-apisudo systemctl start beampay-payments

📡Using the API

Get deposit address

curl -X POST http://127.0.0.1:8000/create_wallet

Withdraw funds

curl -X POST http://127.0.0.1:8000/withdraw      -H"Content-Type: application/json"      -d'{"from_address": "your_wallet", "to_address": "recipient_wallet", "asset_id": "0", "amount": 1000000}'

Get balances

curl -X GET http://127.0.0.1:8000/balances?address=your_wallet

📊Admin Dashboard

4️⃣ Access the Web UI

Openhttp://127.0.0.1:8000/dashboard
Monitortransactions, balances, and users.
Track mismatched balances between the blockchain & database.

📲Telegram Notifications

Enable Telegram monitoring in.env

TELEGRAM_BOT_TOKEN=your_bot_token_here

Monitored Events✅ Deposit received
✅ Withdrawal request
✅ Internal transfers

🎯Features

✔️Secure API authentication (API keys, IP whitelisting)
✔️Webhook notifications for deposits/withdrawals
✔️Automatic address & transaction syncing
✔️Admin Panel to monitor balances
✔️Auto-restarting services using systemd

Server Security

Disable SSH Password Authentication

For security reasons, it's recommended to disable SSH login using passwords and allow only key-based authentication.

Step 1: Get Your Public Key

Run the following command on yourlocal PC (the one that should have access to the server):

cat~/.ssh/id_rsa.pub

Copy the output, which is your public SSH key.

Step 2: Add the Key to the Server

nano~/.ssh/authorized_keys

Paste the copied public key into the file. Save and exit by pressingCTRL + X, thenY, andENTER.

Step 3: Verify SSH Key Login

Open a new terminal on your PC and try connecting to the server:

ssh root@YOUR_SERVER_IP

If you can connect without entering a password, the setup is correct.

Step 4: Disable Password Authentication

Now, disable password authentication for SSH to enhance security.

Open the SSH configuration file:

sudo nano /etc/ssh/sshd_config

Find the following line:

PasswordAuthentication Yes

Change it to:

PasswordAuthentication No

Make sure there is only one occurrence of this setting in the file. Sometimes, another entry might be commented (#) and a duplicate could exist later in the file.

Step 5: Restart SSH Service

Apply the changes by restarting the SSH service:

sudo systemctl restart sshd

🔧 Installation BEAM

Setup the Node, Wallet, and Wallet API

Create Directory

mkdir beam-walletcd beam-wallet

Install Beam Node

Get the latest version of Beam Nodehere

wget -c https://github.com/BeamMW/beam/releases/download/latest/linux-beam-node.tar.gz -O -| tar -xz

Addhorizon_hi=1440 at the end ofbeam-node.cfg.
Addfast_sync=1 at the end ofbeam-node.cfg.
Addpeer=eu-nodes.mainnet.beam.mw:8100,us-nodes.mainnet.beam.mw:8100 at the end ofbeam-node.cfg.

Run the node:

./beam-node

Install CLI Beam Wallet

Get the latest version of Beam Wallet CLIhere

wget -c https://github.com/BeamMW/beam/releases/download/latest/linux-beam-wallet-cli.tar.gz -O -| tar -xz

To create a wallet use:

./beam-wallet init

💡Keep your seed phrase in a safe place!

To restore a wallet use:

./beam-wallet restore --seed_phrase="<semicolon-separated list of 12 seed phrase words>"

For more information, readthis guide.

Install Beam Wallet API

Get the latest version of Beam Wallet APIhere

wget -c https://github.com/BeamMW/beam/releases/download/latest/linux-wallet-api.tar.gz -O -| tar -xz

Configuration:

Editwallet-api.cfg and add the following:

use_http=1

Start Wallet API:

./wallet-api

For more information, readthe API documentation.

⚡Contributing

Fork the repository.
Make your changes.
Submit a Pull Request (PR).

🔥Support & Community

📢 Join BEAMTelegram Group:https://t.me/BeamPrivacy

BeamPay is created by@vsnation

Donate Address

Beam:203ae2ac20c67c67e035e580284c472156356e783c33af4c74a87ab84169d433b01
BTC:3QVqpztjTXrfDCDaQiaVanHyjW6yGsWTRd

About