Salvium Tip Bot

A PHP-based Telegram tip bot for the Salvium (Monero fork) cryptocurrency.

Features

• Telegram tipping via subaddresses
• Wallet interaction via JSON-RPC
• Secure MySQL backend using PDO
• Deposit, withdraw, balance, and tipping commands
• Per-user balances for SAL1 and token assets such as salCULT
• Cron-compatible monitoring of deposits and withdrawals

Installation

1. Clone the repo
2. Copy config.sample.php to config.php and fill in your credentials
3. Update config.php with your RPC, DB, and Telegram Bot credentials
4. Set WITHDRAWALS_ENABLED to true only when wallet RPC withdrawals should be active
5. Create the user_balances table and add asset_type columns to deposits, tips, and withdrawals
6. Run salvium_tipbot.php as a Telegram webhook listener
7. Schedule salvium_tipbot_monitor.php using cron for periodic checks

Requirements

• PHP 8.1+
• MySQL 5.7+/MariaDB
• Telegram Bot Token
• Salvium RPC Wallet node

License

MIT