Astra 🌌

Astra is a Windows‑native automation stack for Roblox limited trading. It keeps value data current, schedules outbound trade scans with configurable RAP/value thresholds, and supervises companion binaries (Outbound Checker, Olympian) with automatic restart. Access is enforced via machine‑bound licensing (hardware‑locked whitelist), while an optional Discord bot handles buyer provisioning, whitelisting commands, and operational logging. Built for headless execution with a simple INI‑based configuration.

Features

• Outbound trade scans with configurable loss thresholds (RAP/value/both)
• Automatic/scheduled value file updates
• Hardware‑locked whitelist licensing per buyer
• Discord bot integration for onboarding, whitelisting, and logs
• Process orchestration for Olympian and Outbound Checker (auto‑launch/restart)
• Version check with update prompts
• Simple configuration via src/Astra_Settings.ini
• Headless operation with minimal setup

Installation

• Ensure Python is installed (recommend 3.9+).
• From the repo root, install all dependencies for both the Discord bot and the whitelist CLI:

python -m pip install -r requirements.txt

📦 Distribution

For information about the build system and executables, see the

• Distribution README

Discord Bot System 🤖

The Astra Discord Bot serves as the bridge between Astra’s backend infrastructure, Shoppy.gg’s purchase API, and the Discord user network.

For all specifications and technical details options, see Discord Bot README.

It operates as an autonomous verification and access control daemon, continuously synchronizing user data across systems.

---

⚙️ Architecture Overview

Component	Description
Shoppy API Listener	Polls Shoppy.gg REST API every few minutes for new transactions.
Database Engine	Maintains a JSON-based order registry with locked atomic updates.
Threading System	Multi-threaded monitoring with watchdog self-restart and fault tolerance.
Discord Command Interface	Provides secure DM-based commands for buyers ($buyer, $whitelist, $help).
Whitelist Sync Module	Rebuilds and deploys machine whitelists to Astra’s secure web endpoint.
Logging Core	Streams structured logs to Discord for administrative tracking.

---

🧠 Core Features

• Real-Time Order Syncing: Automatically detects and registers new Shoppy purchases via authenticated API calls.
• Distributed Whitelist Management: Hash-based whitelist keys tied to user-specific hardware identifiers, regenerated and deployed after each change.
• Cooldown Enforcement: Enforces controlled whitelist regeneration intervals (default: 5 days).
• Concurrent Safety: Thread locks prevent write collisions during database and whitelist updates.
• Fault Recovery: A persistent watchdog thread ensures self-healing in case of monitor thread failure.
• Command Protocol: Secure DM commands ($buyer, $whitelist, $help) for user onboarding and management.
• Secure Data Flow: Verified Shoppy transactions → Astra database → Discord verification → Whitelist sync.

---

🧩 Data Flow Summary

User Purchase (Shoppy.gg)
       ↓
Bot Fetches New Orders (API Poll)
       ↓
Database Update + Backup (JSON)
       ↓
User Executes $buyer / $whitelist
       ↓
Whitelist Generated + Uploaded (/var/www/html/whitelists)
       ↓
Discord Role Assigned + Log Sent

---

🔒 Reliability Features

• Multi-threaded design ensures uninterrupted background monitoring.
• Full backup retention in db_backups/ and whitelist_backups/.
• Continuous upload verification with fallback recovery.
• Minimal latency between purchase and role assignment.

---

This subsystem represents the automation core of Astra’s licensing and access infrastructure,
delivering real-time validation, customer management, and secure distribution pipelines across Shoppy, Discord, and Astra servers.