# ⚡ Lightning Role Bot
Is the ultimate solution for managing Discord subscriptions using the Lightning Network! 🚀

## 🛠️ Key Features:

### 🎭 Role Management:
- Automatically assign roles to paying members.

### 🌩️ Lightning Network Payments:
- Seamless integration with Lightning wallets.

### 📜 Detailed Logs:
- Keep track of activities in a dedicated log channel.

### ⏰ Automatic Monitoring:
- Check expired subscriptions and send renewal notifications.

### 🔧 Simple Setup:
- Easy-to-use commands like `/ln_admin`.

### 🧑‍💻 Perfect for servers looking to:
- Monetize through subscriptions.
- Provide a seamless and automated subscription experience.
- Integrate with Lightning wallets, like Wallet of Satoshi.

## 📖 How to Use Lightning Role Bot
### Step 1: Accept Terms and Conditions
After installing the bot, you must accept the terms and conditions before using it.
The terms will automatically appear when you type any command.
![1-terms.png](https://bernaction.github.io/lightning-role-discord-bot/img/1-terms.png) 
Once you accept, the bot will confirm that the terms have been accepted, and you can proceed to use its features.
![2-terms-accept.png](https://bernaction.github.io/lightning-role-discord-bot/img/2-terms-accept.png) 

### Step 2: Configure the Bot with /ln_admin
Use the `/ln_admin <email-lightning> <subscription usd value>` command to configure the bot for your server. This command will let you set the Lightning wallet, subscription value, log channel, and the role that the bot will manage.
![3-ln_admin_1_roles_list.png](https://bernaction.github.io/lightning-role-discord-bot/img/3-ln_admin_1_roles_list.png) 

**Important:**

> The Lightning Role bot's role must be placed above the role it will assign to users. This ensures proper permissions to assign roles.
> The target role cannot be an externally managed role (e.g., roles provided by YouTube or Twitch integrations).

To adjust the role hierarchy:

> Go to Server Settings > Roles.
> Drag the Lightning Role bot's role above the subscriber role.
> Save the changes.

![3-ln_admin_2_roles_config_in_discord.png](https://bernaction.github.io/lightning-role-discord-bot/img/3-ln_admin_2_roles_config_in_discord.png) 

After selecting and confirming the configuration, the bot will save the settings.
![3-ln_admin_3_roles_confirm.png](https://bernaction.github.io/lightning-role-discord-bot/img/3-ln_admin_3_roles_confirm.png) 
Once the settings are saved, the bot will display a confirmation message.
![3-ln_admin_4_roles_confirmed.png](https://bernaction.github.io/lightning-role-discord-bot/img/3-ln_admin_4_roles_confirmed.png) 


### Step 3: User Subscription with `/ln_subscribe`

Users can subscribe by running the `/ln_subscribe <number>` command, where <number> represents the number of months for the subscription.
Example:
> `/ln_subscribe 1` to subscribe for 1 month.

When the user subscribes, the bot will generate a Lightning invoice and a QR code for payment.
![4-ln_subscribe-new.png](https://bernaction.github.io/lightning-role-discord-bot/img/4-ln_subscribe-new.png) 
After payment is made, the bot will confirm the payment and assign the configured role to the user.
![5-ln_subscribe-payment.png](https://bernaction.github.io/lightning-role-discord-bot/img/5-ln_subscribe-payment.png) 

### Step 4: Renewing an Active Subscription

If a user wants to extend their subscription before it expires, they can use the same `/ln_subscribe` command.
The bot will calculate the new expiration date by adding the selected duration to the current expiration.
![6-ln_subscribe-renewal.png](https://bernaction.github.io/lightning-role-discord-bot/img/6-ln_subscribe-renewal.png) 
Once the renewal payment is made, the bot will confirm the extension of the subscription.
![7-ln_subscribe-renewal-payment.png](https://bernaction.github.io/lightning-role-discord-bot/img/7-ln_subscribe-renewal-payment.png) 

### 📜 Transparent Logging for Administrators

The bot ensures full transparency by providing an exclusive log channel that only the server administrators and the bot can view.
This channel, configured during the /ln_admin setup, will display detailed logs of all transactions, including:
> - Subscription requests and renewals.
> - Payment hashes and Lightning invoices.
> - Payment confirmation and status updates.
> - Commission calculations and net values sent to the configured wallet. (5%)
> - Role assignments for subscribed users.

![8-log-channel.png](https://bernaction.github.io/lightning-role-discord-bot/img/8-log-channel.png) 

This log channel helps administrators keep track of all activities related to subscriptions and payments in a clear and organized manner.
It ensures that all actions performed by the bot are visible and traceable, maintaining accountability and transparency.

## 🚀 Ready to Start?
Add the Lightning Role Bot to your server and automate everything with seamless Lightning Network payments!

Lightning Role

💡 Automate Discord Subscriptions with Lightning Network! 
⚡ Manage roles and memberships easily and effectively.

بوتات ديسكورد

Lightning Role